Virtubox Ubuntu 21.04环境下MySQL Workbench无法显示二级侧边栏

问题复现场景 #

• 系统环境：搭载Virtubox的Ubuntu 21.04
• 软件版本：mysql-workbench-community_8.0.26-1ubuntu21.04_amd64.deb
• 故障表现：点击右上角二级侧边栏图标后界面仅闪烁一次，通过「View -> Panels -> show secondary sidebar」菜单操作仍无法正常显示SQL Additions面板
  

修复步骤 #

方案1：GTK渲染兼容修复（成功率最高） #

该问题核心为MySQL Workbench 8.0.26与Ubuntu 21.04默认GTK3客户端装饰特性不兼容，可通过修改启动参数临时测试：

1. 关闭所有已打开的MySQL Workbench进程
2. 终端执行启动命令：

GTK_CSD=0 mysql-workbench

3. 启动后尝试呼出二级侧边栏，若可正常显示，执行以下操作永久修改快捷方式：
   • 执行命令编辑桌面快捷方式：sudo nano /usr/share/applications/mysql-workbench.desktop
   • 找到Exec开头的配置行，修改为：Exec=GTK_CSD=0 /usr/bin/mysql-workbench %f
   • 保存退出后，重新从启动栏打开软件即可生效

方案2：清除本地缓存配置 #

若方案1无效，可尝试删除损坏的本地缓存配置（操作前请先导出你的数据库连接配置避免丢失）：

rm -rf ~/.mysql/workbench/

重启软件后即可重新生成配置文件，再尝试呼出二级侧边栏。

方案3：更换安装渠道 #

若以上两种方案均无效，大概率是单独下载的deb包依赖适配异常，可卸载当前版本后通过官方apt仓库重新安装：

1. 卸载当前版本：sudo apt remove -y mysql-workbench-community
2. 导入MySQL官方apt源后执行安装：sudo apt update && sudo apt install -y mysql-workbench-community

内容的提问来源于stack exchange，提问作者Homer