概述

自定义响应头策略用于在网关将后端响应返回给客户端之前，向响应中追加额外的 Header 字段。

重要

自定义响应头仅当请求成功（响应状态码为 200）时才会注入。当后端返回 4xx / 5xx 等非成功状态码时，自定义响应头不会生效，请勿用于异常场景的标识或排查信息。

适用场景

下列场景下推荐配置自定义响应头：

• 配合跨域策略暴露自定义 Header：网关或后端注入了业务自定义 Header（如 X-Trace-Id），需要让浏览器跨域时也能读取，可同时配置「跨域策略」中的 expose_headers 与本策略。
• 统一注入安全相关 Header：例如向所有响应附加 X-Content-Type-Options: nosniff、X-Frame-Options: DENY 等安全标识，无需后端逐个接口改造。
• 标记网关侧处理信息：在响应中添加网关版本、节点编号、限流状态等元信息，便于客户端或前端识别请求经过了哪个网关链路。
• 配合前端调试或日志埋点：临时为响应附带调试用的标识（如灰度版本号），帮助前端在浏览器开发者工具中快速判断当前响应来自哪条灰度链路。

操作步骤

1. 登录百度智能云 AI 原生网关控制台。
2. 在顶部导航栏选择目标地域，并在实例列表中单击目标实例 ID，进入实例详情页。
3. 在左侧导航栏选择 AI 服务 > 模型推理服务。

4. 创建或编辑一个模型推理服务：

   • 创建场景：单击列表上方的 创建推理服务。
   • 编辑场景：在目标服务的操作列单击 编辑。
5. 滚动到页面底部的 高级策略 模块，在 自定义响应 下勾选 开启自定义响应头。

6. 在 自定义响应头 中单击 添加 逐条配置 Header：

   配置项	说明
   Key	Header 字段名。建议遵循 HTTP Header 命名规范，使用英文字母、数字与短横线（-）。
   Value	Header 字段值，按业务需要填写。

7. 如需删除某条 Header，单击对应行右侧的 删除（至少保留 1 条）。
8. 配置完成后，单击页面底部的 发布，策略发布后即时生效。