pytest-bdd 3.4运行UI测试 已实现步骤仍报StepDefinitionNotFoundError

核心触发根因 #

• Python模块的命名空间覆盖机制是这次报错的直接原因：
  你在test_login.py中连续定义了两个完全同名的step_impl函数，分别绑定两个不同的when步骤：

  # 第一次定义step_impl，绑定"El usuario ingresa el nuevo user"步骤
  @when('El usuario ingresa el nuevo user')
  def step_impl():
      context.page.insertUsername("user7")
  
  # 第二次定义同名step_impl，绑定"El usuario ingresa la password"步骤
  @when('El usuario ingresa la password')
  def step_impl(context):
      context.page.insertPassword("12345")
  

  模块加载时，后定义的同名函数会完全覆盖前面的函数引用。pytest-bdd在加载步骤注册表时，前面那个绑定El usuario ingresa el nuevo user的step_impl已经被覆盖销毁，自然找不到对应的可执行实现，抛出StepDefinitionNotFoundError。
• 代码中还存在多处同类重名问题，后续执行会接连触发同类报错：
  • 两个push_login_button函数：分别绑定El boton ingresar es presionado、El boton aceptar es presionado两个步骤
  • 两个terms_conditions_page_displayed函数：分别绑定La pantala de terminos y condiciones es desplegada、La pantalla Home es desplegada两个步骤

其他连带影响步骤识别的问题 #

• 缺少fixture入参声明：pytest的依赖注入机制要求，只有在函数签名中显式声明要使用的fixture名称，框架才会将fixture实例传入函数。你定义的context fixture，在绝大多数步骤函数中都没有作为入参声明，直接在函数体里引用context变量，属于未定义的全局访问，框架收集这类函数时会因为签名不合法跳过步骤注册。
• fixture初始化逻辑错误：你定义的context fixture当前初始值是b = None，就算成功注入到步骤函数里，后续给context.page赋值的时候也会触发AttributeError，应该把context初始化为一个可赋值的空对象，保证属性可以正常写入。
• 残留HTML转义字符：你贴出的代码中context.page.insertUsername("user7")里的"是网页复制时携带的双引号转义实体，如果实际代码保留了这个内容，会直接触发语法错误，导致整个测试文件收集失败。
• 严格匹配偏差：pytest-bdd对步骤文本的匹配是逐字符级别的，需要确认装饰器内的步骤文本和feature文件中的文本没有全角/半角空格差异、不可见换行符、拼写错误，哪怕多一个空格也会匹配失败。

修复操作 #

• 给所有步骤函数使用全局唯一的、和步骤语义对应的函数名，杜绝重名覆盖，比如把之前的两个step_impl分别改成input_new_username、input_account_password。
• 所有用到context的步骤函数，都要在参数列表中显式声明context作为入参，不要直接在函数体里引用未注入的变量。
• 调整context fixture的初始化逻辑，将返回值从None替换为可存储属性的空对象。
• 删除代码中残留的HTML转义字符，逐字符对齐装饰器和feature文件中的步骤文本。

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