使用 Xwayland 解決 Wayland 上的 Element Desktop 崩潰問題
透過 Xwayland 測試 Element Desktop,保留本地數據,並在 Linux Wayland 導致應用程式崩潰時隔離圖形或軟體包問題。
如果 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 安裝路徑,以及其他發行版的社群維護軟體包連結。軟體包的行為可能因發行版和打包格式而異。
開啟終端機並檢查哪個顯示會話處於活動狀態:
echo "$XDG_SESSION_TYPE"
element-desktop --version
如果第一個指令輸出「」wayland,則表示目前會話為 Wayland。如果輸出「」x11,則 Electron Wayland-default 的變更不太可能是導致崩潰的原因。某些打包格式可能不支援 version 命令;如果遇到這種情況,請檢查應用程式的「關於」畫面或您的軟體包管理器。
從相同終端啟動 Element,並保持輸出可見:
element-desktop
記錄視窗關閉前列印的第一個錯誤訊息,以及您的 Linux 發行版、桌面環境、顯示卡驅動程式、Element 版本和安裝類型(例如,Element APT 軟體包、Flatpak 或社群版軟體包)。共用日誌時,請勿發佈存取權杖、訊息內容或私人帳戶資料。
測試開始前,請完全關閉 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 切換方法。
對於一次性測試,使用終端命令是最安全的,因為它不會修改任何檔案。如果它能持續解決崩潰問題,您可以將該參數新增至桌面啟動器。具體方法取決於 Element 的安裝方式:
Exec=文件,新增 `<install_name>` --ozone-platform=x11。請勿編輯 `<install_name>` 下的 vendor 檔案/usr/share/applications;軟體包更新可能會取代它。flatpak run im.riot.Riot --ozone-platform=x11。請先確認已安裝的應用程式 ID。保留原有的啟動器指令,並在執行檔或 Flatpak 套用 ID 後新增標誌。避免進行大範圍的 shell 更改,例如匯出已過時的變數ELECTRON_OZONE_PLATFORM_HINT;Electron 38 已移除該變數。您可以稍後移除新增的參數以恢復原生 Wayland。
從您最初使用的軟體包來源更新 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 測試 Element Desktop,保留本地數據,並在 Linux Wayland 導致應用程式崩潰時隔離圖形或軟體包問題。
使用 UnifiedPush 和 ntfy 設定 Element Android,然後在警報失敗時檢查自架 Matrix 閘道和 Android 背景設定。
檢查 Nextcloud 上傳設定、iOS 權限、電池模式以及 iPhone 後台定時拍攝的限制,以恢復後台照片偵測功能。
比較 ONLYOFFICE 字型提示模式,檢查縮放和 Linux 字型可用性,並驗證模糊效果是否僅限於編輯器或影響整個桌面。
在 ONLYOFFICE Desktop Editors 中將 PDF 本地轉換為 DOCX,然後檢查佈局變更、掃描頁面和需要修正的文字。
將您的 ownCloud 帳戶新增至 ONLYOFFICE 桌面編輯器,以了解連線的功能,並在直接存取、同步和瀏覽器編輯之間進行選擇。
使用正確的入口網站或 WebDAV 位址,從您的手機測試 HTTPS 可存取性,並區分專用網路、TLS 和登入問題。
建置並測試自訂 ONLYOFFICE 桌面編輯器插件,安裝其 .plugin 存檔,並啟動開發者工具進行偵錯。
在 Calc 中提供 Python 函數,針對開啟的電子表格執行函數,並排查缺少的巨集或匯入問題,而無需混淆 LibreOffice 和系統 Python。
鎖定特定段落以防止常規編輯,同時保持 Writer 文件的其餘部分可用,並了解何時文件加密是更好的選擇。