一、什么是 SoapCore？

在现代微服务和 REST API 成为主流的今天，SOAP（Simple Object Access Protocol）看似已经被边缘化，但在许多企业和政务系统中，SOAP 仍然是 重要的通信协议。特别是在金融、保险、医疗、政府等行业，很多老系统和第三方接口仍然依赖 SOAP 协议。

然而，自从 .NET Core 推出后，原本用于构建 SOAP 服务的 WCF（Windows Communication Foundation）在跨平台的 .NET Core 中就不再被支持。这给需要构建或迁移 SOAP 服务的开发者带来了挑战。

SoapCore 正是为了解决这个问题而诞生的。它是一个开源库，可以让你在 ASP.NET Core 中实现 SOAP 服务功能，不需要依赖 WCF，轻量、易用、跨平台。

---

二、SoapCore 的适用用户

SoapCore 适用于以下类型的用户和项目场景：

• 需要与传统 SOAP 服务对接的开发者 如：集成第三方 SOAP 接口（例如银联、医保、政务数据交换平台）。

• 维护或迁移现有 WCF 服务的开发者 如果你的旧系统使用了 WCF，但现在需要迁移到 .NET 6/.NET 8，可以用 SoapCore 重写服务逻辑。

• 需要公开 SOAP 接口给合作方的公司 某些合作伙伴只支持 SOAP 接口，可以用 SoapCore 快速构建 Web Service。

• 在容器或 Linux 环境部署 SOAP 服务的团队 WCF 无法跨平台，而 SoapCore 能完美运行在 Docker、Linux 等平台。

---

三、SoapCore 的核心功能

功能	说明
支持 SOAP 1.1 / 1.2	可兼容大多数 SOAP 客户端和服务
WSDL 自动生成	自动提供标准格式的 Web 服务描述语言（WSDL）
支持依赖注入（DI）	与 ASP.NET Core 完全集成，便于管理服务生命周期
支持多种序列化方式	支持 DataContractSerializer、XmlSerializer
可自定义中间件和过滤器	实现日志、认证、异常处理等功能
支持 HTTPS、SOAP Headers	可通过中间件或扩展支持更复杂的协议层功能

---

四、如何使用 SoapCore？（开发示例）

1. 安装 NuGet 包

dotnet add package SoapCore

或者通过 Visual Studio 的 NuGet 管理器添加 SoapCore 包。

---

2. 编写服务接口和实现类

[ServiceContract]
public interface ICalculatorService
{[OperationContract]int Add(int a, int b);
}

public class CalculatorService : ICalculatorService
{public int Add(int a, int b){return a + b;}
}

---

3. 在 ASP.NET Core 项目中注册服务

public void ConfigureServices(IServiceCollection services)
{services.AddSoapCore();services.AddSingleton<ICalculatorService, CalculatorService>();services.AddControllers(); // 或 services.AddMvc();
}

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{app.UseRouting();app.UseEndpoints(endpoints =>{endpoints.UseSoapEndpoint<ICalculatorService>("/CalculatorService.svc", new SoapEncoderOptions(), SoapSerializer.DataContractSerializer);});
}

这样就可以通过浏览器访问：

http://localhost:5000/CalculatorService.svc?wsdl

---

五、SOAP Serializer 类型说明

SoapCore 支持多种序列化器：

类型	优点	使用场景
DataContractSerializer（默认）	性能高、易用	推荐大多数情况使用
XmlSerializer	可自定义 XML 输出格式	与旧系统集成时更灵活
自定义序列化器	完全自定义	特殊场景

示例：

endpoints.UseSoapEndpoint<IMyService>("/Service.svc", new SoapEncoderOptions(), SoapSerializer.XmlSerializer);

---

六、常见高级用法

✅ 添加认证中间件（如 Basic Auth）

你可以通过 app.UseMiddleware<YourAuthMiddleware>() 插入认证逻辑。

✅ 自定义 SOAP Header 处理

SoapCore 支持自定义请求头，可通过 MessageInspector 实现。

✅ 多个 SOAP Endpoint 同时提供

你可以在 UseEndpoints 中注册多个 UseSoapEndpoint<>，实现不同服务接口的并行运行。

---

七、SoapCore 的优势与局限

✅ 优势：

• 轻量级，无需完整 WCF 框架

• 与 ASP.NET Core 原生集成

• 支持依赖注入、跨平台部署

• 社区活跃，开源可扩展

⚠️ 局限：

• 不完全兼容所有 WCF 功能（如复杂的 Duplex 服务）

• 高度自定义需求需手动扩展（如安全策略、签名）

---

八、结语

在当今 .NET 开发领域，如果你需要在 现代架构 中保留对传统 SOAP 协议的支持，SoapCore 是一个非常优秀的解决方案。它既保持了与 WCF 接口风格的兼容，又具备了 ASP.NET Core 的灵活性和扩展能力。

无论是为了兼容老系统，还是为特定合作方提供接口服务，SoapCore 都可以帮助你快速、安全地构建符合标准的 SOAP Web Service。

https://github.com/DigDes/SoapCore.git