ASP.NET Core WebAPI集成测试：TestServer使用真实SQL Server数据库遇阻

我之前也碰到过类似的情况——你已经搞定了配置文件加载的问题，但卡在数据读取这一步，大概率是测试环境和运行环境的配置、DbContext初始化或者数据库状态不一致导致的，下面给你几个排查和解决的方向：

1. 确认TestServer使用的配置文件和环境是否正确 #

有时候TestServer默认的环境配置和你正常运行WebAPI时不一样，或者测试项目里的appsettings.json没有正确复制到输出目录，导致加载的连接字符串其实不对。

• 首先，确保测试项目的appsettings.json属性设置为复制到输出目录（右键文件→属性→复制到输出目录选择“如果较新则复制”）。
• 在测试代码里显式指定加载配置文件，避免依赖默认逻辑：

  var config = new ConfigurationBuilder()
      .SetBasePath(Directory.GetCurrentDirectory())
      .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
      .Build();
  
  var server = new TestServer(new WebHostBuilder()
      .UseConfiguration(config)
      .UseStartup<Startup>());
  

• 可以在测试里打印连接字符串验证是否正确读取：

  var connectionString = config.GetConnectionString("YourConnectionName");
  Console.WriteLine($"Loaded connection string: {connectionString}");
  

2. 检查DbContext的注册逻辑是否在测试环境中生效 #

你的Startup.cs里可能有条件注册逻辑（比如根据环境判断用内存库还是真实库），导致TestServer没有注册真实的SQL Server DbContext。

打开ConfigureServices方法，确保注册DbContext的代码没有被环境判断包裹：

// 错误示例：如果测试环境不是Development，就不会注册真实库
// if (env.IsDevelopment())
// {
//     services.AddDbContext<YourDbContext>(options => 
//         options.UseSqlServer(Configuration.GetConnectionString("YourConnectionName")));
// }

// 正确做法：不管环境，注册真实DbContext（测试时需要）
services.AddDbContext<YourDbContext>(options => 
    options.UseSqlServer(Configuration.GetConnectionString("YourConnectionName")));

3. 确保测试用的数据库和运行时数据库是同一个 #

很容易犯的错误：测试项目里的连接字符串指向的数据库和你正常运行WebAPI时的不一样（比如一个用(localdb)\mssqllocaldb，另一个用远程服务器，或者数据库名称拼写错误）。

把WebAPI项目里的appsettings.json里的连接字符串完全复制到测试项目的对应文件里，避免手动输入出错。

4. 测试前确保数据库已迁移且有数据 #

正常运行WebAPI时，你可能已经执行过迁移或者添加了种子数据，但TestServer不会自动帮你做这些。需要在测试初始化时手动处理：

在测试类的初始化方法里（比如xUnit的[CollectionFixture]，NUnit的[OneTimeSetUp]）添加以下逻辑：

var config = new ConfigurationBuilder()
    .SetBasePath(Directory.GetCurrentDirectory())
    .AddJsonFile("appsettings.json")
    .Build();

var connectionString = config.GetConnectionString("YourConnectionName");

// 应用迁移
using var context = new YourDbContext(new DbContextOptionsBuilder<YourDbContext>()
    .UseSqlServer(connectionString)
    .Options);
context.Database.Migrate();

// 添加测试种子数据（如果需要）
if (!context.YourEntities.Any())
{
    context.YourEntities.AddRange(
        new YourEntity { Id = 1, Name = "Test Data 1" },
        new YourEntity { Id = 2, Name = "Test Data 2" }
    );
    context.SaveChanges();
}

5. 从TestServer的DI容器中获取DbContext进行验证 #

有时候你自己实例化的DbContext和TestServer使用的不是同一个，导致查询结果不一致。应该从TestServer的服务提供者中获取DbContext：

var server = new TestServer(new WebHostBuilder().UseStartup<Startup>());
using var scope = server.Services.CreateScope();
var context = scope.ServiceProvider.GetRequiredService<YourDbContext>();

// 直接查询验证数据是否存在
var data = context.YourEntities.ToList();
Assert.NotEmpty(data);

按照上面的步骤逐一排查，应该能找到问题所在。

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