Flask+Gunicorn搭配Nginx反向代理时无法加载静态文件问题

当你直接运行Flask+Gunicorn时，Flask的内置静态文件服务（开发环境适配的功能）能正常处理/static路径的请求，但加上Nginx反向代理后失效，主要有这几个核心原因：

• Nginx的请求拦截或路径转发问题：Nginx默认会尝试自行处理静态文件请求（比如匹配.css/.js这类后缀的文件），而不是把请求转发给Gunicorn。如果你的Nginx配置里没有明确说明要把/static请求转交给后端，它会去自己的root目录下找文件，找不到就返回404。
• 请求头传递缺失：如果Nginx转发请求时没传递Host头，Flask生成静态文件URL时会用Gunicorn的本地地址（比如http://127.0.0.1:8000/static/xxx.css），而不是你的公网域名，浏览器自然无法加载。
• Flask静态路径配置不匹配：虽然默认情况下Flask会找项目根目录的static文件夹，但如果你的static_folder或static_url_path自定义过，可能导致请求路径和实际文件位置不对应。

1. 先检查Nginx的转发配置是否正确 #

首先确保你的Nginx server块配置里，正确转发了所有请求，并且传递了必要的请求头。示例配置如下：

server {
    listen 80;
    server_name your-domain.com;

    location / {
        # 转发到Gunicorn的监听地址
        proxy_pass http://127.0.0.1:8000;
        # 必须传递Host头，否则Flask生成的URL会出错
        proxy_set_header Host $host;
        # 传递客户端真实IP和转发信息（可选但推荐）
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

修改完配置后，记得执行sudo nginx -t检查语法，然后sudo systemctl reload nginx生效。

2. 验证Gunicorn端的静态文件服务是否正常 #

在服务器上用curl直接访问Gunicorn的静态文件路径：

curl http://127.0.0.1:8000/static/style.css

如果能返回正确的CSS内容，说明Flask+Gunicorn本身没问题，问题肯定在Nginx；如果返回404，那得检查Flask的静态文件配置：

# 确保Flask app的静态路径配置正确（默认情况不用改，自定义的话要对应）
app = Flask(__name__, 
            static_folder='./static',  # 你的静态文件实际目录
            static_url_path='/static'  # 对外暴露的URL路径
           )

3. 解决Nginx拦截静态请求的问题 #

如果Nginx默认拦截了/static请求，你有两种处理方式：

方式一：强制让Nginx把/static请求转发给Gunicorn

在Nginx配置里添加专门的location /static规则：

location /static {
    proxy_pass http://127.0.0.1:8000;
    proxy_set_header Host $host;
    # 其他proxy头和location /里的保持一致
}

方式二：推荐生产环境用Nginx直接托管静态文件（性能更好）

Flask的内置静态服务只适合开发，生产环境让Nginx直接返回静态文件效率更高。把你的静态文件目录暴露给Nginx，然后配置：

location /static {
    # 这里填你的Flask项目根目录，Nginx会自动找该目录下的static文件夹
    root /path/to/your/flask-project;
    # 设置缓存过期时间，提升加载速度
    expires 30d;
    add_header Cache-Control "public, max-age=2592000";
}

最常见的问题就是Nginx没传递Host头，或者默认拦截了静态请求没转发给Gunicorn。如果只是临时测试，用方式一转发就行；但生产环境一定要用方式二，让Nginx处理静态文件，既能提升性能，也能减轻Gunicorn的压力。

内容的提问来源于stack exchange，提问作者X.Z