Spring Cloud Config Server打包Jar后无法访问本地配置文件求助

问题场景 #

项目结构 #

src
  - main
    - java
      - com.my.configserver
        - ConfigserverApplication.java
    - resources
      - config
        - my-service
        - my-service-prod.yml
        - my-service-qa.yml
      - application.yml

核心配置（application.yml） #

spring:
  application:
    name: "configserver"
  profiles:
    active: native
  cloud:
    config:
      server:
        native:
          search-locations: classpath:/config

异常现象 #

• IDE内启动应用时，可正常访问src/main/resources/config下的配置文件
• 执行mvn clean install打包为Jar后，运行java -jar target/configserver-0.0.1-SNAPSHOT.jar出现如下报错：

Monitoring for local config changes: [/config]

Failed to walk directory: /config

java.io.IOException: Cannot register watcher for /config
        at org.springframework.cloud.config.monitor.FileMonitorConfiguration.registerWatch(FileMonitorConfiguration.java:319) ~[spring-cloud-config-monitor-4.2.1.jar!/:4.2.1]

原因解析 #

1. Jar包内资源不支持文件系统监听：打包成Jar后，classpath:/config是Jar归档文件内部的虚拟目录，并非操作系统本地文件系统的真实目录。Spring Cloud Config的文件监控组件（FileMonitor）只能监听本地真实文件系统的目录，无法对Jar内的虚拟目录进行遍历和监听操作。
2. IDE与Jar运行环境的路径差异：IDE运行时，项目资源会被编译到本地文件系统的target/classes/config目录，属于真实可访问的文件路径，因此监控组件能正常注册监听；而Jar启动时，classpath:/config指向的是Jar内部的资源路径，Java的文件IO API无法像操作本地目录一样处理Jar内的路径，导致注册监听器失败。
3. native模式的监听逻辑限制：使用native存储模式时，若search-locations配置为classpath:开头的路径，Spring Cloud Config会默认尝试为该路径注册配置变更监听，但Jar内的目录不支持这种文件系统级别的监听，最终触发IO异常。

可选解决方案 #

• 将配置移至Jar外部：把config目录放到Jar所在的同级目录，修改search-locations为file:./config，让监控组件监听本地真实目录。
• 关闭配置监控功能：若不需要实时监听配置变更，可添加配置spring.cloud.config.server.monitor.enabled=false，禁用监控组件，避免尝试注册Jar内目录的监听器。
• 切换外部存储模式：改用Git、SVN等外部存储替代native模式，摆脱对本地文件系统目录的依赖。

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