.NET Core 5 WebAPI搭建的SOAP服务中OperationContract参数未在WSDL显示且客户端生成无输入参数问题

看起来你的问题核心是WSDL生成时输入消息未正确关联参数，导致客户端生成后TestMethodAsync没有输入参数。我来帮你一步步排查和解决：

问题根源分析 #

从你提供的WSDL可以看到，输入消息ITestService_TestMethod_InputMessage是空的（没有<wsdl:part>节点），虽然类型定义里已经有TestMethod元素包含request参数，但元数据生成时没有把两者关联起来。这通常和异步方法的OperationContract配置、以及.NET Core WCF兼容层的元数据处理逻辑有关。

具体解决方案 #

1. 修正接口的OperationContract配置 #

显式指定操作名称、Action和命名空间，避免WCF自动处理异步方法名称时出现偏差：

[ServiceContract(Namespace = "http://your-custom-namespace.com")]
public interface ITestService
{
    [OperationContract(
        Name = "TestMethod",
        Action = "http://your-custom-namespace.com/ITestService/TestMethod",
        ReplyAction = "http://your-custom-namespace.com/ITestService/TestMethodResponse")]
    Task<TestResponse> TestMethodAsync(TestRequest request);
}

• 指定Name = "TestMethod"：确保WSDL中的操作名称和方法逻辑匹配，避免异步后缀Async导致的元数据混淆。
• 统一命名空间：替换默认的tempuri.org为自定义命名空间，减少类型冲突风险。

2. 修复异步方法的实现逻辑 #

你当前用new Task<TestResponse>(...)的方式是错误的——这种方式创建的任务不会自动执行，会导致服务调用挂起。正确的做法是使用Task.FromResult（同步逻辑场景）或async/await（异步逻辑场景）：

public class TestService : ITestService
{
    public Task<TestResponse> TestMethodAsync(TestRequest request)
    {
        // 同步逻辑用Task.FromResult返回已完成的任务
        var response = new TestResponse
        {
            TestBaseProperty = request.TestBaseProperty,
            TestProperty = request.TestProperty,
        };
        return Task.FromResult(response);

        // 如果有异步操作，改用async/await：
        // public async Task<TestResponse> TestMethodAsync(TestRequest request)
        // {
        //     await SomeAsyncOperation();
        //     return new TestResponse { ... };
        // }
    }
}

3. 为所有DataContract指定统一命名空间 #

给所有[DataContract]标记的类添加相同的命名空间，确保元数据生成时类型定义一致：

[DataContract(Namespace = "http://your-custom-namespace.com")]
public class TestPropertyClass
{
    [DataMember]
    public string Text { get; set; }
}

[DataContract(Namespace = "http://your-custom-namespace.com")]
public class TestResponseBase
{
    [DataMember]
    public TestPropertyClass TestBaseProperty { get; set; }
}

// 其他TestResponse、TestRequestBase、TestRequest类同理添加Namespace属性

4. 检查SOAP服务的注册配置 #

确保在Startup.cs（.NET 5）中正确注册WCF服务，注意路径用.svc而非.asmx（.asmx是旧ASMX服务的后缀）：

// 在ConfigureServices中添加
services.AddServiceModelServices();

// 在Configure的UseEndpoints中添加
app.UseEndpoints(endpoints =>
{
    endpoints.MapWcfService<TestService>(new ServiceOptions
    {
        Path = "/TestService.svc"
    });
});

验证修改效果 #

重启服务后查看WSDL，你会发现输入消息已经正确关联参数：

<wsdl:message name="ITestService_TestMethod_InputMessage">
  <wsdl:part name="parameters" element="tns:TestMethod" />
</wsdl:message>

此时再生成客户端，TestMethodAsync就会正确接收TestRequest类型的输入参数了。

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