Visual Studio 2022生成WCF服务引用无法复用项目引用类问题

现象对比 #

• VS2019中，添加共享类项目引用后生成WCF服务引用，会直接复用共享类，不会在reference.cs中生成新类，且「复用引用程序集中的类型」列表会显示该项目引用。
• VS2022中，无论操作步骤如何，服务引用都会在reference.cs中生成新类，无法复用现有共享类，且「复用引用程序集中的类型」列表不显示已添加的项目引用。

操作流程 #

1. 右键客户端项目，添加项目引用并勾选目标共享类库
2. 通过「添加/连接服务/WCF Web服务」入口添加服务引用，指定WCF服务地址net.tcp://localhost
3. 生成服务引用后，发现reference.cs未复用共享类，反而生成了新的类型定义

代码示例 #

VS2019生成的接口（复用共享类） #

[System.CodeDom.Compiler.GeneratedCodeAttribute("System.ServiceModel", "4.0.0.0")]
[System.ServiceModel.ServiceContractAttribute(ConfigurationName="ExampleService.IExampleImportService")]
public interface IExampleImportService {

    [System.ServiceModel.OperationContractAttribute(Action="http://tempuri.org/IExampleImportService/GetExamples", ReplyAction="http://tempuri.org/IExampleImportService/GetExamplesResponse")]
    System.Threading.Tasks.Task<SharedLibrary.ExampleInfo[]> GetExamplesAsync();
    
    [System.ServiceModel.OperationContractAttribute(Action="http://tempuri.org/IExampleImportService/AddNewExample", ReplyAction="http://tempuri.org/IExampleImportService/AddNewExampleResponse")]
    System.Threading.Tasks.Task<uint> AddNewExampleAsync(SharedLibrary.ExampleInfo example);
}

VS2022生成的接口（生成新类） #

[System.CodeDom.Compiler.GeneratedCodeAttribute("Microsoft.Tools.ServiceModel.Svcutil", "2.0.3")]
[System.ServiceModel.ServiceContractAttribute(ConfigurationName="ExampleService.IExampleImportService")]
public interface IExampleImportService
{
    [System.ServiceModel.OperationContractAttribute(Action="http://tempuri.org/IExampleImportService/GetExamples", ReplyAction="http://tempuri.org/IExampleImportService/GetExamplesResponse")]
    System.Threading.Tasks.Task<ExampleService.ExampleInfo[]> GetExamplesAsync();
     
    [System.ServiceModel.OperationContractAttribute(Action="http://tempuri.org/IExampleImportService/AddNewExample", ReplyAction="http://tempuri.org/IExampleImportService/AddNewExampleResponse")]
    System.Threading.Tasks.Task<uint> AddNewExampleAsync(ExampleService.ExampleInfo example);
}

解决方案 #

1. 手动指定复用程序集 #

在添加服务引用的「高级设置」中：

• 勾选「复用引用程序集中的类型」选项
• 点击「浏览」按钮，手动选择已添加的共享类库的程序集文件
• 确保共享类的命名空间、数据契约属性（[DataContract]/[DataMember]）与WCF服务端定义完全一致

2. 使用SvcUtil工具手动生成 #

打开Visual Studio开发者命令提示符，执行以下命令生成服务引用（替换路径为实际文件路径）：

svcutil net.tcp://localhost/YourServiceEndpoint /reference:.\SharedLibrary\bin\Debug\net6.0\SharedLibrary.dll /out:Reference.cs /config:App.config

生成后将Reference.cs和更新后的配置文件添加到客户端项目中，替换自动生成的服务引用内容。

3. 检查框架与版本兼容性 #

• 确保共享类库项目与客户端项目的目标.NET框架版本一致
• 确认服务端发布的契约类型与共享类的版本完全匹配，避免因版本差异导致无法识别复用

4. 修复VS工具异常 #

• 将Visual Studio 2022更新至最新稳定版本
• 重置VS设置：依次点击「工具 > 导入和导出设置 > 重置所有设置」，解决工具本身的配置异常

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