部署至Azure的WCF服务调用返回404，但可获取服务定义的排查咨询

API 探路者

2026-5-13

我之前也踩过WCF部署到Azure App Service后调用404的坑，结合你的情况，梳理了几个可能的原因和排查方向：

可能的原因分析

端点配置不匹配：本地调试时的端点配置（比如基地址、协议）和Azure生产环境不兼容。比如本地用HTTP，Azure默认强制HTTPS，而服务端没配置HTTPS的绑定规则；或者基地址还是localhost，导致客户端请求的地址和服务实际监听的地址不匹配。
路由规则冲突：Azure App Service的IIS环境和本地IIS Express有差异，可能web.config里缺少WCF路由处理的配置，或者URL重写规则（比如HTTP转HTTPS的重写）干扰了SOAP请求的路由，导致请求无法到达WCF服务。
基地址设置错误：web.config中<service>节点下的<baseAddresses>如果还是本地的地址，部署后没有更新为Azure的域名，会导致服务的实际访问路径和客户端调用的路径不一致，虽然能获取WSDL，但调用时找不到对应的端点。
HTTPS安全配置缺失：Azure App Service默认使用HTTPS，而如果WCF服务的binding没有配置security mode="Transport"，或者客户端没有适配HTTPS的调用方式，就会导致请求被拒绝或无法找到端点。

进一步排查建议

对比本地和Azure的web.config：重点检查<endpoint>和<baseAddresses>的配置，确保address、binding、contract正确，基地址更新为https://<mydeployment>.azurewebsites.net，HTTPS场景下要配置binding的security模式：
```
<bindings>
  <wsHttpBinding>
    <binding name="SecureWsHttpBinding">
      <security mode="Transport">
        <transport clientCredentialType="None"/>
      </security>
    </binding>
  </wsHttpBinding>
</bindings>
```

启用WCF详细日志：在web.config中添加日志配置，捕获请求的详细过程，方便定位问题：

<system.diagnostics>
  <sources>
    <source name="System.ServiceModel" switchValue="Information, ActivityTracing" propagateActivity="true">
      <listeners>
        <add name="traceListener" type="System.Diagnostics.XmlWriterTraceListener" initializeData="D:\home\site\wwwroot\logs\Traces.svclog"/>
      </listeners>
    </source>
  </sources>
</system.diagnostics>

然后通过Azure App Service的日志流或者下载日志文件，查看请求是否到达服务端，以及具体的错误细节。

用Postman测试SOAP请求：直接构造SOAP请求发送到服务地址，比如POST到https://<mydeployment>.azurewebsites.net/<myservice>，请求体示例：

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/">
  <soap:Body>
    <tem:YourTestMethod>
      <tem:InputParam>TestValue</tem:InputParam>
    </tem:YourTestMethod>
  </soap:Body>
</soap:Envelope>

这样可以排除客户端测试工具的问题，直接看服务端的响应。

检查Azure App Service的配置：在Azure门户中，确认App Service的.NET版本和本地一致，同时检查是否启用了ARR Affinity（虽然一般不影响，但偶尔会导致路由问题），另外确保web.config中添加了WCF的模块配置：

<system.webServer>
  <modules runAllManagedModulesForAllRequests="true">
    <add name="ServiceModel" type="System.ServiceModel.Activation.HttpModule, System.ServiceModel, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" preCondition="managedHandler" />
  </modules>
</system.webServer>

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