测试CIF修改：请求JSON反序列化失败及相关问题咨询

问题现象 #

1. CustMod接口报错 #

调用Customer/CustMod接口时收到服务端错误，错误详情如下：

{
  "Description": "Unable to successfully complete requested action.  See detail section for more information in the standard jXchange fault format.",
  "MessageSource": "Service Gateway",
  "Details": [
    {
      "Code": "225",
      "Category": "Error",
      "Description": "Invalid CIF number",
      "Element": "CustId",
      "ElementValue": "       0",
      "Location": "CFCUSTMOD"
    }
  ]
}

实际发送的JSON请求（遵循SOAP对象结构，已替换为虚构CIF）：

{
  "CustModRq": {
    "ActIntentKey": null,
    "CustDetail": {
      "AnnIncmAmt": "15000",
      "AssetTotAmt": null,
      "BirthDt": null,
      "CustCrtRsnCode": null,
      "Custom": null,
      "CustOrgDt": null,
      "CustType": null,
      "Deceased": null,
      "DeceasedDt": null,
      "EducLvl": null,
      "EmplName": null,
      "EmplTitle": "jXchange Guru",
      "Gender": null,
      "HouseHoldName": null,
      "HouseHoldNum": null,
      "LastConDt": null,
      "LastMainDt": null,
      "NAICSCode": null,
      "OccType": null,
      "StdIndustCode": null
    },
    "CustId": "L012345",
    "Dlt": null,
    "MsgRqHdr": {
      "AuthenProdCred": "",
      "AuthenUsrCred": null,
      "jXchangeHdr": {
        "AuditUsrId": "Test",
        "AuditWsId": "Test",
        "AuthenUsrId": null,
        ...
      }
    }
  }
}

服务端接收的CustId值为" 0"，而非发送的"L012345"，推测存在JSON到SOAP的反序列化/转换问题。

2. 客户搜索时MaxRec不生效 #

设置MaxRec为100时，服务端无法识别该参数，导致搜索功能异常。

使用环境：Mulesoft JSON实现，遵循SOAP对象结构。

排查方向 #

针对CustId反序列化错误 #

• 字段映射验证：
  • 核对jXchange WSDL中CustModRq的结构，确认CustId的层级、字段名（含大小写）是否与JSON请求完全匹配。jXchange接口通常严格区分字段大小写，若JSON中字段名与WSDL定义不一致（如CustID vs CustId），转换器会忽略该字段并填充默认值0。
  • 检查Mulesoft的JSON-to-SOAP转换器配置，确认CustId字段已正确映射到SOAP报文的对应元素，未被自定义转换规则覆盖或过滤。
• 命名空间配置：
  SOAP元素可能关联特定命名空间，若JSON请求未通过转换器指定正确的命名空间，服务端会无法识别CustId字段，转而使用默认值。需确认Mulesoft转换器是否配置了WSDL中要求的命名空间。
• 报文抓包验证：
  用抓包工具捕获Mulesoft实际发送到服务端的SOAP报文，确认CustId的实际值和位置是否与预期一致——若SOAP报文中CustId确实为0，则问题出在Mulesoft的JSON转SOAP转换环节。

针对MaxRec不识别问题 #

• 字段名与数据类型检查：
  核对WSDL中搜索请求的参数定义：
  • 确认参数名称是否为MaxRec（部分jXchange版本中可能为MaxRecs或MaxRecords）；
  • 确认参数类型为数值型，若发送的是字符串"100"而非数字100，服务端会无法解析。
• 层级位置验证：
  确认MaxRec是否放置在搜索请求的正确节点下（如部分接口要求MaxRec位于MsgRqHdr而非请求体根节点）。
• 转换器配置检查：
  检查Mulesoft转换器是否允许传递该参数，未被配置为忽略未知字段或过滤特定参数。

通用排查点 #

• SOAP文档有效性：
  确认使用的WSDL为服务端当前生效的版本，旧文档的字段结构可能与服务端实际实现不匹配，导致参数无法识别。
• 空值处理规则：
  Mulesoft转换器可能对空值字段有特殊处理规则，若CustId的传递方式触发了空值默认填充逻辑，需调整转换器的空值处理配置。

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