Flask初始化报错：'Flask'对象无'session_cookie_name'属性求解决

问题描述 #

之前正常运行的Flask应用，现在初始化时持续抛出上述错误。排查发现移除app.config["SESSION_TYPE"] = "filesystem"后错误消失，但业务必须使用会话功能，且优先选择文件系统存储会话数据。

测试代码如下：

from flask import Flask, render_template,redirect, url_for, request, session
from flask_session import Session

app = Flask(__name__)

app.config["SESSION_PERMANENT"] = False
app.config["SESSION_TYPE"] = "filesystem"

Session(app)

@app.route("/")
def index():
    session["test"] = "test"
    return render_template ('index.html')

该代码此前可正常运行，现在突然失效。已尝试更换Flask-Session版本、手动添加app.config["SESSION_COOKIE_NAME"]配置（默认值为session），但均无法解决问题或改变错误信息。

解决方法 #

1. 修复版本兼容性问题 #

Flask 2.3+ 调整了会话相关属性的存储位置，session_cookie_name从Flask对象的直接属性移到了app.config中。旧版本的Flask-Session仍在直接访问app.session_cookie_name，导致报错：

• 升级Flask-Session到最新稳定版：

  pip install --upgrade flask-session
  

• 若暂时不想升级Flask-Session，可降级Flask到2.2.x版本：

  pip install flask==2.2.5
  

2. 调整Session初始化顺序 #

部分场景下Session(app)初始化过早，导致Flask配置未完全加载，改用延迟初始化方式：

from flask import Flask, render_template,redirect, url_for, request, session
from flask_session import Session

app = Flask(__name__)

app.config["SESSION_PERMANENT"] = False
app.config["SESSION_TYPE"] = "filesystem"

# 先创建Session实例，不传入app
sess = Session()
# 配置完成后再初始化
sess.init_app(app)

@app.route("/")
def index():
    session["test"] = "test"
    return render_template ('index.html')

3. 排查配置覆盖问题 #

确认是否有其他代码或第三方库修改了Flask app的属性，导致session_cookie_name被意外移除。可在Session(app)前添加调试代码：

print("SESSION_COOKIE_NAME:", app.config.get("SESSION_COOKIE_NAME"))
print("Flask app cookie相关属性:", [attr for attr in dir(app) if "cookie" in attr])
Session(app)

通过输出确认配置是否正常加载，以及app对象的属性是否被篡改。

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