.NET Core多环境切换时WSDL服务引用地址自动配置方法

向导生成的WCF客户端天然支持自定义地址，不需要修改自动生成的文件，也不用每个服务写大量重复逻辑，结合.NET Core原生配置和依赖注入就能实现无编译切换环境，具体实现步骤如下：

核心前提说明 #

你看到的两种方案本质逻辑完全一致：连接服务向导生成的所有WCF客户端类（即你看到代码里的GetUrlContractClient，每个服务引用会生成一个对应命名的XxxContractClient类，继承自ClientBase<T>），都支持通过构造函数传入自定义绑定和终结点地址，覆盖生成代码里硬编码的开发环境地址。你之前尝试ConfigureEndpoint方法抛出安全异常，基本是因为没有匹配对应环境的绑定安全配置（比如HTTPS环境需要开启传输安全模式）。

具体实现步骤 #

1. 统一存放多环境基础地址 #

在appsettings.json中新增独立配置段，存放第三方API的基础路径：

{
  "ThirdPartyApi": {
    "BaseAddress": "https://dev.third-party.com/service/"
  }
}

不同环境分别在appsettings.Staging.json、appsettings.Production.json中覆盖BaseAddress为对应环境的地址即可，.NET Core启动时会自动根据当前运行环境加载对应配置，无需重新编译。

2. 依赖注入注册WCF客户端 #

不需要为每个服务实现单独的ConfigureEndpoint扩展方法，直接在服务注册阶段（.NET 6+在Program.cs，旧版本在Startup.cs的ConfigureServices方法中）读取配置后，统一注册所有WCF客户端：

// 读取配置的基础地址
var thirdPartyConfig = builder.Configuration.GetSection("ThirdPartyApi").Get<ThirdPartyApiConfig>();
var baseUri = new Uri(thirdPartyConfig.BaseAddress);

// 逐个注册服务客户端，每个服务仅需3行代码
// 注意绑定类型和你向导生成的默认绑定保持一致，HTTPS环境记得设置SecurityMode为Transport
builder.Services.AddScoped(sp =>
{
    var binding = new BasicHttpBinding
    {
        Security = new BasicHttpSecurity { Mode = BasicHttpSecurityMode.Transport }
    };
    var endpoint = new EndpointAddress(new Uri(baseUri, "GetUrl.svc"));
    return new GetUrlContractClient(binding, endpoint);
});

// 其余14个服务按相同模式注册即可，替换客户端类名和svc后缀文件名
builder.Services.AddScoped(sp =>
{
    var binding = new BasicHttpBinding
    {
        Security = new BasicHttpSecurity { Mode = BasicHttpSecurityMode.Transport }
    };
    var endpoint = new EndpointAddress(new Uri(baseUri, "OrderService.svc"));
    return new OrderContractClient(binding, endpoint);
});

如果服务量后续继续增加，可以写一个反射批量注册逻辑：扫描程序集中所有继承自ClientBase的生成客户端类，按照类名匹配对应的svc文件路径，自动完成注册，完全不需要手动写每个服务的注册代码。

3. 业务代码中直接使用 #

注册完成后，在Controller、业务服务类中直接通过构造函数注入对应的客户端即可使用，不需要手动new实例，客户端会自动加载当前环境对应的地址：

public class OrderService
{
    private readonly OrderContractClient _orderClient;

    // 构造函数直接注入
    public OrderService(OrderContractClient orderClient)
    {
        _orderClient = orderClient;
    }

    public async Task<OrderInfo> GetOrder(string orderId)
    {
        // 直接调用方法即可，地址已经是当前环境的配置值
        var response = await _orderClient.GetOrderAsync(orderId);
        return response;
    }
}

避坑提示 #

不要修改ConnectedService.json或者自动生成的Reference.cs文件，这两类文件会在你下次更新服务引用时被完全覆盖，所有自定义配置必须在生成代码的外部完成。

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