如何在Flask应用中为会话超时设置自定义错误信息

要区分会话超时导致的403和其他场景的403，核心思路是用自定义异常标记会话超时的情况，而非依赖默认的403响应。这样既能保留对无Session请求的兼容，又能精准处理会话超时的场景。以下是具体实现步骤：

1. 定义自定义会话超时异常 #

先创建一个继承自HTTPException的自定义异常，专门用于标记会话超时的情况，状态码仍设为403，但可以自定义描述信息：

from werkzeug.exceptions import HTTPException
from datetime import datetime

class SessionTimeoutError(HTTPException):
    code = 403
    description = "会话已超时，请重新登录"

2. 在会话检查逻辑中抛出自定义异常 #

在before_request钩子（或你用于校验会话的装饰器）中，先排除不需要Session的请求路径，再对需要Session的请求做超时校验，一旦检测到超时就抛出上面定义的异常：

from flask import Flask, request, session, jsonify

app = Flask(__name__)
app.secret_key = 'your_secret_key_here'

# 定义不需要Session校验的路径
EXCLUDED_PATHS = ['/login', '/public', '/api/public-data']

@app.before_request
def check_session_validity():
    # 跳过不需要Session的请求
    if request.path in EXCLUDED_PATHS:
        return
    
    # 这里是你的会话超时校验逻辑，比如检查过期时间
    expires_at = session.get('expires_at')
    if not session.get('user_id') or (expires_at and expires_at < datetime.utcnow().timestamp()):
        # 抛出自定义会话超时异常
        raise SessionTimeoutError()

3. 为自定义异常编写专属错误处理器 #

分别为SessionTimeoutError和通用403错误编写处理器，实现差异化响应：

# 处理会话超时的403
@app.errorhandler(SessionTimeoutError)
def handle_session_timeout(e):
    # 这里可以返回JSON、HTML或任何你需要的自定义响应
    return jsonify({
        'code': 403,
        'error_type': 'session_timeout',
        'message': '您的登录会话已过期，请重新登录后再操作'
    }), 403

# 处理其他场景的403（比如权限不足）
@app.errorhandler(403)
def handle_generic_forbidden(e):
    return jsonify({
        'code': 403,
        'error_type': 'permission_denied',
        'message': '您没有访问该资源的权限'
    }), 403

为什么这种方案可行？ #

• 我们通过自定义异常给会话超时的403打上了唯一标记，和普通的权限不足403彻底区分开；
• 提前排除不需要Session的请求，避免了误判这些请求的状态；
• 错误处理器可以针对性返回不同的响应内容，完全满足你的自定义需求。

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