Flask-Session（文件系统）：会话文件未按PERMANENT_SESSION_LIFETIME删除

核心原因解析 #

1. 文件系统存储无主动后台清理机制
   Flask-Session 的文件系统存储不会在后台自动扫描并删除过期会话，它只会在有新请求进入时，顺带清理少量（默认10个）过期文件。如果会话过期后没有任何请求触发，文件会一直留在目录中。

2. 会话未被标记为永久生效
   虽然你配置了SESSION_PERMANENT = True，但还需要在请求上下文里显式设置session.permanent = True，否则会话会被视为临时会话，不遵循PERMANENT_SESSION_LIFETIME的有效期规则。

解决步骤 #

1. 确保会话被标记为永久

在初始化会话的路由中添加显式标记：

@app.route('/')
def index():
    session.permanent = True  # 必须显式开启永久会话
    session['last_active'] = datetime.now().isoformat()
    return "会话已初始化"

只有设置后，PERMANENT_SESSION_LIFETIME的1分钟有效期才会对该会话生效。

2. 触发清理机制

会话过期后，发起任意请求即可触发Flask-Session的自动清理逻辑，此时过期的会话文件会被删除。

3. 手动配置定时清理（可选）

如果需要更主动的清理策略，可以添加定时任务定期删除过期文件：

from apscheduler.schedulers.background import BackgroundScheduler
import os

def clean_expired_sessions():
    session_dir = app.config.get('SESSION_FILE_DIR', 'flask_session')
    if not os.path.exists(session_dir):
        return
    for filename in os.listdir(session_dir):
        file_path = os.path.join(session_dir, filename)
        try:
            mtime = datetime.fromtimestamp(os.path.getmtime(file_path))
            if datetime.now() - mtime > app.config['PERMANENT_SESSION_LIFETIME']:
                os.remove(file_path)
        except Exception as e:
            print(f"删除文件失败 {file_path}: {e}")

# 启动定时任务，每分钟清理一次
scheduler = BackgroundScheduler()
scheduler.add_job(clean_expired_sessions, 'interval', minutes=1)
scheduler.start()

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