部署于AWS EB2的Flask会话无法跨请求持久化，求排查解决

问题描述 #

应用在本地运行正常，但部署到亚马逊Elastic Beanstalk（EB）后，仅第一个访问的用户能正常使用，后续用户访问会抛出内部服务器错误：

Internal Server Error
服务器遇到内部错误，无法完成您的请求。可能是服务器过载或应用存在错误。

核心异常表现：

• 页面路由跳转后Session变为空
• before_first_request函数仅在第一个用户访问时执行一次，后续不再触发

最小复现代码 #

from flask import Flask, render_template, request, session, url_for
import logging  # 原代码遗漏该导入，此处补充

application = Flask(__name__)
application.secret_key = "mysecretkey"

@application.before_first_request
def before_first_request():
    """ 首次请求前执行的初始化操作"""

    # 设置日志级别
    application.logger.setLevel(logging.INFO)
    application.logger.info('Flask应用启动')

    # 清空Session
    session.clear()

    # 存入PID
    session['pid'] = 123

    # 添加参数到Session
    params = dict()
    params['parameter'] = 0
    session['params'] = params

    application.logger.info(session) # 此处能正常打印Session内容
    return 'OK'


@application.route('/')
def main():
    """ 首页路由 """
    application.logger.info(session) # 此处Session为空
    application.logger.info(application.secret_key) # 密钥可正常输出
    params, results = session.pop('params'), session.pop('results') # 此处抛出错误
    return render_template('empty_template.jinja', args = session)

问题原因及解决方法 #

1. before_first_request的误用 #

before_first_request是整个应用生命周期内仅执行一次的钩子，并非每个用户请求前触发。你用它初始化用户Session，相当于把第一个用户的Session绑定到了全局应用上下文，后续用户的请求根本不会触发这个钩子，自然拿不到Session内的参数。

解决： 替换为before_request钩子，该钩子会在每个用户的每次请求前执行：

# 替换原before_first_request装饰器
@application.before_request
def before_request():
    """ 每个请求前执行的操作 """
    application.logger.setLevel(logging.INFO)
    
    # 仅在Session未初始化时执行设置，避免每次请求重置用户Session
    if not session.get('pid'):
        session.clear()
        session['pid'] = 123
        session['params'] = {'parameter': 0}
        application.logger.info(f"初始化Session: {session}")

2. Session存储机制问题 #

亚马逊EB默认的Flask环境使用内存Session，但EB是多进程/多实例部署架构，后续用户的请求可能被分配到其他进程或实例，导致Session无法跨进程共享；同时内存Session会在进程重启时丢失。

解决：

• 采用持久化Session存储，比如Redis或数据库（如SQLAlchemy），确保Session能跨进程/实例共享
• 测试环境可临时强制单进程运行：在.ebextensions目录下创建flask.config文件，内容如下：

  option_settings:
    aws:elasticbeanstalk:container:python:
      WSGIPath: application.py
      NumProcesses: 1
      NumThreads: 1
  

3. 代码潜在错误修正 #

• 原代码中session.pop('results')，但初始化逻辑未设置results键，即便Session正常也会触发KeyError导致500错误
• 补充遗漏的import logging语句

修正后的main路由示例：

@application.route('/')
def main():
    """ 首页路由 """
    application.logger.info(session)
    # 先判断键是否存在，避免KeyError
    params = session.get('params', {'parameter': 0})
    results = session.get('results', {})
    return render_template('empty_template.jinja', args={'params': params, 'results': results})

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