Visual Studio 2022单元测试项目引用Web项目时appsettings.json加载错误

针对你遇到的VS2022中单元测试项目与Web项目appsettings.json冲突、随机加载错误配置的问题，以下几种最小改动的方案可以解决：

1. 强制测试项目配置文件覆盖输出目录中的同名文件 #

修改单元测试项目的.csproj文件，添加以下配置，确保测试项目的appsettings.json在构建时强制覆盖输出目录中可能存在的Web项目版本：

<ItemGroup>
  <None Update="appsettings.json">
    <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    <OverwriteReadOnlyFiles>true</OverwriteReadOnlyFiles>
  </None>
</ItemGroup>

<Target Name="ForceCopyTestAppSettings" AfterTargets="Build">
  <!-- 构建完成后再次复制测试配置文件，确保覆盖 -->
  <Copy SourceFiles="$(ProjectDir)appsettings.json" 
        DestinationFiles="$(OutputPath)appsettings.json" 
        OverwriteReadOnlyFiles="true" />
</Target>

这个方案从构建环节确保测试配置文件始终是最后被复制到输出目录的，避免Web项目的配置文件覆盖它。

2. 在WebApplicationFactory中显式指定测试配置文件路径 #

自定义WebApplicationFactory实现，在配置阶段直接指定加载测试项目的appsettings.json，跳过默认的自动加载逻辑，从根源上避免路径混淆：

public class TestWebAppFactory<TProgram> : WebApplicationFactory<TProgram> 
    where TProgram : class
{
    protected override void ConfigureWebHost(IWebHostBuilder builder)
    {
        // 获取测试项目输出目录下的配置文件路径
        var testSettingsPath = Path.Combine(Environment.CurrentDirectory, "appsettings.json");

        builder.ConfigureAppConfiguration((context, config) =>
        {
            // 清空现有配置源，只加载测试项目的配置
            config.Sources.Clear();
            config.AddJsonFile(testSettingsPath, optional: false, reloadOnChange: true);
            // 可按需添加其他配置源（如环境变量）
        });

        base.ConfigureWebHost(builder);
    }
}

使用这个自定义Factory来创建测试用的Web应用，就能确保始终加载测试项目的配置。

3. 通过.runsettings指定测试工作目录 #

创建Test.runsettings文件，设置测试运行时的工作目录为测试项目的输出目录，避免加载到Web项目的配置文件：

<?xml version="1.0" encoding="utf-8"?>
<RunSettings>
  <RunConfiguration>
    <WorkingDirectory>$(TargetDir)</WorkingDirectory>
  </RunConfiguration>
</RunSettings>

在Visual Studio中，依次点击测试→配置运行设置→选择解决方案中的.runsettings文件，选中这个文件即可。此方案通过限定测试运行的工作路径，让配置加载逻辑只能找到测试项目的appsettings.json。

问题根源说明 #

临时修改测试配置文件后恢复正常，是因为修改触发了测试项目配置文件的重新复制操作，覆盖了输出目录中Web项目的版本。随机出现问题则是因为构建过程中文件复制的顺序不确定，偶尔Web项目的配置文件会晚于测试项目被复制，导致覆盖。

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