1. Maven依赖管理入门从零配置pom.xml刚接触Maven时我最头疼的就是明明在pom.xml里写了依赖代码里却总是报红。后来才发现依赖管理是个闭环操作从声明到使用有完整链路。先来看个最简单的pom.xml骨架?xml version1.0 encodingUTF-8? project xmlnshttp://maven.apache.org/POM/4.0.0 xmlns:xsihttp://www.w3.org/2001/XMLSchema-instance xsi:schemaLocationhttp://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd modelVersion4.0.0/modelVersion groupIdcom.mycompany/groupId artifactIddemo/artifactId version1.0-SNAPSHOT/version dependencies !-- 这里添加依赖 -- /dependencies /project添加依赖时要注意三个关键属性groupId组织标识类似Java包名artifactId项目名称version版本号比如要添加JUnit测试框架dependency groupIdjunit/groupId artifactIdjunit/artifactId version4.13.2/version scopetest/scope /dependency这里出现了一个重要概念——scope。它决定了依赖的作用范围compile默认编译、测试、运行都有效test仅测试时使用如JUnitprovided编译和测试需要但运行时由容器提供如Servlet APIruntime运行时才需要如JDBC驱动2. 依赖下载与本地仓库验证在IDEA中保存pom.xml后记得点击Maven面板的刷新按钮或者右键pom.xml选择Maven - Reload Project。这时可能会遇到第一个坑——下载速度慢。建议配置阿里云镜像!-- 在settings.xml或pom.xml中配置 -- mirror idaliyunmaven/id mirrorOf*/mirrorOf name阿里云公共仓库/name urlhttps://maven.aliyun.com/repository/public/url /mirror验证依赖是否下载成功有三种方式查看本地仓库默认在用户目录的.m2/repository下会按groupId/artifactId/version的路径存放IDEA的External Libraries展开项目结构应该能看到新增的jar包命令行验证mvn dependency:tree我曾经遇到依赖下载不全的情况这时候可以尝试删除本地仓库中对应的文件夹重新下载执行mvn clean install -U强制更新快照版本3. 代码中的依赖导入与使用当依赖成功下载后在Java类中就可以import了。以常用的Apache Commons Lang为例import org.apache.commons.lang3.StringUtils; public class Main { public static void main(String[] args) { String str hello; System.out.println(StringUtils.capitalize(str)); // 输出Hello } }如果遇到代码报红但依赖确实存在的情况可以尝试右键项目 - Maven - ReimportFile - Invalidate Caches检查JDK版本是否匹配我踩过JDK11项目用JDK1.8编译的坑4. 依赖冲突与关系图分析当引入多个依赖时可能会遇到版本冲突。比如项目A依赖X 1.0项目B依赖X 2.0这时Maven会根据依赖调解原则选择版本最短路径优先直接依赖优先级高于传递依赖先声明优先在pom.xml中先声明的依赖优先查看依赖关系图特别有用mvn dependency:tree -Dverbose在IDEA中也可以安装Maven Helper插件它能直观显示冲突依赖。我曾经遇到Spring Boot和Hibernate版本冲突就是通过这个插件发现并解决的。对于需要排除的传递依赖可以这样处理dependency groupIdcom.example/groupId artifactIdsome-library/artifactId version1.0/version exclusions exclusion groupIdconflict-group/groupId artifactIdconflict-artifact/artifactId /exclusion /exclusions /dependency5. 常见问题排查指南问题1依赖下载成功但代码报红检查scope是否设置正确比如test范围的依赖不能在main代码中使用查看File - Project Structure - Modules里依赖是否正常引入问题2编译通过但运行时报ClassNotFound可能是runtime依赖没有打包进去使用mvn package后检查target目录下的jar包内容问题3SNAPSHOT版本不更新添加-U参数强制更新mvn clean install -U问题4本地修改的依赖不生效需要先执行mvn install安装到本地仓库6. 高级技巧BOM与依赖管理对于大型项目推荐使用dependencyManagement统一管理版本号dependencyManagement dependencies dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-dependencies/artifactId version2.7.0/version typepom/type scopeimport/scope /dependency /dependencies /dependencyManagement这样后续声明Spring Boot相关依赖时就不需要写version了。企业级项目通常会定义自己的parent POM来集中管理依赖版本。7. 实战从配置到打包的全流程最后来看个完整示例假设我们要开发一个使用Lombok和H2数据库的工具dependencies !-- 开发工具 -- dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId version1.18.24/version scopeprovided/scope /dependency !-- 测试 -- dependency groupIdorg.junit.jupiter/groupId artifactIdjunit-jupiter/artifactId version5.8.2/version scopetest/scope /dependency !-- 数据库 -- dependency groupIdcom.h2database/groupId artifactIdh2/artifactId version2.1.214/version /dependency /dependencies打包时要注意不同scope的依赖处理方式。使用maven-assembly-plugin可以打包含所有依赖的fat jarplugin groupIdorg.apache.maven.plugins/groupId artifactIdmaven-assembly-plugin/artifactId version3.3.0/version configuration descriptorRefs descriptorRefjar-with-dependencies/descriptorRef /descriptorRefs /configuration executions execution phasepackage/phase goals goalsingle/goal /goals /execution /executions /plugin执行mvn clean package后target目录下会生成两个jar文件选择*-jar-with-dependencies.jar运行即可。
