Quarkus中PanacheRepository在CDI服务中依赖注入失败问题排查

错误现象 #

启动应用时抛出 jakarta.enterprise.inject.spi.DeploymentException，提示 DisciplineRepository 和 StudentRepository 两个PanacheRepository接口在对应CDI服务中依赖无法满足。

错误日志详情 #

Caused by: jakarta.enterprise.inject.spi.DeploymentException: Found 2 deployment problems: 
[1] Unsatisfied dependency for type br.com.pongolino.study.quarkus.repository.DisciplineRepository and qualifiers [@Default]
    - java member: br.com.pongolino.study.quarkus.service.DisciplineService():disciplineRepository
    - declared on CLASS bean [types=[br.com.pongolino.study.quarkus.service.DisciplineService, java.lang.Object], qualifiers=[@Default, @Any], target=br.com.pongolino.study.quarkus.service.DisciplineService]
[2] Unsatisfied dependency for type br.com.pongolino.study.quarkus.repository.StudentRepository and qualifiers [@Default]
    - java member: br.com.pongolino.study.quarkus.service.StudentService():studentRepository
    - declared on CLASS bean [types=[br.com.pongolino.study.quarkus.service.StudentService, java.lang.Object], qualifiers=[@Default, @Any], target=br.com.pongolino.study.quarkus.service.StudentService]
...

项目代码结构 #

项目包含两个PanacheRepository接口、对应的CDI服务类，以及调用服务的资源类：

DisciplineRepository #

@ApplicationScoped
public interface DisciplineRepository extends PanacheRepository<Discipline> {
}

DisciplineService #

@ApplicationScoped
public class DisciplineService {
    @Inject
    DisciplineRepository disciplineRepository;
    // ...
}

StudentRepository #

@ApplicationScoped
public interface StudentRepository extends PanacheRepository<Student> {
}

StudentService #

@ApplicationScoped
public class StudentService {
    @Inject
    StudentRepository studentRepository;
    // ...
}

资源类（简化版） #

@Path("/v1/discipline")
@Consumes(MediaType.APPLICATION_JSON)
@Produces(MediaType.APPLICATION_JSON)
public class DisciplineResource {
    private final DisciplineService disciplineService;

    @Inject
    public DisciplineResource(DisciplineService disciplineService) {
        this.disciplineService = disciplineService;
    }

   // ...
}

POM配置 #

<dependencyManagement>
    <dependencies>
      <dependency>
        <groupId>${quarkus.platform.group-id}</groupId>
        <artifactId>${quarkus.platform.artifact-id}</artifactId>
        <version>${quarkus.platform.version}</version>
        <type>pom</type>
        <scope>import</scope>
      </dependency>
    </dependencies>
  </dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>io.quarkus</groupId>
      <artifactId>quarkus-resteasy-jsonb</artifactId>
    </dependency>
    <dependency>
      <groupId>io.quarkus</groupId>
      <artifactId>quarkus-smallrye-openapi</artifactId>
    </dependency>
    <dependency>
      <groupId>io.quarkus</groupId>
      <artifactId>quarkus-hibernate-orm-panache</artifactId>
    </dependency>
    <dependency>
      <groupId>io.quarkus</groupId>
      <artifactId>quarkus-resteasy</artifactId>
    </dependency>
    <dependency>
      <groupId>io.quarkus</groupId>
      <artifactId>quarkus-jdbc-mysql</artifactId>
    </dependency>
    <dependency>
      <groupId>io.quarkus</groupId>
      <artifactId>quarkus-arc</artifactId>
    </dependency>
    <dependency>
      <groupId>io.quarkus</groupId>
      <artifactId>quarkus-junit5</artifactId>
      <scope>test</scope>
    </dependency>
  </dependencies>

已尝试的操作 #

• 移除quarkus-jdbc-mysql依赖并显式配置数据源，问题未解决
• 重新生成项目结构并迁移类，问题未解决
• 怀疑缺少依赖，但不确定具体缺失项

疑问 #

1. 移除quarkus-jdbc-mysql后为何仍出现依赖不满足问题？
2. Quarkus中使用PanacheRepository接口是否需要额外配置或依赖？

解决方案 #

针对疑问1：移除jdbc依赖后仍报错的原因 #

该错误本质是CDI容器无法找到PanacheRepository接口的代理实现类，和数据源驱动无直接关联。即便移除quarkus-jdbc-mysql，只要Panache的代理生成逻辑异常，依然会触发依赖不满足错误。数据源配置错误只会在实际操作数据库时抛出异常，不影响CDI bean的初始化流程。

针对疑问2：PanacheRepository的正确使用要求 #

你当前的写法存在错误：PanacheRepository接口不能直接标注@ApplicationScoped，正确用法分两种：

1. 接口式仓库（推荐）：无需添加任何CDI scope注解，Quarkus会自动为接口生成代理实现并注册为CDI bean。修改后的仓库代码：

   // 移除@ApplicationScoped注解
   public interface DisciplineRepository extends PanacheRepository<Discipline> {
   }
   

2. 类式仓库：若用类实现PanacheRepository，才需要添加@ApplicationScoped或其他scope注解：

   @ApplicationScoped
   public class DisciplineRepository implements PanacheRepository<Discipline> {
       // 自定义业务方法
   }
   

额外检查点 #

• 确保实体类Discipline和Student正确标注@Entity注解，且配置了JPA映射（如@Id主键），Panache依赖实体类的JPA元数据生成代理。
• 确认quarkus-hibernate-orm-panache依赖已正确引入（你的POM中已包含，此部分无问题）。
• 清理项目构建缓存：执行mvn clean install或对应构建工具的清理命令，避免旧编译产物干扰。

内容的提问来源于stack exchange，提问作者Victor Hugo Pongolino