Spring Boot处理入站请求时注入的NativeWebRequest为null如何解决？

快速验证方案（优先尝试） #

直接将NativeWebRequest/HttpServletRequest作为控制器接口方法的入参使用，Spring MVC会自动绑定当前请求上下文对象，无需依赖注入，可规避作用域代理相关的所有问题，代码示例：

@RestController
@RequestMapping("/your-api")
public class OpenApiGeneratedController {
    // 直接在方法入参声明即可
    @PostMapping("/your-endpoint")
    public void yourEndpoint(NativeWebRequest request, @RequestBody YourDto dto) {
        // 直接读取请求头
        String targetHeader = request.getHeader("目标请求头名称");
        // 业务逻辑
    }
}

字段注入为null的常见原因与修复 #

如果必须使用字段注入的方式，按以下顺序排查：

• 检查注入位置的调用时机：@Autowired字段注入是在Bean的构造方法执行完成后才完成赋值的，如果在构造方法、@PostConstruct初始化方法中调用该对象，拿到的必然是null，请调整为请求处理阶段再调用。
• 补充请求作用域代理配置：NativeWebRequest是请求作用域的Bean，注入到默认单例的控制器中时需要显式声明代理模式，修改注入代码为：

@RestController
public class YourController {
    @Autowired
    @Scope(value = WebApplicationContext.SCOPE_REQUEST, proxyMode = ScopedProxyMode.TARGET_CLASS)
    private NativeWebRequest request;
}

• 确认组件扫描范围：如果OpenAPI生成的控制器不在启动类所在的包及子包路径下，需要在启动类上补充@ComponentScan注解指定扫描路径，示例：

@SpringBootConfiguration
@ComponentScan(basePackages = {"你的业务代码包路径", "OpenAPI生成控制器的包路径"})
@EnableAutoConfiguration(
        excludeName = { "org.keycloak.adapters.springboot.KeycloakAutoConfiguration"},
        exclude = {
                DataSourceAutoConfiguration.class,
                ErrorMvcAutoConfiguration.class,
                HttpEncodingAutoConfiguration.class,
                PropertyPlaceholderAutoConfiguration.class,
                ThymeleafAutoConfiguration.class,
                WebSocketMessagingAutoConfiguration.class,
                OAuth2ClientAutoConfiguration.class,
})
public class AthenaApplication extends SpringBootServletInitializer

• 外部容器部署适配：如果当前应用是打WAR包部署在外部Tomcat等Servlet容器中，确认容器版本与Spring Boot版本兼容：Spring Boot 2.7.x要求Servlet 4.0+，Spring Boot 3.x要求Servlet 5.0+，版本不匹配会导致请求上下文初始化异常。

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