如何在WSO2 MI的Payload Factory中移除Header/Body的默认命名空间

开发者阿泽

2026-7-12

解决WSO2 MI Payload Factory中Header/Body元素自动添加Synapse命名空间的问题

问题原因

Header和Body是WSO2 Synapse（Micro Integrator基于Synapse构建）的内置保留元素名，当你在Payload Factory的XML格式模板中直接使用这两个标签时，Synapse会自动将它们关联到自身的命名空间http://ws.apache.org/ns/synapse。

解决方案

方案1：强制指定空命名空间

在模板中的自定义Header和Body标签上添加xmlns=""，明确声明这些元素属于无命名空间，覆盖Synapse的默认行为。修改后的完整配置如下：

<payloadFactory media-type="xml">
  <format>
    <soapenv:Envelope xmlns:chan="http://www.tibco.com/ChangeSubOfferingAPI/" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
      <soapenv:Header/>
      <soapenv:Body>
        <chan:ChangeSubOfferingRqsAPI>
          <Header xmlns="">
            <Username>$1</Username>
          </Header>
          <Body xmlns="">
            <SerialNo>$2</SerialNo>
          </Body>
        </chan:ChangeSubOfferingRqsAPI>
      </soapenv:Body>
    </soapenv:Envelope>
  </format>
  <args>
    <arg evaluator="xml" expression="$ctx:userName"/>
    <arg evaluator="xml" expression="$ctx:password"/>
  </args>
</payloadFactory>

方案2：重命名自定义元素（若允许）

如果后端服务接受元素名修改，将自定义的Header和Body改为非保留名（比如RequestHeader、RequestBody），彻底避免与Synapse保留元素冲突。示例模板片段：

<chan:ChangeSubOfferingRqsAPI>
  <RequestHeader>
    <Username>$1</Username>
  </RequestHeader>
  <RequestBody>
    <SerialNo>$2</SerialNo>
  </RequestBody>
</chan:ChangeSubOfferingRqsAPI>