REST API常见错误码对照表

一文掌握 REST API 常见错误代码

在 REST API 的使用过程中，错误码是调试和解决问题的关键。以下为大家呈现 REST API 常见错误码对照表及详细解析。

1xx - 信息性状态码：这类状态码表示临时的响应信息。例如 100 Continue，客户端在发送大请求时，先发送一个包含 100 - Continue 期望的请求，服务器返回 100 表示客户端可以继续发送剩余部分。

2xx - 成功状态码：表示请求已成功被服务器接收、理解并接受。200 OK 最为常见，表明请求正常处理，返回所需的数据。201 Created 用于创建资源的请求，如创建新用户或新订单后返回该状态码。204 No Content 表示请求已成功处理，但没有返回内容，常见于删除操作。

3xx - 重定向状态码：表示需要客户端采取进一步的操作来完成请求。301 Moved Permanently 表示请求的资源已永久移动到新的 URL，客户端应使用新的 URL 进行后续请求。302 Found 和 307 Temporary Redirect 都表示资源临时移动，客户端下次请求仍可使用原 URL。304 Not Modified 用于缓存机制，当客户端有缓存时，服务器通过此状态码告知客户端可以使用缓存内容。

4xx - 客户端错误状态码：意味着客户端可能存在错误。400 Bad Request 通常是由于客户端发送的请求格式有误，如参数缺失或格式不正确。401 Unauthorized 表示请求需要身份验证，但客户端未提供有效的认证信息。403 Forbidden 表明客户端已通过身份验证，但没有权限访问该资源。404 Not Found 是最常见的错误之一，表示请求的资源不存在。405 Method Not Allowed 指定了不允许的 HTTP 方法，如对一个只支持 GET 请求的资源使用了 POST 请求。

5xx - 服务器错误状态码：表示服务器在处理请求时发生了内部错误。500 Internal Server Error 是通用的服务器错误，可能是服务器端代码出现异常或配置问题。502 Bad Gateway 通常表示服务器作为网关或代理时，从上游服务器收到无效响应。503 Service Unavailable 说明服务器暂时无法处理请求，可能是服务器过载或正在维护。504 Gateway Timeout 在服务器作为网关或代理时，未能及时从上游服务器收到响应时返回。

了解这些常见的 REST API 错误码，有助于开发者快速定位和解决问题，并能更好地设计和优化 API 接口，提升系统的稳定性和可用性以及用户体验。

tags标签：客户端 请求 服务器 API REST 状态 表示 错误 错误码 100