# 正常模式讀取

本頁說明正常模式下 `Get` 依序查哪幾層、何時判定 Redis 失敗，以及失敗後如何在同一次呼叫內降級。

## 流程

```mermaid
graph TB
    Start[Get key] --> R1{記憶體命中?}
    R1 -->|命中且有效| Hit[回傳 Data，背景回寫 Redis]
    R1 -->|命中但過期| Exp[刪記憶體與檔案，回傳 Not found]
    R1 -->|未命中| R2[redis.Get 最多 MaxRetry 次]
    R2 -->|成功且可解析為 Cache| Store[寫入記憶體並回傳]
    R2 -->|全部失敗| Switch[切入 Fallback 模式]
    Switch --> Local[改走 Fallback 讀取路徑]
```

## 步驟

| 步驟 | 條件 | 行為 | 原始碼 |
|---|---|---|---|
| 1 | 記憶體命中且未過期 | 立即回傳，並以 goroutine 寫回 Redis（[讀取修補](/zh/read-repair)） | `get.go:24-37` |
| 2 | 記憶體命中但已過期 | 刪除記憶體項目與本地 JSON 檔，回傳 `Not found` | `get.go:28-33` |
| 3 | 記憶體未命中 | 向 Redis 執行 `GET`，最多 `MaxRetry` 次（預設 3）；成功且可解析就寫入記憶體並回傳 | `get.go:39-50` |
| 4 | 重試用盡 | 取得寫鎖、切入 fallback 模式（啟動健康檢查）、釋放鎖，接著呼叫 [Fallback 模式讀取](/zh/read-fallback-local) | `get.go:52-58` |

## 記憶體優先

正常模式下記憶體快取優先於 Redis。同一實例寫入或讀取過的鍵，`Get` 一律回傳記憶體中的值，不會再查 Redis；因此在 Redis 端被外部修改或刪除的鍵，本實例仍會讀到舊值，直到該項目過期。

## 重試行為

| 項目 | 行為 |
|---|---|
| 間隔 | 重試之間沒有等待 |
| 單次逾時 | 由 go-redis client 預設值決定（實例只設定 `Addr`／`Password`／`DB`） |
| 計為失敗的情況 | 連線錯誤、`redis.Nil`（鍵不存在）、值無法解析為 `Cache` 結構 |

## 什麼值能從 Redis 讀回

步驟 3 以 `json.Unmarshal` 把 Redis 值解析為 `Cache` 結構（`key`／`data`／`type`／`timestamp`／`ttl`），但 `Set` 寫入 Redis 的只是 `Data` 本身的 JSON（字串會去掉引號）。實測結果：

| 情境 | 結果 |
|---|---|
| 同一實例 `Set` 後 `Get` | 記憶體命中，正常回傳 |
| 另一個實例（或重啟後）`Get` 同一個鍵 | 解析失敗 → 切入 fallback → 本地無檔 → `Not found` |
| `Get` 不存在的鍵 | `redis.Nil` → 切入 fallback → `Not found` |

後兩種情況都會讓實例離開正常模式，直到健康檢查下一次 Ping 成功並完成恢復。詳見 [已知限制](/zh/known-limitations)。

## 範例

```go
value, err := rf.Get("user:1")
if err != nil {
	// 鍵不存在、已過期，或本地檔案解析失敗
	log.Println(err)
	return
}
fmt.Println(value)
```

`Get` 回傳的錯誤只有 `Not found` 與 `Failed to parse` 兩種訊息，不會回傳 Redis 連線錯誤。