Maven pom.xml dependency management 统一管理依赖版本号

dependencymanagement仅统一管理依赖版本，不引入实际依赖；必须在dependencies中声明groupid和artifactid才生效，否则报classnotfoundexception。

dependencyManagement 为什么不能直接引入依赖

它只管版本号，不管是否生效。你在 dependencyManagement 里写了 spring-boot-starter-web 的版本，但没在 dependencies 里声明，项目里就压根不会拉这个包。

• 典型错误现象：ClassNotFoundException 或 ide 显示类不可用，但 pom.xml 里明明写了版本
• 正确姿势：把公共依赖的版本和 scope 放到 dependencyManagement；子模块需要时，在自己 dependencies 里只写 groupId 和 artifactId，不写 version
• scope 在 dependencyManagement 中声明后，会强制继承给所有引用该依赖的模块（除非子模块显式覆盖）

子模块里 version 写错会导致 dependencyManagement 失效

只要子模块的 dependency 块里写了 version，maven 就会优先用它，完全忽略 dependencyManagement 的设定——这不是 bug，是设计行为。

• 常见坑：复制粘贴依赖时忘了删 <version>1.2.3</version>，结果版本没统一
• 检查方法：运行 mvn dependency:tree -Dverbose，看实际解析出的版本是不是你期望的那个
• CI 可加检查：用 maven-enforcer-plugin 配置 banDuplicatePomDependencyVersions 规则，自动报错

import scope 的 bom 依赖必须放在 dependencyManagement 里

import 是唯一只能出现在 dependencyManagement 中的 scope，专门用来导入其他 BOM（Bill of Materials）文件，比如 spring boot 的 spring-boot-dependencies。

• 错误写法：<scope>import</scope> 放进普通 dependencies → 构建直接失败，报错 Unknown scope: import
• 正确位置：必须嵌套在 dependencyManagement > dependencies 里，且 type 得是 pom
• 注意顺序：多个 import 的 BOM，后声明的会覆盖先声明的同名依赖版本（不是合并）

多级 parent 继承下 dependencyManagement 的覆盖规则

父 POM 的 dependencyManagement 会被子 POM 自动继承，但如果子 POM 也定义了同 groupId+artifactId 的条目，就会完全替换父级的定义。

• 不会“叠加”：父定义了 A-1.0，子定义了 A-2.0，最终生效的是 2.0；子没定义 A，才用父的 1.0
• 跨模块协作时容易漏看：团队共用基础 parent，但某个业务模块悄悄覆盖了日志组件版本，导致全链路日志格式不一致
• 排查建议：用 mvn help:effective-pom 输出最终生效的 POM，搜索目标依赖名，一眼看到来源

事情说清了就结束。真正难的不是写对语法，而是让所有人——包括半年后回来看代码的你自己——都清楚某一行版本号到底由谁拍板、在哪生效、改了会影响哪些模块。