使用 Xwayland 解決 Wayland 上的 Element Desktop 崩潰問題

如果 Element Desktop 在 Linux 或應用程式更新後開始崩潰或無法打開,請先透過 Xwayland 進行測試:關閉所有 Element 進程,然後element-desktop --ozone-platform=x11從終端啟動。 Electron 38 已將其預設設定更改為在 Wayland 會話中使用原生 Wayland,並且 Electron 文件中也提到,可以透過 Xwayland 標誌來恢復到 X11 相容模式。如果這樣可以使 Element 穩定運行,那麼在檢查是否有更新的軟體包或特定於合成器的問題時,您就擁有了一個實用的臨時解決方案。

這並不能證明 Wayland 是所有問題的根源。 Element 是一個 Electron 應用程序,但崩潰也可能是由過時的軟體包、圖形驅動程式、擴充功能或本地配置引起的。請依照以下步驟在不刪除帳戶資料的情況下隔離問題。

韋蘭的改變為何如此重要

Wayland 是許多目前 Linux 桌面系統使用的顯示協定。 Xwayland 是一個相容層,它允許傳統的 X11 應用程式在 Wayland 會話中運行。 Electron 38 將其 Ozone 平台預設為`--xwayland` auto;當XDG_SESSION_TYPE=wayland`--xwayland` 為真時,Electron 現在預設在 Wayland 上原生運行。 Electron 也移除了舊的ELECTRON_OZONE_PLATFORM_HINT環境變數 `--xwayland-app`。強制使用 Xwayland 的官方開關是 `--xwayland-app` --ozone-platform=x11。請參閱Electron 的重大變更文件。

Element Desktop 在 Electron 框架下執行 Element Web。其桌面程式碼現已移至 Element Web 程式碼庫,該專案文件中也對這款基於 Electron 封裝的桌面應用程式進行了說明。 Element 的下載頁面目前提供 Debian 和 Ubuntu 的官方 Linux 安裝路徑,以及其他發行版的社群維護軟體包連結。軟體包的行為可能因發行版和打包格式而異。

1. 確認會話並記錄失敗狀況

開啟終端機並檢查哪個顯示會話處於活動狀態:

echo "$XDG_SESSION_TYPE"
element-desktop --version

如果第一個指令輸出「」wayland,則表示目前會話為 Wayland。如果輸出「」x11,則 Electron Wayland-default 的變更不太可能是導致崩潰的原因。某些打包格式可能不支援 version 命令;如果遇到這種情況,請檢查應用程式的「關於」畫面或您的軟體包管理器。

從相同終端啟動 Element,並保持輸出可見:

element-desktop

記錄視窗關閉前列印的第一個錯誤訊息,以及您的 Linux 發行版、桌面環境、顯示卡驅動程式、Element 版本和安裝類型(例如,Element APT 軟體包、Flatpak 或社群版軟體包)。共用日誌時,請勿發佈存取權杖、訊息內容或私人帳戶資料。

2. 透過 Xwayland 測試元素

測試開始前,請完全關閉 Element 流程。檢查剩餘進程,如有必要,僅停止 Element 進程:

pgrep -a element

如果進程卡住,請從桌面系統監視器中將其關閉,或pkill element-desktop在確認列出的進程是 Element 後執行:

element-desktop --ozone-platform=x11

對於官方的 Debian/Ubuntu 軟體包,其可執行檔通常是 ` element-desktop.`。其他軟體包可能使用不同的啟動器。對於 Flatpak 軟體包,請嘗試在應用程式 ID 後面新增 `--starter` 參數:

flatpak run im.riot.Riot --ozone-platform=x11

如果您的系統上未安裝該應用程式 ID,請使用flatpak list查找 Element 應用程式 ID 並進行替換。請勿在未檢查軟體包啟動語法的情況下,隨意將該標誌添加到包裝命令中。

嘗試運行應用程式幾分鐘,並重複先前導致崩潰的操作。如果應用程式仍然保持開啟狀態,請暫時使用 Xwayland 啟動。 Electron 指出,原生 Wayland 和 Xwayland 的某些視窗行為有所不同;例如,在 Wayland 下,某些程式化的視窗大小調整和定位操作受到限制。 Electron BrowserWindow 文件描述了此限制以及 Xwayland 切換方法。

3. 僅當該變通方案有效時才將其永久保留。

對於一次性測試,使用終端命令是最安全的,因為它不會修改任何檔案。如果它能持續解決崩潰問題,您可以將該參數新增至桌面啟動器。具體方法取決於 Element 的安裝方式:

  • 無論是 APT 還是獨立軟體包:將系統啟動器複製到使用者應用程式目錄,然後編輯複製的啟動器Exec=文件,新增 `<install_name>` --ozone-platform=x11。請勿編輯 `<install_name>` 下的 vendor 檔案/usr/share/applications;軟體包更新可能會取代它。
  • Flatpak:如果可用,請使用桌面環境的應用程式編輯器;或建立一個使用者級啟動器來運作flatpak run im.riot.Riot --ozone-platform=x11。請先確認已安裝的應用程式 ID。

保留原有的啟動器指令,並在執行檔或 Flatpak 套用 ID 後新增標誌。避免進行大範圍的 shell 更改,例如匯出已過時的變數ELECTRON_OZONE_PLATFORM_HINT;Electron 38 已移除該變數。您可以稍後移除新增的參數以恢復原生 Wayland。

4. 如果 Xwayland 無法阻止碰撞

從您最初使用的軟體包來源更新 Element,然後使用常規啟動器和 Xwayland 標誌重新測試。 Element官方下載頁面列出了目前的 Linux 安裝說明。避免混用來自不同來源的軟體包,因為重複安裝會導致同一系統中存在多個啟動器和版本。

如果當機仍然存在,請停用 GPU 加速後再次啟動程序,以測試圖形路徑是否與此有關:

element-desktop --disable-gpu

這是一個診斷測試,並非建議的永久設定。如果測試後程式行為發生變化,請透過發行版支援的方法更新顯示卡驅動程序,並檢查是否存在已知的合成器或 GPU 驅動程式問題。請勿一次更改多個 Chromium 標誌;每次測試只更改一個標誌,才能確保結果有效。

您也可以檢查問題是否僅限於目前本機設定檔。請勿~/.config/Element先刪除 Flatpak 資料目錄:它們可能包含本機應用程式狀態,刪除它們可能會導致您登出或遺失未同步的資料。更安全的初步檢查方法是,如果您的建置支援 Electron 的--user-data-dir選項,則啟動一個單獨的臨時設定文件,並將其指向 `<path>` 下的新目錄/tmp。僅將其視為診斷步驟,如果您不需要測試帳戶行為,請勿登入。如果乾淨的設定檔改變了結果,請保留原始目錄並調查本機狀態,而不是將其刪除。

驗證修復是否成功

更改後,多次啟動 Element,打開先前導致崩潰的對話或視圖,並使其運行足夠長的時間以重現原始情況。確認終端不再報告相同的致命錯誤。更新後再次測試正常啟動器:如果當機僅在原生 Wayland 模式下出現,請保留文件中記錄的 Xwayland 解決方法,並將詳細資訊(包括您的版本、發行版、合成器、GPU 驅動程式、啟動命令和已脫敏的日誌)報告給 Element。

Element 的問題追蹤器中包含一份 Ubuntu 24.04 的報告,其中一位使用者描述了該應用程式在 Wayland 下無法打開,並報告了 GBM 緩衝區導出錯誤。此問題僅展示了一個已知的圖形路徑故障,並非適用於所有系統的通用診斷或已確認的修復方案。請參閱Element 專案的問題以查看該報告。如果 Xwayland 和乾淨的軟體包更新都無法解決問題,那麼提供終端輸出和系統詳細資訊比重複更改無關設定更有幫助。

留下評論

使用 Xwayland 解決 Wayland 上的 Element Desktop 崩潰問題

透過 Xwayland 測試 Element Desktop,保留本地數據,並在 Linux Wayland 導致應用程式崩潰時隔離圖形或軟體包問題。

無需 Google 服務即可取得 Element Android 通知

使用 UnifiedPush 和 ntfy 設定 Element Android,然後在警報失敗時檢查自架 Matrix 閘道和 Android 背景設定。

讓 Nextcloud 的 iPhone 照片上傳功能在背景運行

讓 Nextcloud 的 iPhone 照片上傳功能在背景運行

檢查 Nextcloud 上傳設定、iOS 權限、電池模式以及 iPhone 後台定時拍攝的限制,以恢復後台照片偵測功能。

ONLYOFFICE Desktop 中的文字更清晰:在 Linux 上調整字型提示

ONLYOFFICE Desktop 中的文字更清晰:在 Linux 上調整字型提示

比較 ONLYOFFICE 字型提示模式,檢查縮放和 Linux 字型可用性,並驗證模糊效果是否僅限於編輯器或影響整個桌面。

在 ONLYOFFICE Desktop 中將 PDF 轉換為可編輯的 DOCX。

在 ONLYOFFICE Desktop 中將 PDF 轉換為可編輯的 DOCX。

在 ONLYOFFICE Desktop Editors 中將 PDF 本地轉換為 DOCX,然後檢查佈局變更、掃描頁面和需要修正的文字。

將 ONLYOFFICE 桌面編輯器連接到您自己的雲端文件

將您的 ownCloud 帳戶新增至 ONLYOFFICE 桌面編輯器,以了解連線的功能,並在直接存取、同步和瀏覽器編輯之間進行選擇。

透過檢查伺服器 URL 修復 ONLYOFFICE 行動端逾時問題

透過檢查伺服器 URL 修復 ONLYOFFICE 行動端逾時問題

使用正確的入口網站或 WebDAV 位址,從您的手機測試 HTTPS 可存取性,並區分專用網路、TLS 和登入問題。

啟用 ONLYOFFICE 桌面插件開發和調試

啟用 ONLYOFFICE 桌面插件開發和調試

建置並測試自訂 ONLYOFFICE 桌面編輯器插件,安裝其 .plugin 存檔,並啟動開發者工具進行偵錯。

透過 LibreOffice 的巨集系統在 Calc 中運行 Python

透過 LibreOffice 的巨集系統在 Calc 中運行 Python

在 Calc 中提供 Python 函數,針對開啟的電子表格執行函數,並排查缺少的巨集或匯入問題,而無需混淆 LibreOffice 和系統 Python。

使用節密碼保護選定的作者文本

使用節密碼保護選定的作者文本

鎖定特定段落以防止常規編輯,同時保持 Writer 文件的其餘部分可用,並了解何時文件加密是更好的選擇。