升级至Spring Boot 3.1后无法连接Tanzu Cloud Foundry的Redis cups

问题分析 #

升级到Spring Boot 3.1.1后，PostgreSQL和RabbitMQ的CUPS服务能正常绑定，但Redis的CUPS配置被忽略，系统默认连接本地Redis；手动配置Redis连接信息可以正常工作，说明Redis客户端本身无问题，问题出在CF环境变量的自动绑定逻辑上。

解决步骤 #

1. 升级java-cfenv依赖版本 #

Spring Boot 3.x需要搭配java-cfenv 3.x版本，你当前使用的java-cfenv-boot:2.4.1适配Spring Boot 2.x，版本不兼容会导致环境变量解析失败。

修改pom.xml中的依赖：

<dependency>
    <groupId>io.pivotal.cfenv</groupId>
    <artifactId>java-cfenv-boot</artifactId>
    <version>3.2.0</version> <!-- 适配Spring Boot 3.x的稳定版 -->
</dependency>

2. 添加Redis专用CF环境绑定依赖 #

java-cfenv-boot默认不包含Redis自动绑定逻辑，需单独引入java-cfenv-boot-redis依赖，让框架自动识别Redis CUPS配置：

<dependency>
    <groupId>io.pivotal.cfenv</groupId>
    <artifactId>java-cfenv-boot-redis</artifactId>
    <version>3.2.0</version> <!-- 和java-cfenv-boot版本保持一致 -->
</dependency>

3. 移除不必要的手动导入配置 #

启动类中手动导入的RedisAutoConfiguration.class可能覆盖java-cfenv的自动绑定逻辑，建议移除：

@SpringBootApplication
@EnableTransactionManagement
@EnableFeignClients
@EnableWebSecurity
@EnableAsync
@EnableRetry
@EnableCaching
@ImportAutoConfiguration({FeignAutoConfiguration.class}) // 移除RedisAutoConfiguration
public class Application {
    // ...
}

4. 验证Redis CUPS服务绑定 #

• 确认CUPS服务实例名称包含redis关键字（java-cfenv默认识别名称含redis的服务）；
• 若服务名称不符合默认规则，可通过配置指定服务名称：

  spring.redis.cfenv.service-name=your-redis-cups-service-name
  

5. 检查配置优先级 #

确保没有自定义配置类硬编码Redis连接信息，覆盖CF环境变量（Spring Boot 3.x中CF环境变量优先级应高于默认配置）。

验证方法 #

部署修改后的应用到CF，查看启动日志，确认是否输出Found Redis service binding类日志，说明Redis CUPS配置已被正确加载。

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