Spring Cloud Gateway与Netflix Eureka启动失败问题求助

针对启动时出现的Cannot invoke "java.lang.CharSequence.toString()" because "replacement" is null空指针异常，以下是具体排查和解决步骤：

• 检查配置占位符完整性
  重点核查application.yml/application.properties中的Eureka相关配置，确认所有使用${xxx}格式的占位符都有对应配置值。比如：

  • 若配置了eureka.client.service-url.defaultZone=http://${eureka.host}:${eureka.port}/eureka/，必须在配置文件或环境变量中定义eureka.host和eureka.port，否则占位符替换时会返回null触发NPE。

• 确认版本兼容性
  核对Spring Boot、Spring Cloud、Spring Cloud Netflix的版本匹配关系：

  • Spring Boot 3.2.x/3.3.x对应Spring Cloud 2023.0.x（Leyton），需确保Spring Cloud Netflix的版本与该Cloud版本适配，避免因版本不兼容导致内部Bean初始化逻辑出错。可参考Spring Cloud官方版本矩阵确认。

• 排查自动配置干扰

  • 确保Eureka服务端启动类添加了@EnableEurekaServer，Gateway端添加了@EnableDiscoveryClient，保证自动配置流程正常触发。
  • 检查是否存在自定义配置类手动注册EurekaAutoServiceRegistration相关Bean，或禁用了必要的自动配置项，这类操作可能破坏默认初始化逻辑。

• 校验配置文件语法
  检查YAML/Properties文件的格式正确性：

  • YAML文件需注意缩进规范、字符串引号闭合；Properties文件需避免键值对格式错误，这些问题可能导致配置值解析为null。

• 调试定位根源
  通过添加断点跟踪EurekaAutoServiceRegistration初始化流程，重点查看PropertySourcesPlaceholderConfigurer类中的占位符替换逻辑，定位具体哪个配置项的replacement为null，精准解决问题。

内容的提问来源于stack exchange，提问作者다람쥐