Spring Batch在Windows Bash运行报错：解析类路径XML资源IO异常

原CMD正常执行命令：

java -Xms2048m -Xmx2048m -Ddivision=25 -Ddate= -Denv=dv -Dconn=45 -jar demo-jobs*.jar job-definition.xml jobName -next

报错内容：

Job Terminated in error: IOException parsing XML document from Class Path Resource c:/directory/job-definition.xml

核心原因 #

Windows下的Bash环境（包含Git Bash、WSL Bash等）和CMD的参数解析、路径识别逻辑存在差异，导致原本CMD下正常的命令参数被错误解析。

分步排查解决 #

• 第一步：替换jar包通配符
  Bash会自动展开*通配符，CMD不会。如果当前目录存在多个匹配demo-jobs*.jar的文件，Bash会将所有匹配文件名全部传入命令，打乱参数顺序，导致后续的XML配置文件路径被错误识别。直接替换为完整的jar包文件名即可，示例：

java -Xms2048m -Xmx2048m -Ddivision=25 -Ddate= -Denv=dv -Dconn=45 -jar demo-jobs-1.0.0.jar job-definition.xml jobName -next

优先使用相对路径指定XML文件，避免绝对路径的跨环境识别问题。

• 第二步：适配路径格式
  如果使用的是WSL Bash：Windows风格的盘符路径c:/directory/在WSL中需要转换为/mnt/c/directory/格式，否则Java无法正常识别路径。
  如果使用的是Windows版Git Bash：Git Bash会自动将Windows绝对路径转换为POSIX风格，导致Windows版Java识别失败，可在绝对路径前加双斜杠规避转换，示例：//c:/directory/job-definition.xml。

• 第三步：校验Java环境一致性
  在Bash中执行java -version，确认和CMD下的Java版本、发行版一致，避免不同JDK的类加载路径逻辑差异导致的资源读取失败。

• 第四步：开启调试日志定位路径
  在启动命令中添加日志参数-Dlogging.level.org.springframework.core.io=DEBUG，运行后查看日志中Spring实际尝试加载的XML文件路径，可直接定位路径解析错误的具体原因。

内容的提问来源于stack exchange，提问作者One Developer