概述

自定义请求头策略用于在网关将请求转发到后端服务之前，向请求中注入额外的 Header 字段。

重要

自定义请求头采用覆盖式写入：

• 若客户端请求中未携带对应 Key，则在转发前向请求中新增该 Header。
• 若客户端请求中已携带同名 Key，则该 Header 的值会被网关侧配置的值覆盖，客户端原始值不会到达后端。

配置前请确认是否会与客户端已有 Header 冲突，避免覆盖业务关键字段。

适用场景

下列场景下推荐配置自定义请求头：

• 向后端注入业务标识：在请求转发到后端时统一附加业务来源、租户标识、产品线编码等元信息，便于后端区分流量来源做差异化处理。
• 在网关层注入鉴权 / 调用链字段：例如向后端补充网关签发的内部 token、服务间调用的 trace-id 等字段，避免每个客户端各自实现。
• 统一头部配置、解耦客户端与后端：当后端要求所有请求必须携带某个 Header（如版本号、协议标识）但客户端无法逐一改造时，可在网关层统一注入。
• 临时调试或 A/B 测试标记：在某条模型推理服务上临时打上特定 Header（如 X-Experiment: variant-A），让后端按该 Header 走不同逻辑，无需改动客户端代码。
• 强制覆写客户端 Header：当不信任客户端传入的某些 Header（如租户标识、调用方身份）时，可在网关层用配置值强制覆盖，防止客户端伪造。

操作步骤

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

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

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

6. 在 请求头列表 中单击 添加 逐条配置 Header：

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

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