上传超990个文件触发413错误（Python+Flask+Nginx）如何解决？

你的问题核心是表单字段数量超限，而非单纯的文件总大小。当上传大量文件时，每个文件对应表单中的一个独立字段，Flask底层的Werkzeug默认限制了表单字段总数，同时Nginx的请求头缓冲区也可能因字段过多被撑爆，最终触发413错误。以下是具体解决步骤：

1. 调整Flask/Werkzeug的表单字段数量限制 #

Werkzeug默认设置MAX_FORM_KEYS = 1000，当上传文件数量接近这个值（比如990个）时就会触发限制。你需要在Flask配置中手动增大这个值：

# 在Flask app初始化后添加配置
app.config['MAX_FORM_KEYS'] = 5000  # 根据业务需求调整，比如设为10000

这个参数控制表单中允许的最大键/字段数量，每个上传的文件都会占用一个字段，所以设置的值要大于你预期的最大上传文件数。

2. 优化Nginx的请求头缓冲区配置 #

当表单字段过多时，请求头的大小会超出Nginx默认缓冲区，也会导致413错误。需要在/etc/nginx/nginx.conf或对应站点配置文件中添加/修改以下配置：

http {
    # 其他原有配置...
    client_header_buffer_size 4k;
    large_client_header_buffers 4 8k;
    # 若使用fastcgi反向代理Flask，补充以下配置
    fastcgi_buffers 8 16k;
    fastcgi_buffer_size 32k;
}

这些配置用于扩大Nginx处理请求头和FastCGI响应的缓冲区，避免因字段过多导致的请求截断。

3. 验证配置并重启服务 #

修改完配置后，分别重启Nginx和Flask应用：

# 重启Nginx
sudo systemctl restart nginx

# 重启Flask应用（根据你的部署方式调整，比如用gunicorn托管的场景）
sudo systemctl restart your-flask-service

之后测试上传超过990个文件的场景，确认413错误是否消失。

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