WSO2 Integration Studio调用大数据量API端点时脚本引擎报错

核心问题定位 #

报错java.lang.IllegalArgumentException: out of range index主要来自两个方面：

• Script Mediator的错误用法：代码中mc.setPayloadJSON(JSON.stringify(buildings))是错误操作——setPayloadJSON方法需要传入JSON对象，而非JSON字符串，大数据量下这种错误转换会触发索引越界异常。
• 脚本引擎内存限制：WSO2默认的Nashorn JavaScript引擎对大对象的处理有内存阈值，当返回数据接近1000条时，超出了默认内存限制。

修复步骤 #

1. 修正Script Mediator的错误代码 #

原脚本中var buildings = mc.getPayloadJSON(); mc.setPayloadJSON(JSON.stringify(buildings));完全是多余且错误的操作，直接删除整个Script Mediator即可——调用API后已经是JSON payload，不需要额外转换。

修改后的inSequence：

<inSequence>
    <call>
        <endpoint>
            <http method="get" uri-template="http://localhost/entities?type=Building&amp;limit=800">
                <suspendOnFailure>
                    <initialDuration>-1</initialDuration>
                    <progressionFactor>-1</progressionFactor>
                    <maximumDuration>0</maximumDuration>
                </suspendOnFailure>
                <markForSuspension>
                    <retriesBeforeSuspension>0</retriesBeforeSuspension>
                </markForSuspension>
            </http>
        </endpoint>
    </call>
    <property name="messageType" scope="axis2" type="STRING" value="application/json"/>
    <jsontransform description="Json Convert">
        <property name="synapse.commons.json.output.autoPrimitive" value="true"/>
        <property name="synapse.commons.enableXmlNullForEmptyElement" value="false"/>
    </jsontransform>
    <respond/>
</inSequence>

2. 调整脚本引擎内存配置（若仍需使用Script Mediator处理数据） #

如果确实需要用Script Mediator处理大数据，需修改WSO2的axis2.xml文件（位于<EI_HOME>/conf/axis2/目录），增加Nashorn引擎的内存限制：

<parameter name="nashorn.args">--no-deprecation-warning -Xmx1024m</parameter>

在<axisconfig>标签内添加上述参数，将内存调整为1024MB（可根据实际情况调整）。

3. 分批处理数据（极端大数据场景） #

如果API支持分页参数（比如offset），可以通过循环分批获取数据，再合并结果，避免一次性加载大量数据到内存：

• 先调用API获取总条数
• 循环调用API，每次取500条，直到获取全部数据
• 在Sequence中用Aggregate Mediator合并分批结果

额外优化建议 #

• 避免在Script Mediator中处理超大JSON对象，优先使用WSO2原生Mediator（比如Filter、Aggregate、PayloadFactory）处理数据，性能和稳定性更好。
• 检查jsontransform Mediator的配置，确保不会对大数据量造成额外解析负担。

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