nUnit [Retry]属性在断言失败时未生效的问题排查

先明确：[Retry(2)]的作用是当测试失败时，额外重试2次，也就是测试最多会执行3次（初始1次+2次重试）。如果你的测试只失败一次就停止，大概率是以下几个问题导致：

1. Retry属性的使用位置错误 #

必须将[Retry(2)]直接标注在测试方法上，而非测试类（TestFixture）或其他辅助方法上。正确示例：

[Test]
[Retry(2)]
public void TestPageTitle()
{
    // 你的测试代码
    Assert.AreEqual("Attention! WrongTitle so that Assertion will fail", driver.Title);
}

若将Retry加在TestFixture上，仅类级别的错误（如SetUp执行失败）才会触发重试，测试方法内的断言失败不会触发重试逻辑。

2. NUnit与NUnit3TestAdapter版本不兼容 #

版本不匹配会直接导致Retry特性失效，建议：

• 确保NUnit版本在3.13.0以上（该版本后Retry特性稳定性大幅提升）
• 保持NUnit3TestAdapter版本与NUnit版本同步（例如NUnit 3.13.x对应Adapter 4.0.x，NUnit 3.14.x对应Adapter 4.2.x）
• 更新所有相关NuGet包到最新兼容版本，避免版本冲突

3. 测试环境未正确重置 #

如果测试依赖Selenium Driver，重试前未重置Driver状态，会导致后续重试直接失败（如Driver停留在错误页面、未重新初始化）。正确的重置方式：

• 在[TearDown]方法中确保关闭并释放Driver：

[TearDown]
public void Cleanup()
{
    driver?.Quit();
    driver?.Dispose();
}

• 在[SetUp]方法中，每次测试（包括重试）都重新初始化Driver：

[SetUp]
public void Initialize()
{
    driver = new ChromeDriver();
    driver.Navigate().GoToUrl("你的测试URL");
}

你可以在测试方法中添加日志，确认是否真的触发了重试：

[Test]
[Retry(2)]
public void TestPageTitle()
{
    Console.WriteLine($"测试执行第 {TestContext.CurrentContext.Test.RepeatCount + 1} 次");
    Assert.AreEqual("Attention! WrongTitle so that Assertion will fail", driver.Title);
}

若控制台仅输出一次，说明Retry未触发；若输出多次但每次都失败，是测试本身的问题而非Retry失效。

4. 测试运行设置问题 #

Visual Studio Test Explorer中开启并行测试会干扰Retry特性执行，可尝试关闭：

• 打开Test Explorer → 点击右上角设置图标 → 取消勾选"Run tests in parallel"
• 或在nunit.runsettings文件中添加配置：

<RunSettings>
  <NUnit>
    <Parallelize>
      <Workers>1</Workers>
      <Scope>None</Scope>
    </Parallelize>
  </NUnit>
</RunSettings>

5. 断言异常被自行捕获处理 #

若测试代码中用try-catch包裹断言并吞掉异常，NUnit会认为测试通过，自然不会触发重试。错误示例：

[Test]
[Retry(2)]
public void TestPageTitle()
{
    try
    {
        Assert.AreEqual("WrongTitle", driver.Title);
    }
    catch (AssertionException)
    {
        // 吞掉异常导致NUnit无法识别测试失败
    }
}

需确保断言失败时的异常被NUnit捕获，不要自行处理。

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