POST请求缺少Request Body时最合适的错误提示与状态码是什么

对应HTTP状态码 #

应该使用 400 Bad Request。
根据HTTP 1.1 标准定义，400状态码用于标识客户端请求存在格式错误、服务端无法正常处理的场景，完全缺失POST请求体属于典型的客户端请求不符合接口要求的情况，完全匹配400状态码的适用范围。
注意不要误用422状态码：422是用于请求体格式合法但内容语义错误（比如必填字段为空、字段类型不匹配）的场景，和完全无请求体的情况有本质区别

错误提示内容 #

返回的错误信息要清晰明确，优先提供问题原因和排查方向，参考返回结构如下：

{
  "biz_code": 400001,
  "error_msg": "请求缺少必填的Request Body，请检查请求参数结构是否符合接口文档要求",
  "request_id": "20240520xxxxx1234"
}

其中request_id用于后续排查问题时快速定位日志，避免联调阶段反复沟通索要上下文。

报错信息展示规则 #

分两类场景处理：

• 面向接口调用方（前后端开发人员、第三方对接者）：必须完整返回上述错误信息，能够大幅降低联调、问题排查的沟通成本
• 面向普通前端用户：不需要展示技术类报错细节，统一转换为“当前操作失败，请稍后再试”这类友好提示即可，既避免用户困惑，也能降低接口实现细节泄露的安全风险

内容的提问来源于stack exchange，提问作者Srish