如何在XUnit集成测试中设置跨类全局AccessToken变量

要实现跨所有测试类共享AccessToken，核心是利用XUnit的ICollectionFixture特性，它支持在多个测试类之间共享同一个Fixture实例，替代原来单个类级别的IClassFixture。

步骤1：定义共享集合标记类 #

创建一个空类用于标记共享集合，XUnit会识别这个标记并为集合内的测试类共享同一个Fixture实例：

[CollectionDefinition("SharedTokenCollection")]
public class SharedTokenCollection : ICollectionFixture<TokenDTO>
{
    // 无需任何实现，仅作为集合标记使用
}

步骤2：改造TokenDTO为全局Fixture #

将获取AccessToken的逻辑移到TokenDTO的构造函数中，确保集合初始化时仅执行一次Token获取操作：

public class TokenDTO
{
    public string AccessToken { get; private set; }

    public TokenDTO()
    {
        // 初始化WebApplicationFactory并创建客户端
        var factory = new WebApplicationFactory<Program>();
        using var client = factory.CreateClient();

        // 构造Token请求参数
        var tokenRequest = new TokenRequestDto
        {
            Email = "123@gmail.com",
            Password = "123456"
        };

        // 序列化请求并发送POST请求
        var payload = JsonConvert.SerializeObject(tokenRequest);
        var content = new StringContent(payload, Encoding.UTF8, "application/json");
        var response = client.PostAsync("/api/Tokens/Auth", content).Result;
        
        // 确保请求成功，否则抛出异常终止测试
        response.EnsureSuccessStatusCode();

        // 解析响应获取AccessToken
        var tokenJson = response.Content.ReadAsStringAsync().Result;
        var tokenResult = JsonConvert.DeserializeObject<TokenDto>(tokenJson);
        
        AccessToken = tokenResult.AccessToken;
    }
}

步骤3：在测试类中使用全局Token #

所有需要使用AccessToken的测试类，都标记为属于SharedTokenCollection集合，并通过构造函数注入TokenDTO：

示例测试类1：

[Collection("SharedTokenCollection")]
public class CarNamesControllerTest
{
    private readonly HttpClient _client;
    private readonly TokenDTO _tokenDTO;

    public CarNamesControllerTest(TokenDTO tokenDTO)
    {
        _tokenDTO = tokenDTO;
        var factory = new WebApplicationFactory<Program>();
        _client = factory.CreateClient();
    }

    [Fact]
    public async Task CallAPIEndPoint1()
    {
        // 使用规范的AuthenticationHeaderValue设置授权头，避免重复添加报错
        _client.DefaultRequestHeaders.Authorization = 
            new AuthenticationHeaderValue("Bearer", _tokenDTO.AccessToken);
            
        var response = await _client.GetAsync("api/Car/CarNames");
        // 可添加断言验证响应状态
        response.EnsureSuccessStatusCode();
    }
}

示例测试类2：

[Collection("SharedTokenCollection")]
public class CarTypesControllerTest
{
    private readonly HttpClient _client;
    private readonly TokenDTO _tokenDTO;

    public CarTypesControllerTest(TokenDTO tokenDTO)
    {
        _tokenDTO = tokenDTO;
        var factory = new WebApplicationFactory<Program>();
        _client = factory.CreateClient();
    }

    [Fact]
    public async Task CallAPIEndPoint2()
    {
        _client.DefaultRequestHeaders.Authorization = 
            new AuthenticationHeaderValue("Bearer", _tokenDTO.AccessToken);
            
        var response = await _client.GetAsync("api/Car/CarTypes");
        response.EnsureSuccessStatusCode();
    }
}

关键注意事项 #

• Token仅获取一次：ICollectionFixture的构造函数在整个测试集合启动时执行一次，所有测试类共享同一个AccessToken实例。
• 有效期问题：确保Token的有效期足够覆盖所有测试的执行时长，避免中途过期导致测试失败。
• 避免重复添加Header：使用AuthenticationHeaderValue直接赋值，而非Add方法，防止多次添加同一个Authorization头引发异常。

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