在 quarkus 多模块项目中，当单元测试集中于 module-impl 而被测代码位于 module-api 时，jacoco 报告中 module-api 的覆盖率恒为 0%——根本原因是 quarkus 缺少对 module-api 的 cdi 扫描支持，导致 jacoco 代理无法正确织入其字节码。
JaCoCo 在 Quarkus 环境下依赖 运行时字节码插桩（instrumentation），而 Quarkus 的测试执行（尤其是使用 @QuarkusTest 或 @Inject 的测试）会启动一个精简的 CDI 容器。该容器默认仅扫描当前模块及其显式声明为可扫描的依赖模块。由于 module-api 是一个纯接口/POJO 模块（无 beans.xml），Quarkus 将其视为“非 CDI 模块”，不会加载其类到运行时上下文中——即使 module-impl 依赖它，JaCoCo 代理也无法在 JVM 启动阶段或测试执行期间对其字节码进行覆盖标记。
✅ 正确解决方案：启用 module-api 的 CDI 扫描
只需在 module-api/src/main/resources/META-INF/ 目录下添加一个空的 beans.xml 文件（符合 Jakarta EE 规范的最小化配置）：
在调试 Java 后端 API 故障时使用此技能，尤其适用于以下任务：分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转，以及生成简洁的诊断结论与修复方案。
<!-- module-api/src/main/resources/META-INF/beans.xml -->
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="https://jakarta.ee/xml/ns/jakartaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="https://jakarta.ee/xml/ns/jakartaee https://jakarta.ee/xml/ns/jakartaee/beans_4_0.xsd"
version="4.0" bean-discovery-mode="all">
</beans>? bean-discovery-mode="all" 是关键：它强制 Quarkus 扫描该模块中所有类（包括无注解的普通类），使其纳入运行时上下文，从而允许 JaCoCo 代理成功织入并收集覆盖率数据。
? 验证与补充说明
- ✅ 执行 mvn clean verify -Dquarkus.test.flat-class-path=true（推荐）确保测试类路径扁平化，避免因模块隔离导致的类加载问题；
- ✅ 确保 quarkus-jacoco 依赖声明在 根 POM 的
中 （你已正确配置），而非仅在 module-impl 中——这是跨模块覆盖率的前提； - ❌ 不要将 quarkus-jacoco 插件配置在子模块的
中，JaCoCo 的 prepare-agent 需在根构建阶段统一激活，以影响整个 reactor 的测试执行； - ⚠️ 若 module-api 中存在 @ApplicationScoped、@Singleton 等 CDI 组件，还需确认其构造函数/方法满足 Quarkus 的编译时限制（如无反射依赖）。
? 最终效果
添加 beans.xml 后，再次运行 mvn verify，JaCoCo 报告（位于 module-api/target/site/jacoco/）将准确反映 module-api/src/main/java/ 下所有类的真实覆盖率，与 module-impl 的覆盖率并列呈现，实现真正的全模块质量度量。
这一方案轻量、标准、无侵入性，是 Quarkus 多模块架构下保障测试覆盖率完整性的最佳实践。
