quarkus 多模块项目中出现 “无法为非可代理 bean 类自动生成无参构造函数” 错误，根本原因在于子模块缺失 quarkus 构建插件配置，导致编译期元数据（如 jandex 索引、cdi 合成支持）未被正确生成。
在将单模块 Quarkus 应用拆分为多模块结构（如 base 和 dominio）后，开发者常误以为只需在父 POM 中声明 quarkus-maven-plugin 即可全局生效。然而，Quarkus 的构建生命周期高度依赖每个参与依赖注入的模块独立执行代码生成与元数据索引——尤其是 quarkus-maven-plugin:generate-code 和 jandex-maven-plugin（由 Quarkus 插件隐式触发）必须在每个含 CDI Bean 的子模块中运行，否则 Arc（Quarkus 的 CDI 实现）将无法识别或增强目标类。
错误提示：
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...
表面指向 NFCeSyncServiceImpl 缺少无参构造器，实则是 Arc 在编译期未能为其生成合成构造器，因为该类所在的 base 模块未执行 Quarkus 专属构建流程，导致其字节码未被 Jandex 索引、未被 Arc 注册为可代理 Bean。
✅ 正确解决方案：为每个含 Bean 的子模块显式配置 Quarkus 构建插件
你无需修改任何 Java 代码（如手动添加无参构造器），也不需额外引入 jandex-maven-plugin 或 beans.xml——只需确保所有提供 CDI Bean 的子模块（如 base、dominio）的 pom.xml 中完整继承父 POM 的构建插件配置。
以 base/pom.xml 为例，应在
${quarkus.platform.group-id} quarkus-maven-plugin ${quarkus.platform.version} true build generate-code generate-code-tests org.apache.maven.plugins maven-compiler-plugin ${compiler-plugin.version} -parameters 17 17 maven-surefire-plugin ${surefire-plugin.version} org.jboss.logmanager.LogManager maven-failsafe-plugin ${surefire-plugin.version} integration-test verify
? 关键说明：quarkus-maven-plugin 的 generate-code 目标会触发 Jandex 扫描、生成 META-INF/jandex.idx，并为 @ApplicationScoped 等作用域 Bean 注入合成无参构造器（即使你只定义了带参构造器）。这是 Arc 运行时代理和依赖注入的前提。
⚠️ 注意事项与最佳实践
- 不要手动添加无参构造器：虽然添加 public NFCeSyncServiceImpl() {} 可绕过此错误，但这违背了构造器注入（Constructor Injection）的设计原则，且丧失了不可变性和测试友好性。
-
避免 system 依赖污染构建环境：dominio/pom.xml 中使用
system 引入 sajdbc4.jar 属于反模式，建议改用本地 Maven 仓库部署或 maven-install-plugin，否则可能干扰类路径隔离与编译顺序。 - 验证 Jandex 索引是否生成：构建成功后，检查 base/target/classes/META-INF/jandex.idx 是否存在。若缺失，则插件未生效。
- 模块间依赖需明确作用域：dominio 依赖 base 时，应确保 base 模块已 mvn install 或启用 --also-make 构建，避免因依赖解析失败导致 Bean 不可见。
- 统一版本管理：所有模块应严格继承父 POM 的 quarkus.platform.version 和插件版本，避免混合版本引发兼容性问题。
完成上述配置后，执行 mvn clean compile，Quarkus 将为 NFCeSyncServiceImpl 自动合成无参构造器，Arc 可正常创建代理实例，依赖注入恢复工作——整个过程零代码侵入，完全符合 Quarkus 的约定优于配置理念。
