Java多模块项目集中管理公共参数的核心思路是将配置上提到父模块或独立config-module，通过Maven继承或Gradle ext属性统一注入子模块，并支持子模块覆盖和profile环境切换。

在 Java 多模块项目中，集中管理公共参数的核心思路是：把配置“上提”到父模块（或独立配置模块），通过构建工具能力注入子模块，避免重复定义和版本错乱。

用 Maven 父 POM 统一定义 properties

Maven 的父子继承机制天然支持集中配置。在根项目的 pom.xml 中声明通用属性，所有子模块自动继承：

• 在 标签下定义参数，如：
  3.2.0
1.4.14
• 子模块的 pom.xml 不需重复声明，直接在 中引用：
  ${spring-boot.version}
• 还可统一配置插件参数，例如编译 JDK 版本、源码编码、测试超时等

抽离独立的 config-module（推荐用于运行时参数）

若参数需在运行时生效（如数据库 URL、API 密钥前缀），建议新建一个 config 模块（打包类型为 jar），专门存放类型安全的配置类：

• 该模块只含 @ConfigurationProperties 类和 application.yml（或 application.properties）
• 其他业务模块依赖它：
  

  <dependency><br><groupid>com.example</groupid><br><artifactid>config</artifactid><br></dependency>

• Spring Boot 项目启动时自动加载，且支持 profile 激活不同环境配置

Gradle 多模块下的集中配置方式

Gradle 通过 root build.gradle 或 gradle.properties 实现类似效果：

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

• 在 gradle.properties 中定义：
  springBootVersion=3.2.0
commonLibVersion=1.5.2
• 在根 build.gradle 的 subprojects 块中统一应用：
  ext { springBootVersion = project.findProperty("springBootVersion") ?: "3.2.0" }
• 子模块中直接引用：
  implementation "org.springframework.boot:spring-boot-starter-web:$springBootVersion"

避免硬编码 + 保证可覆盖性

集中配置不等于“不可变”。关键原则是：允许子模块按需覆盖，但默认走统一值：

• Maven 中，子模块可在自身 pom.xml 里重写同名 ，优先级更高
• Gradle 中，子模块 build.gradle 可重新赋值 ext.springBootVersion
• 运行时配置（如 YAML）应设计为“基础值 + profile 覆盖”，而非全量复制

不复杂但容易忽略的是：集中配置必须配套版本收敛策略和定期审计机制，否则容易演变成“表面统一、实际分散”的假象。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南