WebApplicationFactory的HttpClient未保存认证Cookie致MSTest测试401

使用MSTest编写集成测试时，调用登录接口返回状态码200且包含Set-Cookie响应头，但使用同一个HttpClient调用其他接口时返回401，检查发现后续请求的Cookie为空。

自定义应用工厂代码 #

public class WebAppFactory<TProgram> : WebApplicationFactory<TProgram> where TProgram : class

测试方法代码 #

Factory = new WebAppFactory<Program>();
Client = Factory.CreateClient();

// 登录接口返回200，响应包含正确的Set-Cookie头
var jsonContent = JsonSerializer.Serialize(new { Username = "test", Password = "test"});
var requestContent = new StringContent(jsonContent, Encoding.UTF8, "application/json");
var authResponse = await Client.PostAsync("/login", requestContent);

// 此请求返回401
var response = await Client.GetAsync("/user/details");

• 检查Cookie的属性配置
  查看登录接口返回的Set-Cookie头参数，确认：

  • Path是否为/或包含后续请求的接口路径（比如/user），路径不匹配时HttpClient不会自动携带Cookie；
  • SameSite属性设置是否合理，同应用内请求Strict或Lax均可正常携带；
  • HttpOnly属性不影响HttpClient自动携带Cookie，无需额外处理。

• 确保HttpClient启用自动Cookie处理
  默认WebApplicationFactory.CreateClient()返回的HttpClient会自动处理Cookie，但自定义工厂配置可能覆盖默认行为，可显式配置：

  // 创建Client时指定配置
  Client = Factory.CreateClient(new WebApplicationFactoryClientOptions
  {
      HandleCookies = true,
      AllowAutoRedirect = true
  });
  

  或在自定义WebAppFactory中添加配置：

  protected override void ConfigureClient(HttpClient client)
  {
      base.ConfigureClient(client);
      if (client.GetHandler() is HttpClientHandler handler)
      {
          handler.UseCookies = true;
          handler.CookieContainer ??= new CookieContainer();
      }
  }
  

• 手动提取并携带Cookie
  如果自动处理失效，可手动从登录响应中提取Cookie并添加到后续请求：

  // 从登录响应中提取Set-Cookie头
  if (authResponse.Headers.TryGetValues("Set-Cookie", out var cookieValues))
  {
      foreach (var cookie in cookieValues)
      {
          // 截取Cookie键值对部分（忽略后续属性）
          var cookiePart = cookie.Split(';')[0];
          Client.DefaultRequestHeaders.Add("Cookie", cookiePart);
      }
  }
  
  // 再次调用接口
  var response = await Client.GetAsync("/user/details");
  

• 验证应用端认证配置
  确认目标应用已正确启用Cookie认证中间件，UseAuthentication()和UseAuthorization()在中间件管道中的顺序正确，且Cookie认证的名称、路径等参数与登录接口设置一致。

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