.NET 8单元测试中ConfigurationBuilder交替加载错误appsettings.json问题

问题原因 #

出现交替加载应用项目和测试项目配置文件的核心原因是测试运行时的工作目录不固定：

• 测试运行器（如Visual Studio测试资源管理器）在不同场景下（单测试运行、批量测试运行、并行测试）会切换工作目录，有时指向测试项目的输出目录，有时会因解决方案级的执行上下文指向应用项目的目录。
• 当调用AddJsonFile("appsettings.json")时，ConfigurationBuilder会在当前工作目录下查找文件，工作目录的不稳定就导致了时而找到测试项目的文件，时而找到应用项目的文件。

彻底解决方法 #

要完全避免这个问题，必须明确指定测试项目appsettings.json的绝对路径，不要依赖不稳定的工作目录。最可靠的方式是通过测试程序集的位置来定位配置文件：

步骤1：添加必要的命名空间 #

确保引用以下命名空间：

using System.Reflection;
using Microsoft.Extensions.Configuration;

步骤2：修改配置加载代码 #

替换原有的配置构建代码，用程序集路径定位测试项目的配置文件：

// 获取测试程序集的所在目录
var assemblyDirectory = Path.GetDirectoryName(Assembly.GetExecutingAssembly().Location);
// 拼接测试项目appsettings.json的绝对路径
var configPath = Path.Combine(assemblyDirectory!, "appsettings.json");

var configurationBuilder = new ConfigurationBuilder();
// 用绝对路径加载配置文件，保留optional: true避免文件缺失报错
configurationBuilder.AddJsonFile(configPath, optional: true);
var configuration = configurationBuilder.Build();

额外说明 #

• 若之前使用SetBaseDirectory(Directory.GetCurrentDirectory())无效，是因为Directory.GetCurrentDirectory()在测试运行时的值不稳定，而程序集位置能确保始终指向测试项目的输出目录，不受运行场景影响。
• 确保测试项目的appsettings.json属性中，“复制到输出目录”设置为“始终复制”或“如果较新则复制”，否则输出目录中不会存在该文件，导致加载失败。

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