构建与依赖 / 系统课时

声明第一个项目依赖

声明第一个项目依赖

这一课把一个真实的第三方库加入 Maven 项目,并用编译和依赖树两种方式确认它已经进入主代码的编译类路径。完成后,你会知道坐标写在哪里、默认作用域是什么,以及依赖声明正确但代码仍找不到类时该从哪里查。

学习目标

  • 能在 pom.xml 的 dependencies 中写出完整依赖坐标。
  • 能用 mvn compile 和 mvn dependency:tree 验证依赖是否被解析并进入编译类路径。
  • 能区分坐标错误、作用域错误和本地缓存问题。

用坐标声明依赖

Maven 用 groupId、artifactId、version 唯一确定一个构件。下面使用真实存在的 Apache Commons Lang 3.14.0;scope 省略时默认为 compile,因此主代码编译、测试和运行时都可以使用它。

xml
<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 会在导入或符号解析阶段失败,而不是等到运行时才暴露问题。

java
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 的目录执行:

bash
mvn compile

预期输出的关键行如下,插件版本和耗时可能因 Maven 版本与本机缓存不同而变化:

text
[INFO] BUILD SUCCESS

看到 BUILD SUCCESS 只能证明编译通过;下一步还要确认 Maven 解析到的确实是预期坐标和作用域。

用依赖树验证解析结果

dependency:tree 会显示最终解析后的版本与 scope。针对单个构件加 includes 可以避免被大量传递依赖淹没,特别适合排查“明明写了 dependency,实际却用了别的版本”的情况。

bash
mvn dependency:tree -Dincludes=org.apache.commons:commons-lang3

预期输出的关键部分为:

text
[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 最终使用的是解析后的有效依赖模型。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

声明第一个项目依赖

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通