pytest.raises对自定义异常“视而不见”的根本原因是异常类未被正确导入或作用域不可见，需确保显式导入、路径准确、类对象一致，并优先使用上下文管理器语法。
pytest.raises 为什么对自定义异常“视而不见”？
根本原因通常是异常类未被正确导入或未在测试作用域内可见。比如你在 my_module.py 中定义了 class MyCustomError(Exception)，但在测试文件里只写了 from my_module import * 或漏掉了该类的显式导入，pytest.raises(MyCustomError) 就会报 NameError: name 'MyCustomError' is not defined 或更隐蔽地“不触发断言失败”——即异常抛出了，但 pytest.raises 没匹配上，导致测试意外通过。
务必确认：测试文件中能直接求值该异常类，例如在测试开头加一行 print(MyCustomError) 看是否报错。
- 用
from my_module import MyCustomError，而非模糊的import my_module后试图写my_module.MyCustomError（除非你真这么用了且路径无误） - 检查模块层级：如果自定义异常在子包里（如
my_package.errors.MyCustomError），导入路径必须完整准确 - 避免在测试中动态创建异常类（如
type('MyErr', (Exception,), {})），pytest.raises匹配的是类对象身份，不是名称字符串
使用 pytest.raises 的正确姿势：上下文管理器 vs. 函数调用
pytest.raises 推荐始终用上下文管理器形式，函数调用形式（pytest.raises(..., func, *args, **kwargs)）已弃用且易出错——它内部用 try/except 包裹函数执行，但无法可靠捕获某些异常传播路径（尤其是涉及生成器、协程或异常被中间层吞掉的情况）。
正确写法：
立即学习“Python免费学习笔记（深入）”；
def test_something():
with pytest.raises(MyCustomError):
some_function_that_raises()
- 上下文管理器能精确控制异常抛出点，且支持
match参数做正则匹配：with pytest.raises(MyCustomError, match=r"invalid.*input") - 若需检查异常属性（如
e.code），必须赋值给变量：with pytest.raises(MyCustomError) as exc_info:，然后用exc_info.value.code - 别在
with块里写多条语句——只放**必然触发异常的那一行**，否则一旦前面语句出错（如NameError），pytest.raises就会误判为“捕获成功”
继承关系导致的匹配失败：BaseException 和 Exception 的区别
如果你的自定义异常继承自 BaseException（比如误写成 class MyFatalError(BaseException)），pytest.raises(MyFatalError) 仍能工作，但这是危险信号：标准异常都应继承 Exception。更常见的是“父类能捕获，子类不能”，例如你定义了 class ValidationError(ValueError)，却在测试中写 pytest.raises(ValueError) ——这能过，但若换成 pytest.raises(ValidationError) 却失败，大概率是导入的 ValidationError 和实际抛出的不是同一个类对象（比如两个同名类来自不同文件或 reload 过）。
- 用
is检查类一致性：assert type(raised_exc) is ValidationError（在exc_info.value上） - 避免在测试中重新定义同名异常类，哪怕只是临时
class ValidationError(Exception): pass - Python 3.11+ 中注意
ExceptionGroup场景，pytest.raises默认不匹配组内单个异常，需用match或手动解包
异步函数（async def）里怎么用 pytest.raises？
直接对 await 表达式用 pytest.raises 会报 RuntimeError: await wasn't used with future，因为 with 语句无法挂起协程。
正确做法是用 await 调用协程对象，并确保它真正执行：
async def test_async_raises():
with pytest.raises(MyCustomError):
await async_function_that_raises()
- 必须用
async def定义测试函数，且 pytest 需启用 asyncio 插件（如pytest-asyncio） - 不要写
with pytest.raises(...): async_function_that_raises()（没await），这只会返回协程对象，不执行 - 若函数返回
asyncio.Task，需await task或task.result()才会触发异常
最易忽略的一点：异常类的模块路径和导入方式，在跨文件、热重载、打包场景下极易不一致——宁可多打一行 print(MyCustomError.__module__)，也别靠名字猜。
