VNC Viewer 黑屏无画面——远程桌面连接成功但看不到任何东西
几种不同的黑屏表现
黑屏不是一个问题，而是几类问题的共同表现：
| 表现 | 最可能原因 |
|---|---|
| 全黑屏 + 有鼠标光标 | headless 设备未开虚拟模式 |
| 全黑屏 + 无鼠标光标 | 远程设备桌面环境未正常启动 |
| 屏幕闪烁 / 偶尔黑屏 | 显卡驱动冲突（Linux Wayland 最常见） |
| 只看到桌面背景、图标全没 | 远程设备资源管理器（Windows explorer.exe）挂了 |
原因一：Headless 设备没开虚拟模式
最常见场景——树莓派或无物理显示器的 Linux 服务器。VNC Server 启动时检测不到有显示器插上，可能默认用了很低的虚拟分辨率，或者根本没渲染桌面。
排查：
- 远程设备上打开 RealVNC Server 主界面 → 找 Virtual Display 或 Mode 标签
- 选 Virtual 模式 → 设置虚拟分辨率（1280×720 起步）
- Apply → VNC Viewer 端断开重连
Raspberry Pi headless 的完整配置见 Raspberry Pi headless 无屏控制。
原因二：Wayland 兼容性问题
从 Ubuntu 22.04 开始 GNOME 默认用 Wayland 而非 Xorg。RealVNC Server 7.x 对 Wayland 的支持有已知限制——表现就是连接成功但黑屏。
排查和解决：
- 登出远程设备的桌面
- 在登录界面点齿轮图标（或 Session 选项）→ 选 "Ubuntu on Xorg"
- 重新登录 → 再用 VNC Viewer 连
这是 RealVNC 官方认可的解决方案——Wayland 的安全模型（不让 VNC 直接采集 Wayland 合成器输出）导致目前 VNC 协议无法完美对接。RealVNC Connect v8 对 Wayland 的支持有改善，但实战仍建议切换到 Xorg。
原因三：远程设备桌面环境挂了
Windows 上 explorer.exe 进程崩了、Linux 上 gnome-shell 崩了、macOS 上 Finder 崩了——都可能导致 VNC Viewer 连上后看到黑屏或只有背景。
Windows
远程设备可能只是 explorer.exe 挂了。虽然黑屏，但你仍然可以用 Ctrl+Shift+Esc 打开任务管理器，然后：
- 在任务管理器里 → File → Run new task → 输入
explorer.exe→ 回车 - 桌面应该恢复
如果任务管理器都打不开：Viewer 工具栏里点 Ctrl+Alt+Del → 选 Task Manager → 重启 explorer.exe。
Linux (GNOME)
黑屏但能移动鼠标 → GNOME Shell 可能崩了。在 Viewer 里按 Alt+F2 → 输入 r → 回车 → GNOME Shell 会重启（不会注销当前会话）。
如果 Alt+F2 没反应 → 用 Ctrl+Alt+F3 进 TTY 纯终端 → 登录 → 输入：
sudo systemctl restart gdm3 # GNOME 显示管理器
# 或
sudo systemctl restart lightdm # LightDM然后 Ctrl+Alt+F1 切回图形界面。
原因四：远程设备正在启动中
远程设备刚开机、还没进到登录界面时，VNC Server 还没启动——连接会失败。但如果远程设备已经到了登录界面但 RealVNC Server 还没完全初始化（Windows 上有时会慢几秒），VNC Viewer 连上后可能短暂黑屏。
等 30 秒再重连试试。
原因五：显卡驱动 / 合成器冲突
少数情况下（比如 Linux 用了专有的 NVIDIA 驱动 + Wayland），远程桌面的合成器输出可能被驱动拦截。解决方法：
- 切到开源驱动（nouveau）
- 或者在 RealVNC Server Options → Performance 里把 Hardware Acceleration 关掉 → 用纯软件渲染
快速排查流程
黑屏问题最快的排查顺序：
- 树莓派 / 无显示器设备 → 确认开了 Virtual Mode
- Ubuntu 22.04+ → 确认登录用的是 Xorg（不是 Wayland）
- Windows → Ctrl+Shift+Esc 任务管理器重启 explorer.exe
- 等 30 秒 → 有些启动慢的设备需要时间初始化
- 以上都不行 → 重启远程设备再试