You need to enable JavaScript to run this app. 搭建Quarkus多模块可运行Uber-Jar项目的操作是否符合最佳实践?
优惠活动
大模型
产品
解决方案
定价
更多

搭建Quarkus多模块可运行Uber-Jar项目的操作是否符合最佳实践?

关于你当前Quarkus多模块实现的评估

你这套流程能正常跑通、生成可独立运行的Jar包是没问题的,但距离Quarkus官方推荐的多模块最佳实践还有明显差距,还藏着几个随着项目规模扩大会很容易踩的坑,具体如下:

现有方案的潜在隐患

  • 父POM职责越位,所有模块无意义负重
    你现在在根POM的全局依赖、全局构建配置里,统一配了所有Quarkus运行时依赖、构建插件,这意味着controller、res这两个本来应该是纯业务逻辑、静态资源库的模块,会无差别继承所有依赖和插件执行逻辑。比如res模块只是放个静态文件、通用配置,平白无故就要拉取Resteasy响应式、CDI这些运行时类,还要走一遍构建流程,不仅拖慢整体构建速度,还容易出现业务代码误依赖测试类的问题——毕竟这些依赖是全局无scope引入的,编译期不会拦着你在业务代码里import本该是测试用途的rest-assured类,等打生产包的时候就会出现类路径污染的问题。
  • 插件全局执行带来的构建冲突风险
    目前jandex类索引插件、Quarkus构建插件是在根POM全局配置执行的,三个模块在构建的时候都会跑一遍类索引生成、Quarkus代码生成流程。但Quarkus的Bean扫描逻辑只需要在最终的启动入口模块的类路径下执行一次就够了,重复生成的索引不仅是无用功,还可能因为跨模块的同名Bean被重复扫描,出现很难排查的CDI Bean定义冲突、类加载顺序错乱的问题。另外每个子模块执行Quarkus构建目标的时候,都会在自己的target目录生成一遍冗余的runner Jar,本地构建目录里全是没用的产物,清理都麻烦。
  • 模块命名的认知混淆
    你把最终可运行的入口模块命名为package,这本身是Maven的核心构建生命周期阶段名。后期执行构建命令的时候,比如敲mvn clean package -pl package,很容易搞混到底是要执行package构建阶段,还是单独构建名为package的模块;新加入项目的同事看结构的时候,也很难第一时间理解模块的真实职责。
  • 打包行为的不确定性
    你现在能生成可运行的runner Jar,是靠全局Quarkus插件的配置碰巧生效,但你没在最终的入口模块显式指定打包类型。要知道Quarkus从1.13版本开始默认的打包方式是fast-jar,不是传统的Uber Jar,万一后续依赖版本升级、插件配置变更,可能突然发现打出来的包不能独立运行,还要翻半天配置找原因。

对齐最佳实践的调整方向

不用推翻现有的项目结构,只要做几个简单调整就能把大部分坑填上:

  • 把根POM的职责拉回正轨:只保留Quarkus BOM的版本管控配置、公共版本属性,把全局的业务依赖、构建插件配置全部从根POM移除,让根POM只做纯聚合的父模块,不强行给子模块塞无关的依赖和插件。
  • 重命名入口模块:把名叫package的模块改成bootstrap或者app,明确这个模块的职责是放Quarkus主类、全局配置、打包逻辑,避免和Maven生命周期重名。
  • 依赖按需分配:把Quarkus的业务依赖移到真正需要的子模块里——比如controller模块要写REST接口,就自己引入Resteasy响应式依赖;哪个模块需要用到CDI能力,就在哪个模块引入Arc依赖;测试依赖也是哪个模块要写测试,就在哪个模块加test scope的依赖,不要全局铺开。
  • 插件下沉到入口模块:把jandex索引插件、Quarkus构建插件的配置全部移到bootstrap入口模块的构建标签里,只有这个模块需要执行类索引生成、Quarkus代码生成、最终打包的流程,业务纯库模块不需要触碰这些插件,既能加快整体构建速度,也能避免重复类索引带来的冲突问题。
  • 显式指定打包类型:在bootstrap模块的application.properties里加一行quarkus.package.type=uber-jar,明确要打可独立运行的Uber Jar,别依赖框架的默认配置,从根源上避免版本升级带来的行为变化。

注:内容的提问来源于stack exchange,提问作者jiayaoO3O

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.27 03:36:04