.NET 6 Web API：基于配置驱动的DI与NuGet包注册

针对你的需求，以下是一套落地性强的实现方案，既能通过配置控制Mock服务的加载，又能确保生产环境无Mock包冗余：

核心思路 #

通过条件引用NuGet包+配置驱动的动态服务注册结合，实现开发/测试环境启用Mock，生产环境自动剔除相关依赖。

方案1：条件包引用+反射动态注册 #

1. 仅在指定环境引入Mock包 #

修改你的Web API项目的.csproj文件，添加条件引用，确保只有Debug/Test配置下才会引入Mock包：

<ItemGroup Condition="'$(Configuration)' == 'Debug' Or '$(Configuration)' == 'Test'">
  <PackageReference Include="YourCustomMockPackage" Version="x.x.x" />
</ItemGroup>

这样Release编译时，Mock包不会被打包到输出目录，彻底避免部署到生产环境。

2. 环境配置开关 #

在对应环境的appsettings文件中添加Mock配置：

• appsettings.Development.json/appsettings.Test.json：

{
  "MockSettings": {
    "EnableMockServices": true,
    "MockAssemblyName": "YourCustomMockPackage"
  }
}

• appsettings.Production.json：

{
  "MockSettings": {
    "EnableMockServices": false
  }
}

3. 动态注册Mock服务 #

在Program.cs中读取配置，通过反射加载Mock包并注册服务：

var builder = WebApplication.CreateBuilder(args);

// 读取Mock配置
var mockConfig = builder.Configuration.GetSection("MockSettings");
var enableMock = mockConfig.GetValue<bool>("EnableMockServices");

if (enableMock)
{
    try
    {
        var assemblyName = mockConfig.GetValue<string>("MockAssemblyName");
        var mockAssembly = Assembly.Load(assemblyName);

        // 约定Mock包中包含一个实现IMockServiceRegistrar的类
        var registrarType = mockAssembly.GetTypes()
            .FirstOrDefault(t => typeof(IMockServiceRegistrar).IsAssignableFrom(t) && !t.IsInterface);

        if (registrarType != null)
        {
            var registrar = Activator.CreateInstance(registrarType) as IMockServiceRegistrar;
            registrar?.RegisterServices(builder.Services);
        }
    }
    catch (FileNotFoundException)
    {
        // 生产环境下包不存在，直接忽略
    }
}

// 常规服务注册...

var app = builder.Build();
// 中间件配置...

配套Mock包约定

在你的自定义Mock NuGet包中，定义一个公共接口并实现服务注册：

// Mock包中的公共接口
public interface IMockServiceRegistrar
{
    void RegisterServices(IServiceCollection services);
}

// Mock包中的实现类
public class MockServiceRegistrar : IMockServiceRegistrar
{
    public void RegisterServices(IServiceCollection services)
    {
        // 注册你的Mock服务，比如替换真实接口为Mock实现
        services.AddScoped<IUserService, MockUserService>();
    }
}

方案2：封装扩展方法简化注册 #

可以把动态注册逻辑封装成扩展方法，让Program.cs更简洁：

public static class MockServiceExtensions
{
    public static IServiceCollection AddConditionalMockServices(this IServiceCollection services, IConfiguration config)
    {
        var mockSettings = config.GetSection("MockSettings");
        if (!mockSettings.GetValue<bool>("EnableMockServices"))
            return services;

        try
        {
            var assembly = Assembly.Load(mockSettings.GetValue<string>("MockAssemblyName"));
            var registrar = assembly.CreateInstance("YourCustomMockPackage.MockServiceRegistrar") as IMockServiceRegistrar;
            registrar?.RegisterServices(services);
        }
        catch (Exception)
        {
            // 容错：生产环境无包时不影响启动
        }

        return services;
    }
}

然后在Program.cs中一行调用：

builder.Services.AddConditionalMockServices(builder.Configuration);

关键注意事项 #

• 条件引用必须准确：确保.csproj中的Condition只匹配开发/测试配置，防止Mock包流入生产。
• 反射容错处理：必须捕获FileNotFoundException等异常，避免生产环境因找不到Mock包而启动失败。
• 接口约定降低耦合：通过公共接口实现主项目和Mock包的解耦，避免硬编码类型名称。
• 配置环境隔离：不同环境的appsettings单独配置开关，生产环境默认关闭Mock服务。

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