SpecFlow：导入的NuGet包步骤定义在Feature文件中不被识别

问题重现 #

Feature文件代码 #

Feature: Log In

Scenario: User Log in
    When initialize App Tests
    When login to 'test-app' with creds 'user' 'password'
    Then wait for '10' seconds
    Then logout

错误提示 #

No matching step definition found for one or more steps.

NuGet包中的步骤定义片段 #

using System;
using TechTalk.SpecFlow;

namespace MyNamespace
{
    [Binding]
    public class StepDefinitions
    {
        private readonly ScenarioContext _scenarioContext;

        public StepDefinitions(ScenarioContext scenarioContext)
        {
            _scenarioContext = scenarioContext;
        }
        [When(@"login to '(.*)' with creds '(.*)' '(.*)'"))]
        public void WhenLoginToWithCreds(string p0, string p1, string p2)
        {
            _scenarioContext.Pending();
        }

...

已确认：NuGet包已正确安装、步骤类带有[Binding]属性、正则参数匹配、项目已重新构建、Feature文件导入了正确命名空间，但问题仍存在。

可能的原因及解决方法 #

1. 步骤定义的正则表达式语法错误 #

从给出的代码片段可以看到，[When]属性的字符串末尾多了一个多余的右括号：

[When(@"login to '(.*)' with creds '(.*)' '(.*)'"))]
// 多余的右括号 ---------------------------^

这个语法错误会导致SpecFlow无法识别该步骤定义。解决方法：移除多余的右括号，修正为：

[When(@"login to '(.*)' with creds '(.*)' '(.*)'")]

2. SpecFlow程序集扫描配置问题 #

SpecFlow默认会扫描当前项目及引用程序集中的[Binding]类，但部分情况下需要显式配置：

• 检查测试项目根目录下的specflow.json文件，确保包含对NuGet包程序集的扫描配置：

  {
    "assembly": {
      "name": "YourTestProjectName"
    },
    "stepAssemblies": [
      { "assembly": "MyNamespace" } // NuGet包的程序集名称
    ]
  }
  

• 如果没有specflow.json，可以右键测试项目 → 添加 → 新建项 → 搜索"SpecFlow Configuration File"添加。

3. 目标框架版本不兼容 #

如果NuGet包的目标框架与测试项目的目标框架不匹配，会导致程序集无法被正确加载：

• 检查NuGet包的.nuspec文件或项目文件，确认其目标框架（如.NET 6、.NET Framework 4.8）与测试项目一致；
• 若不一致，重新打包NuGet包，选择与测试项目兼容的目标框架。

4. SpecFlow版本不匹配 #

NuGet包中引用的SpecFlow版本必须与测试项目中使用的版本完全一致：

• 查看测试项目的NuGet依赖，确认SpecFlow、SpecFlow.NUnit（或其他测试框架适配包）的版本；
• 查看NuGet包的依赖，确保其使用的SpecFlow版本与测试项目完全相同，版本不一致会导致步骤定义无法被识别。

5. 步骤定义的访问权限问题 #

确保步骤定义类和方法的访问修饰符为public：

• 虽然示例中类和方法是public，但需确认NuGet包中所有步骤定义方法都为public，非public的方法无法被SpecFlow扫描到。

6. 程序集未被正确复制到输出目录 #

检查测试项目的输出目录（如bin/Debug/net6.0），确认NuGet包的程序集文件是否存在：

• 右键测试项目中引用的NuGet包 → 属性 → 确认"复制本地"设置为True；
• 重新构建测试项目，确保程序集被复制到输出目录。

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