AWS EKS中Spring Boot无限拉取远程application.yml故障排查

从日志可见每次配置拉取都能成功加载远程application.yml配置源，无网络、鉴权类报错，属于典型的客户端逻辑死循环问题，结合AWS EKS部署场景，按出现概率从高到低排查修复：

• 远程配置自引用触发循环加载（最高发）
  如果你把配置中心相关的配置（比如spring.cloud.config.uri、spring.config.import=configserver:这类触发配置源初始化的参数）写到了远程仓库的application.yml里，会形成闭环：客户端启动拉远程配置 → 加载到配置中心参数 → 刷新Spring上下文重新初始化配置源 → 再次拉远程配置 → 再次触发上下文刷新，无限循环。
  修复：所有配置中心连接、导入类的参数，必须放在镜像内打包的本地bootstrap.yml/application.yml中，不能出现在远程配置仓库的配置文件里。
• 本地配置缓存目录无写入权限
  Spring配置客户端默认会把拉取到的远程配置缓存到本地目录，每次刷新前先比对本地缓存和远程版本，版本一致就跳过拉取。如果EKS Pod里配置了安全上下文，应用用非root用户运行，且对默认缓存目录（应用工作目录下的临时文件夹、/tmp下的缓存路径）没有写入权限，会导致每次缓存校验都判定缓存失效，立刻触发全量拉取，拉取后的配置也无法写入缓存，下一轮校验马上又触发拉取，频率可达毫秒级。
  修复：给应用运行用户开放工作目录、临时目录的写权限，或者显式指定可写的缓存路径：

  spring:
    cloud:
      config:
        server:
          git:
            basedir: /tmp/writable-config-cache
  

• 刷新事件监听逻辑错误
  检查代码和引入的第三方starter：
  • 有没有监听RefreshScopeRefreshedEvent、EnvironmentChangeEvent、ContextRefreshedEvent的逻辑，在监听方法里手动调用了ContextRefresher.refresh()、或者主动触发配置拉取的方法
  • 有没有引入自研配置增强组件、AWS服务集成starter存在循环触发刷新的bug
    排查方式：在配置客户端拉取配置的核心方法打断点，看调用栈来源，直接定位触发拉取的类。
• 刷新间隔参数配置错误
  老版本Spring Cloud Config的spring.cloud.config.refresh-interval参数单位为毫秒，如果误以为单位是秒配置为1，就会每1毫秒触发一次拉取；如果配置为0会关闭间隔校验，持续触发拉取。生产环境建议该值配置为30000（30秒）及以上。
• 版本不兼容导致配置源重复注册
  Spring Boot 2.4+重构了配置加载逻辑，如果Spring Boot和Spring Cloud版本不匹配（比如Spring Boot 2.7搭配2020.0.0以下的Spring Cloud版本），会出现配置源重复注册的问题，多个配置源实例互相触发刷新，形成死循环，直接对照Spring官方版本兼容矩阵调整依赖版本即可。

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