Maven中定义的版本在中不生效，根本原因是属性仅作文本替换，而不支持直接引用自定义属性；必须通过声明才能实现版本统一控制。

为什么 <properties></properties> 里定义的版本号在 <dependency></dependency> 中不生效

常见现象是：在 <properties></properties> 里写了 <spring-boot.version>3.2.0</spring-boot.version>，但在 <dependencies></dependencies> 里写 <version>${spring-boot.version}</version>，结果构建失败或版本没被替换——根本原因是 Maven 属性解析顺序问题：<properties></properties> 只对当前 POM 生效，而 <dependency></dependency> 的 <version></version> 不支持直接引用自定义属性（除非该依赖属于 BOM 或 parent 声明的管理范围）。

真正能用属性控制版本的场景，只适用于以下情况：

• 该依赖的 <groupid></groupid> 和 <artifactid></artifactid> 在 <dependencymanagement></dependencymanagement> 中已声明过 <version></version>（此时可省略或留空）
• 你用的是 Spring Boot 的 spring-boot-starter-parent，它把常用依赖的版本都放进 <dependencymanagement></dependencymanagement> 了，所以 ${spring-boot.version} 才能间接起作用
• 你手动在 <dependencymanagement></dependencymanagement> 中用属性占位，例如：

  <dependencyManagement>
    <dependencies>
      <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
        <version>${spring-boot.version}</version>
      </dependency>
    </dependencies>
  </dependencyManagement>

<properties></properties> 定义版本变量时，哪些命名习惯会埋坑

Maven 对属性名本身没硬性限制，但实际协作中容易因命名模糊导致误用。比如写成 <version>2.7.18</version>，这个 version 会被 Maven 内置属性覆盖（Maven 自带 version 表示当前模块版本），导致不可预期的行为。

安全做法是统一加前缀，明确作用域：

• 用 spring-boot.version 而不是 version —— 避免和内置属性冲突
• 避免点号过多，如 com.example.mylib.version；虽然合法，但某些 IDE 或插件解析异常，推荐用短横线：mylib-version
• 不要在 <properties></properties> 里写表达式，如 ${project.version}-SNAPSHOT；Maven 不支持嵌套解析，会原样保留字符串

想让子模块也复用父 POM 的版本变量，必须满足什么条件

子模块能读到父 POM 的 <properties></properties>，前提是它正确继承了父 POM。但很多人忽略了关键一点：子模块的 pom.xml 必须显式声明 <parent></parent>，且 <relativepath></relativepath> 指向正确（默认是 ../pom.xml）。

典型错误配置：

<parent>
  <groupId>com.example</groupId>
  <artifactId>parent-project</artifactId>
  <version>1.0.0</version>
  <!-- 缺少 relativePath，Maven 会去远程仓库找，而不是本地文件系统 -->
</parent>

正确写法：

<parent>
  <groupId>com.example</groupId>
  <artifactId>parent-project</artifactId>
  <version>1.0.0</version>
  <relativePath>../pom.xml</relativePath>
</parent>

另外注意：<properties></properties> 是“继承”而非“导入”，子模块不能覆盖父模块同名属性（除非用 -D 命令行参数强制覆盖）。

用 <properties></properties> 管理版本，和用 <dependencymanagement></dependencymanagement> 有什么本质区别

这是最容易混淆的点。<properties></properties> 只是文本替换，不参与依赖解析逻辑；<dependencymanagement></dependencymanagement> 是 Maven 的依赖仲裁机制，决定最终引入哪个版本、是否传递、是否可选。

举个例子：

• 你在 <properties></properties> 里设了 <junit.version>5.10.0</junit.version>，又在两个不同依赖里分别写了 ${junit.version} 和 5.9.2 —— Maven 不会帮你统一，也不会报错，只是按字面值插入
• 但如果你在 <dependencymanagement></dependencymanagement> 中声明了 junit-jupiter 的 <version>5.10.0</version>，那么所有子模块只要声明该依赖（哪怕不写 <version></version>），都会强制使用 5.10.0
• 性能影响几乎为零，但语义完全不同：一个管“写法简洁”，一个管“依赖一致性”

复杂点在于，很多团队把两者混着用，以为写了属性就等于统一了版本——其实只有配合 <dependencymanagement></dependencymanagement> 才真正生效。这点一旦漏掉，CI 构建时可能因为间接依赖版本不一致而突然失败。