疑難排解

重試前請閱讀錯誤與操作報告，確認已完成的步驟。發生錯誤不代表先前變更已回復。

連線與權限錯誤

檢查管理員 kubeconfig、所選情境、API 伺服器位址及叢集網路連線。CLI 中明確設定 --kubeconfig 與 --context，或在 TUI 重新選擇情境。

遇到 Forbidden 錯誤時，請檢查管理員權限。建立繫結可能需要額外的 RBAC 授權；試執行也需要相關權限。啟用產品授權無法解決叢集權限不足。

kticket 不覆寫既有檔案或符號連結。CLI 使用 --output 指定新檔名。TUI 請選擇可寫入的既有目錄，並在確認畫面檢查路徑。收件者 kubeconfig 應與管理員設定分開。

情況	下一步
建立資源後簽發失敗	閱讀報告，並用 `kticket list` 與 `kticket access list` 檢查殘留帳戶及授權。
權杖已簽發，但後續步驟失敗	先檢查報告。TUI 標示為「需要處理」的帳戶不會自動重試。
批次作業中途停止	同一工作階段中按 r，重新檢查失敗或待處理帳戶。成功帳戶會略過。結束後無法還原批次狀態。
授權變更部分失敗	重新載入帳戶並產生新計畫。已完成的變更不會回復。
憑證歷程無法讀取或已滿	保存錯誤，請叢集管理員在重新簽發前檢查帳戶記錄。刪除記錄不會撤銷權杖。

簽發失敗後，kticket 會嘗試刪除未完成的輸出檔，並回報清理錯誤。已對帳戶、命名空間及授權完成的變更可能保留。即使輸出檔已刪除，權杖仍可能已簽發。若需使全部憑證失效，請撤銷帳戶。

移除一項授權不會刪除帳戶，也不會移除外部繫結提供的權限。使用 kticket access check 檢查特定操作是否仍被允許。

帳戶撤銷影響全部憑證，但不終止已建立的連線。若帳戶已刪除但繫結清理失敗，請以管理員憑證檢查殘留的受管理繫結，清理完成後再重新建立同名帳戶。不要刪除共用角色或其他帳戶的繫結。

執行 kticket license status 查看狀態、目前機器 ID 及授權檔位置。

情況	下一步
未收到授權郵件	檢查結帳郵件地址及垃圾郵件匣，再提供訂單資訊聯絡支援。
找不到授權	以執行 kticket 的系統使用者安裝附件。確認 `KTICKET_LICENSE_FILE` 與安裝時設定相同。
安裝拒絕覆寫檔案	若確定要取代，請使用 `kticket license install --force FILE`。
`wrong machine`	比較目前機器 ID 與購買時提交的值。硬體已變更時請聯絡支援。
檔案無效或損毀	還原原始郵件中未修改的附件。仍失敗時請聯絡支援。
無法辨識簽署金鑰	更新 kticket 後重試。若已是最新版，請聯絡支援。

完整安裝步驟請參閱授權購買與啟用。

透過支援頁面提供 kticket 版本、作業系統、指令及錯誤訊息。付款或授權問題請附訂單編號及機器 ID。公開或透過郵件分享診斷資訊前，請移除權杖、管理員 kubeconfig 及其他憑證。