EGL_BAD_PARAMETER：CC Switch Linux 白屏
Quick fix
在受影响的 Linux AppImage 环境中，先预加载宿主机的 libwayland-client；若仍白屏，可改用使用系统组件的 .deb 包。
Symptom
Section titled “Symptom”Could not create default EGL display: EGL_BAD_PARAMETER. Aborting...多个 Linux 白屏报告都出现了 `EGL_BAD_PARAMETER`，但触发环境并不完全一致。已关闭的 #7335 通过对照实验确认，AppImage 内置的旧版 `libwayland-client.so.0` 被优先加载后，会与宿主 Mesa/EGL 冲突，导致 `WebKitWebProcess` 在 EGL 初始化时中止；预加载系统库或移除 AppImage 内该库后可恢复渲染。#5609 的 Wayland 报告中，用户也反馈预加载宿主 `libwayland-client` 后可启动。
另一些报告显示相同白屏还可能伴随不同的 AppImage 兼容性问题：#5912 指出宿主 GVFS 与包内旧版 GLib/GIO 的 ABI 不匹配，#7709 指出 VMware 虚拟 GPU 下包内 WebKitGTK 无法创建 EGL display。#5659 是 v3.18.0 在 NVIDIA/X11 上的白屏变体，明确没有 `EGL_BAD_PARAMETER`，且所列环境变量均未解决；因此不能保证本页的预加载方案适用于所有白屏情况。
在终端中用宿主系统的 `libwayland-client.so.0` 预加载方式启动官方 AppImage。
如果问题仍然存在，尝试使用 .deb 包；在 Ubuntu 26.04 的报告中，同机 .deb 可正常工作，而 AppImage 白屏。
Affected Versions
Section titled “Affected Versions”Source Issues
Section titled “Source Issues”本页汇总自 8 个真实 issue
- #487在openSUSE系统上启动显示白屏
- #2943[Bug] Linux on X11/i3 shows blank window and aborts with EGL_BAD_PARAMETER on Intel UHD 620
- #2950WSL2更新后出现白屏
- #5609[Bug] Linux Wayland 环境下启动崩溃抛出 EGL_BAD_PARAMETER 错误
- #5659[Bug] v3.18.0 Linux X11 白屏 — NVIDIA + WebKitGTK 2.50.4，v3.17.0 正常
- #5912AppImage blank window on Ubuntu 26.04 (GLib/GIO ABI mismatch with host GVFS)
- #7335Linux AppImage 主窗口全白：包内自带旧版 libwayland-client 导致 WebKitWebProcess EGL 初始化失败（EGL_BAD_PARAMETER）
- #7709[Bug][Linux/Arch+VMware] AppImage shows gray window; WebKitWebProcess aborts (EGL_BAD_PARAMETER)
- 各位大佬都解决了吗，我另外一台电脑装了Linux也是同样的情况，直接安装AUR里面的也不行，ccs的UI完全就是卡死的状态
- 有用户建议在启动命令前加入 `LD_PRELOAD=/usr/lib/libwayland-client.so`；另有用户补充可尝试 `LD_PRELOAD=/usr/lib/libwayland-client.so.0 /usr/bin/cc-switch`，但原提问者反馈前一种方式在其机器上无效。
- AUR里面的也不行，ccs的UI完全就是卡死的状态
- 该簇中 AUR 包并非对所有环境都有效。#7709 认为 Arch 的 `cc-switch-bin` 使用发行版 `webkit2gtk-4.1` 可能解决其虚拟 GPU 场景；但 #5609 的讨论中也有人反馈 AUR 安装后仍卡死。
这是一个非官方社区 wiki，与 cc-switch 作者及项目本身无隶属关系。内容整理自项目公开的 GitHub issues。本站不分发任何软件。