本文的核心读者是 SpringBoot 初学者、后端开发工程师，以及在项目中遇到 “配置远程 Redis 后仍连接 localhost” 问题的技术人员。将为你解决以下实际问题：

• 明明配置了 spring.redis.host 远程地址，项目却始终使用默认 localhost:6379 连接；
• 用 Jedis 能直接连接远程 Redis，但 SpringBoot 集成时失败；
• 不清楚 SpringBoot Redis 自动配置逻辑，无法定位配置失效原因。

二、核心前提：SpringBoot Redis 自动配置逻辑解析

要解决连接失败问题，必须先理解 SpringBoot 对 Redis 的自动配置规则。Redis 相关的核心自动配置类是 RedisAutoConfiguration（包路径：org.springframework.boot.autoconfigure.data.redis），其工作原理如下：

• 该类会扫描配置文件中 spring.redis.* 前缀的配置项，自动创建 RedisConnectionFactory、RedisTemplate 等核心 Bean；
• 关键逻辑：只有当 spring.redis.host、spring.redis.port 等关键配置项被显式设置且有效时，自动配置类才会使用自定义配置；若配置项缺失或无效，会触发默认值（host=localhost，port=6379）。

我在 CentOS 7 服务器 + SpringBoot 2.7.8 版本的项目中遇到了典型问题：配置 spring.redis.host=192.168.1.100 后，项目启动日志仍显示 “Connecting to localhost:6379”。但通过 Jedis 客户端直接连接 192.168.1.100:6379 却能成功（代码如下），这说明远程 Redis 服务本身正常，问题出在 SpringBoot 配置或依赖层面。

// 测试 Jedis 直接连接远程 Redis（成功代码，作者：张三，2024-05）
public class JedisDirectTest {
    public static void main(String[] args) {
        // 远程 Redis 地址与端口
        Jedis jedis = new Jedis("192.168.1.100", 6379);
        // 若 Redis 有密码，需添加认证（我的 Redis 密码为 123456）
        jedis.auth("123456");
        // 测试连接：返回 PONG 说明连接成功
        System.out.println("Jedis 连接测试：" + jedis.ping());
        jedis.close();
    }
}

三、三步排查：从配置到服务的全流程解决

1. 第一步：排查配置文件有效性 —— 优先级与格式陷阱

很多开发者会忽略 “多配置文件冲突” 问题。我当时的项目中同时存在 application.properties 和 application.yml 两个配置文件，具体配置如下：

问题配置示例

application.yml（期望的远程配置）：

spring:
  redis:
    host: 192.168.1.100  # 远程 Redis 地址
    port: 6379
    password: 123456
    timeout: 3000  # 连接超时时间，单位：毫秒

application.properties（隐藏的冲突配置）：

# 该配置覆盖了 yml 中的远程地址
spring.redis.host=localhost

关键知识点：SpringBoot 配置加载优先级

在未指定 profile 的情况下，同一配置项，properties 文件优先级高于 yml 文件。因此，即使 yml 配置了远程地址，最终生效的仍是 properties 中的 localhost。

解决办法

• 方案 1：删除 application.properties 中冲突的 spring.redis.host 配置；
• 方案 2：统一使用 application.yml（推荐，结构更清晰），删除冗余的 properties 文件。

验证配置是否生效

修改后启动项目，查看日志中 RedisAutoConfiguration 相关输出，若出现以下日志，说明配置已被识别：

2024-05-20 14:30:00.123  INFO 12345 --- [main] o.s.b.a.redis.RedisAutoConfiguration    : Using redis host: 192.168.1.100

2. 第二步：排查依赖冲突 —— Lettuce 与 Jedis 客户端选择

SpringBoot 2.x 及以上版本中，spring-boot-starter-data-redis 依赖默认引入 Lettuce 客户端（而非 Jedis）。若项目中同时引入 Jedis 依赖且版本不兼容，会导致 RedisConnectionFactory 创建失败，进而 fallback 到默认配置。

问题依赖示例（pom.xml）

<!-- 默认引入 Lettuce 客户端 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>

<!-- 额外引入 Jedis 3.0.0 版本，与 SpringBoot 2.7.8 不兼容 -->
<dependency>
    <groupId>redis.clients</groupId>
    <artifactId>jedis</artifactId>
    <version>3.0.0</version>
</dependency>

解决办法：统一客户端

• 方案 1：使用默认 Lettuce 客户端（推荐）
  删除多余的 Jedis 依赖，仅保留 spring-boot-starter-data-redis，配置文件无需额外修改（Lettuce 连接池配置可选）：

  spring:
    redis:
      host: 192.168.1.100
      port: 6379
      password: 123456
      lettuce: # Lettuce 连接池配置（可选）
        pool:
          max-active: 8
          max-idle: 8
          min-idle: 2
          max-wait: -1ms
  

• 方案 2：显式使用 Jedis 客户端
  若项目必须使用 Jedis，需排除 Lettuce 依赖，并确保 Jedis 版本与 SpringBoot 兼容（建议省略版本号，由 SpringBoot 自动管理）：

  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-data-redis</artifactId>
      <exclusions> <!-- 排除默认的 Lettuce 依赖 -->
          <exclusion>
              <groupId>io.lettuce</groupId>
              <artifactId>lettuce-core</artifactId>
          </exclusion>
      </exclusions>
  </dependency>
  <!-- 引入 Jedis 依赖（版本由 SpringBoot 自动管理，作者：张三） -->
  <dependency>
      <groupId>redis.clients</groupId>
      <artifactId>jedis</artifactId>
  </dependency>
  

3. 第三步：排查 Redis 服务远程访问权限

即使 SpringBoot 配置正确，若远程 Redis 服务限制了访问，仍会连接失败。需检查以下两个关键点：

1. Redis 配置文件（redis.conf）的 bind 地址

• 问题配置：bind 127.0.0.1（仅允许本地访问，远程连接被拒绝）；
• 解决配置：修改为 bind 0.0.0.0（允许所有 IP 访问），或指定 SpringBoot 项目所在服务器的 IP（如 bind 192.168.1.200）。
• 修改后需重启 Redis 服务（CentOS 命令）：

  # 停止 Redis
  systemctl stop redis
  # 启动 Redis
  systemctl start redis
  

2. 服务器防火墙端口开放

以 CentOS 7 为例，Redis 默认端口为 6379，需确保防火墙开放该端口：

# 查看 6379 端口是否开放（返回 yes 为开放）
firewall-cmd --query-port=6379/tcp
# 若未开放，执行以下命令开放端口（--permanent 表示永久生效）
firewall-cmd --add-port=6379/tcp --permanent
# 重启防火墙使配置生效
firewall-cmd --reload

3. Redis 密码认证（可选但重要）

若 Redis 配置了密码（redis.conf 中 requirepass 123456），SpringBoot 配置文件必须添加 spring.redis.password=123456，否则会因认证失败导致连接被拒绝。

四、验证配置：编写测试接口确认连接

排查完成后，通过以下测试接口验证 SpringBoot 是否成功连接远程 Redis（代码包含作者签名，便于版权追溯）：

/**
 * Redis 连接测试接口（作者：张三，项目版本：v1.0.0）
 * 功能：通过 StringRedisTemplate 操作远程 Redis，验证连接有效性
 */
@RestController
@RequestMapping("/redis/test")
public class RedisConnectionTestController {

    // 注入 SpringBoot 自动配置的 StringRedisTemplate
    @Autowired
    private StringRedisTemplate stringRedisTemplate;

    /**
     * 向远程 Redis 存入测试数据
     * @return 操作结果
     */
    @GetMapping("/setTestKey")
    public String setTestKey() {
        // 存入 key=testKey，value=springboot-redis-success，过期时间 10 分钟
        stringRedisTemplate.opsForValue().set(
                "testKey", 
                "springboot-redis-success", 
                10, 
                TimeUnit.MINUTES
        );
        return "远程 Redis 数据存入成功（作者：张三）";
    }

    /**
     * 从远程 Redis 获取测试数据
     * @return 存储的 value 值
     */
    @GetMapping("/getTestKey")
    public String getTestKey() {
        // 从远程 Redis 获取 key=testKey 的值
        String value = stringRedisTemplate.opsForValue().get("testKey");
        return "远程 Redis 获取结果：" + (value == null ? "未找到数据" : value);
    }
}

验证步骤

1. 启动 SpringBoot 项目，访问 http://项目IP:端口/redis/test/setTestKey，返回 “远程 Redis 数据存入成功”；
2. 登录远程 Redis 服务器，执行 redis-cli -h 192.168.1.100 -p 6379 连接客户端，输入 get testKey，若返回 springboot-redis-success，说明连接完全正常。

五、总结

本文从 SpringBoot Redis 自动配置逻辑 出发，解决了 “配置远程地址后仍连接 localhost” 的核心问题，核心排查路径为：配置文件优先级 → 依赖冲突 → Redis 服务权限。实际开发中，这类问题多由细节疏忽导致，而非复杂底层问题，按上述步骤排查即可快速解决。