ServiceStack 5.11 如何在单元测试中校验WSDL是否发生变更

方案可行性 #

该方案完全可行，属于接口契约测试的轻量落地实现，能够第一时间捕获未预期的WSDL契约变更，避免下游SOAP客户端调用出错，实现成本低、逻辑清晰，适配ServiceStack 5.11版本的原生能力。

具体实现步骤 #

• 第一步：准备基准WSDL文件
  首次落地时先正常启动ServiceStack服务，访问/soap11或/soap12元数据路径，将返回的WSDL内容保存为baseline.wsdl，存储到单元测试项目的同级目录下，同时在文件属性中设置「复制到输出目录」为「如果较新则复制」，确保单元测试运行时可以正常读取到该文件。
• 第二步：单元测试内启动轻量化AppHost
  ServiceStack支持在测试进程内直接启动无需外部容器的测试宿主，初始化示例代码如下：

// 替换为你项目中继承自AppHostBase的实际AppHost类
var appHost = new MyServiceAppHost()
    // 注册服务所在程序集
    .Init()
    .Start("http://localhost:9898/"); // 使用本地空闲端口即可

• 第三步：请求获取最新生成的WSDL内容
  在测试逻辑中用HttpClient请求对应SOAP端点的元数据地址，拿到实时生成的WSDL：

using var httpClient = new HttpClient();
string latestWsdl = await httpClient.GetStringAsync("http://localhost:9898/soap11");

• 第四步：内容对比触发测试结果
  读取本地基准WSDL，和实时生成的WSDL做对比，可先预处理移除不影响契约的动态内容（比如WSDL中的生成时间戳、本地服务地址字段）避免误判，内容不一致直接断言失败：

string baselineWsdl = await File.ReadAllTextAsync("baseline.wsdl");

// 可选预处理逻辑：替换两个WSDL中的动态无关内容，比如：
// latestWsdl = Regex.Replace(latestWsdl, @"<wsdl:documentation>.*?</wsdl:documentation>", string.Empty);
// baselineWsdl = Regex.Replace(baselineWsdl, @"<wsdl:documentation>.*?</wsdl:documentation>", string.Empty);

if (latestWsdl != baselineWsdl)
{
    Assert.Fail("WSDL契约发生未预期变更，请确认变更合理性后更新基准WSDL文件");
}

// 测试结束释放AppHost资源
appHost.Dispose();

补充说明：当服务契约需要正常迭代变更时，只需重新生成WSDL覆盖本地的baseline.wsdl基准文件即可，后续测试会以新契约作为校验标准。

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