如何为MVC Web应用不同构建版本实现独立启动配置？

针对你的需求，我们可以利用.NET的Hosting Startup特性结合条件编译来实现——完全不需要改动主项目的启动代码，同时能彻底隔离测试代码，避免其被编译部署到生产环境。下面是具体的落地步骤：

1. 创建独立的测试变体代码容器 #

首先在解决方案里新建一个类库项目（比如命名为YourMvcApp.TestVariant），所有测试相关的代码（模拟认证、测试服务等）都放在这里。这个项目绝对不要被主MVC项目引用，从根源上避免主编译流程接触到测试代码。

2. 配置条件编译隔离 #

在测试变体项目的属性中添加专属编译符号，确保只有编译测试项目时才会生效：

• 右键测试项目 → 属性 → 生成 → 常规 → 条件编译符号，输入TEST_VARIANT

主项目不需要添加这个符号，所以编译主版本时，所有带#if TEST_VARIANT标记的代码都会被忽略。

3. 编写Hosting Startup扩展类 #

Hosting Startup是.NET提供的原生扩展点，允许我们在不修改主启动代码的前提下，向应用的主机构建流程注入服务和配置。在测试项目中创建如下代码：

#if TEST_VARIANT
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.AspNetCore.Authentication;
using System.Security.Claims;
using System.Threading.Tasks;

// 标记这个类为Hosting Startup扩展，框架会自动识别
[assembly: HostingStartup(typeof(YourMvcApp.TestVariant.TestHostingStartup))]

namespace YourMvcApp.TestVariant
{
    public class TestHostingStartup : IHostingStartup
    {
        public void Configure(IWebHostBuilder builder)
        {
            // 在这里配置测试变体的所有服务
            builder.ConfigureServices(services =>
            {
                // 替换默认认证为模拟方案，自动登录测试用户
                services.AddAuthentication("TestAuth")
                    .AddScheme<AuthenticationSchemeOptions, TestAuthenticationHandler>("TestAuth", _ => { });

                // 按需添加其他模拟服务，比如Mock数据库、外部API实现
                services.AddScoped<IUserService, MockUserService>();
            });

            // 也可以配置测试专属的中间件逻辑
            builder.Configure(app =>
            {
                // 比如强制开启认证，或者添加测试用的调试中间件
            });
        }
    }

    // 自定义模拟认证处理程序，自动生成测试用户身份
    public class TestAuthenticationHandler : AuthenticationHandler<AuthenticationSchemeOptions>
    {
        public TestAuthenticationHandler(IOptionsMonitor<AuthenticationSchemeOptions> options, 
            ILoggerFactory logger, UrlEncoder encoder, ISystemClock clock) 
            : base(options, logger, encoder, clock)
        {
        }

        protected override Task<AuthenticateResult> HandleAuthenticateAsync()
        {
            // 构造测试用户的身份信息
            var claims = new[]
            {
                new Claim(ClaimTypes.Name, "TestAdmin"),
                new Claim(ClaimTypes.Role, "Administrator")
            };
            var identity = new ClaimsIdentity(claims, Scheme.Name);
            var principal = new ClaimsPrincipal(identity);
            var ticket = new AuthenticationTicket(principal, Scheme.Name);

            return Task.FromResult(AuthenticateResult.Success(ticket));
        }
    }

    // 示例：模拟用户服务接口与实现
    public interface IUserService { /* 定义业务方法 */ }
    public class MockUserService : IUserService { /* 模拟业务逻辑 */ }
}
#endif

4. 启动测试变体服务 #

要加载测试变体，只需要设置环境变量ASPNETCORE_HOSTINGSTARTUPASSEMBLIES为测试项目的程序集名称，再启动主MVC应用即可：

命令行启动方式 #

# Windows
set ASPNETCORE_HOSTINGSTARTUPASSEMBLIES=YourMvcApp.TestVariant
dotnet run --project YourMvcApp

# Linux/macOS
export ASPNETCORE_HOSTINGSTARTUPASSEMBLIES=YourMvcApp.TestVariant
dotnet run --project YourMvcApp

IDE调试方式 #

在主MVC项目的启动配置中，添加环境变量ASPNETCORE_HOSTINGSTARTUPASSEMBLIES=YourMvcApp.TestVariant，直接启动调试即可加载测试变体。

5. 额外保障：环境判断+部署隔离 #

可以在Hosting Startup类中增加环境判断，确保只有测试环境才会加载模拟服务：

public void Configure(IWebHostBuilder builder)
{
    builder.ConfigureServices((context, services) =>
    {
        // 仅在Test环境下启用模拟服务
        if (context.HostingEnvironment.IsEnvironment("Test"))
        {
            services.AddAuthentication("TestAuth")
                .AddScheme<AuthenticationSchemeOptions, TestAuthenticationHandler>("TestAuth", _ => { });
        }
    });
}

同时，在CI/CD流程中只需编译部署主MVC项目，完全跳过测试变体项目，彻底避免测试代码流入生产环境。

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