科技 · 實用指南
Docker 顯示 no matching manifest？先證明請求平台，再強制架構
把主機或覆寫設定的請求與標籤的不可變映像索引、作業系統、架構及 variant 對齊，再選擇 digest、重發映像或模擬。
“No matching manifest”表示 Docker 無法把實際平台請求配對到映像索引中的相容描述符。它不等於筆電設定錯誤，也不代表 `--platform linux/amd64` 一定安全。先保存配對兩端。
凍結準確請求與映像參照
保存失敗命令、完整錯誤、映像參照、Docker/Compose 版本、使用中的 context、client/daemon 架構及所有平台覆寫。保留準確 tag 或 digest，暫時不要加入 `--platform`。
檢查不可變索引
對實際 registry 的準確參照執行索引檢查，記錄媒體類型、索引 digest，以及每個描述符的 digest、OS、architecture、variant。若只解析為單一 manifest 也要記錄。
連接請求與描述符
逐欄比較實際請求和描述符。`linux/amd64` 不符合 `linux/arm64`，arm variant 也可能關鍵；unknown 平台的證明物件不是可執行變體。無匹配時，區分發布缺漏與 context、環境或服務設定改變請求。
依責任選擇修復
有原生描述符時固定其 digest 或修正陳舊策略。自有映像缺少變體時，重建該平台並發布完整索引。確需異構架構時明確啟用模擬並測試；無支援變體時改用相容標籤。
把部署綁定到已審位元組
記錄選中的平台 manifest digest，必要時連同父索引 digest。讓 Compose、CI 或部署政策明確表達平台選擇。只改 tag 是暫時方案，因為 tag 會移動。
證明執行架構與可重複性
從乾淨快取拉取，檢查最終 digest 和架構，啟動工作負載並核對其機器架構與健康。每種支援主機都重做；digest 漂移、隱式模擬或索引變動時停止。
