PHP客户端向Java SOAP服务传递Creator对象数组的传参问题解决

一、Java端JAX-WS注解合规性校验 #

• 现有标注的核心问题：单独使用@WebParam(name="creator")标注ArrayList<Creator>参数时，JAX-WS默认生成的XML结构无法满足跨语言解析要求——缺少集合类参数必需的包裹层定义，会导致服务端解析时出现节点匹配偏移，最终读取到空的Creator集合。
• 合规的接口参数标注参考：

  @WebService
  public class MetadataService {
      @WebMethod
      public String createMetadata(
          @WebParam(name = "identifier") String identifier,
          @WebParam(name = "publishYear") int publishYear,
          // 集合参数需同时配置WebParam、XmlElementWrapper、XmlElement三个注解
          @WebParam(name = "creatorParam")
          @XmlElementWrapper(name = "creatorList")
          @XmlElement(name = "creator", type = Creator.class)
          List<Creator> creators
      ) {
          // 原有遍历拼接业务逻辑无需修改
          return String.join(";", creators.stream().map(Creator::getFullName).toList());
      }
  }
  

• Creator实体类的强制要求：类上必须标注@XmlRootElement，所有参与序列化的字段必须配置公开的无参构造方法、对应的getter/setter，不存在未定义映射的私有字段——否则即便节点匹配成功，JAXB也会因字段访问权限问题读取到空对象。
• 必做排查步骤：使用wsgen工具生成标准WSDL文件，核对WSDL中creator相关的schema定义，确认参数名、包裹节点名、元素名、命名空间和实际请求的节点完全匹配，90%以上的解析失败都来源于节点命名或命名空间不匹配。

二、PHP端原生SoapClient的对象数组构造方法 #

• 常见错误写法：直接将实例化的Creator对象放入索引数组，直接作为方法入参传入——这种写法生成的XML缺少外层包裹节点，会被JAXB解析逻辑直接过滤，出现其余参数正常、Creator集合为空的现象。
• 正确构造流程：
  1. 按照WSDL中定义的Creator结构生成单个对象实例，字段名必须和WSDL定义的元素名完全一致（区分大小写）：

     // 单个Creator对象结构匹配WSDL定义
     $creatorA = new stdClass();
     $creatorA->givenName = "三";
     $creatorA->familyName = "张";
     $creatorB = new stdClass();
     $creatorB->givenName = "四";
     $creatorB->familyName = "李";
     

  2. 构造和Java端@WebParam名称一一对应的顶级参数对象，将Creator数组作为对应参数的属性值传入：

     $requestParams = new stdClass();
     $requestParams->identifier = "ISBN978-7-111-00000-0";
     $requestParams->publishYear = 2024;
     // 属性名和Java端@WebParam(name = "creatorParam")完全一致
     $requestParams->creatorParam = [
         $creatorA,
         $creatorB
     ];
     

  3. 调用接口时直接传入构造好的$requestParams对象，不要额外嵌套数组层。
• 调试技巧：初始化SoapClient时开启trace调试参数，调用完成后通过__getLastRequest()方法打印实际发送的XML报文，对比WSDL的schema结构逐节点核对，确认所有节点都带有正确的命名空间声明。

三、跨语言对象数组传递的常见踩坑点 #

• 不要依赖PHP SoapClient的自动参数匹配：直接将数组作为方法参数传入时，PHP会自动生成不带命名空间的平铺节点，即便节点名称匹配，也会因命名空间不匹配被JAXB直接丢弃，导致集合内容为空。
• 单对象可正常传递、数组解析为空的典型成因：Java端缺少@XmlElementWrapper注解，服务端期待的结构是“外层包裹节点下嵌套多个Creator子节点”，但PHP端生成的是平铺的多个Creator节点，触发JAXB的解析容错逻辑，直接返回空集合。
• 链路验证：可以先构造符合WSDL结构的XML报文，通过curl直接发送到SOAP端点，确认Java端的解析逻辑本身可正常识别Creator节点，再反向调整PHP端的参数组装逻辑，避免双向排查的无效消耗。

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