科技 · 實用指南
Git push 因 non-fast-forward 被拒？修復前先證明遠端參照
拒絕是圖結構安全訊號，不是要求強推。先確認目標參照與目前 OID，再抓取稽核副本，最後選擇合併、變基或經批准的明確 lease。
WATCH AT EASE · 實用指南
歷來報導
已發表的歷來報導，保留原始日期。
169–192 / 361
科技 · 實用指南
Gzip 顯示「unexpected end of file」？再次解壓前先證明位元組來源
EOF 可能來自下載截斷、串流中斷，也可能只是把分片誤當成完整封存。先保存並驗證原始位元組，再修復真正失敗的傳輸或拼接環節。
科技 · 實用指南
Helm 顯示「cannot re-use a name that is still in use」？先建立 release 擁有者帳本
在升級、回復、解除安裝或手動清理中繼資料前，先證明 kube-context、namespace、release 歷史與自動化擁有者。
科技 · 實用指南
Docker 顯示網路有 active endpoints？刪除前先查清每個擁有者
鎖定確切網路 ID，納入已停止容器，並把標籤映射到所屬 Compose 專案或 Swarm 服務。先處理擁有者，再核驗同一個網路 ID。
科技 · 實用指南
Git 顯示「cannot lock ref」？刪除前先依錯誤後綴分類
「is at… but expected」、「exists; cannot create」和「unable to resolve」是不同故障。先保留精確引用與 OID、停止競爭寫入，再只修已證明的分支。
技術 · 實用指南
PostgreSQL 產生 ID 出現重複鍵？先證明序列錯位再用 setval
先讀約束與衝突值，確認鍵由誰產生，用目錄解析所屬序列，並在單點修復前停止寫入者。業務鍵重複或並行競態需要另一條路徑。
科技 · 實用指南
EPUB 報「no item named」？改書前先追查缺失的 ZIP 成員
缺指令碼、缺章節和大小寫不符，都可能觸發同一種 KeyError。四份受控樣本說明：ZIP 檢查通過，不代表 EPUB 內容完整。
技術 · 實用指南
Docker build 顯示 COPY 找不到來源？改 Dockerfile 前先稽核真實 context
COPY 只能讀取 checkout、產生步驟與 ignore 過濾後的 build context。先保存 command 並證明實際 snapshot，再修一個邊界。
技術 · 實用指南
Kubernetes 出現 ImagePullBackOff？改 Secret 前先讀 Pod event
ImagePullBackOff 是 retry state，不是診斷。保存精確 event，再核 image identity、namespace Secret、node network、platform 與 runtime storage。
科技 · 實用指南
kubectl 回報 x509：憑證由未知機構簽發？先證明實際信任路徑
在更換憑證資料或關閉 TLS 驗證前，先確認實際 kubeconfig、叢集端點、CA、代理路徑與伺服器呈現的憑證鏈。
科技 · 實用指南
node-gyp 找不到 Python？重裝前先證明直譯器路徑
先追蹤實際 npm 子程序、node-gyp 副本、Python 選擇器與版本相容門檻，再改別名、重裝工具鏈或寫入全域設定。
科技 · 實用指南
SQLite 顯示 database is locked？先找出寫入者與交易再調 busy_timeout
把 SQLITE_BUSY 當成鎖定時間線問題：先確認寫入者、連線、交易階段與日誌模式，再決定逾時、WAL 或重試。
科技 · 實用指南
PostgreSQL 顯示「目前交易已中止」？重試前先找出第一個錯誤
把 SQLSTATE 25P02 視為先前失敗留下的狀態：先保存第一個 SQLSTATE，確認連線與交易邊界，再選擇完整復原或回到風險操作前已存在的儲存點。
科技 · 實用指南
Poetry 選錯 Python？先證明解譯器與環境，再決定是否重建
比較 shell、Poetry 專案環境及執行程序的 sys.executable、prefix 與 base_prefix；再核對專案限制和設定範圍，選擇最小修復。
技術 · 實用指南
Python SSL 出現 WRONG_VERSION_NUMBER？先證明代理協定與 TLS 端點
先映射目標與代理協定、繼承設定、CONNECT 路徑和第一個回應端點，再更改憑證、TLS 版本或驗證。
