构建与依赖 / 系统课时
声明第一个项目依赖
声明第一个项目依赖
这一课把一个真实的第三方库加入 Maven 项目,并用编译和依赖树两种方式确认它已经进入主代码的编译类路径。完成后,你会知道坐标写在哪里、默认作用域是什么,以及依赖声明正确但代码仍找不到类时该从哪里查。
学习目标
- 能在
pom.xml的dependencies中写出完整依赖坐标。 - 能用
mvn compile和mvn dependency:tree验证依赖是否被解析并进入编译类路径。 - 能区分坐标错误、作用域错误和本地缓存问题。
用坐标声明依赖
Maven 用 groupId、artifactId、version 唯一确定一个构件。下面使用真实存在的 Apache Commons Lang 3.14.0;scope 省略时默认为 compile,因此主代码编译、测试和运行时都可以使用它。
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.example</groupId>
<artifactId>dependency-demo</artifactId>
<version>1.0.0</version>
<properties>
<maven.compiler.release>17</maven.compiler.release>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
<dependencies>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-lang3</artifactId>
<version>3.14.0</version>
</dependency>
</dependencies>
</project>这个 POM 的关键结果是 commons-lang3-3.14.0.jar 会参与 compile 类路径。首次构建时 Maven 还会把构件下载到本地仓库,默认位置通常是用户目录下的 .m2/repository。
在源码中确认编译类路径
在项目下创建 src/main/java/com/example/App.java。这里直接导入 StringUtils;如果依赖没有进入编译类路径,mvn compile 会在导入或符号解析阶段失败,而不是等到运行时才暴露问题。
package com.example;
import org.apache.commons.lang3.StringUtils;
public class App {
public static void main(String[] args) {
String value = " ";
System.out.println(StringUtils.isBlank(value));
}
}在包含 pom.xml 的目录执行:
mvn compile预期输出的关键行如下,插件版本和耗时可能因 Maven 版本与本机缓存不同而变化:
[INFO] BUILD SUCCESS看到 BUILD SUCCESS 只能证明编译通过;下一步还要确认 Maven 解析到的确实是预期坐标和作用域。
用依赖树验证解析结果
dependency:tree 会显示最终解析后的版本与 scope。针对单个构件加 includes 可以避免被大量传递依赖淹没,特别适合排查“明明写了 dependency,实际却用了别的版本”的情况。
mvn dependency:tree -Dincludes=org.apache.commons:commons-lang3预期输出的关键部分为:
[INFO] com.example:dependency-demo:jar:1.0.0
[INFO] \- org.apache.commons:commons-lang3:jar:3.14.0:compile
[INFO] BUILD SUCCESS末尾的 compile 表示该依赖处于默认编译作用域。若这里显示了其他版本,应继续检查父 POM 或 dependencyManagement 是否覆盖了你在当前 POM 中预期的版本。
依赖未生效时按顺序定位
先不要反复删除 .m2。按“坐标是否解析 → scope 是否正确 → 源码包名是否匹配 → 本地缓存是否异常”的顺序检查,通常能更快定位问题。
| 现象 | 优先检查 | 可执行修正 |
|---|---|---|
Could not find artifact |
groupId、artifactId、version 是否真实存在 |
核对坐标后执行 mvn -U compile 强制检查更新 |
package ... does not exist |
依赖是否为 runtime/test,或导入包名写错 |
用 mvn dependency:tree 查看最终 scope |
| 版本与 POM 中写的不一致 | 父 POM、BOM、dependencyManagement |
执行 mvn help:effective-pom 查看有效 POM |
| 只在一台机器失败 | 本地仓库下载损坏或镜像配置差异 | 删除该构件对应目录后重新构建,不要清空整个仓库 |
声明依赖时先保证坐标准确,再用编译结果确认“能不能用”,最后用依赖树确认“实际用了谁”。这三步比只看 pom.xml 文本更可靠,因为 Maven 最终使用的是解析后的有效依赖模型。