Spring Boot集成Redisson连接Redis启动报错：redisson Bean创建失败

我来帮你排查这个Redisson Bean创建失败的问题，这种错误在Spring Boot整合Redisson时很常见，主要是配置或依赖层面的问题，咱们一步步来解决：

1. 先确认Redisson依赖是否正确引入 #

Redisson和Spring Boot的版本兼容性很重要，建议使用官方提供的Spring Boot Starter来避免版本冲突：

<!-- Maven依赖示例，版本请选择和你的Spring Boot匹配的，比如Spring Boot 3.x对应Redisson 3.22+ -->
<dependency>
    <groupId>org.redisson</groupId>
    <artifactId>redisson-spring-boot-starter</artifactId>
    <version>3.23.3</version>
</dependency>

如果是手动引入核心包，一定要同时引入Spring整合模块，否则会出现Bean创建时的依赖缺失。

2. 检查RedisConfig类的配置逻辑 #

你的redisson()工厂方法是创建Bean的核心，一定要确保配置逻辑没有问题，比如地址格式、密码设置、连接参数等。这里给一个正确的单机模式配置示例：

@Configuration
public class RedisConfig {

    @Value("${spring.redis.host}")
    private String redisHost;

    @Value("${spring.redis.port}")
    private int redisPort;

    @Value("${spring.redis.password:}")
    private String redisPassword;

    @Bean
    public RedissonClient redisson() {
        Config config = new Config();
        // 注意地址必须带redis://前缀，集群/哨兵模式要对应切换配置方法
        config.useSingleServer()
              .setAddress("redis://" + redisHost + ":" + redisPort)
              // 无密码时一定要传null，不能传空字符串
              .setPassword(redisPassword.isEmpty() ? null : redisPassword)
              .setConnectionPoolSize(10)
              .setConnectionMinimumIdleSize(2);
        return Redisson.create(config);
    }
}

重点注意：如果Redis没有设置密码，不要把setPassword的参数设为空字符串，必须传null，否则Redisson会把空字符串当成密码去验证，导致连接失败。

3. 验证Redis服务的可达性 #

很多时候问题出在Redis服务本身：

• 先确认Redis服务器是否正在运行，用redis-cli ping命令测试，返回PONG才是正常的。
• 如果是远程Redis，检查应用所在机器能否通过telnet或ping访问Redis的IP和端口（比如telnet your-redis-host 6379），同时检查Redis配置文件：
  • bind是否设置为允许应用IP访问，或者设为0.0.0.0（生产环境需谨慎）
  • protected-mode是否关闭（如果需要远程访问）
  • 防火墙是否开放了6379端口

4. 查看完整的错误堆栈 #

你提供的错误信息被截断了，最关键的是nested exception部分，里面会给出具体的失败原因——比如密码错误、地址格式不对、Redis连接超时等。把完整的错误日志找出来，能更快定位问题。

5. 检查Spring Boot配置文件的参数 #

确保application.properties或application.yml中的Redis参数没有拼写错误：

# application.properties示例
spring.redis.host=127.0.0.1
spring.redis.port=6379
spring.redis.password=your-redis-password # 没有密码就删掉这一行

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