Magento 1.9.3.3相关SOAP及C#对接通信异常问题求助

我来帮你梳理下这两个问题的解决方案，都是Magento 1.9和C# SOAP集成中很容易踩的坑：

一、SOAP-ERROR: Parsing WSDL: Couldn't load from 错误 #

这个错误本质是PHP端无法正确加载或生成SOAP WSDL文件，常见原因和解决方法如下：

• 确认WSDL地址的正确性
  Magento 1.9的SOAP V2服务WSDL地址必须是：http(s)://你的Magento域名/api/v2_soap/?wsdl，先直接在浏览器访问这个地址，看是否能正常返回XML格式的WSDL内容。如果浏览器都打不开，先排查Magento的SOAP服务是否启用（后台系统 > 配置 > 服务 > SOAP/XML-RPC里确认SOAP V2已启用）。

• 禁用SOAP WSDL缓存
  PHP默认会缓存WSDL文件，有时候缓存过期或损坏会导致加载失败。可以临时修改PHP配置：

  soap.wsdl_cache_enabled = 0
  

  或者在调用SOAP的PHP代码里临时禁用：

  ini_set("soap.wsdl_cache_enabled", "0");
  

• 检查服务器文件权限
  Magento生成WSDL时需要写入var/目录下的缓存文件，确保var/及其子目录有服务器进程的写入权限（一般设置为755或777，根据服务器配置调整）。

• HTTPS证书问题（如果用HTTPS）
  如果你的Magento用的是HTTPS，要确保服务器SSL证书是有效的，没有过期或不被信任。如果是测试环境的自签名证书，可能需要在PHP里跳过证书验证（生产环境不建议）：

  $context = stream_context_create([
      'ssl' => [
          'verify_peer' => false,
          'verify_peer_name' => false
      ]
  ]);
  $client = new SoapClient($wsdlUrl, ['stream_context' => $context]);
  

二、System.ServiceModel.CommunicationException: 'Unrecognized message version.' 错误 #

这个错误是C#客户端发送的SOAP消息版本和Magento服务端不兼容导致的，结合你给出的app.config片段，重点检查以下几点：

• 匹配Security Mode与Magento服务协议
  你配置了<security mode="Transport">，这意味着客户端会用HTTPS发送请求，但如果你的Magento服务实际是HTTP协议，就会出现版本不匹配的问题。

  • 如果Magento用HTTP：把security mode改成None，完整配置示例：

    <basicHttpBinding>
      <binding name="httpBinding" maxReceivedMessageSize="2147483647">
        <security mode="None">
          <transport clientCredentialType="None"/>
        </security>
      </binding>
    </basicHttpBinding>
    

  • 如果Magento用HTTPS：确保endpoint的address是https开头，并且服务器证书能被客户端信任（测试环境可以在配置里跳过验证，但生产环境必须用有效证书）。

• 确保使用SOAP 1.1版本
  Magento 1.9的SOAP V2只支持SOAP 1.1，而BasicHttpBinding默认就是SOAP 1.1，不要手动改成SOAP 1.2（比如用WSHttpBinding就会用SOAP 1.2，这和Magento不兼容）。

• 检查端点配置的完整性
  确保你的endpoint配置正确关联了binding，比如：

  <client>
    <endpoint address="http://你的Magento域名/api/v2_soap/"
              binding="basicHttpBinding"
              bindingConfiguration="httpBinding"
              contract="你的服务契约名称"/>
  </client>
  

  注意address不要带?wsdl后缀，那是用来获取WSDL的，实际请求地址是/api/v2_soap/。

• 重新生成代理类
  如果之前是用错误的WSDL生成的代理类，可能配置已经混乱。建议删除旧的服务引用，重新用正确的WSDL地址（http(s)://你的Magento域名/api/v2_soap/?wsdl）生成新的代理类，这样Visual Studio会自动生成匹配的binding配置。

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