Skip to content

Failed to create GBM buffer:Clash Verge Rev 窗口画不出来 ​

在 Linux 上双击 Clash Verge Rev 没反应,改从终端启动才看到一行 Failed to create GBM buffer of size xxx: Invalid argument,窗口始终没有画出来。文档站把这条报错收进了 Linux 的问答页,给的是一个环境变量。这页把「怎样在终端验证、怎样长期生效」写得最完整,同系列另外两篇会链回这里。

对上号:报错原文和你的环境 ​

文档站这一条的标题就是报错原文,其中 xxx 是具体的尺寸数字,每台机器不一样。

文档对原因只写了一句:属于已知的上游缺陷,出现场景是 NVIDIA 显卡搭配 Wayland 会话。核对时看两样:终端输出里有没有 GBM buffer 这几个词;你用的是不是 NVIDIA 显卡、桌面会话是不是 Wayland。两样都对上,就是这一条。

图形界面启动时看不到终端输出,所以第一步是打开终端,用平时的启动命令把客户端拉起来,让报错显示出来。看不到报错就去猜原因,很容易把别的问题也套到这个变量上。

文档给的规避办法 ​

文档写的是:可通过设置以下环境变量进行规避。

bash
WEBKIT_DISABLE_DMABUF_RENDERER=1

文档用的词是「规避」,意思是绕开上游问题,不是修好了上游。

第一步:用前缀方式临时试一次 ​

最省事的验证方式,是把变量赋值直接写在启动命令前面。

bash
WEBKIT_DISABLE_DMABUF_RENDERER=1 <你平时启动 Clash Verge Rev 的命令>

GNU Bash 手册对这种写法的说明是:命令前面的变量赋值,在这条命令执行期间属于它的环境。只影响这一次启动,不改任何文件。

试完按下面三种情况分:

现象说明下一步
窗口正常出现,GBM 报错消失对上了这条问题考虑长期设置
窗口还是不出现,报错换成别的遇到的是另一条按新报错的原文去文档里找条目
报错原样不变这个变量对你的环境无效带完整日志去 issue 区

上游 issue #13493 的经过 ​

条目里的上游链接是 #13493 号 issue,标题就是这句 GBM 报错,尺寸写的是 2560x1440。

报告时间是 2025-05-22,环境是 Arch Linux 加 Hyprland 的 Wayland 会话,显卡型号报告者没写。Tauri 的一位项目成员在 2025-05-23 建议设置这个变量,报告者 2025-05-24 回复确认有效,这个 issue 随后被标成 not planned 关闭。这位项目成员在评论里还提到,WebKitGTK 在 Nvidia 硬件上的问题一版比一版多。2025-06-26 另有用户说两个变量都设了仍然无效,所以它不是对每台机器都管用。

第二步:验证有效后的长期设置 ​

临时前缀有效之后,每次在终端敲一遍很麻烦。文档站没有说明应该写在哪里,下面是通用的 Linux 机制,选哪种取决于你怎么启动客户端:

  • 习惯从终端启动:在同一个终端里先执行 export WEBKIT_DISABLE_DMABUF_RENDERER=1,再启动。Bash 手册写明 export 用于把变量加入环境,关掉这个终端设置就没了。
  • 客户端由 systemd 用户实例拉起:看 systemd 手册的 environment.d(5),它规定用户级目录是 ~/.config/environment.d/,文件以 .conf 结尾,每行一个 KEY=VALUE。手册没有保证桌面启动器一定读取它,改完要注销重登,再核对报错是否还在。
  • 改 .desktop 启动器:Desktop Entry 规范对 Exec 键只要求一条命令行,没有讲怎样在里面设置环境变量,改之前先查清你的桌面环境支持什么写法。

一次只加一个变量。几个变量叠在一起,出了效果分不清是哪个起的作用,以后升级再出问题时也不好回退。

变量设对了还是启动不了 ​

先到 Tauri 的 issue 列表搜 GBM buffer,看别人有没有贴过同样的显卡组合。没有的话再开新帖,附上终端完整输出,以及显卡、驱动、发行版、桌面环境和客户端各自的版本。临时想换条路用,可以翻 Clash 客户端下载现状 看别的客户端选项。客户端起得来之后,订阅有没有问题再另行检查,思路在 订阅侧自查清单。

常见问题 ​

GBM buffer 报错算不算客户端自己的 bug? ​

文档站认定它是已知的上游缺陷,出现在 NVIDIA 显卡配 Wayland 会话的机器上,上游链接是 #13493 号 issue。受影响的客户端版本和驱动版本,文档都没列。

文档给的环境变量值是多少? ​

这一条的变量值取 1,即 WEBKIT_DISABLE_DMABUF_RENDERER=1,别和其他条目的值混了。

怎么只试一次、不改任何配置? ​

在终端里把变量赋值写在启动命令前面,再接上你平时的启动命令。按 Bash 手册的说明,这样的赋值只在这条命令执行期间生效,关掉就恢复原样。

我不是 NVIDIA 显卡也报这个错怎么办? ​

文档只写了可能在 NVIDIA 加 Wayland 环境出现,没有说其他环境是否适用。可以照样用终端临时试一次,有效再考虑长期设置,无效就到 Tauri 的 issue 列表里反馈。

环境变量应该写在哪个文件里? ​

文档站没有说明写入位置。先用终端前缀验证有效,再按自己的启动方式决定;用 systemd 用户实例启动的程序可以参考 environment.d 的写法。

机场推荐排行榜 2026 · 便宜机场推荐 · 专线机场推荐 · 稳定机场推荐
本站内容仅供学习交流,请遵守当地法律法规。本站与部分服务商存在联盟推广关系,标注「站长主推」的栏目为商业推荐位;本站不做速度实测,收录名单中没有采集记录的字段显示「未采集」,详见「关于本站」的利益披露。发现内容有误欢迎通过「联系与反馈」指出。