Navicat在Wayland下启动失败或界面错位，根本原因是Java Swing/ATW对Wayland原生支持不完整；最有效解法是强制回退X11：设置GDK_BACKEND=x11、LANG=en_US.UTF-8，并添加-Dsun.java2d.uiScale=1.0等JVM参数，且须写入.desktop文件或启动脚本中生效。
Navicat 在 Wayland 下启动失败或界面错位
linux 桌面（尤其是 ubuntu 22.04+、fedora 38+）默认启用 wayland 后，navicat（基于 java swing）常出现黑屏、窗口不响应、菜单无法弹出、拖拽卡死等现象。这不是 navicat 崩溃，而是它无法正确协商 wayland 合成器的缓冲区和输入事件——java 17+ 对 wayland 的原生支持仍不完整。
最直接有效的做法是绕过 Wayland，强制回退到 X11 渲染链：
- 临时运行：
QT_QPA_PLATFORM=xcb GDK_BACKEND=x11 LANG=en_US.UTF-8 navicat - 若提示
Cannot connect to X server，说明未启动 X server：先在终端运行Xvfb :99 -screen 0 1024x768x24 &，再设DISPLAY=:99 - 桌面快捷方式（
.desktop文件）中，在Exec=行开头插入完整环境变量，例如：Exec=env QT_QPA_PLATFORM=xcb GDK_BACKEND=x11 LANG=en_US.UTF-8 /opt/navicat/start_navicat
为什么不能只设 QT_QPA_PLATFORM=wayland？
因为 Navicat 不是 Qt 程序，它是 Java 应用，依赖的是 Swing + AWT，底层调用的是 GTK 或 X11 的绘图后端。设置 QT_QPA_PLATFORM 对它完全无效——这个变量只影响 Qt 应用。强行设它不仅没用，还可能干扰系统其他 Qt 程序。
真正起作用的是：
-
GDK_BACKEND=x11：强制 GTK（Navicat 启动器和部分对话框依赖 GTK）走 X11 路径 -
LANG=en_US.UTF-8：避免因 locale 非 UTF-8 导致 Swing 字体 fallback 失败（见下一条） - 不推荐设
SWT_GTK3=0或swt.autoScale=none：这些是 Eclipse/旧 SWT 应用的参数，Navicat 不使用 SWT
字体正常但界面元素错位或缩放异常
Wayland 下高 DPI 屏幕常见此问题，表现为按钮太小、文字糊、窗口边框消失。这不是字体缺失，而是 Java 对 Wayland 的 scale factor 解析错误。
解决方法是禁用自动缩放，并显式指定缩放值：
- 启动命令末尾加：
-Dsun.java2d.xrender=false -Dsun.java2d.uiScale=1.0 - 完整示例：
GDK_BACKEND=x11 LANG=en_US.UTF-8 java -Dsun.java2d.xrender=false -Dsun.java2d.uiScale=1.0 -jar /opt/navicat/lib/jre/lib/jfxrt.jar（路径以实际安装为准） - 注意：
-Dsun.java2d.uiScale必须是数字（如1.0、1.25），不能是auto或空值
关键点：Wayland 兼容性与字体/LANG 是两层独立问题
很多人把界面乱码（方块/问号）和界面错位/黑屏混为一谈。前者是 LANG + 中文字体缺失；后者是显示协议栈（Wayland vs X11）不匹配。即使你已装好 fonts-wqy-microhei 并设了 LANG=zh_CN.UTF-8，只要 Navicat 还在 Wayland 下跑，就仍可能黑屏或无响应。
真正容易被忽略的是：图形界面启动 Navicat 时，不会读 ~/.bashrc，必须把 GDK_BACKEND=x11 和 LANG 写进 .desktop 文件或封装脚本里——否则每次双击图标都回到 Wayland。
