client_max_body_size不生效致HTTP 413错误，求排查方向

1. 排查是否存在多层Nginx代理 #

从错误信息的差异（有时带版本号nginx/1.21.6，有时只显示nginx）来看，请求可能经过了多层Nginx节点（比如宿主机Nginx、云服务商负载均衡Nginx、CDN节点等）。外层Nginx可能未配置client_max_body_size，导致大文件在到达你配置的Nginx之前就被拦截：

• 检查服务器宿主机级别的Nginx配置，确认其client_max_body_size设置；
• 若使用云服务，查看负载均衡、CDN的文件上传限制配置。

2. 验证Nginx配置是否正确生效 #

• 先检查配置语法：在Docker容器内执行nginx -t，确保无语法错误；
• 修改配置后必须重载或重启Nginx：执行nginx -s reload（容器内），或直接重启Docker容器；
• 确认修改的是运行中Nginx实例对应的配置文件（比如Docker挂载的配置卷是否正确，避免误改本地文件但容器内未同步）。

3. 检查后端应用的文件大小限制 #

即使Nginx放开了限制，Nuxt/Node.js后端可能自身存在上传大小限制：

• Nuxt 2中，可在nuxt.config.js里添加或修改：

  server: {
    maxBodySize: '20mb'
  }
  

• 若后端使用Express等框架，检查body-parser或文件上传中间件（如multer）的大小限制配置。

4. 确认请求路径匹配到目标location块 #

你的client_max_body_size配置在匹配/api等路径的location块中，需确认文件上传的请求URL确实匹配该正则：

• 比如如果上传接口是/upload而非/api/upload，则该location块的限制不会生效；
• 可临时将client_max_body_size 20M;移到server块（全局）测试，验证路径匹配是否正确。

5. 查看Nginx错误日志定位根源 #

直接查看Nginx错误日志（Docker容器内路径通常为/var/log/nginx/error.log），日志会明确记录触发413错误的具体细节，比如：

client intended to send too large body: 2097152 bytes, client: xxx.xxx.xxx.xxx, server: xxx, request: "POST /api/upload HTTP/1.1", host: "xxx"

通过日志可确定是哪一层Nginx、哪个配置块触发的限制，是最直接的排查方式。

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