1. 了解优先级
Gateway 插件策略按以下顺序解析:- 工作区默认值
- 预设默认值
- 请求级插件
2. 设置工作区默认值
如果要让某个工作区默认对结构化 JSON 请求启用响应修复,请在路由设置中配置工作区默认值。 适合在此处配置:- 通用运行默认值
- 共享的 API 密钥行为
- 避免不同服务之间出现偏差
3. 策略不可协商时将其锁定
如果某个工作区必须始终启用响应修复,请锁定该默认值。 锁定工作区默认值后:- 预设无法将其禁用
- 请求正文无法将其禁用
- 日志仍会显示插件是已应用、已跳过还是失败
4. 使用预设设置工作流专属默认值
如果一组请求需要同时包含以下内容,预设是合适的配置层:- 结构化输出设置
- 响应修复插件默认值
safe用于范围受限的语法清理strict用于仅移除外层包装的行为
5. 仅在工作区允许时按请求覆盖
如果工作区默认值未锁定,请求仍可直接覆盖插件配置:请求示例
6. 在日志中验证行为
发送一次请求后,检查请求详情并确认:plugin_executions包含response-healing- 状态为以下之一:
appliedskippedfailed
- 可以查看最终生效的插件模式
- 架构验证拒绝修复后的候选内容时,会显示验证错误
7. 服务间行为不一致时的处理方法
如果两个服务的行为不同,请比较:- 工作区路由设置
- 预设插件默认值
- 请求级
plugins - 工作区默认值是否已锁定