Spring Boot Batch跨平台运行时application.properties路径解析异常求助

问题描述 #

• Spring Boot Batch 2.7.3项目，application.properties中配置rs.input.path=/opt/ingestiondata/rs
• Windows本地执行mvn clean install生成jar，本地运行java -jar myjar.jar抛出预期异常：java.nio.file.NoSuchFileException: \opt\ingestiondata\rs
• 同一份jar部署到Linux服务器运行时，rs.input.path被解析为Windows路径c:\users\ajay\some\dir，而非配置文件中的Linux路径
• 路径注入与使用代码：

  @Value("${rs.input.path}")
  private String inputPath;   
  
  @Bean
  ItemReader<File> myReader() throws IOException {
      List<File> files = Files.walk(Paths.get(inputPath))
                          .filter(Files::isRegularFile)
                          .map(Path::toFile)
                          .collect(Collectors.toList());
      return new IteratorItemReader<>(files);
  }
  

排查方向 #

• 配置优先级覆盖：Spring Boot按优先级加载配置，检查Linux服务器上是否存在更高优先级的配置源：

  • 查看jar同目录是否有application.properties/application.yml
  • 检查是否存在环境变量SPRING_APPLICATION_JSON或启动时通过-Drs.input.path=xxx传递的系统属性
  • 排查服务器上~/.config/spring-boot/等Spring Boot默认外部配置路径

• 打包时配置篡改：检查打包过程是否修改了配置文件：

  • 查看pom.xml中maven-resources-plugin或其他插件是否有配置替换逻辑
  • 解压jar包，查看BOOT-INF/classes/application.properties中的rs.input.path值是否正确（执行unzip myjar.jar -d temp后查看对应文件）

• 缓存/旧进程残留：

  • 清理Linux服务器上Spring Boot缓存目录（如/tmp/spring-boot-*）
  • 通过jar -tvf myjar.jar | grep application.properties确认jar内配置文件的修改时间，确保部署的是最新包

• 代码逻辑篡改：

  • 排查是否有@PostConstruct方法、AOP切面或其他代码动态修改了inputPath变量
  • 在myReader()方法开头添加日志（如System.out.println("当前inputPath: " + inputPath)），确认注入值是否正确

解决方法 #

• 强制使用jar内配置：启动时明确指定加载jar内的配置文件，避免外部覆盖：

  java -jar myjar.jar --spring.config.location=classpath:/application.properties
  

• 锁定打包配置：在pom.xml中配置maven-resources-plugin，禁止对properties文件进行过滤替换：

  <build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-resources-plugin</artifactId>
        <version>3.3.0</version>
        <configuration>
          <nonFilteredFileExtensions>
            <nonFilteredFileExtension>properties</nonFilteredFileExtension>
          </nonFilteredFileExtensions>
        </configuration>
      </plugin>
    </plugins>
  </build>
  

• 环境感知配置：为不同环境创建专属配置文件，通过profile切换：

  • 创建application-linux.properties，配置rs.input.path=/opt/ingestiondata/rs
  • 创建application-windows.properties，配置rs.input.path=C:\ingestiondata\rs
  • Linux启动时指定profile：java -jar myjar.jar --spring.profiles.active=linux

内容的提问来源于stack exchange，提问作者Ajay Kumar