WebService 對接疑難雜症：WSDL 差異導致 SOAP 錯誤排查指南

現象

Axis2 生成的 WSDL 與聯通提供的華為標準 WSDL 結構不一致，調用拋出 SOAP 錯誤。

排查清單

1. 對比關鍵差異：
   • targetNamespace、elementFormDefault 是否一致。
   • 複雜類型定義順序、sequence vs all。
   • 命名空間前綴映射（xmlns:tns、xmlns:ns1）。
   • SOAP Binding 風格：document/literal vs rpc/encoded。
2. 抓包分析：用 SoapUI 或 tcpdump 捕獲請求/響應 XML，定位具體違規元素。
3. 啟用 Axis2 線路日誌：

   log4j.logger.org.apache.axis2=DEBUG
   log4j.logger.httpclient.wire=DEBUG

4. 強制符合標準：
   • 手寫/調整 WSDL，用 wsdl2java 生成存根，而非依賴自動發布。
   • 設置 messageReceiver 手動構建符合標準的 SOAP Body。
5. 諮詢對方技術支持：提供雙方 WSDL 差異截圖，確認必填字段、枚舉值、加密簽名要求。

常見華為標準要求

• Header 必須包含 TransactionID、Timestamp、Signature。
• Body 統一採用 document/literal/wrapped。
• 日期格式 yyyy-MM-dd'T'HH:mm:ss.SSSZ。
• 所有字符串字段 minOccurs="0" nillable="true"。

最佳實踐

• 採用 Contract-First：先定 WSDL，再生成代碼，雙方以 WSDL 為準。
• 建立自動化契約測試（Pact/Schemathesis），CI 中驗證雙向兼容。
• 保留原始報文存證，便於爭議溯源。