如何在Postman中为集合内所有请求添加集合级统一请求头

方案1：配置集合级通用请求头（最简便，无需代码） #

• 打开Postman左侧Collections面板，找到目标集合，点击集合名称右侧的更多操作按钮（三个点图标），选择「Edit」
• （可选，方便后续统一维护密钥）在弹出的集合编辑窗口中切换到「Variables」标签，新增变量：
  • 变量名填x_apikey
  • 初始值、当前值都填写你持有的apikey明文
  • 点击保存变量
• 切换到同一编辑窗口的「Headers」标签，新增一条请求头配置：
  • 键填写x-apikey
  • 值填写{{x_apikey}}（如果没有提前配置变量，直接填写apikey明文即可）
  • 确保该条请求头右侧的启用勾选框处于选中状态
• 保存整个集合的配置即可。集合下所有未单独配置x-apikey头的请求，都会自动继承该集合级请求头，无需修改任何单个请求。

方案2：使用集合前置脚本（适合需要动态处理密钥的场景） #

如果后续有动态生成apikey、加判断逻辑等需求，可以通过前置脚本实现自动加头：

• 打开目标集合的编辑窗口，切换到「Pre-request Script」标签
• 输入以下脚本代码：

// 固定值写法
pm.request.headers.add({
  key: 'x-apikey',
  value: '你实际的apikey内容'
})

// 读取集合变量写法（提前配置好x_apikey变量时用）
// pm.request.headers.add({
//   key: 'x-apikey',
//   value: pm.variables.get('x_apikey')
// })

• 保存集合配置即可。该脚本会在集合下所有请求发送前自动执行，为请求添加上指定的x-apikey头。

注意：如果单个请求本身已经配置了同名的x-apikey头，Postman会优先使用请求本身配置的参数，不会被集合级配置覆盖，符合正常使用逻辑。

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