Google Cloud Functions中Flask会话报错：未设置密钥的解决方法

我开发了一个简单的登录脚本，本地运行app.py时会设置app.secret_key并启动Flask应用，程序正常。但部署到Google Cloud Functions后，入口函数main(request=None)没有初始化Flask应用，导致未设置secret_key，出现错误：The session is unavailable because no secret key was set。

问题出在哪 #

Google Cloud Functions运行时不会执行app.py里if __name__ == "__main__"的代码块，而你的main.py既没初始化Flask应用实例，也没设置secret_key——session依赖Flask应用上下文和secret_key，自然就报错了。得把Flask应用的初始化逻辑抽出来，让本地和云端环境共用。

怎么解决 #

1. 抽离Flask应用配置到公共模块 #

新建app_config.py，把Flask初始化、CORS配置、secret_key设置都放在这，本地和云端都能导入使用：

# app_config.py
import os
import flask
from flask_cors import CORS

# 初始化Flask应用
app = flask.Flask(__name__)

# 配置CORS
cors = CORS(app)
app.config['CORS_HEADERS'] = 'Content-Type'

# 设置Secret Key：优先用环境变量（云端安全），本地开发用随机生成的
app.secret_key = os.environ.get('FLASK_SECRET_KEY') or os.urandom(12)

2. 修改本地运行的app.py #

现在app.py只需要导入公共配置的app，绑定路由后启动服务就行：

# app.py - 仅本地使用
from app_config import app
import main
from flask import request

@app.route("/", methods=['GET', 'POST'])
def index():
    print("index()")
    return main.main(request)

if __name__ == "__main__":
    app.run(debug=True, host="0.0.0.0", port=8080, ssl_context=('certificates/cert.pem', 'certificates/key.pem'))

3. 调整GCF入口main.py #

在main.py里导入公共的app，用Flask的请求上下文包裹业务逻辑，确保session能正常工作：

# main.py - Google Cloud Function入口文件
from flask import session
from app_config import app
from src.pages.login import login

def main(request=None):
    print("main()")
    # 把GCF的请求放到Flask应用上下文里
    with app.request_context(request.environ):
        if not session.get('logged_in'):
            return login()
        else:
            return "logged in!"

if __name__ == '__main__':
    # 本地测试时，模拟请求上下文
    with app.test_request_context():
        main()

4. 简化login.py #

不需要再传app参数，直接用Flask的全局上下文就行，顺便加个参数默认值避免KeyError：

# src/pages/login.py
from flask import request, session

def login():
    print("login() :: Init")

    # 处理process参数，默认0避免KeyError
    process = int(request.args.get('process', 0))

    if process == 1:
        inp_username = ""
        inp_password = ""
        try:
            login_form = request.form
            inp_username = login_form.get('inp_username', "")
            inp_password = login_form.get('inp_password', "")
        except Exception as e:
            print(f"login() :: Process error when getting request form e={e}")

        if inp_username == "admin" and inp_password == "admin":
            print("login() :: Welcome")
            session['logged_in'] = True
            return "Welcome"
        else:
            print("login() :: Wrong password")
            return "Wrong password"

    return '''
    <form method="post" action="?process=1" enctype="multipart/form-data">
        <p>Username:<br />
        <input type="text" name="inp_username" value="" />
        </p>
        
        <p>Password:<br />
        <input type="password" name="inp_password" value="" />
        </p>
        
        <p>
        <input type="submit" value="Login" />
        </p>
    </form>
    '''

5. 部署GCF的注意事项 #

• 设置环境变量：在GCF控制台的函数配置里加FLASK_SECRET_KEY，用openssl rand -hex 16生成一个固定随机字符串，避免函数重启后secret_key变化导致session失效。
• 依赖清单：确保requirements.txt里包含flask、flask-cors，部署时GCF会自动安装。

为啥这样改就好使 #

• 公共的app_config.py保证本地和云端用同一个Flask实例，secret_key在应用启动时就设置好了，不会遗漏。
• app.request_context(request.environ)把GCF的请求套进Flask上下文里，session就能正常读取和写入了。
• 去掉冗余的app参数传递，用Flask全局上下文简化代码逻辑。

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