SpringBoot启动失败：UnsatisfiedDependencyException错误排查求助

核心错误定位 #

异常堆栈里的关键提示是：

java.lang.IllegalArgumentException: Not a managed type: class platform.CodeContext

简单说就是JPA不认识CodeContext这个类——它没被标记为JPA的托管实体，导致依赖它的CodeRepository初始化失败，进而连锁导致CodeService无法创建。

具体解决步骤 #

1. 给CodeContext添加JPA实体注解 #

你没贴CodeContext的代码，但90%的概率是这个类缺了@Entity注解，同时主键字段需要@Id注解。补全后的示例代码如下：

package platform;

// Spring Boot 2.x用javax.persistence，3.x及以上用jakarta.persistence
import jakarta.persistence.Entity;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.GenerationType;
import jakarta.persistence.Id;
import lombok.Getter;
import lombok.Setter;

@Entity // 必须加这个注解，告诉JPA这是数据库映射实体
@Getter
@Setter
public class CodeContext {
    @Id // 标记主键字段
    @GeneratedValue(strategy = GenerationType.IDENTITY) // 主键自增策略
    private Long id;

    // 你的业务字段，比如代码内容、时间戳等
    private String codeSnippet;
    private Long createTime;

    public void nowTime() {
        this.createTime = System.currentTimeMillis();
    }
}

2. 确保Spring能扫描到实体类 #

• 如果你的主启动类（带@SpringBootApplication的类）在platform包下，那Spring会自动扫描这个包及其子包下的实体，不用额外配置。
• 如果主启动类不在platform包，比如在com.example这样的上级包，需要在主类上添加@EntityScan指定实体所在包：

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

@SpringBootApplication
@EntityScan(basePackages = "platform") // 明确告诉Spring要扫描这个包下的实体
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

3. 验证现有配置 #

你的gradle依赖和application.properties配置都没问题——已经引入了JPA和H2依赖，JPA的DDL自动更新、数据库连接配置也都正确，这部分不用改。

排查顺序 #

先检查CodeContext的@Entity注解，这是最常见的问题；如果注解加了还是报错，再确认实体类的包扫描范围是否覆盖到platform包。

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