如何在pytest -Werror模式下忽略第三方库的警告？

DevOps 小满

2026-8-11

解决pytest -Werror下忽略第三方库特定警告的问题

方案1：精准配置pyproject.toml的filterwarnings

你之前的filterwarnings规则精度不足，导致在-Werror模式下未生效。针对jsonschema的特定警告，修改配置如下：

[tool.pytest.ini_options]
filterwarnings = [
    "error",  # 全局开启警告转错误，等价于-Werror
    # 精准忽略jsonschema.validators模块的DeprecationWarning
    "ignore::DeprecationWarning:jsonschema.validators:",
    # 保留你原有对openapi_spec_validator的忽略规则
    "ignore::DeprecationWarning:openapi_spec_validator.*:"
]

这里先全局设置警告转错误，再通过更精确的规则覆盖第三方库的特定警告，优先级高于全局配置。

方案2：命令行直接指定忽略规则

如果不想修改配置文件，运行测试时使用以下命令：

pytest -Werror -W ignore::DeprecationWarning:jsonschema.validators:

-W ignore::DeprecationWarning:jsonschema.validators:会精准忽略该模块下的DeprecationWarning，同时保持其他所有警告转为错误。

方案3：在测试代码中精准禁用警告（修正你的catch_warnings用法）

你之前的warnings.catch_warnings()代码缺少过滤规则，因此未生效。正确写法如下：

import warnings

def test_third_party_integration():
    with warnings.catch_warnings():
        # 仅在当前代码块内忽略指定模块的特定警告
        warnings.filterwarnings(
            "ignore",
            category=DeprecationWarning,
            module="jsonschema.validators"
        )
        call_third_party_code_with_warnings()

这种方式只会在调用第三方代码的范围内忽略警告，不会影响其他测试逻辑。