Apigee代理XML-to-JSON策略无报错但未完成转换问题

问题背景 #

使用Apigee代理对接第三方SOAP端点，将其转换为RESTful JSON API。PreFlow配置如下：

<PreFlow name="PreFlow">
    <Request>
        <Step>
            <Name>JSON-to-XML</Name>
        </Step>
        <Step>
            <Name>XSL-Zoot-buildSoap</Name>
        </Step>
    </Request>
    <Response>
        <Step>
            <Name>XML-to-JSON</Name>
        </Step>
    </Response>
</PreFlow>

请求侧的JSON转XML、自定义XSLT构建SOAP请求功能正常，但响应侧的XML-to-JSON策略未生效。该策略配置如下：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<XMLToJSON async="false" continueOnError="false" enabled="true" name="XML-to-JSON">
    <DisplayName>XML to JSON</DisplayName>
    <Options>
        <RecognizeNumber>true</RecognizeNumber>
        <RecognizeBoolean>true</RecognizeBoolean>
        <RecognizeNull>true</RecognizeNull>
        <TextNodeName>TEXT</TextNodeName>
        <AttributePrefix>@</AttributePrefix>
        <StripLevels>2</StripLevels>
    </Options>
    <OutputVariable>response</OutputVariable>
    <Source>response</Source>
</XMLToJSON>

调试确认策略已执行且无报错，但响应内容未发生任何转换。

可能的原因及解决方案 #

1. 源变量内容不符预期 #

• 确认<Source>指定的response变量是否包含完整的SOAP响应XML。SOAP响应通常被包裹在soap:Envelope/soap:Body节点中，若response变量并非原始XML（比如已被提前处理），会导致策略无有效内容可转换。
• 解决：在调试会话中查看response变量的实际值，确认是原始SOAP XML；若XML存放在其他变量（如message.content），修改策略的<Source>为对应变量。

2. StripLevels配置不合理 #

• 当前设置<StripLevels>2</StripLevels>会移除XML最外层的2级节点。如果SOAP响应的有效数据结构刚好因层级移除被破坏，会出现转换后无内容或结果不符合预期的情况。
• 解决：先将StripLevels改为0测试转换是否生效，再根据实际XML结构调整层级数。比如SOAP结构为<Envelope><Body><Data>...</Data></Body></Envelope>，StripLevels=2会保留Data节点内容，但若Data节点结构特殊，需调整层级或配合XSLT预处理。

3. 输出变量被后续流程覆盖 #

• 策略将转换结果输出到response变量，若后续Flow或PostFlow中有其他策略（如AssignMessage）修改了response变量，会覆盖XML-to-JSON的转换结果。
• 解决：将<OutputVariable>改为临时变量（如json_response），再通过后续步骤把临时变量的值赋值给response；检查所有响应流阶段，确保XML-to-JSON是最后执行的内容修改策略。

4. XML命名空间干扰转换 #

• SOAP响应通常带有命名空间，XML-to-JSON策略对带命名空间的节点可能处理异常，导致转换无效果。
• 解决：在XML-to-JSON策略前添加XSLT预处理，移除XML中的命名空间，示例XSLT片段：

<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
    <xsl:output method="xml" indent="yes"/>
    <xsl:template match="*">
        <xsl:element name="{local-name()}">
            <xsl:apply-templates select="@* | node()"/>
        </xsl:element>
    </xsl:template>
    <xsl:template match="@*">
        <xsl:attribute name="{local-name()}">
            <xsl:value-of select="."/>
        </xsl:attribute>
    </xsl:template>
</xsl:stylesheet>

5. 策略执行顺序错误 #

• 若响应流中存在其他策略在XML-to-JSON之后执行，且这些策略修改了响应内容，会直接覆盖转换结果。
• 解决：调整响应流的策略顺序，确保XML-to-JSON是最后执行的内容修改操作；检查PostFlow中是否有影响响应的配置。

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