Flask应用Apache 2.4 CGI部署后文件上传返回HTTP 400错误求助

兄弟，我之前在Windows Server 2012 R2的Apache 2.4上用CGI部署Flask时，也踩过一模一样的文件上传400坑！本地功能全正常，一上服务器就报Bad Request，查下来都是环境配置的锅，你挨个排查试试：

1. 先确认表单的enctype属性（最容易漏的点！） #

本地测试可能表单碰巧加了，但部署后如果HTML表单没设置enctype="multipart/form-data"，浏览器根本不会把文件数据传给服务器，Flask的request.files自然是空的，直接返回400。

检查你的上传表单代码，必须包含这个属性：

<form method="POST" action="/upload" enctype="multipart/form-data">
    <!-- 文件输入框和提交按钮 -->
    <input type="file" name="file">
    <button type="submit">上传</button>
</form>

2. 匹配Apache和Flask的文件大小限制 #

Apache默认对CGI请求的POST大小有严格限制，同时Flask自身也有上传文件大小上限，两者不匹配就会触发400：

Apache端配置 #

打开httpd.conf，添加或修改以下配置（这里设为10M，根据你的需求调整）：

# 限制CGI请求的最大POST内容大小（单位：字节）
LimitRequestBody 10485760

确保mod_cgi模块已经启用（Windows下Apache默认应该启用了，检查httpd.conf里有没有LoadModule cgi_module modules/mod_cgi.so）。

Flask端配置 #

在你的Flask app里显式设置最大上传大小，和Apache的限制保持一致：

from flask import Flask

app = Flask(__name__)
# 设置最大上传文件大小为10M
app.config['MAX_CONTENT_LENGTH'] = 10 * 1024 * 1024

3. 检查上传目录的权限 #

Windows Server上，Apache是用特定用户运行的（默认是Local System，也可能是你自定义的用户），如果Flask的临时上传目录或你指定的上传目录没有给这个用户读写权限，文件上传会失败，进而触发400。

• 可以显式设置Flask的上传目录，避免使用系统临时目录：

  import os
  app.config['UPLOAD_FOLDER'] = os.path.join(os.getcwd(), 'uploads')
  # 确保目录存在
  os.makedirs(app.config['UPLOAD_FOLDER'], exist_ok=True)
  

• 然后在Windows资源管理器里找到这个uploads文件夹，右键→属性→安全，添加Apache运行用户，给它读写权限。

4. 验证CGI环境变量是否正常传递 #

有时候Apache的CGI环境会漏掉CONTENT_TYPE或CONTENT_LENGTH这两个关键变量，导致Flask无法解析multipart格式的文件数据。

可以在你的CGI脚本（比如flask.cgi）开头加一段调试代码，打印所有环境变量：

import os
print("Content-Type: text/plain\n")
for key, value in os.environ.items():
    print(f"{key}: {value}")

访问上传页面提交请求后，看看输出里有没有CONTENT_TYPE: multipart/form-data; boundary=xxx和CONTENT_LENGTH的正确值。如果缺失，检查Apache的httpd.conf里有没有禁用这些变量的配置，比如SetEnvIf之类的规则。

5. 排查ModSecurity拦截（如果安装了的话） #

如果你的Apache装了ModSecurity模块，它可能会把文件上传请求误判为恶意请求，直接返回400。可以临时在上传接口的Location配置里关闭ModSecurity测试：

<Location "/upload">
    SecRuleEngine Off
</Location>

如果测试后上传正常，再调整ModSecurity的规则，不要直接全局关闭，避免安全风险。

本地正常说明你的Flask代码逻辑没问题，重点放在服务器环境的配置上，先从表单enctype和文件大小限制查起，这两个是最常见的原因！

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