Spring自定义JPA Repository实现出现UnsatisfiedDependencyException依赖注入错误

你遇到的是Spring Bean初始化阶段的循环依赖问题：

• 你的MajorRepository继承了CustomMajorRepository，Spring Data JPA需要先实例化自定义实现类CustomMajorRepositoryImpl，才能组装生成最终的MajorRepository代理Bean
• 而CustomMajorRepositoryImpl在初始化时又要求注入MajorRepository，此时后者还没完成组装，就会触发循环依赖报错。你之前把@Lazy加在MajorRepository接口上不生效，是因为注解加错了位置。

方案1（推荐）：自定义实现类直接用持久化原生API #

自定义Repository实现的设计初衷就是用来写非标准的持久化操作，完全不需要注入主Repository，直接注入EntityManager或者JdbcTemplate实现业务逻辑即可：

// CustomMajorRepositoryImpl.java
import jakarta.persistence.EntityManager;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Repository;

@Repository
public class CustomMajorRepositoryImpl implements CustomMajorRepository {
    private final EntityManager entityManager;

    @Autowired
    public CustomMajorRepositoryImpl(EntityManager entityManager) {
        this.entityManager = entityManager;
    }

    @Override
    public void addStudentToMajor(Student student, Major major) {
        // 直接用entityManager写JPQL/原生SQL实现逻辑
    }

    @Override
    public void increaseMajorLimit(UUID majorId, int amount) {
        // 直接用entityManager写JPQL/原生SQL实现逻辑
    }
}

这种方案从根源上消除了循环依赖，性能和可维护性最好。

方案2：给注入点加@Lazy注解 #

如果确实需要复用MajorRepository里已有的方法，把@Lazy注解加在CustomMajorRepositoryImpl的注入点上，而非接口上：

// CustomMajorRepositoryImpl.java
private MajorRepository majorRepository;

@Autowired
@Lazy // 注解加在注入点才会生效，延迟注入已经组装完成的MajorRepository代理
public void setMajorRepository(MajorRepository majorRepository) {
    this.majorRepository = majorRepository;
}

这个方案可以快速解决问题，但是本质上还是保留了循环依赖，只适合临时修复。

方案3：抽离公共逻辑到独立服务 #

把MajorRepository和CustomMajorRepositoryImpl都需要用到的公共方法抽成独立的MajorPersistenceService类，两边都依赖这个服务类，彻底消除循环依赖的结构问题。

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