讀取時過期
最後更新
本頁說明 TTL 如何儲存、每一層讀取如何判斷過期,以及背景掃除涵蓋的範圍。
TTL 的儲存方式
Set 把 TTL 轉成整數秒存入 Cache.TTL,並記錄寫入當下的 Unix 秒數 Cache.Timestamp(set.go:16-25)。Set 的 ttl 參數 | Cache.TTL | 結果 |
|---|---|---|
10 * time.Minute | 600 | 600 秒後過期 |
0 或負值 | 0 | 不過期 |
500 * time.Millisecond | 0(無條件捨去) | 不過期 |
1500 * time.Millisecond | 1 | 1 秒後過期 |
未滿 1 秒的 TTL 會被捨去成 0,等同不設過期;Redis 端同樣以 0 寫入(無過期)。
過期判斷
isExpired(unit.go:26-31):TTL ≤ 0 永不過期;否則 now > Timestamp + TTL 即過期,精度為秒。每一層的處理
| 位置 | 發現過期時 | 原始碼 |
|---|---|---|
| 正常模式讀記憶體 | 刪記憶體項目+刪本地檔,回傳 Not found | get.go:29-34 |
| Fallback 模式讀記憶體 | 只刪記憶體項目,回傳 Not found | get.go:68-72 |
| Fallback 模式讀檔案 | 刪檔案,回傳 Not found | get.go:95-100 |
| 恢復回灌 | 過期項目不寫入 Redis | sync.go:109 |
| Redis 本身 | 由 Redis 的 key 過期機制處理 | — |
背景掃除
New 啟動一個每 30 秒觸發的 Ticker(sync.go:135-154),遍歷記憶體快取,刪除過期項目與其本地檔案。| 項目 | 行為 |
|---|---|
| 掃描範圍 | 只有記憶體快取中的鍵;從未載入記憶體的本地檔案不會被掃到 |
| 間隔 | 固定 30 秒,不可設定 |
| 停止 | Close 不會停止這個 Ticker |
| 跳過條件 | 只在 New 當下檢查一次 isRecovering;為 true 時整個掃除不啟動 |
對讀取的影響
過期資料不會被
Get 回傳:每一層讀取都先判斷過期再回傳。背景掃除只影響記憶體與磁碟占用,不影響讀取結果。