413 Payload Too Large报错

一句话：上传或请求内容太大，超过服务器、网关或接口允许的体积限制。

它是什么

413 Payload Too Large表示请求体过大。常见于上传图片、音频、PDF、长文本、Base64文件、聊天记录或知识库文档时。限制可能来自前端、后端框架、Nginx、云函数、API网关或第三方AI接口。

适合干什么

• 上传文件失败的人
• 做知识库和RAG的人
• 提交长文本给AI的人
• 部署到云函数或Nginx的人

不适合干什么

• 不知道上传内容大小
• 没有服务器配置权限
• 想无限制上传大文件
• 没有考虑存储和费用的人

普通人怎么用

• 先确认文件或请求体大小
• 查看是哪一层返回413
• 压缩文件或缩短文本
• 调整后端请求体限制
• 大文件改用对象存储直传

进阶用户怎么用

• 用分片上传处理大文件
• 把长文本分块入库
• 避免用Base64传大文件
• 设置前端上传大小提示
• 在网关层和应用层保持限制一致

常见误区

• 只改前端限制，后端仍然拒绝
• 把图片转Base64导致体积变大
• 不知道是Nginx还是应用框架限制
• 让AI一次处理超长文档

和相似工具的区别

• 413 vs 500：413通常是请求太大被明确拒绝，500是服务器内部错误。
• 文件上传 vs 文本请求：二者都可能触发413，本质都是请求体超过限制。

入门步骤

• 确认大小
• 定位返回层
• 压缩或分块
• 调整限制
• 改存储方案
• 加前端提示

推荐工具（第三方）

浏览器Network、Nginx、Express、Next.js、对象存储、Vercel Logs