Windows下WSL Docker中ROS Noetic的Qt应用（如RViz）显示故障排查

核心原因 #

Qt应用（包括RViz）依赖X11图形显示系统，Docker容器默认没有图形环境，且WSL本身需要将图形输出转发到Windows的X服务器才能显示GUI界面。

分步修复 #

1. 配置Windows端X服务器 #

• 安装VcXsrv或Xming（推荐VcXsrv，体积更小更稳定）
• 启动X服务器时，务必勾选Disable access control，其余保持默认设置。

2. 配置WSL环境变量 #

打开WSL终端，设置DISPLAY变量指向Windows的X服务器：

export DISPLAY=$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}'):0.0

为了避免每次重启WSL都重复设置，将这条命令写入~/.bashrc：

echo 'export DISPLAY=$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}'):0.0' >> ~/.bashrc
source ~/.bashrc

3. 启动Docker容器时添加X11转发参数 #

启动ROS Noetic容器时，必须挂载X11套接字并传递DISPLAY环境变量，命令示例：

docker run -it \
    --name ros-noetic-rviz \
    --env DISPLAY=$DISPLAY \
    --volume /tmp/.X11-unix:/tmp/.X11-unix \
    --privileged \
    ros:noetic

参数说明：

• --env DISPLAY=$DISPLAY：将WSL的DISPLAY变量传递给容器，指定图形输出目标
• --volume /tmp/.X11-unix:/tmp/.X11-unix：挂载X11套接字文件，让容器能连接到Windows的X服务器
• --privileged：提升容器权限，解决部分图形访问的权限限制

4. 容器内补充配置（若仍无法启动） #

进入容器后，安装图形依赖并修复X11权限：

sudo apt-get update && sudo apt-get install -y libgl1-mesa-glx libgl1-mesa-dri x11-xserver-utils
# 允许本地root用户访问X服务器
xhost +local:root

5. 测试RViz #

在容器内执行：

rosrun rviz rviz

此时RViz应该能正常启动并在Windows桌面显示图形界面。

常见排查点 #

• 确认Windows的X服务器处于运行状态，且防火墙未阻挡6000端口（X11默认端口）
• 若使用WSL1，DISPLAY变量可直接设为:0，无需读取resolv.conf
• 若使用非root用户运行容器，可临时执行sudo chmod 777 /tmp/.X11-unix/X0解决套接字权限问题（长期建议通过xhost配置用户权限）

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