讲师中心 微信公众号
AI工具推荐 视频效率加速

怎么利用Maven的pom.xml文件管理项目所需的第三方Jar包依赖

秋杰同学_4044

秋杰同学_4044

发布时间:2026-04-08 20:46:06

|

821人浏览过

|

来源于php中文网

原创

依赖声明必须写在<dependencies>标签内,每个<dependency>至少含<groupId>、<artifactId>、<version>;scope控制生效阶段,默认compile;传递依赖冲突用<exclusions>精准排除;本地Jar应安装到本地仓库而非用system scope。

怎么利用maven的pom.xml文件管理项目所需的第三方jar包依赖

依赖声明必须写在 <dependencies> 标签下

不是所有 XML 节点都能放依赖,pom.xml 中只有 <dependencies> 及其子节点 <dependency> 是合法位置。写在 <build>、<properties> 或根节点下都无效,Maven 会直接忽略。

每个 <dependency> 至少要包含三个字段:<groupId>、<artifactId>、<version>。例如引入 Jackson JSON 处理库:

<dependency>
  <groupId>com.fasterxml.jackson.core</groupId>
  <artifactId>jackson-databind</artifactId>
  <version>2.15.2</version>
</dependency>
  • <groupId> 通常对应 Java 包名倒序(如 org.springframework),但不是绝对;它本质是 Maven 仓库中的命名空间
  • <artifactId> 是模块名,和 Jar 文件名前缀一致(如 jackson-databind-2.15.2.jar)
  • <version> 推荐用具体版本号,避免用 LATEST 或 RELEASE —— 它们已被 Maven 3.9+ 默认禁用,且破坏构建可重现性

scope 属性决定依赖何时生效,别乱设 provided 或 test

scope 控制依赖参与编译、运行、测试等阶段的时机。默认是 compile,即全生命周期可用;但常见误用是把本该运行时才需要的包(如 Servlet API)设为 compile,导致打包进 WAR 后与容器冲突。

  • provided:仅编译和测试期有效,运行时不提供(如 javax.servlet-api)。打成 WAR 部署到 Tomcat 时,必须设这个,否则会和容器自带的类重复
  • test:只在 mvn test 阶段可用(如 junit-jupiter)。若在 main 代码里 import,编译直接报错
  • runtime:不参与编译,但运行时需要(如 JDBC 驱动 mysql-connector-java)。IDE 可能提示“找不到符号”,这是正常现象

依赖传递性常引发版本冲突,优先用 <exclusions> 而非盲目升级

Maven 自动拉取间接依赖(比如你引入 Spring Boot Starter Web,它又依赖 Spring Core、Jackson、Tomcat Embed 等),但不同 starter 可能带不同版本的同一依赖(如两个库分别依赖 slf4j-api:1.7.36 和 slf4j-api:2.0.7),此时 Maven 按“路径最短优先”选一个,可能选错。

查冲突用命令:mvn dependency:tree -Dverbose。看到警告如 omitted for conflict with 1.7.36 就说明被丢弃了。

  • 不要一上来就全局 <properties> 覆盖所有版本,容易引发兼容问题
  • 精准排除干扰项更安全:在冲突依赖的 <dependency> 内加 <exclusions>,例如排除掉某个 starter 带的旧版 Logback
  • 真正需要统一版本时,用 <dependencyManagement> 块集中声明,它只“约定”不“引入”,子模块仍需显式声明依赖

本地 Jar 包不能直接扔进 lib/ 目录,得用 system scope 或安装到本地仓库

把第三方 Jar 拷进项目 lib/ 并在 IDE 里手动 Add to Build Path,Maven 打包(mvn package)时根本不会包含它 —— 因为 Maven 不认这个路径。

  • 临时方案(不推荐长期用):用 system scope,指定 <systemPath> 绝对或相对路径,但该依赖不会上传到远程仓库,协作时别人构建必失败
  • 正确做法:用 mvn install:install-file 把 Jar 安装进本地 ~/.m2/repository,再像普通依赖一样声明 <groupId>、<artifactId>、<version>
  • 企业级场景应搭建私有 Nexus/Artifactory,把内部 Jar deploy 上去,而非依赖本地文件

依赖管理真正的复杂点不在写法,而在于理解“谁真正加载了这个类”——运行时 ClassLoader 层级、容器环境、打包方式(jar vs war vs fat jar)都会让同一个 pom.xml 表现出不同行为。动手前先想清楚:这个包,是在编译期检查语法?测试期构造对象?还是运行期连接数据库?答案不同,配置就完全不同。

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

LibLibAI
LibLibAI Hot

一款AI视频创作工具,主要用于国内领先的AI创意平台,以海量模型、低门槛操作与“创作-分享-商业化”生态,让小白与专业创作者都能高效实现图文乃至视频创意表达,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

相关专题

更多
Java Maven专题
Java Maven专题

本专题聚焦 Java 主流构建工具 Maven 的学习与应用,系统讲解项目结构、依赖管理、插件使用、生命周期与多模块项目配置。通过企业管理系统、Web 应用与微服务项目实战,帮助学员全面掌握 Maven 在 Java 项目构建与团队协作中的核心技能。

3540

2025.09.15

Java Maven/Gradle 构建与依赖管理合集
Java Maven/Gradle 构建与依赖管理合集

系统讲解 Java 项目构建工具的使用与进阶配置,涵盖 Maven 的 POM 文件结构、生命周期(clean/compile/package/install/deploy)与插件机制、依赖范围(compile/provided/test/runtime)与传递依赖管理、多模块聚合与继承、私有 Nexus 仓库发布,以及 Gradle 的 Groovy / Kotlin DSL 语法、Task 自定义与增量构建、依赖版本目录(Versi

349

2026.05.09

PixTV官网入口地址合集
PixTV官网入口地址合集

本专题汇总了 PixTV AI 一站式视频创作平台的官方入口与使用教程。无需下载软件,浏览器直接访问即可使用。平台将剧本、图像、视频、声音与剪辑整合在“无限画布”中,接入 GPT Image 2.5、Seedance 2.5 等头部模型。本专题整理了从新建画布、角色锚定、分镜拆分到视频生成与导出的完整操作指南,助你快速上手 AI 短剧与漫剧创作。

60

2026.10.10

Kratos框架HTTP与gRPC服务开发教程
Kratos框架HTTP与gRPC服务开发教程

本专题围绕Kratos框架双协议服务开发,涵盖HTTP路由与处理器编写、参数获取、gRPC服务实现与客户端调用、metadata上下文传递、encoding编解码注册、统一响应封装、超时控制与流式响应实现方法。

20

2026.10.10

Kratos框架Protobuf接口定义与代码生成合集
Kratos框架Protobuf接口定义与代码生成合集

本专题讲解Kratos框架接口定义体系,涵盖proto编写规范、proto add/client/server生成命令、http注解路由、validate校验、OpenAPI文档生成、跨服务proto复用与兼容性设计。

20

2026.10.10

C++虚函数怎么定义和调用
C++虚函数怎么定义和调用

C++虚函数是实现运行时多态的重要机制。本专题从virtual关键字的基本用法入手,介绍基类与派生类之间的函数重写、基类指针调用派生类方法,以及动态绑定的执行过程,帮助初学者掌握虚函数的核心语法。

20

2026.10.10

C++类与对象的封装方法教程
C++类与对象的封装方法教程

C++封装是面向对象编程的核心特性之一,通过类将数据与操作数据的函数组织在一起,并利用访问权限控制外部访问。本专题介绍类的定义、成员变量、成员函数以及public、private和protected的使用方法,帮助初学者掌握封装的基本原理。

20

2026.10.10

C++构造函数定义与调用方法
C++构造函数定义与调用方法

C++构造函数用于初始化类对象,是面向对象编程的重要基础。本专题从构造函数的定义、声明和调用入手,介绍默认构造函数、带参数构造函数、拷贝构造函数及成员初始化列表,帮助初学者掌握对象创建与初始化的基本方法。

20

2026.10.10

Kratos框架零基础入门教程
Kratos框架零基础入门教程

本专题整理Kratos框架入门内容,涵盖Go环境准备、kratos CLI安装升级、new命令创建项目、目录结构分层说明、服务启动与双协议端口、依赖下载报错排查,帮助开发者快速跑通第一个Kratos框架微服务应用。

20

2026.10.10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn