400 错误请求

HTTP 400 错误请求 客户端错误响应 状态码表示服务器不会处理请求,因为服务器认为这是一个客户端错误。400 响应的原因通常是请求语法格式错误、请求消息框架无效或请求路由欺骗。

收到 400 响应的客户端应该预期在不修改的情况下重复请求将会失败并出现相同的错误。

状态

http
400 Bad Request

示例

格式错误的请求语法

假设一个 REST API 存在,其端点在 http://example.com/users 管理用户,并且以下内容的 POST 请求尝试创建用户,但使用无效的 JSON,没有转义换行符

http
POST /users HTTP/1.1
Host: example.com
Content-Type: application/json
Content-Length: 38

{
  "email": "[email protected]
",
  "username": "b.smith"
}

如果 内容 格式正确,我们期望得到一个 201 已创建 响应或其他成功消息,但服务器返回了 400,并且响应主体包含一个带有上下文信息的 message 字段,以便客户端可以使用格式正确的请求重试操作。

http
HTTP/1.1 400 Bad Request
Content-Type: application/json
Content-Length: 71

{
  "error": "Bad request",
  "message": "Request body could not be read properly.",
}

规范

规范
HTTP 语义
# status.400

另请参阅