fixture跨文件失效的根本原因是conftest.py位置错误：pytest仅自动加载测试文件所在目录及其父级目录中的conftest.py，不扫描子目录或无关路径；测试函数必须显式声明fixture参数才能注入；作用域不匹配、autouse误用、参数化未设indirect=True也会导致失效。
fixture 在跨文件时找不到，根本原因是 conftest.py 位置不对
pytest 只自动加载测试文件所在目录及其父级目录中的 conftest.py，不会向上穿透到无关路径。比如测试文件在 tests/api/test_user.py，而你把 conftest.py 放在了 src/ 或 utils/ 目录下，它就完全不会被发现。
常见错误场景：
- 把
conftest.py和 fixture 定义放在和测试文件平级的fixtures/子目录里（pytest 不扫描子目录） - 项目结构是
project/tests/和project/app/，却把conftest.py放在app/下 - 用了相对导入（如
from ..conftest import my_fixture），但 pytest 不执行 import，只靠自动发现机制
正确做法：把 conftest.py 放在最靠近测试文件的公共父目录中。例如所有测试都在 tests/ 下，那就放 tests/conftest.py；如果测试分散在 tests/unit/ 和 tests/integration/，且需要共享 fixture，就放到 tests/conftest.py —— 它会自动作用于两个子目录。
测试函数没声明参数，fixture 就不会注入
fixture 不是全局变量，也不是装饰器自动附着的资源。它必须通过函数签名显式“请求”——也就是把 fixture 名作为参数名写进测试函数定义里。
立即学习“Python免费学习笔记（深入）”；
典型失效写法：
def test_login():
# 没写 user_fixture 参数 → pytest 根本不调用它
assert True
正确写法：
@pytest.fixture
def user_fixture():
return {"id": 1, "name": "alice"}
<p>def test_login(user_fixture): # 必须出现这个参数名
assert user_fixture["name"] == "alice"
注意：@pytest.mark.usefixtures("user_fixture") 可以触发 fixture 执行，但它不传值；如果你需要返回值，只能靠参数声明方式。
作用域（scope）和依赖链导致 fixture 被跳过
当 fixture A 依赖 fixture B，而 B 的作用域比 A 大（比如 B 是 scope="session"，A 是 scope="function"），pytest 仍能正常工作；但反过来——B 是 function 级，A 是 session 级——就会报错或静默失效，因为 A 初始化时 B 还没准备好。
调用 Cutout.Pro 视觉处理 API 进行背景移除、人像抠图和照片增强，支持文件上传与图片 URL 输入。
更隐蔽的问题是 autouse + scope 组合：
-
@pytest.fixture(autouse=True, scope="class")写在tests/unit/conftest.py，但某个测试在tests/integration/下且没继承任何类 → 它不会触发 - 多个
conftest.py中定义同名 fixture，低层目录的会覆盖高层的，但你可能根本没意识到有冲突
验证方法：运行 pytest --setup-show test_file.py，看 fixture 实际执行顺序和层级是否符合预期。重点关注 SETUP 行里是否出现了你要的那个 fixture 名。
参数化 fixture 和 @pytest.mark.parametrize 混用时漏掉 indirect=True
这是最容易踩坑的点：当你既想参数化输入，又想走 fixture 流程，但忘了告诉 pytest “这个参数名其实是 fixture 名”，它就会直接把字符串塞进测试函数，而不是去调用 fixture 函数。
错误示例：
@pytest.fixture(params=["chrome", "firefox"])
def browser(request):
return request.param
<p>@pytest.mark.parametrize("browser", ["chrome", "firefox"])
def test_open(browser):</p><h1>这里 browser 是字符串，不是 fixture 返回的 WebDriver 实例</h1><pre class="brush:php;toolbar:false;"><code>pass
正确写法（两种之一）：
- 只用 fixture 参数化（推荐）：
def test_open(browser):—— 此时browser是 fixture 返回值 - 混用时加
indirect=True：@pytest.mark.parametrize("browser", ["chrome", "firefox"], indirect=True)
漏掉 indirect=True 的后果不是报错，而是静默传参，你拿到的不是初始化好的浏览器对象，而是原始字符串，后续调用 browse.get() 就会抛 AttributeError。
fixture 跨文件失效，往往不是语法错，而是目录结构、作用域层级、参数绑定这三处细节没对齐。尤其要注意 conftest.py 的物理位置和 --setup-show 输出里的实际加载路径是否一致——很多问题查到这里就自然浮现了。
