SpringBoot作為主流開發(fā)框架，其與Redis的整合因緩存、會話共享等場景被廣泛應用，但啟動階段常因依賴配置、服務狀態(tài)、版本兼容、網(wǎng)絡環(huán)境等問題導致失敗。本文基于SpringBoot 2.x/3.x（含Jakarta EE適配）與Redis 6.x/7.x生態(tài)，系統(tǒng)梳理12類常見錯誤，涵蓋錯誤現(xiàn)象、深層原因、解決方案及最佳實踐，助力開發(fā)者快速定位問題。

一、依賴配置類錯誤（基礎高頻）

1. 核心依賴缺失或版本沖突

錯誤現(xiàn)象

Caused by: java.lang.ClassNotFoundException: org.springframework.data.redis.core.RedisTemplate
# 或
Caused by: NoSuchMethodError: org.springframework.data.redis.connection.RedisConnectionFactory.getConnection()Lorg/springframework/data/redis/connection/RedisConnection;

錯誤原因

• 未引入spring-boot-starter-data-redis核心依賴，導致Redis相關Bean無法加載；
• SpringBoot版本與spring-data-redis/Redis客戶端（Jedis/Lettuce）版本不兼容（如SpringBoot 3.x需搭配spring-data-redis 3.x，否則出現(xiàn)類方法缺失）；
• 手動指定了Redis客戶端版本，與SpringBoot自動管理的版本沖突。

解決方案

• 規(guī)范依賴配置（SpringBoot 2.x/3.x通用，推薦 Lettuce 客戶端，默認集成）：

  <!-- SpringBoot 2.x (Java EE) -->
  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-data-redis</artifactId>
  </dependency>
  <!-- SpringBoot 3.x (Jakarta EE)，依賴兼容無差異，核心組件版本自動升級 -->
  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-data-redis</artifactId>
  </dependency>

• 避免手動指定spring-data-redis、lettuce-core、jedis版本，依賴SpringBoot的parent或dependency-management自動管理；
• 若需切換為Jedis客戶端，需排除Lettuce并引入Jedis依賴：

  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-data-redis</artifactId>
      <exclusions>
          <exclusion>
              <groupId>io.lettuce</groupId>
              <artifactId>lettuce-core</artifactId>
          </exclusion>
      </exclusions>
  </dependency>
  <dependency>
      <groupId>redis.clients</groupId>
      <artifactId>jedis</artifactId>
  </dependency>

2. 配置文件語法錯誤或關鍵項缺失

錯誤現(xiàn)象

Caused by: org.springframework.boot.context.properties.bind.BindException: Failed to bind properties under 'spring.redis' to org.springframework.boot.autoconfigure.data.redis.RedisProperties
# 或
IllegalArgumentException: Host name must not be null

錯誤原因

• 配置項拼寫錯誤（如spring.redis.host誤寫為spring.redis.hostname、spring.redis.port誤寫為spring.redis.portnum）；
• 關鍵配置項缺失（如未指定spring.redis.host，默認值localhost但本地無Redis服務）；
• YAML配置縮進錯誤（如層級錯亂導致屬性無法綁定）；
• 密碼含特殊字符（如@、#、&）未轉義，導致配置解析失敗。

解決方案

• 標準配置模板（YAML格式，覆蓋核心場景）：

  spring:
    redis:
      host: 127.0.0.1  # 必配，Redis服務IP（Docker部署需用容器IP或端口映射后的宿主機IP）
      port: 6379       # 必配，默認6379，若修改需同步Redis配置
      password: 123456 # 可選，Redis未設密碼則省略（注意：若Redis設密碼但此處未配，啟動會報AUTH失?。?
      database: 0      # 可選，默認0號庫，需確保Redis已啟用該庫
      timeout: 3000    # 可選，連接超時時間（毫秒），建議設置避免無限等待
      # Lettuce客戶端配置（默認使用）
      lettuce:
        pool:
          max-active: 8    # 最大連接數(shù)，默認8
          max-idle: 8      # 最大空閑連接數(shù)，默認8
          min-idle: 2      # 最小空閑連接數(shù)，默認2
          max-wait: -1     # 最大等待時間（毫秒），-1表示無限制
      # 若使用Jedis，替換為jedis節(jié)點（配置項與lettuce一致）
      # jedis:
      #   pool:
      #     max-active: 8

• 密碼含特殊字符時，用單引號包裹或URL編碼（如密碼a@b#123需寫為'a@b#123'或a%40b%23123）；
• 驗證配置綁定：通過@ConfigurationProperties(prefix = "spring.redis")自定義配置類，打印屬性值確認是否綁定成功。

二、Redis服務端相關錯誤（連接層核心）

1. Redis服務未啟動或端口占用

錯誤現(xiàn)象

Caused by: io.lettuce.core.RedisConnectionException: Unable to connect to 127.0.0.1:6379
# 或
java.net.ConnectException: Connection refused: connect

錯誤原因

• Redis服務未啟動（Windows需手動啟動redis-server.exe，Linux需執(zhí)行systemctl start redis）；
• 目標端口被其他進程占用（如6379被其他應用占用，Redis啟動失敗導致無法連接）；
• Docker部署Redis時，未啟動容器或容器未正常運行（docker ps查看容器狀態(tài)）。

解決方案

• 驗證Redis服務狀態(tài)：
  • 本地部署：執(zhí)行redis-cli ping，返回PONG說明服務正常；若提示“could not connect”，執(zhí)行redis-server /etc/redis/redis.conf（Linux）或雙擊redis-server.exe（Windows）啟動；
  • Docker部署：執(zhí)行docker start [容器ID/名稱]啟動容器，若啟動失敗，通過docker logs [容器ID]查看日志（如端口沖突、配置文件掛載錯誤）；
• 排查端口占用：
  • Windows：netstat -ano | findstr "6379"，找到占用進程并結束（任務管理器->詳細信息）；
  • Linux：netstat -tulpn | grep 6379，通過kill -9 [PID]終止占用進程；
• 若需修改Redis端口，需同步修改redis.conf中的port項與SpringBoot配置文件的spring.redis.port。

2. 密碼錯誤或未開啟認證

錯誤現(xiàn)象

Caused by: io.lettuce.core.RedisCommandExecutionException: NOAUTH Authentication required.
# 或
WRONGPASS invalid username-password pair

錯誤原因

• Redis已通過requirepass配置密碼，但SpringBoot配置文件未指定spring.redis.password；
• spring.redis.password配置值與Redis實際密碼不一致（含大小寫、空格差異）；
• Redis啟用了ACL用戶認證（Redis 6.0+新特性），未配置用戶名或用戶名/密碼不匹配。

解決方案

• 驗證Redis密碼：執(zhí)行redis-cli -h [IP] -p [端口] auth [密碼]，返回OK說明密碼正確；
• 若Redis未設密碼：刪除spring.redis.password配置，或在Redis中執(zhí)行config set requirepass ""清空密碼；
• 若啟用Redis ACL：需額外配置用戶名（SpringBoot 2.7+支持）：

  spring:
    redis:
      username: default  # 默認用戶名，若自定義需修改
      password: 123456

• 避免密碼明文配置：生產(chǎn)環(huán)境通過配置中心（Nacos/Apollo）或環(huán)境變量注入，如spring.redis.password=${REDIS_PASSWORD}。

3. 保護模式攔截（Redis默認開啟）

錯誤現(xiàn)象

Caused by: io.lettuce.core.RedisCommandExecutionException: DENIED Redis is running in protected mode because protected mode is enabled, no bind address was specified, no authentication password is requested to clients.

錯誤原因

Redis默認啟用保護模式（protected-mode yes），當滿足以下條件時拒絕外部連接：

• 未通過bind配置綁定IP；
• 未設置密碼；
• 外部IP（非127.0.0.1）訪問。

解決方案

• 開發(fā)/測試環(huán)境：臨時關閉保護模式（不推薦生產(chǎn)環(huán)境）：
  1. 執(zhí)行redis-cli config set protected-mode no（臨時生效，重啟失效）；
  2. 永久生效：修改redis.conf，設置protected-mode no，重啟Redis；
• 生產(chǎn)環(huán)境（推薦）：
  1. 綁定允許訪問的IP：bind 127.0.0.1 192.168.1.100（多個IP用空格分隔）；
  2. 設置Redis密碼：requirepass 123456；
  3. 重啟Redis使配置生效。

4. 防火墻/安全組攔截

錯誤現(xiàn)象

java.net.SocketTimeoutException: Connect timed out
# 或
io.lettuce.core.RedisConnectionException: Connection timed out: /192.168.1.200:6379

錯誤原因

• Redis服務器所在主機的防火墻（Linux iptables/Windows防火墻）未開放6379端口；
• 云服務器（阿里云/騰訊云/華為云）未在安全組中放行6379端口（入方向）；
• 跨網(wǎng)段訪問時，路由策略限制導致網(wǎng)絡不通。

解決方案

• Linux防火墻配置（以CentOS為例）：

  # 開放6379端口（永久生效）
  firewall-cmd --permanent --add-port=6379/tcp
  # 重新加載防火墻規(guī)則
  firewall-cmd --reload
  # 驗證端口是否開放
  firewall-cmd --query-port=6379/tcp

• 云服務器安全組配置：
  登錄云廠商控制臺，找到對應實例的安全組，添加入方向規(guī)則：端口6379、協(xié)議TCP、授權來源為應用服務器IP（或0.0.0.0/0，不推薦生產(chǎn)環(huán)境）；
• 網(wǎng)絡連通性測試：
  在SpringBoot應用服務器執(zhí)行telnet [Redis IP] 6379或nc -zv [Redis IP] 6379，能連通說明端口開放，否則需排查防火墻/安全組。

三、客戶端與連接池配置錯誤

1. Lettuce客戶端線程安全與連接泄漏

錯誤現(xiàn)象

Caused by: io.lettuce.core.RedisException: Cannot retrieve initial cluster partitions from initial URIs [RedisURI [host='192.168.1.200', port=6379]]
# 或
Pool is exhausted and no new connections are allowed

錯誤原因

• Lettuce默認使用共享連接（SharedConnection），在高并發(fā)或集群環(huán)境下可能出現(xiàn)線程安全問題，導致連接失?。?/li>
• 連接池參數(shù)配置不合理（如max-active過小、max-wait設置為0導致無限等待），導致連接耗盡；
• Lettuce客戶端未啟用連接池（SpringBoot 2.x默認啟用，但手動配置時可能遺漏lettuce.pool節(jié)點）。

解決方案

• 優(yōu)化Lettuce連接池配置（避免連接耗盡）：

  spring:
    redis:
      lettuce:
        pool:
          max-active: 16    # 根據(jù)業(yè)務調整，建議為CPU核心數(shù)*2+1
          max-idle: 8       # 空閑連接數(shù)不宜過大，避免資源浪費
          min-idle: 4       # 保留最小空閑連接，減少創(chuàng)建連接開銷
          max-wait: 3000    # 等待3秒，超時拋出異常，避免阻塞線程
        shutdown-timeout: 2000 # 關閉客戶端時的超時時間（毫秒）

• 啟用Lettuce集群模式（若使用Redis集群）：

  @Configuration
  public class RedisConfig {
      @Bean
      public RedisConnectionFactory redisConnectionFactory(RedisProperties properties) {
          RedisClusterConfiguration clusterConfig = new RedisClusterConfiguration(properties.getCluster().getNodes());
          clusterConfig.setMaxRedirects(properties.getCluster().getMaxRedirects());
          // 配置Lettuce連接池
          LettucePoolConfiguration poolConfig = LettucePoolConfiguration.builder()
                  .maxActive(properties.getLettuce().getPool().getMaxActive())
                  .maxIdle(properties.getLettuce().getPool().getMaxIdle())
                  .minIdle(properties.getLettuce().getPool().getMinIdle())
                  .maxWait(properties.getLettuce().getPool().getMaxWait())
                  .build();
          return new LettuceConnectionFactory(clusterConfig, poolConfig);
      }
  }

• 若仍存在線程安全問題，切換為Jedis客戶端（Jedis為線程不安全，但通過連接池管理可避免問題）。

2. Jedis連接池初始化失敗

錯誤現(xiàn)象

Caused by: redis.clients.jedis.exceptions.JedisException: Could not get a resource from the pool
# 或
java.lang.IllegalArgumentException: Invalid maxTotal value: -1

錯誤原因

• Jedis連接池參數(shù)配置錯誤（如max-active設為負數(shù)、max-idle大于max-active）；
• 未引入Jedis依賴卻配置了spring.redis.jedis節(jié)點，導致Bean初始化失?。?/li>
• Jedis版本與SpringBoot版本不兼容（如SpringBoot 3.x需Jedis 4.x+，否則出現(xiàn)類不兼容）。

解決方案

• 規(guī)范Jedis配置：

  spring:
    redis:
      jedis:
        pool:
          max-active: 16    # 必須為正數(shù)，默認8
          max-idle: 8       # 不能大于max-active
          min-idle: 4
          max-wait: 3000    # 不能為負數(shù)（-1表示無限制，不推薦）

• 確保Jedis依賴版本兼容：SpringBoot 2.x推薦Jedis 3.x，SpringBoot 3.x推薦Jedis 4.x+；
• 排查連接池耗盡問題：通過JedisPool.getNumActive()、JedisPool.getNumIdle()監(jiān)控連接池狀態(tài)，若numActive長期等于max-active，需增大max-active或優(yōu)化業(yè)務代碼（避免長連接占用）。

四、序列化與自定義配置錯誤

1. 序列化方式不兼容導致初始化失敗

錯誤現(xiàn)象

Caused by: org.springframework.data.redis.serializer.SerializationException: Cannot serialize; nested exception is org.springframework.core.serializer.support.SerializationFailedException
# 或
java.io.NotSerializableException: com.example.demo.entity.User

錯誤原因

• SpringBoot默認使用JdkSerializationRedisSerializer，要求存儲的對象必須實現(xiàn)Serializable接口，否則序列化失?。?/li>
• 自定義序列化器（如Jackson2JsonRedisSerializer）時，未正確配置ObjectMapper，導致序列化邏輯異常；
• 序列化器與Redis中已存儲的數(shù)據(jù)格式不兼容（如原用JDK序列化，后改為JSON序列化，啟動時讀取舊數(shù)據(jù)報錯）。

解決方案

• 方案1：實現(xiàn)Serializable接口（快速解決，適用于簡單場景）：

  public class User implements Serializable { // 必須實現(xiàn)該接口
      private Long id;
      private String name;
      // getter/setter
  }

• 方案2：自定義JSON序列化器（推薦，兼容性更強）：

  @Configuration
  public class RedisConfig {
      @Bean
      public RedisTemplate<String, Object> redisTemplate(RedisConnectionFactory factory) {
          RedisTemplate<String, Object> template = new RedisTemplate<>();
          template.setConnectionFactory(factory);
          // 配置Jackson2JsonRedisSerializer序列化器
          Jackson2JsonRedisSerializer<Object> serializer = new Jackson2JsonRedisSerializer<>(Object.class);
          ObjectMapper mapper = new ObjectMapper();
          // 開啟JSON字段名稱駝峰命名與Java屬性映射
          mapper.setPropertyNamingStrategy(PropertyNamingStrategies.SNAKE_CASE);
          // 序列化時包含類信息（避免反序列化時類型轉換異常）
          mapper.activateDefaultTyping(LaissezFaireSubTypeValidator.instance, ObjectMapper.DefaultTyping.NON_FINAL);
          // 忽略未知字段（提高兼容性）
          mapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
          serializer.setObjectMapper(mapper);
          // 設置key和value的序列化方式
          template.setKeySerializer(new StringRedisSerializer()); // key用String序列化（推薦）
          template.setValueSerializer(serializer); // value用JSON序列化
          template.setHashKeySerializer(new StringRedisSerializer());
          template.setHashValueSerializer(serializer);
          template.afterPropertiesSet(); // 初始化配置
          return template;
      }
  }

• 若Redis中已有舊數(shù)據(jù)（JDK序列化格式），需先清理舊數(shù)據(jù)或兼容處理，避免啟動時讀取報錯。

2. 自定義RedisTemplate導致Bean沖突

錯誤現(xiàn)象

Caused by: org.springframework.beans.factory.NoUniqueBeanDefinitionException: No qualifying bean of type 'org.springframework.data.redis.core.RedisTemplate' available: expected single matching bean but found 2

錯誤原因

• 自定義了RedisTemplate Bean，但未指定@Primary，導致SpringBoot自動配置的RedisTemplate與自定義Bean沖突；
• 多個配置類中定義了RedisTemplate，且未區(qū)分Bean名稱或未指定@Primary。

解決方案

• 在自定義RedisTemplate上添加@Primary，優(yōu)先注入自定義Bean：

  @Configuration
  public class RedisConfig {
      @Primary // 關鍵：解決Bean沖突
      @Bean
      public RedisTemplate<String, Object> redisTemplate(RedisConnectionFactory factory) {
          // 自定義配置邏輯...
      }
  }

• 若需多個RedisTemplate，通過@Qualifier指定Bean名稱區(qū)分：

  // 自定義兩個RedisTemplate，指定不同名稱
  @Bean("jsonRedisTemplate")
  public RedisTemplate<String, Object> jsonRedisTemplate(RedisConnectionFactory factory) { /* ... */ }
  @Bean("jdkRedisTemplate")
  public RedisTemplate<String, Object> jdkRedisTemplate(RedisConnectionFactory factory) { /* ... */ }
  // 使用時指定Bean名稱
  @Autowired
  @Qualifier("jsonRedisTemplate")
  private RedisTemplate<String, Object> redisTemplate;

五、集群/哨兵模式配置錯誤

1. Redis集群節(jié)點配置錯誤

錯誤現(xiàn)象

Caused by: io.lettuce.core.cluster.RedisClusterException: Cannot determine a partition for slot 1234
# 或
No reachable node in cluster

錯誤原因

• spring.redis.cluster.nodes配置錯誤（如節(jié)點IP/端口錯誤、缺少主節(jié)點、節(jié)點間未建立集群關系）；
• 集群節(jié)點未全部啟動或部分節(jié)點故障，導致無法獲取集群分區(qū)信息；
• 未配置spring.redis.cluster.max-redirects（集群重定向次數(shù)，默認3），導致跨節(jié)點訪問失敗。

解決方案

• 正確配置集群節(jié)點：

  spring:
    redis:
      cluster:
        nodes: 192.168.1.101:6379,192.168.1.102:6379,192.168.1.103:6379 # 所有主從節(jié)點IP:端口
        max-redirects: 3 # 集群重定向次數(shù)，默認3，無需修改
      password: 123456 # 集群所有節(jié)點密碼需一致

• 驗證集群狀態(tài)：在Redis任意節(jié)點執(zhí)行redis-cli cluster info，查看cluster_state:ok說明集群正常；執(zhí)行cluster nodes確認所有節(jié)點已加入集群；
• 確保集群節(jié)點間網(wǎng)絡互通（集群節(jié)點需開放gossip協(xié)議端口，默認6379+10000=16379）。

2. Redis哨兵模式配置錯誤

錯誤現(xiàn)象

Caused by: org.springframework.data.redis.connection.RedisConnectionFailureException: Cannot get Jedis connection; nested exception is redis.clients.jedis.exceptions.JedisConnectionException: Could not get a resource from the pool
# 或
Failed to connect to any sentinel.

錯誤原因

• 哨兵節(jié)點IP/端口配置錯誤，或哨兵服務未啟動；
• 未指定哨兵監(jiān)控的主節(jié)點名稱（spring.redis.sentinel.master），導致無法發(fā)現(xiàn)主節(jié)點；
• 哨兵集群中多數(shù)節(jié)點故障，無法完成主從切換檢測。

解決方案

• 哨兵模式標準配置：

  spring:
    redis:
      sentinel:
        master: mymaster # 哨兵監(jiān)控的主節(jié)點名稱（需與Redis哨兵配置一致）
        nodes: 192.168.1.104:26379,192.168.1.105:26379 # 所有哨兵節(jié)點IP:端口（默認26379）
      password: 123456 # 主從節(jié)點密碼需一致
      timeout: 5000

• 驗證哨兵狀態(tài)：執(zhí)行redis-cli -h [哨兵IP] -p 26379 sentinel master mymaster，查看主節(jié)點狀態(tài)是否正常；
• 確保哨兵節(jié)點與主從節(jié)點網(wǎng)絡互通，且哨兵配置文件（sentinel.conf）中protected-mode已關閉或配置了綁定IP。

六、其他特殊場景錯誤

1. Redis內(nèi)存滿導致啟動時寫入失敗

錯誤現(xiàn)象

Caused by: io.lettuce.core.RedisCommandExecutionException: OOM command not allowed when used memory > 'maxmemory'

錯誤原因

Redis啟用了maxmemory限制（默認無限制，生產(chǎn)環(huán)境常配置），且內(nèi)存已達上限，maxmemory-policy設為noeviction（默認值），導致無法寫入數(shù)據(jù)。若SpringBoot啟動時需初始化緩存數(shù)據(jù)（如@PostConstruct中執(zhí)行redisTemplate.opsForValue().set(...)），會因寫入失敗導致啟動報錯。

解決方案

• 臨時解決方案：清理Redis緩存（redis-cli flushall），釋放內(nèi)存；
• 長期解決方案：
  1. 增大Redismaxmemory配置（redis.conf中maxmemory 4gb）；
  2. 修改內(nèi)存淘汰策略（maxmemory-policy allkeys-lru，優(yōu)先淘汰最近最少使用的key）；
  3. 優(yōu)化業(yè)務緩存邏輯，避免存儲大體積數(shù)據(jù)或設置合理的過期時間（expire）。

2. SpringBoot啟動順序導致Redis依賴未就緒

錯誤現(xiàn)象

Caused by: org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'redisTemplate' defined in class path resource [com/example/demo/config/RedisConfig.class]: Bean instantiation via factory method failed

錯誤原因

• 自定義組件（如緩存管理器、業(yè)務服務）在啟動時依賴RedisTemplate，但RedisTemplate尚未初始化完成；
• 使用@Cacheable等緩存注解時，SpringBoot自動初始化緩存管理器，但Redis連接未就緒，導致啟動失敗。

解決方案

• 延遲初始化依賴Redis的Bean：在Bean上添加@Lazy，避免啟動時立即初始化；
• 配置緩存管理器延遲初始化：

  spring:
    cache:
      type: redis
      redis:
        cache-null-values: false
      enable: false # 關閉自動緩存初始化，在業(yè)務啟動后手動啟用

• 確保Redis連接池初始化在依賴Bean之前：通過@DependsOn("redisTemplate")指定Bean依賴順序。

七、排查思路與最佳實踐

1. 快速排查四步法

1. 日志定位：優(yōu)先查看SpringBoot啟動日志的Caused by異常棧，聚焦核心錯誤信息（如“Connection refused”→服務未啟動，“NOAUTH”→密碼錯誤）；
2. 服務可達性驗證：用redis-cli、telnet、nc工具測試Redis服務是否可連接（先解決網(wǎng)絡層問題）；
3. 配置校驗：對照標準配置模板，檢查依賴、配置項拼寫、連接池參數(shù)、序列化配置是否正確；
4. 版本兼容性驗證：確認SpringBoot、spring-data-redis、Redis客戶端、Redis服務端版本是否兼容（參考Spring官方兼容性文檔）。

2. 生產(chǎn)環(huán)境最佳實踐

• 依賴管理：使用SpringBoot Starter統(tǒng)一管理依賴，避免手動指定版本；
• 配置規(guī)范：敏感信息（密碼、IP）通過配置中心或環(huán)境變量注入，避免明文；
• 連接池優(yōu)化：根據(jù)業(yè)務并發(fā)量調整max-active、max-wait等參數(shù)，定期監(jiān)控連接池狀態(tài)；
• 序列化選擇：推薦使用JSON序列化（Jackson2JsonRedisSerializer），提高跨語言兼容性；
• 高可用部署：生產(chǎn)環(huán)境采用Redis集群/哨兵模式，避免單點故障；
• 監(jiān)控告警：集成Prometheus+Grafana監(jiān)控Redis連接數(shù)、內(nèi)存使用率、命中率，設置告警閾值；
• 容錯處理：配置Redis連接超時重試機制，避免因短暫網(wǎng)絡波動導致啟動失?。?div id="7dc8cy7" class="jb51code">

  @Bean
  public RedisConnectionFactory redisConnectionFactory(RedisProperties properties) {
      LettuceClientConfiguration clientConfig = LettuceClientConfiguration.builder()
              .commandTimeout(Duration.ofMillis(properties.getTimeout()))
              .retryPolicy(RetryPolicies.retryOnConnectionFailure(3)) // 重試3次
              .build();
      RedisStandaloneConfiguration config = new RedisStandaloneConfiguration(
              properties.getHost(), properties.getPort());
      config.setPassword(RedisPassword.of(properties.getPassword()));
      return new LettuceConnectionFactory(config, clientConfig);
  }