Spring Boot启动报UnsatisfiedDependencyException及Not a managed type错误如何解决

java.lang.IllegalArgumentException: Not a managed type: class com.example.model.Departments 异常的核心是Spring Data JPA未识别到Departments作为JPA实体类，未将其纳入持久化上下文管理，从而连锁触发后续Repository、Service、Controller的Bean创建失败。
常见触发原因如下：

• Departments实体类未添加@Entity注解，或导入了错误包的@Entity注解（Spring Boot 2.x对应javax.persistence.Entity，3.x以上对应jakarta.persistence.Entity，误导入Hibernate专属的org.hibernate.annotations.Entity也会触发该问题）
• 启动类的默认包扫描范围未覆盖com.example.model包：Spring Boot默认仅扫描启动类所在包及其子包的组件，若实体类所在包不在启动类的子目录下，就会无法识别
• 若手动配置了@EntityScan注解，未将com.example.model包加入扫描路径

第一步：校验实体类注解配置 #

确认Departments类添加了正确的JPA注解，示例如下：

// Spring Boot 2.x 导入路径
import javax.persistence.Entity;
import javax.persistence.Id;
// Spring Boot 3.x 导入路径
// import jakarta.persistence.Entity;
// import jakarta.persistence.Id;

@Entity
public class Departments {
    // 必须添加主键注解
    @Id
    private Long deptId;
    // 其他业务字段、getter、setter方法
}

重点核对@Entity的导入包是否和Spring Boot版本匹配，这是高频错误点

第二步：调整实体扫描范围 #

方案1：调整启动类位置 #

将启动类移动到所有业务包的父级目录，例如所有业务代码都放在com.example的子包下（model、controller、service、repository都属于com.example的子包），将启动类放在com.example根包下即可使用默认扫描逻辑覆盖所有组件。

方案2：显式配置实体扫描路径 #

如果无法调整启动类位置，在启动类上添加@EntityScan注解指定实体类所在包即可：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.autoconfigure.domain.EntityScan;

@SpringBootApplication
// 多个扫描包用逗号分隔即可
@EntityScan(basePackages = "com.example.model")
// 若Repository不在默认扫描路径，可额外添加如下注解指定Repository包路径
// @EnableJpaRepositories(basePackages = "com.example.repository")
public class DemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }
}

若完成上述操作仍报错，检查项目依赖是否引入了spring-boot-starter-data-jpa启动器。

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