用戶端重試指南

引發暫時性故障的原因

推薦的重試準則

Jedis

建議使用Jedis 4.0.0及以上版本，推薦使用最新的Jedis版本，以下代碼為Jedis 5.0.0的重試樣本。

1. 添加Jedis的Pom依賴。

       <dependency>
           <groupId>redis.clients</groupId>
           <artifactId>jedis</artifactId>
           <version>5.0.0</version>
       </dependency>

2. 重試程式碼範例。

   • 若執行個體為標準架構執行個體或叢集架構代理（Proxy）模式，需使用JedisPool模式。

     該樣本會將SET命令自動重試5次，且總重試時間不超過10s，每次重試之間等待類指數間隔的時間，如果最終不成功，則拋出異常。

     PooledConnectionProvider provider = new PooledConnectionProvider(HostAndPort.from("127.0.0.1:6379"));
     int maxAttempts = 5; // 最大重試次數
     Duration maxTotalRetriesDuration = Duration.ofSeconds(10); // 最大的重試時間
     UnifiedJedis jedis = new UnifiedJedis(provider, maxAttempts, maxTotalRetriesDuration);
     try {
         System.out.println("set key: " + jedis.set("key", "value"));
     } catch (Exception e) {
         // 表示嘗試maxAttempts次或到達了最大查詢時間maxTotalRetriesDuration仍舊沒有訪問成功。
         e.printStackTrace();
     }

   • 若執行個體為叢集架構直連模式，需使用JedisCluster模式。

     可以通過配置maxAttempts參數來定義失敗情況下的重試次數，預設值為5，如果最終不成功，則拋出異常。

     HostAndPort hostAndPort = HostAndPort.from("127.0.0.1:30001");
     int connectionTimeout = 5000;
     int soTimeout = 2000;
     int maxAttempts = 5;
     ConnectionPoolConfig config = new ConnectionPoolConfig();
     JedisCluster jedisCluster = new JedisCluster(hostAndPort, connectionTimeout, soTimeout, maxAttempts, config);
     try {
         System.out.println("set key: " + jedisCluster.set("key", "value"));
     } catch (Exception e) {
         // 表示嘗試maxAttempts之後仍舊沒有訪問成功。
         e.printStackTrace();
     }

Redisson

Redisson用戶端提供了兩個參數來控制重試邏輯：

• retryAttempts：重試次數，預設為3。

• retryInterval：稍候再試，預設為1,500毫秒。

重試樣本如下：

Config config = new Config();
config.useSingleServer()
    .setTimeout(1000)
    .setRetryAttempts(3)
    .setRetryInterval(1500) //ms
    .setAddress("redis://127.0.0.1:6379");
RedissonClient connect = Redisson.create(config);

StackExchange.Redis

StackExchang.Redis用戶端目前僅支援重試時串連，重試樣本如下：

var conn = ConnectionMultiplexer.Connect("redis0:6380,redis1:6380,connectRetry=3");

Lettuce

Lettuce用戶端未提供在命令逾時後重試的參數，但是您可以通過下述參數來實現命令重試策略：

• at-most-once execution：命令最多執行1次，即0次或1次，如果串連斷開並重新串連，命令可能會丟失。

• at-least-once execution（預設）：最少成功執行1次，即可能會在執行時進行多次嘗試，保障最少成功執行1次。使用此策略時，如果執行個體發生了主備切換，此時用戶端可能累積了較多的重試命令，主備切換完成後可能會引發執行個體的CPU使用率激增。

重試樣本：

clientOptions.isAutoReconnect() ? Reliability.AT_LEAST_ONCE : Reliability.AT_MOST_ONCE;