Flask单元测试时404 errorhandler无code coverage该如何处理？

问题根因排查 #

• 首先检查Flask测试配置项 PROPAGATE_EXCEPTIONS：测试环境下该配置默认值为True，会让异常直接向上抛出不触发注册的errorhandler，这是绝大多数同类问题的诱因。
• 你当前的测试仅能覆盖isinstance(e, HTTPException)为真的分支，缺少非HTTPException场景的测试，无法覆盖全量代码路径。

修复步骤 #

步骤1：调整测试配置 #

在初始化测试用app的fixture中，显式关闭异常传播：

@pytest.fixture
def app():
    app = create_app("test")
    # 关闭异常传播，确保errorhandler被触发
    app.config["PROPAGATE_EXCEPTIONS"] = False
    yield app

步骤2：补充全路径测试用例 #

你需要补充两个场景的测试，覆盖errorhandler的所有分支：

from werkzeug.exceptions import HTTPException
# 替换为你实际项目中errorhandler的导入路径
from your_app_path import page_not_found

def test_404_trigger_by_invalid_path(client):
    # 覆盖HTTPException分支：访问不存在的路由触发404
    res = client.get("/test_non_exist_path")
    assert res.status_code == 404

def test_404_non_http_exception_branch(app):
    # 覆盖非HTTPException分支：直接调用handler传入普通异常
    test_exception = Exception("test custom exception")
    resp_content, resp_status = page_not_found(test_exception)
    assert resp_status == 404
    assert resp_content == "404 Page not Found"

额外检查项 #

如果修改后仍然无法统计到覆盖率，检查你的覆盖率工具（比如pytest-cov）的排除规则，确认errorhandler所在的文件没有被加入.coveragerc、pyproject.toml等配置的排除列表中。

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