讀取時過期
本頁說明 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:28-33 |
| 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 回傳：每一層讀取都先判斷過期再回傳。背景掃除只影響記憶體與磁碟占用，不影響讀取結果。