如何为Azure DevOps代理上的NUnit测试项目配置专属appsettings.json

针对你遇到的本地与Azure DevOps代理服务器需使用不同测试数据库配置、且不想提交配置文件到Git或在流水线中硬编码代理配置的问题，以下是几个可行的方案：

方案1：利用.NET环境变量覆盖配置（推荐） #

.NET配置系统原生支持从环境变量读取配置，且优先级高于appsettings.json，无需修改测试项目的配置加载逻辑，只需在不同环境设置对应环境变量即可：

• 本地环境：
  1. 在本地系统/用户环境变量中添加键值对，键名格式为ConnectionStrings__TestDb（对应appsettings.json中ConnectionStrings:TestDb的结构，冒号替换为双下划线），值为本地测试数据库的连接字符串。
  2. 若使用Visual Studio，也可在测试项目的launchSettings.json中添加环境变量配置，仅在本地调试时生效。
• 代理服务器环境：
  在Azure DevOps代理所在机器的系统/用户环境变量中添加相同键名的环境变量，值为代理服务器对应的测试数据库连接字符串。
• 测试项目无需额外修改，默认的配置加载流程会自动读取环境变量并覆盖appsettings中的配置（即使appsettings.json不存在也能正常读取）。

方案2：多路径配置文件加载 #

修改测试项目的配置加载逻辑，同时支持从项目目录和代理服务器本地固定目录读取配置文件，兼顾就近存放和环境隔离：

1. 更新测试项目的配置初始化代码：

var configBuilder = new ConfigurationBuilder()
    .SetBasePath(Directory.GetCurrentDirectory())
    // 优先加载项目目录下的配置（本地开发用）
    .AddJsonFile("appsettings.json", optional: true)
    // 加载代理服务器本地的专属配置（仅代理环境存在）
    .AddJsonFile(@"C:\AgentTestConfigs\TestProject\appsettings.json", optional: true);

var configuration = configBuilder.Build();

2. 本地环境：在测试项目目录下存放appsettings.json，并将该文件加入.gitignore避免提交。
3. 代理服务器环境：在C:\AgentTestConfigs\TestProject\路径下存放代理专属的appsettings.json，无需提交到Git，流水线执行测试时会自动读取该文件。

方案3：流水线复制代理配置文件到构建目录 #

通过Azure DevOps流水线的复制任务，将代理服务器本地的配置文件复制到测试项目的构建输出目录，既保证配置与项目就近存放，又避免流水线构建时丢失文件：

1. 在代理服务器本地固定路径（如C:\AgentTestConfigs\TestProject\appsettings.json）存放专属配置文件。
2. 在Azure DevOps流水线中添加复制文件任务，置于构建任务之后、测试任务之前：
   • 源路径：C:\AgentTestConfigs\TestProject\appsettings.json
   • 目标路径：$(Agent.WorkFolder)\$(Build.DefinitionName)\TestProject\bin\$(BuildConfiguration)\net6.0（根据你的项目框架版本和构建配置调整路径）
3. 测试执行时，会从构建输出目录读取到复制后的配置文件，本地环境仍使用项目目录下的appsettings.json。

内容的提问来源于stack exchange，提问作者a.r.