pytest测试结合Hypothesis使用fixture报错原因及解决方法

这个报错不是操作失误，是Hypothesis新版本新增的默认健康检查规则导致的——你看到的旧技术文章示例写得早，没跟进这个规则变更，直接跑就会报错。
核心逻辑是：@given装饰器会把被装饰的测试函数包装成内部循环，在pytest触发的单次测试函数执行周期里，自动生成多组测试用例连续运行。而默认的函数作用域fixture，只会在测试函数刚启动时初始化一次，不会跟着Hypothesis生成的每一组用例重新执行初始化/清理逻辑。如果fixture带可变状态、有副作用（比如返回可变对象、建立临时数据库连接、生成测试临时数据），前一组用例对fixture的修改会污染后续所有用例的运行环境，出问题极难定位，所以Hypothesis默认直接抛出健康检查错误拦截这类写法。

根据你的fixture实际特性选对应方案即可：

• 无状态fixture直接抑制对应健康检查
  如果你的fixture和示例里一样，是完全无状态、不存在被修改可能的（比如返回固定字符串、数值这类不可变常量，纯计算无副作用的依赖），可以直接在测试上加配置关闭对应健康检查，这是官方认可的合规写法：

  from hypothesis import given, strategies as st, HealthCheck, settings
  from pytest import fixture
  
  
  @fixture
  def stuff():
      return "kittens"
  
  
  @settings(suppress_health_check=[HealthCheck.function_scoped_fixture])
  @given(a=st.none())
  def test_stuff(a, stuff):
      assert a is None
      assert stuff == "kittens"
  

  注意：如果fixture返回列表、字典、自定义类实例这类可变对象，哪怕你主观觉得不会修改它，也尽量不要用这个方案，避免出现跨用例的状态污染。不要全局关闭这个健康检查，只在确认单测里的fixture确实无状态的时候，给对应测试单独加抑制配置即可。

• 需要逐用例重置的fixture，将初始化/清理逻辑改为测试内手动调用的上下文管理器
  如果你需要每一组Hypothesis生成的用例都拿到全新初始化的依赖实例，就不要把对应逻辑写成pytest函数级fixture作为参数传入，而是把初始化、清理逻辑封装成独立的上下文管理器，在测试的用例循环里手动调用，保证每轮用例运行时的依赖都是全新状态：

  from contextlib import contextmanager
  from hypothesis import given, strategies as st
  
  
  # 把需要逐用例重置的逻辑抽成上下文管理器
  @contextmanager
  def get_stuff():
      # 原有初始化逻辑
      value = "kittens"
      yield value
      # 原有清理逻辑
  
  
  @given(a=st.none())
  def test_stuff(a):
      # 每轮生成的用例都重新初始化依赖
      with get_stuff() as current_stuff:
          assert a is None
          assert current_stuff == "kittens"
  

• 跨用例复用的fixture调整作用域
  如果你的fixture本身设计就是跨用例复用的（比如提前加载的固定配置、全局mock对象、不需要重置的外部依赖客户端），直接把fixture的作用域改成scope="module"或者scope="session"，Hypothesis就不会触发这个健康检查——这类fixture本身就没有逐用例重置的预期，不存在逻辑冲突。

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