树莓派 4 VNC 白屏解决方案

2026-02-17

在使用 Raspberry Pi 4B (4GB, Rev 1.5) 搭载 Raspberry Pi OS (64-bit) 时，初次配置 SSH 并开启 VNC Server 后，使用 RealVNC Viewer 连接可能会遇到白屏问题（仅能显示右键菜单）。这通常是因为系统默认使用的 Wayland 显示服务器与 RealVNC 不兼容导致的。

1. 问题分析

排除了分辨率设置和驱动问题后，核心原因在于 Raspberry Pi OS在这类新版本中默认启用了 Wayland，而 RealVNC 目前对其支持尚不完美。

虽然网上的部分教程建议修改 /etc/gdm3/daemon.conf 中的 WaylandEnable=false，但该配置文件可能不存在。更稳妥且官方推荐的方法是通过 raspi-config 工具切换回 X11 显示服务。

2. 解决方案

我们将通过命令行工具 raspi-config 将显示后端从 Wayland 切换回 X11。

操作流程

  graph TD
    Start[SSH 连接树莓派] --> Cmd[输入 sudo raspi-config]
    Cmd --> Opt1[选择 6 Advanced Options]
    Opt1 --> Opt2[选择 A6 Wayland]
    Opt2 --> Opt3[选择 W1 X11]
    Opt3 --> Save[保存并退出]
    Save --> Reboot[重启树莓派]
    Reboot --> Success[VNC 正常连接]

详细步骤

进入配置工具：在 SSH 终端中输入以下命令：
```
sudo raspi-config
```
定位设置项：使用键盘方向键选择 6 Advanced Options (高级选项)，按回车。
选择显示服务：选择 A6 Wayland，按回车。
切换至 X11：在弹出的菜单中选择 W1 X11 (Openbox window manager with X11 backend)，按回车确认。
重启生效：按 Esc 或 Tab 键选中 <Finish> 退出工具，系统会询问是否重启，选择 <Yes> 进行重启。

重启完成后，再次使用 RealVNC Viewer 连接，白屏问题即应解决，你将能看到正常的桌面环境。