pytest-bdd框架新增feature文件后无法识别对应步骤求助

• 检查步骤文本与装饰器的匹配度
  确保feature文件里的步骤描述和测试文件中@given/@when/@then装饰器的字符串完全一致，包括空格、大小写、特殊标点。比如feature写的是Given I possess a valid token，装饰器就得是@given("I possess a valid token")，不能多字少字、错漏空格。如果用参数化，比如When I create a user named "{user_name}"，装饰器要对应@when('I create a user named "{user_name}"')，参数占位符和名称也得一一对应。

• 验证测试文件的命名与目录结构

  • 当前测试文件必须符合pytest的命名规则：test_*.py或者*_test.py，否则pytest不会加载它。
  • 共享token步骤能生效，说明全局的conftest.py或共享步骤文件没问题，但如果当前测试目录有自己的conftest.py，要检查有没有覆盖或冲突的配置。
  • 自定义步骤的函数所在文件要么和测试文件同目录，要么被正确导入到测试文件中，别漏了导入语句。

• 检查版本与pytest配置

  • 运行pytest --version查看pytest和pytest-bdd版本，旧版本可能存在步骤匹配的bug，直接升级到稳定版：pip install --upgrade pytest pytest-bdd。
  • 查看项目根目录的pytest.ini/tox.ini等配置文件，检查python_files、testpaths这些参数，别把当前测试文件或步骤文件排除在了扫描范围外。

• 排查步骤重复定义与作用域

  • 有没有其他文件里定义了相同文本的步骤？pytest-bdd会优先匹配先加载的步骤，导致你的自定义步骤被覆盖。可以运行pytest --collect-only查看收集到的所有步骤，确认你的目标步骤是否存在。
  • 步骤函数必须定义在模块级别，不能是嵌套在其他函数里的内部函数，否则框架无法识别。

• 用调试日志定位问题

  • 运行pytest -vvs开启详细日志，看输出里的步骤匹配提示，比如有没有“Step not found”的报错，或者是否匹配到了错误的函数。
  • 先简化测试场景：把feature文件里的其他步骤删掉，只留一个无法识别的步骤，写一个最简单的空步骤函数，看能不能正常匹配，一步步排除复杂逻辑的干扰。

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