Maven 多模块项目(Multi-module Project)是指一个父项目(parent project)包含多个子模块(submodules)的项目结构。这种结构允许我们将一个大型项目拆分成多个逻辑上独立但又相互关联的模块每个模块可以单独构建也可以作为整体一起构建。多模块项目的优势代码复用公共代码可以提取到单独的模块中供其他模块使用职责分离不同团队可以专注于不同模块的开发构建效率只构建发生变化的模块减少构建时间依赖管理统一管理所有模块的依赖关系版本控制所有模块使用统一的版本号便于管理适用场景大型项目分层如web、service、dao微服务架构每个服务一个模块共享通用代码如common模块标准目录结构parent-project/ # 父项目根目录 ├── pom.xml # 父POMpackagingpom ├── module-a/ # 子模块A │ ├── src/ │ └── pom.xml # 子模块A的POM ├── module-b/ # 子模块B │ ├── src/ │ └── pom.xml # 子模块B的POM └── module-web/ # Web模块 ├── src/ └── pom.xml关键特征父POM必须设置packagingpom/packaging通过modules管理子模块子模块通过parent继承父POM可以有自己的依赖和构建配置创建 Maven 多模块项目1. 创建父项目父项目本身通常不包含任何代码它主要用来管理子模块和公共配置。创建父项目的 pom.xml 文件需要设置 packaging 为 pomprojectmodelVersion4.0.0/modelVersiongroupIdcom.example/groupIdartifactIdparent-project/artifactIdversion1.0.0/versionpackagingpom/packagingmodulesmodulemodule1/modulemodulemodule2/module/modules/project2. 创建子模块子模块是实际的代码模块可以是普通的 Java 项目、Web 应用等。每个子模块都有自己的 pom.xml 文件但需要声明父项目projectparentgroupIdcom.example/groupIdartifactIdparent-project/artifactIdversion1.0.0/version/parentmodelVersion4.0.0/modelVersionartifactIdmodule1/artifactId/project多模块项目依赖管理在多模块项目中模块之间可以相互依赖。例如 module2 依赖 module1project!-- module2 的 pom.xml --dependenciesdependencygroupIdcom.example/groupIdartifactIdmodule1/artifactIdversion${project.version}/version/dependency/dependencies/project依赖继承父项目可以定义公共依赖子模块会自动继承这些依赖project!-- 父项目 pom.xml --dependencyManagementdependenciesdependencygroupIdjunit/groupIdartifactIdjunit/artifactIdversion4.12/versionscopetest/scope/dependency/dependencies/dependencyManagement/project子模块只需声明依赖的 groupId 和 artifactId无需指定版本project!-- 子模块 pom.xml --dependenciesdependencygroupIdjunit/groupIdartifactIdjunit/artifactId/dependency/dependencies/project多模块项目构建1. 构建整个项目在父项目目录下执行mvn clean install这会按照依赖顺序构建所有子模块。2. 构建单个模块进入特定模块目录执行cd module1mvn clean install或者从父项目目录指定模块mvn -pl module1 clean install3. 构建模块及其依赖mvn -pl module1 -am clean install多模块项目最佳实践1. 合理的模块划分按功能划分模块按层次划分模块(如 dao, service, web)公共工具提取到单独模块2. 版本管理使用父项目统一管理版本号考虑使用 Maven 的版本插件管理版本升级3. 构建优化配置适当的构建顺序使用 profile 管理不同环境的构建考虑并行构建提高效率4. 依赖管理在父项目中集中管理公共依赖使用 dependencyManagement 统一版本避免循环依赖常见问题与解决方案1. 循环依赖问题问题模块 A 依赖模块 B模块 B 又依赖模块 A解决方案重新设计模块结构提取公共代码到第三个模块使用接口解耦2. 构建顺序问题问题Maven 不能正确识别模块间的依赖顺序解决方案显式声明模块依赖关系使用 reactor 插件分析构建顺序3. 版本不一致问题问题不同模块使用不同版本的依赖解决方案在父项目中统一管理依赖版本使用 dependencyManagement通过合理使用 Maven 多模块项目管理可以显著提高大型项目的可维护性和构建效率。掌握这些技巧将帮助你更好地组织和管理复杂的 Java 项目。