如何在单个WCF服务中兼容WSDL V1与V2版本？

核心思路：命名空间隔离+多端点配置+显式接口实现 #

通过隔离两个版本的类型命名空间，让服务实现类同时兼容双版本契约，再通过多端点区分服务版本，最终实现单实例服务兼容新旧客户端。

1. 隔离同名类型的命名空间 #

由于V1和V2存在大量同名接口、类，首先要通过命名空间区分两者，避免编译冲突：

• 生成代码时指定命名空间（推荐，无需手动修改）：
  使用svcutil.exe的/namespace参数，为两个版本分别指定独立命名空间：

  svcutil.exe CarV1.wsdl /namespace:*,YourCompany.CarService.V1 /out:CarV1.cs
  svcutil.exe CarV2.wsdl /namespace:*,YourCompany.CarService.V2 /out:CarV2.cs
  

• 手动修改现有代码：
  打开已生成的CarV1.cs和CarV2.cs，为所有类型添加版本专属命名空间，示例：

  // CarV1.cs
  namespace YourCompany.CarService.V1
  {
      [ServiceContract(Namespace = "http://yourcompany.com/carservice/v1")]
      public interface CarIdentification
      {
          [OperationContract]
          CarDetails GetDetails(string carId);
      }
      // V1实体类...
  }
  
  // CarV2.cs
  namespace YourCompany.CarService.V2
  {
      [ServiceContract(Namespace = "http://yourcompany.com/carservice/v2")]
      public interface CarIdentification
      {
          [OperationContract]
          NewCarDetails GetDetails(string carId); // V2重命名后的类
      }
      // V2实体类...
  }
  

2. 修改服务实现类，兼容双版本契约 #

让CarService同时实现两个命名空间下的CarIdentification接口，通过显式接口实现区分版本逻辑：

public class CarService : YourCompany.CarService.V1.CarIdentification, YourCompany.CarService.V2.CarIdentification
{
    // 保留原有V1逻辑，兼容老客户端
    YourCompany.CarService.V1.CarDetails YourCompany.CarService.V1.CarIdentification.GetDetails(string carId)
    {
        // 原有业务逻辑直接复用
        return new V1.CarDetails 
        { 
            Id = carId, 
            Model = GetCarModelFromDB(carId) 
        };
    }

    // V2逻辑，复用V1核心逻辑并做实体转换
    YourCompany.CarService.V2.NewCarDetails YourCompany.CarService.V2.CarIdentification.GetDetails(string carId)
    {
        // 调用V1逻辑获取基础数据
        var v1Details = ((V1.CarIdentification)this).GetDetails(carId);
        
        // 转换为V2实体（适配重命名/新增属性）
        return new V2.NewCarDetails
        {
            Id = v1Details.Id,
            VehicleModel = v1Details.Model, // 适配V2重命名的属性
            ProductionYear = GetProductionYear(carId) // V2新增属性的逻辑
        };
    }

    // 复用的通用业务方法
    private string GetCarModelFromDB(string carId) { /* 原有逻辑 */ }
    private int GetProductionYear(string carId) { /* V2新增逻辑 */ }
}

3. 配置多端点，区分服务版本 #

在服务配置文件（web.config/app.config）中添加两个端点，V1端点保持原有地址兼容老客户端，V2端点使用新路径：

<system.serviceModel>
    <services>
        <service name="YourCompany.CarService">
            <!-- V1端点：保持原有地址，老客户端无需修改 -->
            <endpoint 
                address="" 
                binding="basicHttpBinding" 
                contract="YourCompany.CarService.V1.CarIdentification" />
            
            <!-- V2端点：新地址，供新客户端调用 -->
            <endpoint 
                address="V2" 
                binding="basicHttpBinding" 
                contract="YourCompany.CarService.V2.CarIdentification" />
            
            <!-- 元数据端点：对外暴露双版本WSDL -->
            <endpoint address="mex" binding="mexHttpBinding" contract="IMetadataExchange" />
        </service>
    </services>
    <behaviors>
        <serviceBehaviors>
            <behavior>
                <serviceMetadata httpGetEnabled="true" />
                <serviceDebug includeExceptionDetailInFaults="false" />
            </behavior>
        </serviceBehaviors>
    </behaviors>
</system.serviceModel>

4. 简化实体映射（可选） #

如果V2仅新增/重命名属性，可使用AutoMapper减少手动映射代码：

// 初始化映射配置
Mapper.Initialize(cfg =>
{
    cfg.CreateMap<V1.CarDetails, V2.NewCarDetails>()
        .ForMember(dest => dest.VehicleModel, opt => opt.MapFrom(src => src.Model));
    // 其他实体映射规则
});

// 在V2的GetDetails中使用
var v2Details = Mapper.Map<V2.NewCarDetails>(v1Details);

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