如何自定义Anypoint API Manager标准SLA策略生成的错误消息

流程内添加错误处理器、配置全局默认错误处理器均不生效的根本原因是：Mule标准API策略的执行优先级高于应用层所有流逻辑和全局错误处理器。策略在请求进入应用业务流之前就完成校验，校验失败时默认直接在策略层构造默认响应返回，异常不会向下传递到应用的错误处理链路。Studio调试模式下能看到对应异常，是调试功能对全链路异常做了追踪，不代表异常会流入应用层处理分支。

以下两种方案均无需开发自定义策略，可直接复用现有SLA Rate Limit标准策略，仅覆盖指定错误类型的响应内容：

方案1：通过API Manager策略配置直接修改（推荐，CloudHub部署适配最优） #

Mule 4.4配套的SLA Rate Limit、Client ID Enforcement标准策略原生支持自定义错误响应，无需修改应用代码：

• 进入API Manager对应API实例的策略配置页，找到已绑定的SLA Rate Limit策略
• 展开Advanced配置项，定位到Client ID校验相关的错误响应配置段
• 针对INVALID_CREDENTIALS错误类型，直接填写需要的自定义响应状态码、响应头、响应体
• 保存配置后策略会自动热更新到CloudHub上运行的应用，无需重新部署

说明：如果SLA策略与Client ID Enforcement策略是分开绑定的，认证类错误由Client ID Enforcement模块抛出，需要在Client ID Enforcement策略的高级配置中修改对应错误响应。

方案2：应用层全局错误处理器拦截（适用于需要动态响应内容的场景） #

如果自定义响应需要携带动态内容（如请求ID、动态错误码），需要先调整策略配置开放异常传递，再通过错误处理器处理：

1. 编辑已绑定的SLA/Client ID Enforcement策略，在高级配置中关闭Propagate policy error response选项。该选项默认开启，开启状态下策略会直接返回默认响应，不会将异常抛给应用层
2. 关闭该选项后，策略校验失败抛出的CLIENT-ID-ENFORCEMENT:*类型错误会正常流入应用错误处理链路，此前配置的全局错误处理器即可生效
3. 修正原有错误处理器配置：将on-error-propagate替换为on-error-continue。on-error-propagate会将异常继续向上抛出，最终会被Mule默认错误处理器覆盖响应内容。修正后的配置参考：

<configuration doc:name="Configuration" doc:id="7a7e22cd-2ee7-42ee-af15-eaf2693d72d9" defaultErrorHandler-ref="apiErrorHandler" />
<error-handler name="apiErrorHandler">
    <on-error-continue enableNotifications="true" logException="true" type="CLIENT-ID-ENFORCEMENT:INVALID_CREDENTIALS">
        <ee:transform xmlns:ee="http://www.mulesoft.org/schema/mule/ee/core" xsi:schemaLocation="http://www.mulesoft.org/schema/mule/ee/core http://www.mulesoft.org/schema/mule/ee/core/current/mule-ee.xsd">
            <ee:message>
                <ee:set-payload><![CDATA[%dw 2.0
output application/json
---
{
    "code": 401,
    "message": "Unauthorised",
    "requestId": correlationId
}]]></ee:set-payload>
            </ee:message>
            <ee:variables>
                <ee:set-variable variableName="httpStatus">401</ee:set-variable>
            </ee:variables>
        </ee:transform>
        <http:listener-response-builder doc:name="Listener Response Builder" statusCode="#[vars.httpStatus]"/>
    </on-error-continue>
    <on-error-propagate type="ANY">
        <logger level="ERROR" message="Unhandled error: #[error.description]"/>
    </on-error-propagate>
</error-handler>

• 不要在APIKit流级错误处理器中添加策略类错误的处理逻辑：流级错误处理器仅在请求进入APIKit路由流之后才会触发，策略校验失败时请求尚未进入业务流，永远无法命中流级处理分支
• 使用方案2时必须手动设置正确的HTTP响应状态码，否则错误响应会默认返回200状态码，不符合接口规范

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