0

0

Maven pom.xml build resources 将XML文件打包进JAR的方法

月夜之吻

月夜之吻

发布时间:2026-02-13 09:26:04

|

594人浏览过

|

来源于php中文网

原创

xml文件未进jar是因为maven默认只处理src/main/resources目录,若放在其他路径(如src/main/config)需在pom.xml中通过显式配置对应及规则。

maven pom.xml build resources 将xml文件打包进jar的方法

为什么 resources 目录下的 XML 文件没进 JAR?

默认情况下,Maven 只把 src/main/resources 下的文件复制进 target/classes,再打包进 JAR;但如果你把 XML 放在别的路径(比如 src/main/configsrc/main/xml),它根本不会被扫描——不是打包失败,是压根没被发现。

常见错误现象:java.lang.ClassNotFoundExceptiongetResourceAsStream("xxx.xml") 返回 null,查 jar -tf your-app.jar 确实没有那个文件。

  • 确认 XML 是否真在 src/main/resources 下;如果不是,必须显式配置 <resources></resources>
  • Maven 不识别 .xml 为“非资源”,它只认目录位置和 <includes></includes> 规则
  • IDE(如 IntelliJ)可能自动刷新 classpath,但 mvn package 不会——以命令行为准

如何用 <build><resources></resources></build> 包含自定义 XML 路径?

pom.xml<build></build> 块里加 <resources></resources>,告诉 Maven:“这些目录也当资源处理”。关键不是“加 XML”,而是“加路径”。

示例:要把 src/main/config/ 下所有 .xml.properties 打进去:

FineVoice
FineVoice

FineVoice是一种AI数字语音解决方案,可以帮助用户增强声音,并配有实时变声器

下载
<build>
  <resources>
    <resource>
      <directory>src/main/resources</directory>
    </resource>
    <resource>
      <directory>src/main/config</directory>
      <includes>
        <include>**/*.xml</include>
        <include>**/*.properties</include>
      </includes>
    </resource>
  </resources>
</build>
  • 每个 <resource></resource> 是独立路径,<includes></includes> 只对当前 <directory></directory> 生效
  • 不写 <includes></includes> 就全量包含(包括子目录下所有文件),但建议显式限定,避免误打测试数据或临时文件
  • <directory></directory> 必须是相对 pom.xml 的路径,不能用 ../ 向上跳转

XML 文件被过滤(filtering)后格式错乱怎么办?

如果启用了 <filtering>true</filtering>,Maven 会尝试替换 ${xxx} 占位符——这对 properties 文件有用,但对 XML 容易破坏结构(比如把 <bean></bean> 里的 ${id} 替换掉,或误解析 CDATA)。

  • 默认 <filtering></filtering>false,只有你主动设为 true 才会触发
  • 如果 XML 里真有需要替换的变量(如环境相关 URL),单独为它开一个 <resource></resource> 并设 <filtering>true</filtering>,其他 XML 保持 false
  • 常见症状:JAR 里 XML 出现空行、标签截断、< 实体化——基本就是 filtering 搞的鬼

打包后 XML 在 JAR 里的路径和代码中 getResource 怎么对应?

Maven 把资源复制到 target/classes 时,保留原始子目录结构;JAR 里路径 = src/main/resources 或你配置的 <directory></directory> 下的相对路径。代码里必须按这个路径找。

比如 XML 在 src/main/resources/conf/app-config.xml,那运行时要用:

getClass().getResource("/conf/app-config.xml") // 开头带 / 表示从 classpath 根开始
// 或
getClass().getResourceAsStream("/conf/app-config.xml")
  • 路径区分大小写,Linux/CI 环境下尤其容易因大小写不一致导致 null
  • 不要写成 src/main/resources/conf/app-config.xml——那是开发路径,不是 classpath 路径
  • 如果 XML 在 src/main/config/app.xml 且你已配好 <resource></resource>,那路径就是 /app.xml(因为 src/main/config 是根级目录)

最常被忽略的是路径层级和斜杠方向——写错一个字符,getResourceAsStream 就静默返回 null,连异常都不抛。

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

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
Java Maven专题
Java Maven专题

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

0

2025.09.15

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

244

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

706

2024.03.01

resource是什么文件
resource是什么文件

Resource文件是一种特殊类型的文件,它通常用于存储应用程序或操作系统中的各种资源信息。它们在应用程序开发中起着关键作用,并在跨平台开发和国际化方面提供支持。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

167

2023.12.20

pdf怎么转换成xml格式
pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法:1. 使用在线转换器;2. 使用桌面软件(如 adobe acrobat、itext);3. 使用命令行工具(如 pdftoxml)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1927

2024.04.01

xml怎么变成word
xml怎么变成word

步骤:1. 导入 xml 文件;2. 选择 xml 结构;3. 映射 xml 元素到 word 元素;4. 生成 word 文档。提示:确保 xml 文件结构良好,并预览 word 文档以验证转换是否成功。想了解更多xml的相关内容,可以阅读本专题下面的文章。

2101

2024.08.01

xml是什么格式的文件
xml是什么格式的文件

xml是一种纯文本格式的文件。xml指的是可扩展标记语言,标准通用标记语言的子集,是一种用于标记电子文件使其具有结构性的标记语言。想了解更多相关的内容,可阅读本专题下面的相关文章。

1120

2024.11.28

磁盘配额是什么
磁盘配额是什么

磁盘配额是计算机中指定磁盘的储存限制,就是管理员可以为用户所能使用的磁盘空间进行配额限制,每一用户只能使用最大配额范围内的磁盘空间。php中文网为大家提供各种磁盘配额相关的内容,教程,供大家免费下载安装。

1500

2023.06.21

pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法

本专题系统整理pixiv网页版官网入口及登录访问方式,涵盖官网登录页面直达路径、在线阅读入口及快速进入方法说明,帮助用户高效找到pixiv官方网站,实现便捷、安全的网页端浏览与账号登录体验。

23

2026.02.13

热门下载

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

精品课程

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号