quarkus 多模块项目因子模块缺失关键 maven 插件（尤其是 quarkus-maven-plugin 和 maven-compiler-plugin）导致 cdi 容器无法生成代理类，引发 “unproxyable bean” 错误；本文详解问题成因、修复步骤及最佳实践。
在将单模块 Quarkus 应用重构为多模块结构（如 base 与 dominio）后，开发者常遇到如下编译期错误：
[1] It's not possible to automatically add a synthetic no-args constructor to an unproxyable bean class. You need to manually add a non-private no-args constructor to com.gestorsistemas.chupacabra.base.invoicemirror.invoice.usecase.impl.NFCeSyncServiceImpl...
该错误并非代码缺陷（例如构造函数私有化或缺少无参构造器），而是 Quarkus 构建生命周期在子模块中未被正确激活所致。核心原因在于：Quarkus 的 CDI 增强（如代理生成、字节码注入、Jandex 索引扫描）高度依赖 Maven 插件链的显式参与——而这些插件仅在父 POM 的
当 base 模块缺少 quarkus-maven-plugin 时：
- generate-code 目标未执行 → 缺少 @ApplicationScoped 等注解所需的增强元数据；
- maven-compiler-plugin 缺失 -parameters 编译参数 → 方法参数名丢失，Arc 无法解析 @Inject 构造函数参数类型；
- Jandex 索引未生成 → Quarkus 运行时无法发现跨模块的 Bean 类型，导致代理创建失败。
✅ 正确解决方案是：在每个含 Quarkus 组件的子模块（如 base、dominio）的 pom.xml 中，显式声明完整的 Quarkus 构建插件配置。以下为推荐的最小必要插件集（适配 Quarkus 2.16+ 与 Java 17）：
<build>
<plugins>
<!-- 必需：触发 Quarkus 代码生成与构建增强 -->
<plugin>
<groupId>${quarkus.platform.group-id}</groupId>
<artifactId>quarkus-maven-plugin</artifactId>
<version>${quarkus.platform.version}</version>
<extensions>true</extensions>
<executions>
<execution>
<goals>
<goal>build</goal>
<goal>generate-code</goal>
<goal>generate-code-tests</goal>
</goals>
</execution>
</executions>
</plugin>
<!-- 必需：确保编译保留方法参数名（@Inject 构造函数解析依赖此） -->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>${compiler-plugin.version}</version>
<configuration>
<compilerArgs>
<arg>-parameters</arg>
</compilerArgs>
<source>17</source>
<target>17</target>
</configuration>
</plugin>
<!-- 推荐：集成测试支持（尤其 native profile 下） -->
<plugin>
<artifactId>maven-surefire-plugin</artifactId>
<version>${surefire-plugin.version}</version>
<configuration>
<systemPropertyVariables>
<java.util.logging.manager>org.jboss.logmanager.LogManager</java.util.logging.manager>
</systemPropertyVariables>
</configuration>
</plugin>
</plugins>
</build>⚠️ 注意事项：
- 不要仅添加 quarkus-maven-plugin：若忽略 maven-compiler-plugin 及其 -parameters 参数，即使有插件也会因参数名丢失导致注入失败；
-
true 不可省略：这是启用 Quarkus 增强的关键开关； - 避免手动添加无参构造器：虽然能绕过报错，但违背 Quarkus 推荐的构造器注入范式，且掩盖根本问题；
- 验证 Jandex 索引：构建后检查 base/target/classes/META-INF/jandex.idx 是否存在，确认索引已生成；
- 模块依赖范围：确保 dominio 对 base 的依赖为 compile（默认），而非 provided 或 test。
总结而言，Quarkus 多模块项目的健壮性依赖于每个业务模块的独立可构建性。将构建逻辑（插件）下沉至子模块 POM，而非仅依赖父 POM，是符合 Maven 设计哲学与 Quarkus 运行时要求的最佳实践。完成配置后，执行 mvn clean compile 即可消除代理异常，恢复正常的依赖注入与作用域管理能力。
