适用范围与准备

适用于有文档的上传或提交接口明确返回411 Length Required。先保留未上传文件和原始错误;本文不对生产接口反复提交,也不把请求长度问题解释为服务停止维护。

先区分原因

411表示服务拒绝没有明确Content-Length的请求。长度应是实际消息内容的字节数,不是汉字数、编辑器显示的字符数或编码前文本长度。客户端能够流式传输,不代表所有网关和接口都接受该传输方式。

按顺序操作

  1. 先确认HTTP状态确为411,并查看接口允许的方法、正文类型与长度要求。界面只提示上传失败时不能直接套这个结论。
  2. 保存请求头中Content-Length或Transfer-Encoding的情况,以及正文来自固定文件、内存数据还是标准输入流。不要为了取证把真实附件和认证头发到第三方测试网站。
  3. 在本人维护的测试端点,用一个已知内容的小文件和客户端正常的正文发送选项做对照,让HTTP库生成长度。不要把字符数抄进Content-Length,也不同时发送相互矛盾的长度与传输编码头。
  4. 如果固定正文仍被411拒绝,由接口维护者沿网关到后端核对实际收到的请求。确需改传输方式或接口时按服务文档处理;涉及真实写入,先确认前次结果再重试。
正文来源需要确认
固定本地文件发送时的实际字节数与内容
中文或其他Unicode文本编码后的字节数,不是字符数
标准输入或流式来源客户端是否知道长度、网关是否支持该方式
经过中间代理后端实际收到的长度与传输头

怎样确认有效

在测试接口确认完整收到预期字节和字段,且不再返回411。HTTP传输成功后还需核对业务保存结果;手工补一个数字让错误变化,不代表数据完整。

无效时恢复与下一步

撤回手工添加的长度头,保留文件原件和一次受控对照。不要绕过接口限制、修改安全校验或无限加大上传大小;要求不明确时让接口方提供支持的客户端和请求样例。