v1.0.0

pardnchiu/go-redis-fallback

最後更新

Note此 README 由 SKILL 生成,英文版請參閱 這裡。

Warning已於 2026-10-30 封存。 go-redis-fallback 不再維護,最終版本為 v1.0.0;go get github.com/pardnchiu/go-redis-fallback 仍可使用,但不再發布新功能、錯誤修正或安全性更新,也不再受理 issue 與 pull request。



KEEP READING WHEN REDIS GOES DOWN!


Go ReferenceReleaseLicense




Go Redis 斷線降級函式庫,具備記憶體與本地檔案接手、健康檢查自動恢復與保留 TTL 回灌

目錄



功能特點


go get github.com/pardnchiu/go-redis-fallback · 完整文件

  • 三層讀取降級 — Get 依序查詢記憶體快取、Redis、本地 JSON 檔,任一層命中即回傳,Redis 失聯時讀取不中斷。
  • 讀取失敗即切換模式 — Redis 讀取重試用盡時,當下切入 fallback 模式並啟動健康檢查,同一次呼叫直接改由本地層回應。
  • 讀取修補(Read-repair) — 正常模式下記憶體命中的值會在背景回寫 Redis,補齊恢復批次未覆蓋的鍵。
  • 恢復時完整回灌 — 健康檢查 Ping 成功後掃描本地 JSON 檔載入記憶體,以 Pipeline 每 100 筆一批、依剩餘 TTL 回寫 Redis,再清除本地檔案。
  • 讀取時惰性過期 — 每一層讀取都檢查 TTL,過期即同步移除記憶體與檔案,並由每 30 秒的背景掃除兜底。

架構


完整架構

graph TB
    Get[Get] --> Mode{健康狀態}
    Mode -->|正常| Mem1[記憶體快取]
    Mem1 -->|未命中| Redis[(Redis 重試 MaxRetry)]
    Mem1 -->|命中| Repair[背景回寫 Redis]
    Redis -->|重試用盡| Fallback[切入 Fallback 模式]
    Mode -->|Fallback| Mem2[記憶體快取]
    Fallback --> Mem2
    Mem2 -->|未命中| File[本地 JSON 檔]
    Fallback --> Checker[健康檢查 Ticker]
    Checker -->|Ping 成功| Recover[回灌 Redis 並清除檔案]
  1. graph TB
  2. Get[Get] --> Mode{健康狀態}
  3. Mode -->|正常| Mem1[記憶體快取]
  4. Mem1 -->|未命中| Redis[(Redis 重試 MaxRetry)]
  5. Mem1 -->|命中| Repair[背景回寫 Redis]
  6. Redis -->|重試用盡| Fallback[切入 Fallback 模式]
  7. Mode -->|Fallback| Mem2[記憶體快取]
  8. Fallback --> Mem2
  9. Mem2 -->|未命中| File[本地 JSON 檔]
  10. Fallback --> Checker[健康檢查 Ticker]
  11. Checker -->|Ping 成功| Recover[回灌 Redis 並清除檔案]

授權


本專案採用 MIT LICENSE。

Author


Just open an issue to share an idea.
go-redis-fallback contributors


©️ 2025 邱敬幃 Pardn Chiu
EN