爆款云主机2核4G限时秒杀,88元/年起!
查看详情

活动

天翼云最新优惠活动,涵盖免费试用,产品折扣等,助您降本增效!
热门活动
  • 618智算钜惠季 爆款云主机2核4G限时秒杀,88元/年起!
  • 免费体验DeepSeek,上天翼云息壤 NEW 新老用户均可免费体验2500万Tokens,限时两周
  • 云上钜惠 HOT 爆款云主机全场特惠,更有万元锦鲤券等你来领!
  • 算力套餐 HOT 让算力触手可及
  • 天翼云脑AOne NEW 连接、保护、办公,All-in-One!
  • 中小企业应用上云专场 产品组合下单即享折上9折起,助力企业快速上云
  • 息壤高校钜惠活动 NEW 天翼云息壤杯高校AI大赛,数款产品享受线上订购超值特惠
  • 天翼云电脑专场 HOT 移动办公新选择,爆款4核8G畅享1年3.5折起,快来抢购!
  • 天翼云奖励推广计划 加入成为云推官,推荐新用户注册下单得现金奖励
免费活动
  • 免费试用中心 HOT 多款云产品免费试用,快来开启云上之旅
  • 天翼云用户体验官 NEW 您的洞察,重塑科技边界

智算服务

打造统一的产品能力,实现算网调度、训练推理、技术架构、资源管理一体化智算服务
智算云(DeepSeek专区)
科研助手
  • 算力商城
  • 应用商城
  • 开发机
  • 并行计算
算力互联调度平台
  • 应用市场
  • 算力市场
  • 算力调度推荐
一站式智算服务平台
  • 模型广场
  • 体验中心
  • 服务接入
智算一体机
  • 智算一体机
大模型
  • DeepSeek-R1-昇腾版(671B)
  • DeepSeek-R1-英伟达版(671B)
  • DeepSeek-V3-昇腾版(671B)
  • DeepSeek-R1-Distill-Llama-70B
  • DeepSeek-R1-Distill-Qwen-32B
  • Qwen2-72B-Instruct
  • StableDiffusion-V2.1
  • TeleChat-12B

应用商城

天翼云精选行业优秀合作伙伴及千余款商品,提供一站式云上应用服务
进入甄选商城进入云市场创新解决方案
办公协同
  • WPS云文档
  • 安全邮箱
  • EMM手机管家
  • 智能商业平台
财务管理
  • 工资条
  • 税务风控云
企业应用
  • 翼信息化运维服务
  • 翼视频云归档解决方案
工业能源
  • 智慧工厂_生产流程管理解决方案
  • 智慧工地
建站工具
  • SSL证书
  • 新域名服务
网络工具
  • 翼云加速
灾备迁移
  • 云管家2.0
  • 翼备份
资源管理
  • 全栈混合云敏捷版(软件)
  • 全栈混合云敏捷版(一体机)
行业应用
  • 翼电子教室
  • 翼智慧显示一体化解决方案

合作伙伴

天翼云携手合作伙伴,共创云上生态,合作共赢
天翼云生态合作中心
  • 天翼云生态合作中心
天翼云渠道合作伙伴
  • 天翼云代理渠道合作伙伴
天翼云服务合作伙伴
  • 天翼云集成商交付能力认证
天翼云应用合作伙伴
  • 天翼云云市场合作伙伴
  • 天翼云甄选商城合作伙伴
天翼云技术合作伙伴
  • 天翼云OpenAPI中心
  • 天翼云EasyCoding平台
天翼云培训认证
  • 天翼云学堂
  • 天翼云市场商学院
天翼云合作计划
  • 云汇计划
天翼云东升计划
  • 适配中心
  • 东升计划
  • 适配互认证

开发者

开发者相关功能入口汇聚
技术社区
  • 专栏文章
  • 互动问答
  • 技术视频
资源与工具
  • OpenAPI中心
开放能力
  • EasyCoding敏捷开发平台
培训与认证
  • 天翼云学堂
  • 天翼云认证
魔乐社区
  • 魔乐社区

支持与服务

为您提供全方位支持与服务,全流程技术保障,助您轻松上云,安全无忧
文档与工具
  • 文档中心
  • 新手上云
  • 自助服务
  • OpenAPI中心
定价
  • 价格计算器
  • 定价策略
基础服务
  • 售前咨询
  • 在线支持
  • 在线支持
  • 工单服务
  • 建议与反馈
  • 用户体验官
  • 服务保障
  • 客户公告
  • 会员中心
增值服务
  • 红心服务
  • 首保服务
  • 客户支持计划
  • 专家技术服务
  • 备案管家

了解天翼云

天翼云秉承央企使命,致力于成为数字经济主力军,投身科技强国伟大事业,为用户提供安全、普惠云服务
品牌介绍
  • 关于天翼云
  • 智算云
  • 天翼云4.0
  • 新闻资讯
  • 天翼云APP
基础设施
  • 全球基础设施
  • 信任中心
最佳实践
  • 精选案例
  • 超级探访
  • 云杂志
  • 分析师和白皮书
  • 天翼云·创新直播间
市场活动
  • 2025智能云生态大会
  • 2024智算云生态大会
  • 2023云生态大会
  • 2022云生态大会
  • 天翼云中国行
天翼云
  • 活动
  • 智算服务
  • 产品
  • 解决方案
  • 应用商城
  • 合作伙伴
  • 开发者
  • 支持与服务
  • 了解天翼云
      • 文档
      • 控制中心
      • 备案
      • 管理中心

      Spring Boot Jar 包启动时如何加载外部资源

      首页 知识中心 软件开发 文章详情页

      Spring Boot Jar 包启动时如何加载外部资源

      2023-08-07 07:23:20 阅读次数:435

      hive,jar,springboot

      在项目有读取特殊配置文件的地方(不是 Spring 的 application 配置),项目打包为 jar 后,无法从外部替换默认的配置文件。

      我自己尝试了 ​​java -cp​​ 的方式,发现没法启动(Spring Boot 打的包很特殊)。

      通过谷歌搜索查到:​​Spring Boot Executable Jar with Classpath​​

      其中 Peter Tarlos 的答案是完整的,本文的内容也是以这里为起点,通过查找官方文档来说明如何实现。

      1. ​​关键的 PropertiesLauncher​​

      ​​Executable Jars​​ Spring Boot’s executable jars, their launchers, and their format.

      在 Spring Boot 中,存在 3 种类型的启动器:

      • ​​JarLauncher​​
      • ​​WarLauncher​​
      • ​​PropertiesLauncher​​

      当打包为 jar 或 war 时选择的前两个,​​JarLauncher​​​ 从 ​​BOOT-INF/lib/​​​ 目录加载 jars,​​WarLauncher​​​ 从 ​​WEB-INF/lib/​​​ 和 ​​WEB-INF/lib-provided/​​ 加载 jars,如果想添加额外的 jars 就需要往这些目录添加。

      第三个 ​​PropertiesLauncher​​ 默认从 ​​BOOT-INF/lib/​​​ 目录加载 jars,你还可以通过 ​​LOADER_PATH​​ 或者 loader.properties 中的 ​​loader.path​​ 配置额外的位置(多个位置逗号隔开),所以这个是我们需要的启动类。

      启动类最终是在打包文件中的 ​​MANIFEST.MF​​ 中配置的,例如 jar 方式:

      Main-Class: org.springframework.boot.loader.JarLauncher
      Start-Class:

      想要使用 ​​PropertiesLauncher​​,可以通过官方的配置来启用。

      2. 如何配置使用 ​​PropertiesLauncher​​

      ​​Build Tool Plugins​​ Maven Plugin, Gradle Plugin, Antlib, and more.

      在官方打包工具中,有 Maven 和 Gradle 的两种方式。

      ​​Maven 配置​​

      <build>
      <plugins>
      <plugin>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-maven-plugin</artifactId>
      <configuration>
      <mainClass>${start.class}</mainClass>
      <layout>ZIP</layout>
      </configuration>
      <executions>
      <execution>
      <goals>
      <goal>repackage</goal>
      </goals>
      </execution>
      </executions>
      </plugin>
      </plugins>
      </build>

      这里的 ​​<layout>ZIP</layout>​​​ 配置可以选择使用哪个启动器,默认根据 ​​<packing>​​ 打包类型( jar 或 war)确定,可以配置下面可选值:

      • JAR
      • WAR
      • ZIP:使用​​PropertiesLauncher​​
      • NONE: 不捆绑引导加载程序

      通过选择 ​​ZIP​​​ 即可使用 ​​PropertiesLauncher​​。

      ​​Gradle 配置​​

      配置起来更直接,配置如下:

      tasks.named("bootWar") {
      manifest {
      attributes 'Main-Class': 'org.springframework.boot.loader.PropertiesLauncher'
      }
      }

      3. 指定其他类加载路径

      详细的配置可以参考官方文档: ​​PropertiesLauncher Features​​,这里就简单举例用用:

      java -Dloader.path=file:/config -jar spring-boot-app.jar

      通过 ​​-Dloader.path=file:/config​​ 指定路径后,就能通过这种方式覆盖 jar 包中的文件了。

      使用 ​​-Dloader.dubug=true​​​ 会通过 ​​System.out.println​​ 输出日志信息。

      4. 类路径的加载顺序(优先级)

      为了确保替换配置文件的方式有效,最后还要确认一下类路径的加载顺序,只有当我提供的配置先加载时,才能确保替换默认的配置文件,官方没有明确说明加载顺序,因此只能通过代码来确认。

      在 ​​PropertiesLauncher​​​ 中存在 ​​main​​ 方法:

      public static void main(String[] args) throws Exception {
      PropertiesLauncher launcher = new PropertiesLauncher();
      args = launcher.getArgs(args);
      launcher.launch(args);
      }

      这里调用了父类 ​​Launcher​​​ 的 ​​launch​​ 方法:

      protected void launch(String[] args) throws Exception {
      if (!isExploded()) {
      JarFile.registerUrlProtocolHandler();
      }
      ClassLoader classLoader = createClassLoader(getClassPathArchivesIterator());
      String jarMode = System.getProperty("jarmode");
      String launchClass = (jarMode != null && !jarMode.isEmpty()) ? JAR_MODE_LAUNCHER : getMainClass();
      launch(args, launchClass, classLoader);
      }

      在创建 ​​ClassLoader ​​​ 时,调用了 ​​getClassPathArchivesIterator()​​ 方法,这个方法会获取所有类路径下面的资源文件和jar包,这个方法就是我们要重点关注的方法:

      @Override
      protected Iterator<Archive> getClassPathArchivesIterator() throws Exception {
      ClassPathArchives classPathArchives = this.classPathArchives;
      if (classPathArchives == null) {
      classPathArchives = new ClassPathArchives();
      this.classPathArchives = classPathArchives;
      }
      return classPathArchives.iterator();
      }

      这里创建了 ​​ClassPathArchives ​​ 的单例,在构造方法中:

      ClassPathArchives() throws Exception {
      this.classPathArchives = new ArrayList<>();
      for (String path : PropertiesLauncher.this.paths) {
      for (Archive archive : getClassPathArchives(path)) {
      debug("paths: " + archive.getUrl());
      addClassPathArchive(archive);
      }
      }
      addNestedEntries();
      }

      这里的 ​​PropertiesLauncher.this.paths​​ 就是通过 ​​loader.path​​ 配置的所有路径,这部分内容首先添加进去了,从这儿已经可以看出 ​​loader.path​​ 的优先级更高,因此通过这种方式设置的外部配置文件会优先使用。

      上面代码后面的 ​​addNestedEntries​​ 在 jar 包启动时,就是加载 jar 包中的内容:

      private void addNestedEntries() {
      // The parent archive might have "BOOT-INF/lib/" and "BOOT-INF/classes/"
      // directories, meaning we are running from an executable JAR. We add nested
      // entries from there with low priority (i.e. at end).
      try {
      Iterator<Archive> archives = PropertiesLauncher.this.parent.getNestedArchives(null,
      JarLauncher.NESTED_ARCHIVE_ENTRY_FILTER);
      while (archives.hasNext()) {
      this.classPathArchives.add(archives.next());
      }
      }
      catch (IOException ex) {
      // Ignore
      }
      }

      在这里的 ​​PropertiesLauncher.this.parent​​​ 对应的就是启动的 jar,这里调用获取嵌套的包,使用 ​​JarLauncher.NESTED_ARCHIVE_ENTRY_FILTER​​ 作为过滤条件,过滤条件定义:

      static final EntryFilter NESTED_ARCHIVE_ENTRY_FILTER = (entry) -> {
      if (entry.isDirectory()) {
      return entry.getName().equals("BOOT-INF/classes/");
      }
      return entry.getName().startsWith("BOOT-INF/lib/");
      };

      可以看到当遍历当前 jar 包时,只会匹配 ​​BOOT-INF/classes/​​​ 目录和 ​​BOOT-INF/lib/​​ 下面的所有文件。

      5. 不在深入一点吗?

      到这里本文关注的内容就结束了,但是如果看源码只看到这种程度就够了吗?

      看源码最好是有目的的看,看到感兴趣的地方时再深入看,看上面代码时你最有兴趣的地方在哪里?

      我最感兴趣的是 ​​ClassLoader classLoader = createClassLoader(getClassPathArchivesIterator());​​​ 这里,以及后续对该 ​​classLoader​​ 的使用,这部分的内容应该是 Spring Boot 能打成一个特殊 fat jar 启动的核心,Spring Boot 包和 Apache Maven Shade Plugin 插件的区别在于 “Spring Boot 中依赖的 jar 包仍然是独立的 jar,存在于 ​​BOOT-INF/lib​​ 中,Shade 插件打的是一个真正的大 jar 包,把所有依赖的 jar 都抽取到了大的 jar 中,这会存在同路径和名称文件的覆盖问题”。如果后续有时间再单独从这个角度再分析看看。

      版权声明:本文内容来自第三方投稿或授权转载,原文地址:https://blog.51cto.com/isea533/5594814,作者:isea533,版权归原作者所有。本网站转在其作品的目的在于传递更多信息,不拥有版权,亦不承担相应法律责任。如因作品内容、版权等问题需要同本网站联系,请发邮件至ctyunbbs@chinatelecom.cn沟通。

      上一篇:Java基础深化和提高-------容器篇

      下一篇:[Java 常用类库]:StringCompress(字符串压缩)

      相关文章

      2025-05-19 09:04:38

      完美解决tomcat启动异常:Invalid byte tag in constant pool: 19;Unable to process Jar entry [module-info.class]

      完美解决tomcat启动异常:Invalid byte tag in constant pool: 19;Unable to process Jar entry [module-info.class]

      2025-05-19 09:04:38
      jar , tomcat , 版本 , 配置文件
      2025-05-12 10:19:12

      SpringBoot学习(6)(Bean对象扫描)(@ComponentScan)

      SpringBoot学习(6)(Bean对象扫描)(@ComponentScan)

      2025-05-12 10:19:12
      Bean , springboot , 启动 , 扫描 , 注解
      2025-05-12 10:19:12

      springboot学习(2)

      springboot学习(2)

      2025-05-12 10:19:12
      Java , main , springboot , web , 启动 , 方法 , 浏览器
      2025-05-09 08:20:32

      Maven之介绍

      Maven 是一个 Java 项目管理和构建工具。它可以定义项目结构、项目依赖,并使用统一的方式进行自动化构建,是Java项目不可缺少的工具。

      2025-05-09 08:20:32
      jar , Maven , 一个 , 文件夹 , 标准化 , 流程 , 项目
      2025-05-08 09:03:21

      springboot酒店管理系统分前后端【源码+数据库】

      本项目是一套springboot酒店管理系统分前后端【源码+数据库】,主要针对计算机相关专业的正在做bishe的学生和需要项目实战练习的Java学习者。

      2025-05-08 09:03:21
      springboot , 数据库 , 源码 , 管理 , 项目
      2025-05-07 09:09:26

      springboot系列教程(二十五):springboot整合ElasticSearch,实现高性能搜索引擎

      ElasticSearch是一个基于Lucene的搜索服务器。它提供了一个分布式多用户能力的全文搜索引擎,基于RESTful web接口。Elasticsearch是用Java开发的,并作为Apache许可条款下的开放源码发布,是当前流行的企业级搜索引擎。

      2025-05-07 09:09:26
      ElasticSearch , springboot , 接口 , 搜索引擎
      2025-05-07 09:09:26

      springboot系列教程(十七):自定义启动页,项目打包指定运行环境

      springboot的打包方式有很多种。可以打war包,可以打jar包,可以使用jekins进行打包部署的。不推荐用war包,SpringBoot适合前后端分离,打成jar进行部署更加方便快捷。

      2025-05-07 09:09:26
      application , jar , 打包 , 配置
      2025-05-07 09:08:08

      基于springboot框架个人博客管理系统

      本项目是一套基于springboot框架实现的个人博客管理系统,主要针对计算机相关专业的正在做毕设的学生与需要项目实战练习的Java学习者。

      2025-05-07 09:08:08
      springboot , 文章 , 源码 , 页面 , 项目
      2025-05-07 09:07:56

      springboot基于ssm框架实现的家具商城管理系统

      本项目是一套基于springboot框架实现的家具商城管理系统,主要针对计算机相关专业的正在做bishe的学生和需要项目实战练习的Java学习者。

      2025-05-07 09:07:56
      springboot , 数据库 , 模块 , 项目
      2025-05-06 09:19:12

      springboot项目如何将配置文件外挂

      springboot项目如何将配置文件外挂

      2025-05-06 09:19:12
      application , jar , yml , 配置文件
      查看更多
      推荐标签

      作者介绍

      天翼云小翼
      天翼云用户

      文章

      33561

      阅读量

      5265196

      查看更多

      最新文章

      springboot学习(2)

      2025-05-12 10:19:12

      SpringBoot学习(6)(Bean对象扫描)(@ComponentScan)

      2025-05-12 10:19:12

      springboot酒店管理系统分前后端【源码+数据库】

      2025-05-08 09:03:21

      springboot系列教程(二十五):springboot整合ElasticSearch,实现高性能搜索引擎

      2025-05-07 09:09:26

      springboot校园宿舍管理系统前后端分离

      2025-05-06 09:18:49

      使用shell脚本在Linux中管理Java应用程序

      2025-04-18 07:10:44

      查看更多

      热门文章

      基于注解的DI-Spring的JUnit4测试

      2022-12-29 09:29:46

      SpringBoot配置文件分类

      2023-07-27 06:49:01

      springboot接受post/get参数值的几种形式,Java

      2023-04-11 10:14:19

      SpringBoot写的后端API接口如何写得更优雅

      2023-06-15 06:37:47

      Spring Boot 使用拦截器

      2023-05-04 09:43:47

      13_Spring Boot 使用Filter(了解)

      2024-09-24 06:29:51

      查看更多

      热门标签

      java Java python 编程开发 代码 开发语言 算法 线程 Python html 数组 C++ 元素 javascript c++
      查看更多

      相关产品

      弹性云主机

      随时自助获取、弹性伸缩的云服务器资源

      天翼云电脑(公众版)

      便捷、安全、高效的云电脑服务

      对象存储

      高品质、低成本的云上存储服务

      云硬盘

      为云上计算资源提供持久性块存储

      查看更多

      随机文章

      SpringBoot启动模板Run改为Services【附带跳转地址】

      spring的controller是单例还是多例,怎么保证并发的安全

      MyBatisPlus分页插件在SpringBoot中的使用

      springboot校园宿舍管理系统前后端分离

      SpringBoot中使用Jackson序列化返回

      Springboot03整合SpringDataJPA访问MySQL数据库

      • 7*24小时售后
      • 无忧退款
      • 免费备案
      • 专家服务
      售前咨询热线
      400-810-9889转1
      关注天翼云
      • 旗舰店
      • 天翼云APP
      • 天翼云微信公众号
      服务与支持
      • 备案中心
      • 售前咨询
      • 智能客服
      • 自助服务
      • 工单管理
      • 客户公告
      • 涉诈举报
      账户管理
      • 管理中心
      • 订单管理
      • 余额管理
      • 发票管理
      • 充值汇款
      • 续费管理
      快速入口
      • 天翼云旗舰店
      • 文档中心
      • 最新活动
      • 免费试用
      • 信任中心
      • 天翼云学堂
      云网生态
      • 甄选商城
      • 渠道合作
      • 云市场合作
      了解天翼云
      • 关于天翼云
      • 天翼云APP
      • 服务案例
      • 新闻资讯
      • 联系我们
      热门产品
      • 云电脑
      • 弹性云主机
      • 云电脑政企版
      • 天翼云手机
      • 云数据库
      • 对象存储
      • 云硬盘
      • Web应用防火墙
      • 服务器安全卫士
      • CDN加速
      热门推荐
      • 云服务备份
      • 边缘安全加速平台
      • 全站加速
      • 安全加速
      • 云服务器
      • 云主机
      • 智能边缘云
      • 应用编排服务
      • 微服务引擎
      • 共享流量包
      更多推荐
      • web应用防火墙
      • 密钥管理
      • 等保咨询
      • 安全专区
      • 应用运维管理
      • 云日志服务
      • 文档数据库服务
      • 云搜索服务
      • 数据湖探索
      • 数据仓库服务
      友情链接
      • 中国电信集团
      • 189邮箱
      • 天翼企业云盘
      • 天翼云盘
      ©2025 天翼云科技有限公司版权所有 增值电信业务经营许可证A2.B1.B2-20090001
      公司地址:北京市东城区青龙胡同甲1号、3号2幢2层205-32室
      • 用户协议
      • 隐私政策
      • 个人信息保护
      • 法律声明
      备案 京公网安备11010802043424号 京ICP备 2021034386号