生产环境调用GET接口报MissingRequestHeaderException，本地正常

以下是生产环境缺失user_id请求头但本地正常的常见原因及排查步骤：

• 中间件过滤/未转发请求头
  生产环境通常会有Nginx、API网关等中间件做请求转发，检查这些组件的配置：

  • 比如Nginx的proxy_set_header配置是否包含user_id，如果没配置，请求头不会被转发到后端服务；
  • 某些网关或安全组件可能有请求头过滤规则，误将user_id拦截，查看组件的拦截规则列表。

• 生产环境调用方未传递请求头
  本地调试时可能手动在Postman/调试工具中添加了user_id头，但生产环境的调用方（前端、其他服务）未正确配置：

  • 抓生产环境的请求包（比如用浏览器开发者工具、服务端日志），确认请求头中是否存在user_id；
  • 检查调用方的生产环境配置，是否因环境变量、配置文件差异导致未添加该请求头。

• 请求头格式被中间件修改
  部分中间件可能会自动修改请求头的格式（比如将下划线转为短横线、调整大小写）：

  • 比如有些网关会把user_id转为user-id，此时后端@RequestHeader("user_id")就无法匹配；
  • 可以临时在控制器中打印所有请求头，对比生产和本地的请求头差异。

• 生产环境服务配置差异
  虽然同类接口正常，但仍需检查：

  • 是否存在全局的@ControllerAdvice或请求参数配置，在生产环境修改了@RequestHeader的必填校验逻辑；
  • 检查服务的生产环境配置文件，是否有与请求头处理相关的特殊配置。

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