WSO2 APIM 4.4.0网关后端500错误自动重试配置咨询

方法一：利用端点内置故障容错重试 #

这是最直接的配置方式，无需自定义代码：

• 登录API Publisher，打开目标API的编辑页，切换到「Endpoints」标签
• 选中目标后端端点，点击「Advanced Options」
• 在「Fault Tolerance」模块找到「Retry Settings」：
  • 勾选「Enable Retry」
  • 设置「Retry Count」（例如3次）
  • 设置「Retry Delay」（例如1000ms，避免短时间过载后端）
  • 在「Retry On」输入框添加500（可同时添加502、503等其他需重试的状态码）
• 保存端点配置，重新发布API即可生效

方法二：自定义中介序列实现复杂重试逻辑 #

如果需要根据响应内容、特定头信息等自定义重试判断，可通过中介序列实现：

1. 在控制平面进入「Mediations」→「Sequences」，创建新序列，示例代码如下：

<sequence xmlns="http://ws.apache.org/ns/synapse" name="5xx-retry-sequence">
    <property name="RESPONSE" value="true"/>
    <!-- 仅对500错误触发重试 -->
    <filter source="$axis2:HTTP_SC" regex="500">
        <then>
            <property name="retry_count" scope="axis2" type="INTEGER" value="0"/>
            <!-- 最多重试3次 -->
            <loop>
                <break>
                    <source>$ctx:retry_count</source>
                    <comparator>gt</comparator>
                    <value>3</value>
                </break>
                <!-- 重新发送请求到后端 -->
                <send>
                    <endpoint key="YOUR_BACKEND_ENDPOINT_KEY"/> <!-- 替换为你的端点key -->
                </send>
                <!-- 递增重试计数 -->
                <property expression="$ctx:retry_count + 1" name="retry_count" scope="axis2" type="INTEGER"/>
                <!-- 若返回200则终止重试 -->
                <filter source="$axis2:HTTP_SC" regex="200">
                    <then>
                        <break/>
                    </then>
                </filter>
                <!-- 重试间隔1秒 -->
                <delay>
                    <duration>1000</duration>
                </delay>
            </loop>
        </then>
    </filter>
</sequence>

2. 回到目标API编辑页，在「Runtime Configurations」→「Sequences」中，将上述序列绑定到「Out Sequence」
3. 保存并重新发布API

关键注意点 #

• 仅对幂等请求（如GET、PUT）配置重试，避免POST等非幂等请求导致重复操作
• 重试次数和延迟需根据后端承载能力调整，防止引发服务雪崩
• 可通过网关wso2carbon.log日志中的Retry attempt关键字验证重试逻辑是否正常执行

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