Flash消息异常：已登录仍显示「请登录以访问页面」问题排查

问题根源在于Flask-Login的自动Flash提示未被清理：当未登录用户访问带有@login_required装饰器的注册路由时，Flask-Login会自动向session中写入"Please log in to access the page"的Flash消息，并重定向到登录页。用户登录成功后，这条旧消息仍保存在session里，跳转时会被一并渲染出来。

解决办法 #

方法1：禁用Flask-Login的自动登录提示

在Flask应用配置中添加以下设置，直接阻止系统生成这条默认提示：

app.config['LOGIN_MESSAGE'] = None

方法2：登录成功后过滤旧Flash消息

若需保留其他场景的登录提示，可在登录路由中，登录成功后手动过滤掉这条特定提示。修改后的登录路由代码如下：

@bp.route("user_settings/login", methods=["GET","POST"])
def login():
    if current_user.is_authenticated:
        return redirect(url_for('main.user_settings'))
    
    form = LoginForm()

    if form.validate_on_submit():
        user = User.query.filter_by(username=form.username.data).first()

        if user is None or not user.check_password(form.password.data):
            return redirect(url_for("auth.login"))

        login_user(user, remember=form.remember_me.data)
        
        # 过滤掉Flask-Login自动添加的登录提示
        if '_flashes' in session:
            session['_flashes'] = [
                msg for msg in session['_flashes'] 
                if not (msg[1] == 'message' and 'Please log in to access the page' in msg[0])
            ]
        
        next_page = request.args.get("next")

        if not next_page or url_parse(next_page).netloc != '':
            next_page = url_for("main.user_settings")
        return redirect(next_page)  # 修正原代码缩进错误，确保所有情况都执行重定向

    return render_template("auth/login.html", title='Log In', form=form)

方法3：调整注册路由权限（可选）

如果注册功能允许未登录用户访问，直接移除注册路由上的@login_required装饰器，从根源避免触发登录提示：

# 移除@login_required装饰器
@bp.route("user_settings/register", methods=['GET', 'POST'])
def register():
    form = RegistrationForm()

    if form.validate_on_submit():
        user = User(username=form.username.data, password_string=form.password.data, access_level=form.access_level.data)
        user.set_password(form.password.data)
        db.session.add(user)
        db.session.commit()
        flash("User Successfully Registered!", "success")
        return redirect(url_for('main.admin_mid', mode="admin")) 

    return render_template("auth/register.html", title="Register User", form = form)

模板优化建议 #

你的HTML模板未区分Flash消息类别，可修改为只渲染指定类别的消息（比如注册时用的success类别），避免系统提示干扰：

{% with messages = get_flashed_messages(category_filter=["success"]) %} 
  {% if messages %} 
    {% for message in messages %}
      <div class="alert alert-success alert-dismissible fade show" role="alert">
        {{ message }}
        <button type="button" class="btn-close" data-bs-dismiss="alert"></button>
      </div>
    {% endfor %} 
  {% endif %} 
{% endwith %}

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