前端文件上传413 Request Entity Too Large报错解决

最新推荐文章于 2025-10-15 21:45:41 发布

原创最新推荐文章于 2025-10-15 21:45:41 发布 · 4.5k 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#前端

本文介绍了解决Node.js应用中遇到的413 Request Entity Too Large错误的过程。该错误通常发生在上传文件大小超过限制时。通过调整koaBody中间件配置及修改Nginx的client_max_body_size参数，最终解决了文件上传限制的问题。

1.问题：在本地开发中无论上传小文件还是大文件都可以上传成功，但将代码发布到测试环境后，超过1mb的文件就会报错，打开控制台一看413 Request Entity Too Large。

2.排查我们的系统接口在node层做了一下转发代理用到了koaBody

app.use(
  koaBody({
    parsedMethods: ['POST', 'PUT', 'PATCH', 'DELETE'],
    formLimit: '50mb',
    jsonLimit: '50mb', // ajax 请求
    textLimit: '50mb',
    multipart: false,
    formidable: {
      maxFieldsSize: 10 * 1024 * 1024
    },
  })
);

前端限制解除，重新打包上线，还是报错 413 Request Entity Too Large

继续排查：

Nginx默认最大能够上传1MB文件，大于1MB的文件自然无法上传，打开nginx.conf（没权限找运维人员）在http{ }中设置：client_max_body_size 50m。

解决成功！