WSO2 API Manager 4.1.0网关修改SOAP请求属性顺序致错，如何强制保序？

问题背景 #

在WSO2 API Manager 4.1.0中将SOAP服务暴露为REST API后，调用API返回后端错误。排查发现网关在把JSON请求转换为SOAP XML时，修改了请求负载的属性顺序（如MessageHeader中的InitialRequestId和RequestId被调换），而后端服务对XML元素顺序敏感，因此引发错误。

解决方案 #

要强制网关保留JSON原有的属性顺序，需在目标API的**入站序列（In Sequence）**中添加特定配置：

• 登录WSO2 API Manager管理控制台，进入目标API的编辑页面
• 切换到Sequences标签页，找到In Sequence并点击编辑按钮
• 在序列的开头插入以下配置代码：

  <property name="JSON-PRESERVE-ORDER" value="true" scope="axis2" type="STRING"/>
  

• 保存序列并重新发布API

原理说明 #

WSO2网关默认使用无序映射结构（如HashMap）解析JSON数据，转换为XML时会打乱原属性顺序。JSON-PRESERVE-ORDER属性会告知Synapse引擎改用有序映射结构（如LinkedHashMap）处理JSON，确保生成的XML元素顺序与原始JSON的属性顺序完全一致。

验证方式 #

重新调用API后，检查网关转发给后端的SOAP XML请求，确认InitialRequestId和RequestId的顺序与原始JSON请求中的顺序一致即可。

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