Flask Session在开发服务器正常，Nginx+Gunicorn生产环境失效求助

你的问题核心是Flask的session在反向代理环境下无法正确维持，开发环境正常但生产环境失效，大概率是SECRET_KEY未正确配置或Nginx反向代理头传递不全导致的，以下是具体解决步骤：

1. 确保Flask应用设置固定SECRET_KEY #

Flask在开发环境会自动生成临时SECRET_KEY，但生产环境必须显式设置——多个Gunicorn worker会使用不同的临时密钥，导致session加密/解密不一致，直接引发session失效。

在你的Flask应用代码中添加：

import os
app.secret_key = os.urandom(24)  # 生成随机复杂密钥，也可手动指定固定字符串

确保所有worker共享同一个SECRET_KEY，这是客户端session（Flask默认）正常工作的核心前提。

2. 完善Nginx反向代理的请求头配置 #

检查proxy_params文件（通常路径为/etc/nginx/proxy_params），必须包含以下请求头，让Flask正确识别请求来源，保证session cookie的有效性：

proxy_set_header Host $http_host;
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;

如果proxy_params缺失上述配置，可直接修改该文件，或在Nginx的location块中显式添加：

server {
    listen 80;
    server_name 192.168.1.15;
    location / {
        proxy_set_header Host $http_host;
        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;
        proxy_pass http://unix:/home/pi/website/ris2023/ris.sock;
    }
}

3. 验证Cookie传递状态 #

用浏览器开发者工具（F12）检查：

• 登录请求的响应头中是否存在Set-Cookie字段，包含session相关内容
• 后续访问首页的请求头中是否携带了该Cookie字段
  如果没有Set-Cookie，说明Flask未正确生成session；如果有但后续请求未携带，检查Nginx是否拦截了Cookie，或浏览器是否禁用了同域名Cookie。

4. 适配反向代理的Flask Cookie配置 #

若上述步骤无效，可显式设置Flask的Cookie参数，适配反向代理环境：

app.config['SESSION_COOKIE_DOMAIN'] = '192.168.1.15'  # 匹配你的server_name
app.config['SESSION_COOKIE_PATH'] = '/'
app.config['SESSION_COOKIE_HTTPONLY'] = True  # 提升安全性，不影响功能

关于Flask-Login的相同问题 #

Flask-Login本质依赖Flask的session机制实现用户状态维持，核心问题仍是session的传递/解密失效，解决上述问题后Flask-Login也会恢复正常。

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