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）。
典型错误配置：
DouPHP模块化企业网站管理系统是一款轻量级企业网站管理系统，基于PHP+MYSQL架构的，包含“手机版”、“公众号管理模块”、“小程序”，可以使用它快速搭建一个企业网站。 DouPHP功能特色： （模块全部免费，一键安装） 功能性模块：防伪查询模块、投票模块、自定义表单模块、工单模块等、会员模块、订单模块、视频模块、下载模块、图片模块等； 企业官网模块：业务范围
<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 构建时可能因为间接依赖版本不一致而突然失败。
