Spring Boot 2.7迁移后MissingRequestHeaderException问题求助

可能的问题原因 #

1. 请求头未正常传递 #

迁移后调用方（前端/上游服务）的请求中不再携带td-api-consumer-key请求头，而Spring 5环境下该头是正常传递的。需排查请求链路中的网关、代理、调用方代码，确认是否在迁移过程中修改了请求头的发送逻辑。

2. 原有全局异常兼容处理失效 #

之前的Spring 5项目中存在自定义异常处理器，捕获了MissingRequestHeaderException并做兼容处理（比如给参数赋默认值），但迁移到Spring Boot 2.7时，该处理器未被正确注册，或者被Spring Boot的自动配置覆盖，导致异常直接抛出。

3. Spring框架请求头校验逻辑的细微调整 #

Spring Boot 2.7基于Spring 5.3，虽然@RequestHeader默认required=true的规则未变，但在部分场景下的校验逻辑有调整：

• 若之前调用方传递的是大小写不一致的请求头（如TD-API-CONSUMER-KEY），Spring 5可能自动兼容大小写，但Spring 5.3在特定配置下会严格匹配头名称；
• 对空值请求头的处理逻辑变化，若之前调用方传递了空值头，Spring 5可能视为存在，而Spring 5.3会判定为缺失。

4. 过滤器/拦截器未正常添加请求头 #

项目中原有过滤器或拦截器会在请求到达控制器前自动注入td-api-consumer-key头，但迁移到Spring Boot 2.7后，该组件的加载顺序、优先级或代码逻辑被修改，导致请求头未被正确添加。

验证排查步骤 #

• 使用Postman等工具手动构造包含td-api-consumer-key头的请求，直接调用控制器接口，确认接口本身逻辑是否正常；
• 检查项目中是否存在@ControllerAdvice或全局异常处理器，确认MissingRequestHeaderException是否被捕获；
• 对比Spring 5与Spring Boot 2.7的配置文件，排查是否有请求处理相关的配置项差异；
• 查看过滤器/拦截器的注册逻辑，确认它们是否仍在正常执行并添加请求头。

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