.NET Core类库及集成测试项目读取appsettings.json连接字符串方法

我完全懂你的需求——ASP.NET Core项目里的配置体系开箱即用，但类库或者集成测试项目没有默认的配置管道，得手动搭一套才能读取appsettings.json里的连接字符串，对吧？下面是针对你场景的一步步实现方案：

第一步：准备appsettings.json文件 #

1. 在你的集成测试项目中添加appsettings.json文件，配置内容示例：

{
  "ConnectionStrings": {
    "TestDb": "Server=(localdb)\\mssqllocaldb;Database=TestSample;Trusted_Connection=True;"
  }
}

2. 右键该文件 → 属性 → 设置复制到输出目录为「如果较新则复制」或者「始终复制」——这一步至关重要，不然测试运行时会找不到配置文件。

第二步：添加必要的NuGet包 #

测试项目需要以下包来处理配置逻辑：

• Microsoft.Extensions.Configuration
• Microsoft.Extensions.Configuration.Json
• 如果你用EF Core，还要确保安装对应数据库的EF包（比如Microsoft.EntityFrameworkCore.SqlServer）

可以通过CLI命令安装：

dotnet add package Microsoft.Extensions.Configuration
dotnet add package Microsoft.Extensions.Configuration.Json

第三步：手动构建配置并初始化EF上下文 #

在测试类里，手动创建ConfigurationBuilder实例加载JSON配置，读取连接字符串后初始化EF上下文，就能用来插入测试数据了。

示例代码：

using Microsoft.Extensions.Configuration;
using YourProject.Data; // 替换为你的EF上下文所在命名空间
using Microsoft.EntityFrameworkCore;

public class YourIntegrationTests
{
    private readonly YourDbContext _dbContext;

    public YourIntegrationTests()
    {
        // 构建配置实例
        var configuration = new ConfigurationBuilder()
            .SetBasePath(Directory.GetCurrentDirectory())
            .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
            .Build();

        // 读取目标连接字符串
        string connectionString = configuration.GetConnectionString("TestDb");

        // 初始化EF上下文
        var dbOptions = new DbContextOptionsBuilder<YourDbContext>()
            .UseSqlServer(connectionString)
            .Options;

        _dbContext = new YourDbContext(dbOptions);
    }

    // 测试方法示例：插入并验证测试数据
    [Fact]
    public void ShouldInsertTestDataSuccessfully()
    {
        // 插入测试数据
        var testItem = new TestEntity { Title = "Sample Test Data" };
        _dbContext.TestEntities.Add(testItem);
        _dbContext.SaveChanges();

        // 验证数据是否存在
        var insertedItem = _dbContext.TestEntities.Find(testItem.Id);
        Assert.NotNull(insertedItem);
        Assert.Equal("Sample Test Data", insertedItem.Title);
    }
}

额外小提示 #

• 如果需要区分测试环境，可以添加appsettings.Development.json这类环境专属配置文件，通过AddJsonFile的重载或者设置环境变量来加载对应配置。
• 要是用xUnit/NUnit这类框架，也可以把配置构建逻辑放到测试Fixture里，避免每个测试类重复写相同代码。

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