Spring项目@Autowired注入对象为null的排查方法与调试技巧

你的报错直接诱因是UserController中newUser接口方法被声明为private。
Spring MVC 处理@RestController下标记了@PostMapping/@GetMapping等请求映射注解的方法时，要求方法必须使用public修饰：

• private、final、static修饰的方法无法被Spring的CGLIB动态代理重写，请求进来时Spring会绕过代理逻辑直接调用原生类实例的方法，此时实例中@Autowired标记的字段还未完成容器注入，自然为null。
• 直接把newUser方法的修饰符从private改为public，即可解决当前空指针问题。

除了你已经排查过的「手动new实例化托管类」「缺失Spring stereotype注解」两类常见原因，以下场景也极易触发同类问题，排查时可以逐一核对：

• 被AOP、请求映射、事务拦截的方法使用了非public修饰，或者加了final/static关键字，导致动态代理失效
• 托管类的包路径不在Spring Boot默认扫描范围内：启动类所在包是默认扫描根路径，如果Controller/Service/Repository等类放在启动类包的上层、或者无关联的独立路径下，即使加了注解也不会被容器识别加载
• 同类型Bean存在多个实现类，未通过@Primary/@Qualifier指定注入目标，不过这类问题通常在项目启动阶段就会抛出注入失败异常，很少出现运行时空指针
• 自定义BeanPostProcessor、Bean作用域配置错误，截断了正常的Bean初始化、依赖注入流程

• 项目启动时添加--debug运行参数，控制台会打印全量Bean扫描、自动配置、请求映射注册的详细日志，可直接搜索接口路径/api/register，确认Spring识别到的请求处理方法、关联Bean实例是否符合预期
• 优先使用构造器注入代替字段注入：构造器注入能在项目启动阶段就暴露依赖缺失、注入冲突的问题，不会等到请求调用时才抛出空指针，Spring 4.3+版本单构造器场景不需要额外添加@Autowired注解，参考写法：

@CrossOrigin(origins = "*")
@RestController
@RequestMapping("api/")
@Validated
public class UserController {

  private final UserAccountService userAccountService;

  public UserController(UserAccountService userAccountService) {
    this.userAccountService = userAccountService;
  }

  @PostMapping("register")
  public ResponseEntity<String> newUser(@Valid @RequestBody UserAuthenticate userAuthenticate){
    if (userAccountService.addUser(userAuthenticate)){
      return ResponseEntity.status(HttpStatus.OK).build();
    }
    else{
      return ResponseEntity.status(HttpStatus.BAD_REQUEST).build();
    }
  }
}

• 断点调试时，可在Controller的构造方法、@PostConstruct标记的初始化方法中打断点，确认Bean实例化阶段依赖是否正常注入；也可打印当前实例的类名，若类名包含$$EnhancerBySpringCGLIB字样，说明实例是Spring正常生成的代理托管对象，否则就是未完成注入的普通实例
• 借助已配置的actuator/beans端点，搜索目标Controller、Service的Bean名称，核对Bean的作用域、依赖链路是否符合预期，排查是否存在多实例、未被容器托管的情况

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