Spring @Cacheable注解导致服务注入失败，出现空指针异常求助

看起来你碰到了Spring缓存代理和控制器依赖注入冲突的典型问题——当你给RestController的方法加上@Cacheable后，Spring会为这个类生成代理对象，但默认的代理机制可能导致原类中的依赖（比如logger、业务服务）无法正确注入，进而出现空指针异常。下面一步步帮你排查解决：

1. 先确认缓存功能的基础配置是否生效 #

首先要确保你已经开启了Spring缓存的开关，这是最容易忽略的点：

• 在你的配置类上添加@EnableCaching注解，必要时指定使用CGLIB代理（后面会说原因）：

  @Configuration
  @EnableCaching(proxyTargetClass = true) // 强制使用CGLIB代理，解决类代理问题
  public class CacheConfiguration {
      // 配置缓存管理器，示例用内存缓存，生产环境可以换Redis/Caffeine
      @Bean
      public CacheManager cacheManager() {
          return new ConcurrentMapCacheManager("books");
      }
  }
  

如果没加@EnableCaching，@Cacheable完全不会生效，还可能导致代理逻辑混乱，直接引发依赖注入问题。

2. 修复代理导致的依赖注入失效问题 #

Spring默认用JDK动态代理（基于接口），但你的RestController大概率是个普通类（没有实现接口），这时候JDK代理生成的对象和原类不是同一个类型，原类中的字段注入（比如@Autowired的服务、甚至手动初始化的logger）在代理对象中可能为空。解决办法：

方案A：强制使用CGLIB代理 #

CGLIB是基于类的代理，会继承原类，能保留原类的所有成员变量。除了上面在@EnableCaching中加proxyTargetClass = true，你也可以在配置文件中全局设置：

# application.properties
spring.aop.proxy-target-class=true

方案B：改用构造器注入（推荐） #

字段注入虽然方便，但在代理场景下容易出问题。换成构造器注入能确保依赖在对象创建时就被初始化，代理对象也能正确继承这些依赖：

@RestController
public class BookController {
    private final BookService bookService;
    private final Logger logger;

    // 构造器注入，Spring会自动注入BookService
    public BookController(BookService bookService) {
        this.bookService = bookService;
        this.logger = LoggerFactory.getLogger(BookController.class);
    }

    @Cacheable(cacheNames = "books")
    @GetMapping("/books")
    public List<Book> getBooks() {
        logger.info("从数据库查询书籍（缓存未命中）");
        return bookService.getAllBooks();
    }
}

3. 检查@Cacheable的使用规范 #

• 必须用在公共方法上：Spring代理只能拦截公共方法的调用，私有/protected方法加@Cacheable不会触发缓存，还可能导致代理逻辑异常。
• 避免类内部调用：如果同一个类里的其他方法调用getBooks()，会绕过代理直接调用原方法，不会触发缓存。这种情况建议把缓存逻辑移到Service层。
• 推荐把缓存放在Service层：控制器层负责处理HTTP请求，缓存逻辑放在业务服务层更合理，既复用性强，也能避免控制器代理的各种问题。比如：

  @Service
  public class BookService {
      @Cacheable(cacheNames = "books")
      public List<Book> getAllBooks() {
          // 数据库查询逻辑
      }
  }
  

4. 排查空指针的深层原因 #

如果你调试时发现所有对象甚至字符串都为空，大概率是代理对象没有正确初始化原类的成员。你可以在调试时查看对象的类型：

• 如果是JDK代理，类名会带有$Proxy后缀；
• 如果是CGLIB代理，类名会带有CGLIB$$后缀。
  如果代理类型不对，就回到步骤2调整代理方式。

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