Java实战如何使用Maven管理项目依赖_pom.xml生命周期与常用插件打包配置-java教程-PHP中文网

正确设置可避免 noclassdeffounderror，因它严格控制依赖在编译、测试、运行时的可见性：compile 全阶段参与但会传递，provided 仅编译测试期生效且不打包，runtime 不参与编译但进运行时，test 仅限测试代码。

java实战如何使用maven管理项目依赖_pom.xml生命周期与常用插件打包配置

因为 Maven 的依赖传递和类路径（classpath）构建完全由 <scope></scope> 控制。它不是可有可无的修饰，而是决定“这个 jar 在编译、测试、运行时到底能不能被看见”的开关。

compile（默认）：参与编译、测试、打包、运行；但会传递给下游项目 —— 如果你写的工具包引用了 slf4j-api 并设为 compile，下游项目就得自己管实现（比如 slf4j-simple），否则启动就炸
provided：只在编译和测试期生效，打包时剔除 —— 适合 servlet-api 这类由容器（Tomcat）提供的依赖，写成 compile 会导致本地跑得通、部署到 Tomcat 后因版本冲突而 LinkageError
runtime：不参与编译，但进包、进运行时 —— 典型如 mysql-connector-java，接口在 JDK 里（java.sql.*），实现才需要加载
test：仅限 src/test/java，打出来的 jar 里根本不会包含它

maven-jar-plugin 只负责把 src/main/classes 打成普通 jar；想一键运行，必须用 maven-shade-plugin 把所有依赖“揉”进去，并指定入口类。

OpenJDK 24

OpenJDK 24 Windows x64 官方参考实现（24+36），适合 Windows 环境进行 Java 开发、编译、运行和版本兼容性验证。

下载

别在 <plugins></plugins> 里漏掉 <configuration></configuration> 中的 <mainclass></mainclass> —— 缺了它，java -jar xxx.jar 会报 no main manifest attribute
如果项目用了 Spring Boot，直接用 spring-boot-maven-plugin，它内部已封装好 shade 逻辑；混用 maven-shade-plugin 可能导致 META-INF/spring.* 覆盖丢失，启动失败
shade 插件默认会合并同名资源（如 META-INF/MANIFEST.MF），遇到 Invalid signature file digest 错误，加 <transformer implementation="org.apache.maven.plugins.shade.resource.DontIncludeResourceTransformer"><resource>META-INF/*.SF</resource></transformer>

测试类路径 ≠ 主代码类路径。Maven 默认用 maven-surefire-plugin 执行测试，它的 classpath 构建规则独立于主流程，且老版本（2.12 之前）不自动包含 test scope 依赖的传递依赖。

确认 test 依赖是否显式声明 —— 比如 junit-jupiter 必须带 <scope>test</scope>，否则 src/test/java 里 import 都过不了
升级 maven-surefire-plugin 到 2.22.2+，否则像 mockito-core 这种通过 test 传递进来的依赖，在测试运行时可能根本不在 classpath 上
如果用了 JUnit 5，必须额外加 junit-platform-surefire-provider（旧版）或直接用 surefire 2.22.2+ 内置支持 —— 否则 mvn test 会静默跳过所有测试

因为 Maven 默认只从本地仓库（~/.m2/repository）解析 SNAPSHOT 依赖，而 mvn compile 不触发安装，子模块无法“看到”父模块刚编译出的 class —— 它不是缓存问题，是生命周期阶段没走完。

开发时别只跑 mvn compile，改完父模块后至少执行 mvn install（把 jar 安装进本地仓库），子模块才能拉到
更高效的做法是用 mvn compile -pl :child-module -am：强制先编译父模块（-am），再编译子模块（-pl），跳过 install 步骤
CI 环境中若用 mvn deploy 推送到远程仓库，注意 Nexus/Artifactory 对 SNAPSHOT 的时间戳快照策略 —— 本地 mvn clean install 后立刻 mvn test 可能仍读到旧快照，需加 -U 强制更新