如何在pytest测试后清除Flask Session中的Flash消息？

你遇到的核心问题是测试客户端的会话（session）在测试间共享——因为你的test_client和app fixture都是scope="session"级别，整个测试会话只会创建一次客户端实例，前一个测试的flash消息会留在session里，直接干扰后续测试的断言结果。

下面给你几个可行的解决方案，按推荐程度排序：

1. 将Fixture Scope改为Function级别（最推荐） #

最简单直接的办法是让每个测试都使用全新的客户端实例，从根源上隔离session，避免残留问题。修改你的fixture代码：

@pytest.fixture(scope="function")  # 从session改为function级别
def app():
    app = create_app("testing")
    with app.test_request_context():
        yield app

@pytest.fixture(scope="function")
def test_client(app):
    with app.test_client() as c:
        yield c

这样每个测试函数都会拿到一个全新的test_client，每个client的session完全独立，flash消息自然不会跨测试残留。

2. 自动清理每个测试后的Flash消息 #

如果因为某些原因不想修改fixture的scope，可以添加一个自动执行的fixture，在每个测试结束后自动清理session里的flash消息：

@pytest.fixture(autouse=True)
def clear_flashes_after_test(test_client):
    # 先执行测试逻辑
    yield
    # 测试结束后清理flash消息
    with test_client.session_transaction() as sess:
        # 用pop避免出现KeyError
        sess.pop("_flashes", None)

这个autouse=True的fixture会自动应用到所有测试，在测试完成后清除session中的_flashes键，无需手动在每个测试里写清理代码。

3. 在单个测试中手动清理（不推荐，过于繁琐） #

如果你只想针对特定测试做清理，可以在测试末尾通过session_transaction操作客户端的真实session（注意：不是直接导入的flask.session，那个是请求上下文绑定的代理，修改它不会改变client存储的持久session）：

from flask import session
def test_my_redirect_view(test_client):
    "验证重定向并设置正确的Flash消息"
    response = test_client.get("/my/path", follow_redirects=False)
    # 你的断言逻辑
    assert response.status_code == 302
    assert response.location == "http://localhost/a/different/url"
    assert "_flashes" in session
    assert len(session["_flashes"]) == 1
    assert session["_flashes"][0][0] == "warning"
    assert session["_flashes"][0][1] == "My error message"

    # 手动清理flash消息
    with test_client.session_transaction() as sess:
        if "_flashes" in sess:
            del sess["_flashes"]

为什么你之前的清理方法没用？ #

你尝试的del session["_flashes"][0]无效，是因为这里的session是从flask import session导入的——它是当前请求上下文的session代理，而非测试客户端保存的持久session。修改这个代理不会改变client内部存储的session数据，所以下次测试时旧的flash消息依然存在。

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