Quarkus多模块项目咨询：配置规范与服务停止异常

项目结构 #

\--- Project ':backend'
     +--- Project ':backend:api'
     \--- Project ':backend:shared'

问题1：在根模块定义跨模块的公共库与框架插件/依赖是否为最佳实践？ #

• 分场景判断：
  • 纯公共依赖（如通用工具类、日志框架）：可以在根模块subprojects或allprojects块中统一声明，避免重复配置，属于合理的最佳实践。
  • Quarkus插件/框架专属依赖：不建议全局配置。shared模块仅负责实体、仓库这类纯数据层代码，不需要Quarkus运行时支持；如果根模块全局引入Quarkus插件，会让shared模块被Quarkus额外处理，可能引入不必要的构建逻辑或类加载冲突，反而增加复杂度。
  • 最优方案：根模块只配置无业务关联的公共依赖，Quarkus插件和框架依赖仅在api模块中声明，shared模块按需引入自身需要的依赖（如JPA、数据库驱动等）。

问题2：选择api模块作为新功能开发的入口是否正确？ #

• 完全正确。api模块作为Web服务的对外入口，负责接口定义、服务实现这类业务交互逻辑，新功能的开发入口放在这里能保证模块职责清晰；shared模块只专注于通用实体、数据访问层代码，保持单一职责，避免业务逻辑侵入，后续扩展其他服务入口（如消息消费模块）也更灵活。

问题3：如何解决服务器无法正常停止的问题？ #

• 先纠正推测：shared是依赖库，不会独立运行，问题大概率出在Quarkus Dev模式的进程管理或Gradle任务执行逻辑上，解决方法如下：
  1. 拆分任务执行：不要链式执行gradle :backend:api:build :backend:api:quarkusDev，分开执行：先运行gradle :backend:api:build完成构建，再单独启动gradle :backend:api:quarkusDev，避免Gradle进程管理混乱导致子进程残留。
  2. 使用正确终止方式：在运行quarkusDev的终端按Ctrl+C触发优雅停止，不要直接关闭终端。Quarkus Dev模式会监听该信号，主动回收资源。
  3. 配置Quarkus优雅关闭参数：在api模块的build.gradle中添加配置，延长关闭超时时间，确保资源能被完全回收：

     quarkus {
         dev {
             jvmArgs = ["-Dquarkus.shutdown.timeout=5"]
         }
     }
     

  4. 检查资源泄漏：如果shared模块中有自定义线程池、数据库长连接等资源，要在Quarkus的@PreDestroy方法中主动关闭这些资源，避免残留非守护线程导致进程无法终止。

内容的提问来源于stack exchange，提问作者Aleksey Moren