You need to enable JavaScript to run this app. Spring Boot JAR处于含空格路径时为何出现类路径通配扫描资源重复定位问题
优惠活动
大模型
产品
解决方案
定价
更多

Spring Boot JAR处于含空格路径时为何出现类路径通配扫描资源重复定位问题

类路径通配扫描在Windows带空格路径的Spring Boot Fat Jar下的重复加载问题

迁移背景

在将部分遗留代码迁移至Spring Boot应用时,项目通过spring-boot-maven-plugin编译为可执行fat jar部署。
原有遗留逻辑的对象映射采用XML配置的Dozer实现,所有Dozer映射配置文件分散在对应业务包下,和待映射的业务类放在一起维护。为了自动定位这些分散的配置,原本通过工厂Bean搭配宽松的类路径通配扫描规则加载配置,对应代码如下:

@Bean
public DozerBeanMapperFactoryBean dozerBeanMapperFactoryBean(
    @Value("classpath*:**/*_dozer_mapping.xml") Resource[] resources) { ... }

这套逻辑在传统部署模式下可以正常扫描到所有需要的配置文件。

异常表现

当可执行fat jar被放置在Windows系统路径包含空格的目录下时(例如C:\Program Files\MySoftware\myApplication.jar),应用会启动失败:

  • 注入到上述Bean方法的资源数组中,部分Dozer配置文件会被重复加载两次,而Dozer本身不支持重复的映射配置定义,直接触发启动异常。
  • 问题可以被极简复现:新建一个基础Spring Boot应用,代码如下:
    @SpringBootApplication
    public class TestApp {
      private Resource[] resources;
      public static void main(String[] args) {
        SpringApplication.run(TestApp.class, args);
      }
    
      public TestApp(@Value("classpath*:**/*.xml") Resource[] resources) {
        this.resources = resources;
      }
    }
    
    在resources目录下放置任意XML文件,通过spring-boot-maven-plugin的repackage目标编译为单可执行jar,将jar移动到带空格的Windows路径下启动,观察构造器注入的资源数组,会发现该XML文件被重复定位两次。

问题定位过程

通过调试Spring Framework的扫描逻辑,可定位到异常触发点在PathMatchingResourcePatternResolver类的findPathMatchingResources方法内部,核心执行逻辑为:

String rootDirPath = determineRootDir(locationPattern);
String subPattern = locationPattern.substring(rootDirPath.length());
Resource[] rootDirResources = getResources(rootDirPath);

当jar部署路径包含空格时,上述getResources调用会额外返回一个冗余的URL资源,例如:

URL [jar:file:C:\Program Files\MySoftware\myApplication.jar!/]
这个冗余的根路径资源会让后续的子路径扫描流程重复执行一遍,最终导致jar包内的配置文件被重复检测,传入Dozer工厂Bean后触发重复定义异常。

现有疑问

本次问题复现使用的Spring Boot版本为2.3.1.RELEASE,未对类路径通配扫描逻辑做自定义修改,原本预期宽泛的通配扫描规则不会触发这类重复加载的行为,想确认是否存在遗漏的必要配置。

内容的提问来源于stack exchange,提问作者icabod

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.16 03:06:04