什么是 RESTful API？
RESTful API 是一种基于 HTTP 协议设计的 Web API，它是一种约定俗成的接口设计风格，可以提供简单、轻量、可靠、灵活的 Web 服务。RESTful API 依靠 HTTP 协议提供数据传输和状态转移，通过 URIs（Uniform Resource Identifiers）来定位资源，使用 HTTP 动词（GET、POST、PUT、DELETE 等）操作资源，通过 HTTP 状态码标示操作结果。
为什么需要异常处理？
在开发 RESTful API 的过程中，异常处理是非常重要的一环。因为 API 的用户是无法直接操作后台数据库等资源，而是通过 API 来访问，因此错误信息和异常信息需要返回给 API 的调用者。同时，良好的异常处理也能提高系统的可靠性和安全性，可以避免系统出现不必要的错误和被攻击的风险。
异常处理的设计原则
在设计 RESTful API 的异常处理时，我们需要遵循以下原则：
- 接口返回的数据应该与请求有一致的格式；
- 减少接口返回信息的冗余，同时尽可能提供有效的信息；
- 当服务端处理失败时需要为客户端提供妥善的处理方式；
- 避免返回敏感信息；
- 采用标准的 HTTP 状态码。
HTTP 状态码
HTTP 状态码是表示 Web 服务器响应状态的三位数字代码。状态码的第一位数字表示状态的类别，共分为5种，状态码的第二位和第三位数字可在业务自定义。在 RESTful API 中，HTTP 状态码的种类和返回码约定如下：
- 200：请求成功
- 201：创建成功
- 204：删除成功
- 400：请求参数错误
- 401：未授权
- 403：禁止访问资源
- 404：未找到资源
- 500：服务器内部错误
RESTful API 异常处理示例
下面是一个 RESTful API 异常处理的示例：
-- -------------------- ---- -------
----- ------- - ------------------
----- --- - ---------
----- ---- - ----
------------ ------------- ---- -
--------------- --------
--
--------------------- ------------- ---- -
----- ------ - -------------
-- ------- --- ---- -
----------------------
-------- ----- --- -------
------ ---
--
- ---- -
----- ---- - -
--- --
----- ------
---- --
-
--------------
-
--
---------------- ---------- -
---------------- ------ --------- -- ---- ----------
--
以上代码中，我们定义了两个路由：根路由（/）和查询用户路由（/users/:id）。当用户访问根路由时，返回“Hello World!”；当用户访问查询用户路由时，我们通过请求参数获取指定用户的信息，如果查询到用户，则返回用户信息；如果未查询到用户，则返回 404 状态码和错误信息。
总结
设计好 RESTful API 的异常处理是保证 API 质量的一个关键点。可以根据上面的设计原则自行进行合理的设计。在实现过程中要注意，把错误信息和异常信息返回给客户端，同时避免返回敏感信息。让 API 更加可靠，安全！
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/64672bcd968c7c53b078ffbd