HTTP状态码 400 (Bad Request) 含义及原因

HTTP 400 Bad Request

含义

• 400 是 4xx 客户端错误 系列中的第一条状态码，表示服务器因为 客户端发送的请求无效 而无法解析或处理。
• 该错误通常说明 请求的语法、格式或内容不符合 HTTP 协议或服务器的要求，服务器在未对请求做任何业务处理的情况下直接返回此码。

产生原因（常见场景）‍

1. 请求语法错误
   • 请求行（方法、URL、协议版本）拼写错误或缺失。
   • 请求头部格式不符合 RFC 7230（如缺少冒号、换行错误）。
2. 请求体格式错误
   • JSON、XML、表单等数据 不是合法的结构（缺少闭合括号、非法字符等）。
   • 未对对象进行 JSON.stringify 导致发送的不是字符串。
3. 参数错误或缺失
   • 必填字段未提供、字段名称拼写错误、类型不匹配（如期望数字却收到字符串）。
   • 参数值超出服务器设定的合法范围或长度限制。
4. 请求大小超限
   • 请求头或请求体超过服务器配置的最大长度（如 MaxFieldLength、MaxRequestBytes）。
5. 安全或策略限制
   • 请求中包含被服务器视为潜在恶意的内容（如跨站脚本、非法字符）。
   • 受限的域名或未绑定的主机名导致服务器拒绝请求。
6. 路由或资源错误
   • URL 中的路径或查询字符串不符合路由规则，导致服务器无法映射到有效资源。
7. 浏览器/客户端缓存或 Cookie 问题
   • 损坏的 Cookie、过期的会话信息也可能触发 400 错误。

处理建议

• 检查并修正请求语法：确保请求行、请求头、请求体均符合 HTTP/1.1（或 HTTP/2）规范。
• 验证请求参数：确认必填字段、数据类型、取值范围均符合接口文档要求。
• 使用合法的序列化方式：如发送 JSON 时务必使用 JSON.stringify，并检查生成的字符串是否有效。
• 控制请求大小：对上传文件或长查询字符串进行分片或压缩，或在服务器端提升相应的限制阈值。
• 查看服务器返回的错误信息：多数实现会在响应体中提供具体的错误描述，依据提示进行针对性修正。
• 清除缓存/Cookie：在浏览器端尝试清除相关缓存或 Cookie，重新发起请求。

简要结论
HTTP 400 Bad Request 表示 客户端请求本身有错误，服务器无法继续处理。出现该状态码时，必须在客户端侧修改请求（如语法、参数、大小、编码等），否则重复请求只会再次失败。通过仔细检查请求的每一部分并参考服务器返回的错误细节，通常可以快速定位并解决问题。