适用范围与准备
适用于有文档的上传或提交接口明确返回411 Length Required。先保留未上传文件和原始错误;本文不对生产接口反复提交,也不把请求长度问题解释为服务停止维护。
先区分原因
411表示服务拒绝没有明确Content-Length的请求。长度应是实际消息内容的字节数,不是汉字数、编辑器显示的字符数或编码前文本长度。客户端能够流式传输,不代表所有网关和接口都接受该传输方式。
按顺序操作
- 先确认HTTP状态确为411,并查看接口允许的方法、正文类型与长度要求。界面只提示上传失败时不能直接套这个结论。
- 保存请求头中Content-Length或Transfer-Encoding的情况,以及正文来自固定文件、内存数据还是标准输入流。不要为了取证把真实附件和认证头发到第三方测试网站。
- 在本人维护的测试端点,用一个已知内容的小文件和客户端正常的正文发送选项做对照,让HTTP库生成长度。不要把字符数抄进Content-Length,也不同时发送相互矛盾的长度与传输编码头。
- 如果固定正文仍被411拒绝,由接口维护者沿网关到后端核对实际收到的请求。确需改传输方式或接口时按服务文档处理;涉及真实写入,先确认前次结果再重试。
| 正文来源 | 需要确认 |
|---|---|
| 固定本地文件 | 发送时的实际字节数与内容 |
| 中文或其他Unicode文本 | 编码后的字节数,不是字符数 |
| 标准输入或流式来源 | 客户端是否知道长度、网关是否支持该方式 |
| 经过中间代理 | 后端实际收到的长度与传输头 |
怎样确认有效
在测试接口确认完整收到预期字节和字段,且不再返回411。HTTP传输成功后还需核对业务保存结果;手工补一个数字让错误变化,不代表数据完整。
无效时恢复与下一步
撤回手工添加的长度头,保留文件原件和一次受控对照。不要绕过接口限制、修改安全校验或无限加大上传大小;要求不明确时让接口方提供支持的客户端和请求样例。