Nginx设置client_max_body_size超2000m启动失败，如何解决？

报错原因 #

旧版本Nginx对client_max_body_size的单位支持存在限制，比如低于1.9.1的版本不支持G作为单位，同时部分版本对数值与单位的格式要求严格，写错就会触发启动报错。

解决步骤 #

• 检查Nginx版本
  执行命令nginx -v查看当前版本。如果版本低于1.9.1，不要使用G作为单位，把10G转换成兆字节（10*1024=10240），写成client_max_body_size 10240m;。

• 修正配置格式

  • 确保数值和单位之间没有空格，比如正确写法是10240m，不是10240 m；
  • 统一使用小写单位（m），避免大写M或G，部分旧版本仅识别小写单位；
  • 也可以直接写字节数，10G对应的字节值是10737418240，写成client_max_body_size 10737418240;。

• 确认指令上下文
  client_max_body_size必须放在http、server或location块中，不能放在全局配置层级。示例：

  http {
      client_max_body_size 10240m;
      server {
          listen 80;
          server_name your-domain.com;
          # 也可以在server或location块单独设置
          location /upload {
              client_max_body_size 10240m;
              proxy_pass http://your-storage-service;
          }
      }
  }
  

• 验证并重启Nginx
  修改配置后先执行nginx -t验证语法是否正确，无报错后再重启服务：

  # 平滑重启
  nginx -s reload
  # 或者用systemd管理的方式
  systemctl reload nginx
  

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