请求头

请求头用于给方法调用补充上下文信息，例如鉴权 Token、租户标识、语言、灰度标识、请求来源等。DebugTools 支持在方法级、连接级和项目级三个层级配置 Header，最终发起调用时会合并后发送到目标 JVM。

三种设置方法

方法级

方法级 Header 在方法调用页的 请求头 页签中填写，只作用于当前方法调用页。

设置请求头

每一行是一组 Header 键值：

• 勾选启用后，这一行才会参与本次方法调用。
• Key 填 Header 名，例如 Authorization、X-Tenant-Id、Accept-Language。
• Value 填 Header 值，例如 Bearer token、tenant-a。
• 输入 Header 名时，编辑器会提示常见 HTTP Header，并展示每个 Header 的说明，选中后会自动写入当前单元格。
• 同一个方法需要长期复用这些 Header 时，点击工具栏中的 保存到方法参数缓存。下次打开同一方法时会自动恢复。

方法级适合临时调试、单个接口差异、覆盖连接级或项目级默认值。例如同一个应用里只有某个方法需要切换租户，就把 X-Tenant-Id 写在方法级。

编辑工具栏

请求头表格上方的工具栏用于维护当前页签里的 Header：

按钮	作用
	新增一行 Header，默认启用。
	清空当前页签里的所有 Header 行。
	放弃当前编辑内容，重新加载默认 Header。方法调用页中会回到项目级 Header 默认值；连接级或项目级弹窗中会回到对应已保存值。
	保存当前已启用的 Header。方法调用页中配合工具栏保存请求参数使用；连接级或项目级弹窗中会保存到对应层级。
	在表格模式和文本模式之间切换。

表格首列的复选框用于控制单行是否启用，点击表头复选框可以批量启用或禁用所有行。每行操作列中的移除按钮只删除当前行。

点击 后，请求头会切换为文本模式，便于直接粘贴或批量编辑：

文本模式每行使用 Key: Value 格式。行首加 # 表示该 Header 禁用，例如 #Authorization: Bearer token 会转换成未勾选的 Header 行；再次点击 会把文本内容转换回表格。

连接级

连接级 Header 在连接管理页的单个连接卡片上配置，只作用于当前连接。

在连接卡片点击 打开 Header 配置弹窗，保存后该连接下的所有方法调用都会默认携带这些 Header。展开连接卡片后，也可以在详情区域查看当前连接已经保存的 Header。

连接级适合按应用、环境或实例区分的固定上下文，例如：

• 测试环境应用固定使用 X-Env: test。
• 某个租户应用固定使用 X-Tenant-Id: tenant-a。
• 同一个 IDEA 项目同时连接多个应用时，每个连接分别保存自己的鉴权或环境 Header。

TIP

连接级 Header 跟随连接记录内存保存。

项目级

项目级 Header 在连接管理页工具栏的 入口配置。页面按钮显示为 全局 Header，但作用范围是当前 IDEA 项目里的 DebugTools 调用默认 Header。

保存后，当前项目中所有连接、所有方法调用都会默认携带这些 Header。项目级适合真正通用的默认值，例如：

• 所有调试调用都需要的 User-Agent。
• 当前项目统一的基础鉴权 Header。
• 所有服务都一致的语言、渠道或来源标识。

WARNING

项目级 Header 影响范围最大。如果同一个 IDEA 项目同时连接多个应用，且不同应用的鉴权、租户或环境值不同，建议放到连接级，不要放到项目级。

合并和优先级

发起方法调用时，DebugTools 会把三层 Header 合并成最终请求 Header：

方法级 > 连接级 > 项目级

同名 Header 只会保留高优先级的值：

Header Key	项目级	连接级	方法级	最终生效
Authorization	Bearer project-token	Bearer connection-token	Bearer method-token	Bearer method-token
X-Tenant-Id	tenant-default	tenant-a	未填写	tenant-a
Accept-Language	zh-CN	未填写	未填写	zh-CN

也就是说：

• 方法级已经填写的 Header，不会被连接级或项目级覆盖。
• 连接级已经填写的 Header，不会被项目级覆盖。
• 项目级只在方法级和连接级都没有同名 Key 时作为默认值生效。

存储与清理缓存

存储

• 方法级：文件
• 连接级：内存
• 项目级：文件

清理缓存

• Method param cache：会清理掉方法级 header。
• 全部清除：方法级 header 和项目级 header
• 当然对应位置一个个删除保存也是可以的

TIP

• Header 会参与构造 Spring MVC、Spring WebFlux 请求对象。
• 目标方法参数中如果使用 HttpServletRequest、ServerHttpRequest、ServerWebExchange 等请求对象，也可以读取到当前调用合并后的 Header。