科技 · 實用指南
Jellyfin升級後播放清單不見了？還原前先核對顯示與項目
清單入口消失、清單變空與媒體路徑無法讀取，需要不同處理。先保全證據，再選擇相應的還原方式。
播放清單從某個Jellyfin畫面消失，不代表內容已經刪除。先以同一伺服器及帳號，比較Jellyfin網頁版與有問題的用戶端，再判斷是清單完全不顯示、清單存在但為空，還是有項目卻無法播放。
本文提供證據記錄與還原分流流程，不提供資料庫修復腳本，適用於升級或重新啟動後清單缺失的情況。歷史10.11版報告不能證明目前安裝仍有相同錯誤；Jellyfin 12也已更改清單項目的儲存方式。
1. 嘗試修復前保留現況
記錄變更內容、最後正常時間與首次失敗時間，妥善保存啟動、遷移、掃描和清理記錄。資料庫遷移仍在進行時，應觀察進度；Jellyfin提醒不要在遷移中停止伺服器，也不要為了測試症狀而反覆重新啟動。
遷移完成後，依官方備份流程操作。手動複製前必須停止伺服器，並複製實際資料及設定目錄。將目前狀態副本與未動過的升級前備份分開，標註各自對應版本。故障後建立的備份可能只保留了受損狀態。
2. 確認是否只是顯示問題
使用乾淨的網頁工作階段，以受影響帳號登入同一伺服器，比較網頁版與第三方用戶端的清單，檢查媒體庫篩選和所選伺服器。每份受影響清單記錄一列：名稱、擁有者或分享狀態、是否可見、顯示項目數及能否開啟項目。
若網頁版具備預期項目，而其他用戶端沒有，先調查該用戶端。Feishin維護者曾建議比較清單回應與Jellyfin網頁介面，但本人未能重現問題。管理員可在本機查看回應；對外求助時須移除權杖、Cookie及私人媒體路徑。
3. 清理前先確認儲存存取
若項目存在但無法播放，確認Jellyfin能存取其指向的確切媒體。容器環境應記錄目前掛載的主機來源與容器目標路徑；主機可見的檔案，不一定存在於容器所用位置。Jellyfin遷移文件要求，將現有安裝移入Docker時維持路徑相符。
Jellyfin工作文件警告，媒體無法存取時，合集與清單清理工作可能造成清單遺失，而且通常在啟動時執行。主動重新啟動或清理前，先恢復可靠存取並檢查工作觸發條件。停用一項觸發器不會找回遺失項目，也不保證解決所有掃描問題。
4. 盤點確實存續的內容
檢查新舊狀態的副本，而非直接編輯執行中的資料庫。每份可恢復清單應記錄來源快照、預期數量及有順序的媒體參照；重複出現的媒體也要保留各自位置。若只剩名稱或檔案無法解讀，將成員狀態標為未知，不要假設完整。
不要只因檔名相同就套用舊SQL或XML作法。Jellyfin 12將每個清單項目存成獨立資料庫列，並允許重複曲目。舊LinkedChildren欄位的解釋不能通用於目前儲存。磁碟上的XML是有用證據，但不能證明現行伺服器辨識該清單或擁有者。
5. 選擇範圍明確的還原路徑
只有用戶端不一致，就調查用戶端；路徑無法讀取，就修復儲存。已確認項目遺失且有良好備份時，可在獨立工作副本上，以相符應用版本測試官方還原流程。應隔離正式資料目錄，並避免工具寫入原始媒體。不要讓舊版伺服器開啟已遷移的正式資料。
只有部分證據時，可透過受支援操作，從已核實媒體重建一份新清單，並保留原證據。不要將擁有者ID改為全零、合併資料庫或批次替換路徑當作通用修復。無法確認所有權、順序或媒體身分的項目應保留未解狀態，尋求相應版本協助。
6. 逐份清單驗收
對照記錄表檢查項目數、每項順序、重複位置和代表性播放，並確認目標使用者的可見性與編輯權限。只有名稱或數量相符，仍可能隱藏錯誤曲目、順序變動或權限問題。新舊項目ID必須核對，不能直接當作相同媒體的證明。
儲存穩定可用後，再以受控重新啟動及適用版本要求的掃描確認結果，通過前保留還原副本。本文為依來源核驗的決策流程，未實際執行Jellyfin遷移或還原，也不能重建所有存續副本都已失去的項目。
