Quarkus注入外部Maven模块Bean遇UnsatisfiedResolutionException的解决方法

• 确认外部模块的Bean符合CDI规范

  • 确保Bean类标注了@ApplicationScoped、@RequestScoped等CDI作用域注解，无注解的类无法被CDI容器识别。
  • 若Bean有自定义构造方法，必须添加@Inject注解，否则CDI容器无法实例化该类。

• 验证包扫描与依赖索引配置

  • 仅配置包扫描可能不够，Quarkus对外部模块需显式声明索引依赖，在application.properties中添加：

    quarkus.index-dependency.<自定义模块名>.group-id=<外部模块groupId>
    quarkus.index-dependency.<自定义模块名>.artifact-id=<外部模块artifactId>
    

  • 若坚持使用包扫描，确认配置的quarkus.cdi.scan-packages路径与Bean所在的实际包完全一致。

• 检查Maven依赖配置

  • 确保外部模块已正确添加到Quarkus项目的pom.xml，且依赖范围为compile，示例：

    <dependency>
        <groupId>com.example</groupId>
        <artifactId>external-module</artifactId>
        <version>1.0.0</version>
    </dependency>
    

• 处理外部模块的索引构建

  • 若外部模块是Quarkus项目，需在其pom.xml中添加Quarkus插件以生成正确的索引文件：

    <build>
        <plugins>
            <plugin>
                <groupId>io.quarkus</groupId>
                <artifactId>quarkus-maven-plugin</artifactId>
                <version>${quarkus.version}</version>
                <executions>
                    <execution>
                        <goals>
                            <goal>build</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
    

  • 若外部模块是普通Java项目，可在Quarkus项目中添加索引插件手动处理依赖：

    <build>
        <plugins>
            <plugin>
                <groupId>io.quarkus</groupId>
                <artifactId>quarkus-indexer-maven-plugin</artifactId>
                <version>${quarkus.version}</version>
                <executions>
                    <execution>
                        <goals>
                            <goal>index-dependencies</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
    

• 排查注入匹配问题

  • 确保注入点的类型与Bean类型完全匹配，比如按接口注入时，对应的实现类需被标记为CDI Bean。
  • 若使用了自定义限定符（@Qualifier），注入点和Bean上的限定符（包括注解属性）必须完全一致。

• 清理重建项目

  • 执行mvn clean install清理本地缓存，重新构建外部模块和Quarkus项目，避免编译缓存导致的类加载异常。

内容的提问来源于stack exchange，提问作者Md. Milton