使用Go testify/suite并行执行测试触发panic的解决方案咨询

问题根源 #

你遇到的testing: t.Parallel called multiple times panic，是因为在子测试中错误调用了外层Suite的T()实例的Parallel()方法。每个子测试都有独立的*testing.T实例，重复调用同一个T实例的Parallel()就会触发这个panic。

正确实现方式 #

1. 子测试中使用自身的*testing.T实例 #

在子测试的闭包函数中，必须使用传入的子测试专属*testing.T来调用Parallel()，而非Suite的is.T()。

修正后的代码示例：

type IntegrationSuite struct {
    suite.Suite
}

func TestIntegrationSuite(t *testing.T) {
    suite.Run(t, &IntegrationSuite{})
}

func (is *IntegrationSuite) TestSomething() {
    is.T().Log("	Integration Testing something")
    for i := range myTestTable {
        i := i
        // 子测试闭包接收并使用自身的t实例
        is.T().Run("Testing "+myTestTable[i].scenarioName, func(t *testing.T) {
            t.Parallel() // 调用子测试自己的t的Parallel()
            // 编写测试逻辑，如需断言可直接使用testify/assert包
            assert.Equal(t, expectedValue, actualValue)
            // 也可复用Suite的断言方法，传入子测试的t实例
            is.Equal(t, expectedValue, actualValue)
        })
    }
}

func (is *IntegrationSuite) TestSomethingElse() {
    is.T().Log("	Integration Testing something else")
    for i := range myOtherTestTable {
        i := i
        is.T().Run("Testing "+myOtherTestTable[i].scenarioName, func(t *testing.T) {
            t.Parallel() // 同样使用子测试自己的t
            // 测试逻辑
        })
    }
}

2. 让Suite的顶层测试方法并行 #

如果希望TestSomething和TestSomethingElse这两个顶层测试方法也并行执行，可以在每个测试方法开头调用is.T().Parallel()：

func (is *IntegrationSuite) TestSomething() {
    is.T().Parallel() // 让顶层测试方法并行
    is.T().Log("	Integration Testing something")
    // ... 子测试逻辑
}

func (is *IntegrationSuite) TestSomethingElse() {
    is.T().Parallel() // 让顶层测试方法并行
    is.T().Log("	Integration Testing something else")
    // ... 子测试逻辑
}

关键注意点 #

• 每个*testing.T实例只能调用一次Parallel()，子测试必须使用自己的t实例调用该方法。
• 子测试中使用断言时，优先传入自身的t实例，避免复用外层Suite的T()实例引发冲突。

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