修復 Linux Wayland 下 Element Desktop 崩潰的問題

成功的解決方案是什麼樣子的

Element Desktop 應該在觸發崩潰的操作（例如登入、加入通話、共享螢幕或讓應用程式在後台空閒）期間保持開啟狀態。一次成功啟動不足以確認問題已修復。請多次測試相同的觸發操作，並檢查應用在電腦睡眠和喚醒後是否仍穩定運作。

Wayland 並非唯一可能的原因。 Element Desktop 是一個 Electron 應用，崩潰可能與 Wayland 合成器、Xwayland、圖形驅動程式、最近的應用程式更新或特定軟體包的建構有關。以下步驟使用小型、可逆的測試來縮小問題範圍。這些步驟並不能證明 Linux 上的所有 Element 崩潰都是 Wayland 缺陷所造成的。

2026年10月6日已核實。 Electron 38 更改了預設設置，現在當會話報告為 Wayland 時，Electron 應用程式會在 Wayland 上原生啟動XDG_SESSION_TYPE=wayland。 Electron 文件--ozone-platform=x11中提供了使用 Xwayland 的另一種方法。此變更僅在 Element 建置中包含此變更的 Electron 版本時生效；Element 版本和套件來源決定了這一點。請參閱Electron 38 發行說明和Electron 的重大變更說明。

1. 確認桌面會話是 Wayland 會話。

打開終端機並運作：

echo $XDG_SESSION_TYPE

如果輸出為“” wayland，則繼續。如果輸出為“”，則表示x11目前登入已在使用 X11，因此 Wayland 特定的啟動測試無法解釋崩潰原因。您也可以使用以下命令查看桌面和會話詳細資訊：

echo "$XDG_CURRENT_DESKTOP"
loginctl show-session "$XDG_SESSION_ID" -p Type

Linux 終端機顯示指令 echo $XDG_SESSION_TYPE 和輸出 wayland。 — Wayland 會話檢查的終端範例視圖。您的終端主題和輸出可能有所不同。

請記錄桌面環境、圖形硬體以及 Element 的安裝方式。這些細節有助於區分普遍性崩潰和僅限於某個合成器、GPU 驅動程式或軟體包版本的問題。

2. 比較原生 Wayland 和 Xwayland

首先關閉所有已開啟的 Element 視窗。對於提供該命令的 Debian 或 Ubuntu 軟體包element-desktop，請從終端機執行以下命令：

element-desktop --ozone-platform=x11

保持終端打開，以便顯示所有啟動錯誤。正常使用 Element，並重複通常導致崩潰的操作。如果 Xwayland 運作穩定，而正常啟動卻崩潰，這可以作為 Wayland 路徑或整合問題的有力證據。這只是一個診斷結果，並不能證明具體是哪個缺陷。

終端機顯示 Element Desktop 已使用 --ozone-platform=x11 選項啟動。 — Xwayland 測試命令的終端機範例。該命令是否有效取決於軟體包及其可執行檔名。

若要恢復正常行為，請關閉 Element 並從常規應用程式啟動器啟動它。此標誌僅適用於使用該指令啟動的進程。 Electron 在其BrowserWindow 平台說明中記錄了 Xwayland 開關。

如果您的安裝使用的是 Flatpak 或其他社區軟體包，請不要假設上述命令針對的是其沙盒應用程式。請檢查軟體包的啟動器命令，或使用其特定的方法來傳遞應用程式參數。 Element 的下載頁面列出了其 Debian/Ubuntu 軟體包的安裝說明，並將 Flatpak 和其他幾個 Linux 軟體包標識為社群維護：Element Desktop 下載。

3. 從同一包來源更新元素

如果切換到 Xwayland 後問題已解決，或者當機是在更新後發生的，請安裝您目前使用的來源提供的最新穩定版本。從相同來源更新可以避免意外執行兩個具有不同啟動器、配置路徑或捆綁的 Electron 版本的版本。

對於從 Element 官方倉庫安裝的 Debian 或 Ubuntu 系統，請刷新軟體包索引並升級 Element：

sudo apt update
sudo apt install --only-upgrade element-desktop

對於 Flatpak，請透過軟體中心更新或運行命令flatpak update。對於 Arch、Fedora、openSUSE 或其他發行版，請使用您最初選擇的軟體套件管理器和軟體倉庫。請勿安裝無關的「每日建置版」作為崩潰修復程式；Element 將其每日建置版標記為不穩定的測試版本。

Linux 軟體更新程式會顯示 Element Desktop 條目，其中包含一個「更新」按鈕。 — 此範例展示了應用程式更新可能出現的位置。顯示的版本和更新狀態僅為範例，並非您實際安裝情況的報告。

更新完成後，請完全退出 Element 並重新啟動。在 Element 中，如果應用程式保持開啟狀態足夠長的時間，請開啟「設定」→「幫助和關於」以查看用戶端版本。這在比較報告或聯繫支援人員時非常有用。除非發行版維護人員或 Element 支援人員特別建議，否則請避免降級到舊版本；舊版本可能缺少修復程式和安全性更新。

4. 測試圖形加速並收集崩潰證據

如果應用程式在正常情況下以及在 Xwayland 下仍然崩潰，請嘗試停用 Chromium 的 GPU 加速功能運行一次：

element-desktop --disable-gpu

這是一個臨時故障排除測試，並非建議的永久設定。如果僅在啟用此標誌後崩潰消失，則結果指向圖形或驅動程式互動問題；但無法確定是驅動程式、合成器、Electron 還是應用程式程式碼本身存在問題。影片播放和其他圖形密集功能也可能出現異常。關閉該進程並重新啟動（不啟用此標誌）即可撤銷測試。

如果在通話或螢幕分享期間發生崩潰，請分別測試這些操作。 Element 的一個歷史問題描述了舊版 Element 在 Wayland 下進行螢幕分享時發生的崩潰；但這並不意味著當前版本也存在同樣的缺陷。此專案倉庫已歸檔，因此請使用當前的軟體包和支援管道提交新的報告：歷史 Wayland 螢幕共享報告。

捕獲崩潰發生時間附近的日誌。在使用 systemd 日誌的系統上，請嘗試：

journalctl --user -b --since "10 minutes ago" | grep -iE 'element|wayland|gpu'

如果系統記錄了核心轉儲文件，則此處可能會列出該文件：

coredumpctl list element-desktop

終端機顯示 journalctl 指令，並篩選出 Element、Wayland 和 GPU 訊息。 — 日誌搜尋的終端範例視圖。範例行並非真實的診斷輸出；請檢查您自己系統的條目和時間戳記。

日誌可能包含使用者名稱、檔案路徑、房間或伺服器詳細資訊或其他私人資訊。請在公開發布前仔細檢查並刪除敏感資訊。如果日誌搜尋未傳回任何結果，並不代表沒有發生崩潰；不同的軟體包格式和系統記錄日誌的方式可能有所不同。發行版的崩潰報告程式或系統日誌可能更有用。

保護您的本機會話數據

請勿刪除 `<path> ~/.config/Element`、~/.config/Riot`<path>` 或 Flatpak 資料目錄。這些位置可能包含本機應用程式狀態，刪除它們可能會導致您登出登入或影響本機儲存的加密金鑰和設定。重置是最後的診斷手段，並非常規的 Wayland 修復方法。在考慮重置之前，請確認您可以重新登錄，並且您的加密金鑰或還原金鑰已備份。建議優先選擇不會影響設定檔的操作步驟。

如果 Element 可以開啟但執行異常，請先使用套用自身的設定和支援指南，然後再變更其設定檔。有關帳戶設定和版本信息，請參閱最新的Element 用戶端設定文件。

如何判斷修復是否有效

使用先前觸發故障的相同步驟：啟動 Element，登錄，將其置於後台運行，加入相應的通話，並測試螢幕共享是否是問題所在。在正常重啟應用後重複上述步驟。實際結果是 Element 保持回應，並且在這些檢查過程中不會出現新的崩潰或核心轉儲。

僅穩定版本--ozone-platform=x11：如果需要，請將其作為臨時解決方法，並透過目前支援管道報告 Element 版本、軟體包來源、Linux 發行版、桌面環境、GPU 和重現步驟。
僅在以下情況下穩定運行--disable-gpu：請調查圖形驅動程式和合成器更新，並將測試結果包含在支援報告中。啟用此標誌後，圖形效能可能會有所妥協。
兩次測試均出現崩潰：請透過現有軟體套件來源進行更新，擷取日誌，並檢查相同帳戶在 Element Web 中是否正常運作。如果只有桌面版崩潰，請在支援請求中包含日誌和確切的觸發原因；如果兩者都崩潰，請同時調查帳戶、伺服器或網路方面的原因。

沒有任何單一指令能夠保證修復所有 Linux Wayland 崩潰問題。有效的結果是能夠復現穩定性改進，並提供足夠的證據來確定需要關注的層。