C#集成测试环境变量配置详解（手把手教你为.NET应用设置自动化测试环境）

为什么需要在集成测试中使用环境变量？

集成测试通常涉及数据库连接、API 密钥、外部服务地址等敏感或可变配置。如果把这些信息硬编码在代码中，不仅存在安全风险，还会导致测试难以在不同环境中运行（如本地、CI/CD流水线、测试服务器）。

通过使用环境变量，我们可以：

• 避免将敏感信息提交到代码仓库
• 轻松切换测试环境（如使用内存数据库 vs 真实数据库）
• 支持 CI/CD 工具（如 GitHub Actions、Azure DevOps）动态注入配置

步骤一：创建一个简单的集成测试项目

首先，确保你已安装 .NET SDK（建议 .NET 6 或更高版本）。打开终端，执行以下命令创建一个 Web API 项目和对应的测试项目：

dotnet new webapi -n MyAppdotnet new xunit -n MyApp.IntegrationTestscd MyApp.IntegrationTestsdotnet add reference ../MyApp/MyApp.csproj

步骤二：在主项目中读取环境变量

在 MyApp 项目中，.NET 默认通过 IConfiguration 读取配置。它会自动加载环境变量（以双下划线 __ 或冒号 : 分隔层级）。

例如，在 appsettings.json 中有如下配置：

{  "ConnectionStrings": {    "DefaultConnection": "Server=(localdb)\\mssqllocaldb;Database=MyAppDb;..."  },  "ExternalApi": {    "BaseUrl": "https://api.example.com"  }}

你可以通过设置环境变量 ConnectionStrings__DefaultConnection 或 ExternalApi__BaseUrl 来覆盖这些值。

步骤三：在集成测试中设置环境变量

在 MyApp.IntegrationTests 项目中，我们使用 WebApplicationFactory<T> 启动被测应用。可以通过重写 ConfigureWebHost 方法来注入自定义环境变量。

创建测试类 WeatherForecastTests.cs：

using System;using Microsoft.AspNetCore.Mvc.Testing;using Microsoft.Extensions.Configuration;using Xunit;namespace MyApp.IntegrationTests{    public class CustomWebApplicationFactory : WebApplicationFactory<Program>    {        protected override void ConfigureWebHost(IWebHostBuilder builder)        {            // 设置环境变量            Environment.SetEnvironmentVariable("ExternalApi__BaseUrl", "https://mock-api.test");            Environment.SetEnvironmentVariable("ConnectionStrings__DefaultConnection", "...in-memory or test DB...");            builder.ConfigureAppConfiguration((context, config) =>            {                // 强制重新加载配置以包含新环境变量                config.AddEnvironmentVariables();            });        }    }    public class WeatherForecastTests : IClassFixture<CustomWebApplicationFactory>    {        private readonly HttpClient _client;        public WeatherForecastTests(CustomWebApplicationFactory factory)        {            _client = factory.CreateClient();        }        [Fact]        public async Task GetWeatherForecast_ReturnsSuccess()        {            var response = await _client.GetAsync("/weatherforecast");            Assert.True(response.IsSuccessStatusCode);        }    }}

步骤四：使用 .env 文件（可选但推荐）

对于本地开发，你可能不想每次手动设置环境变量。可以借助 dotenv.net 包从 .env 文件加载变量。

安装 NuGet 包：

dotnet add package dotenv.net

在测试项目根目录创建 .env.test 文件：

ExternalApi__BaseUrl=https://staging-api.example.comConnectionStrings__DefaultConnection=Server=localhost;Database=TestDb;...

然后在测试工厂中加载它：

using DotEnv.Core;// 在 CustomWebApplicationFactory 的构造函数或 ConfigureWebHost 中new EnvLoader().AddEnvFile(".env.test").Load();

总结

通过合理使用C#集成测试中的环境变量配置，你可以构建出更安全、更灵活的.NET Core测试体系。无论是在本地开发还是在 CI/CD 流水线中，这种做法都能显著提升自动化测试环境的可靠性与可维护性。

记住：永远不要把敏感信息写死在代码里！善用环境变量，让你的测试既强大又安全。

—— 本文完 ——