如何修复Linux上从Docker启动Qt5 (QML) GUI时出现的libGL错误

你的报错核心是容器内OpenGL上下文创建失败，普通X11应用只依赖X服务的绘制能力，但Qt QML应用需要OpenGL渲染支持，你现有配置虽然打通了X11转发，但没有处理GL渲染的链路，同时缺失XDG_RUNTIME_DIR环境变量也会影响Qt运行时的路径读取。

• 首先修改docker run启动参数，补全必要的环境变量和挂载
  调整后的命令如下：

  docker run -it --rm --privileged -e DISPLAY=$DISPLAY \
  -e XDG_RUNTIME_DIR=$XDG_RUNTIME_DIR \
  -v $XDG_RUNTIME_DIR:$XDG_RUNTIME_DIR \
  -v /tmp/.X11-unix:/tmp/.X11-unix \
  -v $HOME:/myhome \
  --device /dev/dri \
  --name qt-dev myqtdocker /bin/bash
  

  新增参数专门用来打通DRI直接渲染链路，补全Qt依赖的桌面环境运行时路径。

• 容器内补全Mesa OpenGL依赖
  执行以下命令安装必要的GL驱动组件：

  apt update && apt install -y libgl1-mesa-glx libgl1-mesa-dri mesa-utils
  

  安装完成后执行glxinfo | grep "OpenGL renderer"，如果正常输出渲染器信息（比如llvmpipe或者宿主机集成显卡型号），说明GL链路已经正常。

• 修复运行时权限与Qt配置
  如果你使用root用户运行容器内应用，先执行以下命令修复临时目录权限：

  mkdir -p /tmp/runtime-root && chmod 0700 /tmp/runtime-root
  

  如果仍有GL报错，可根据场景选择以下任意一个环境变量配置：

  • 强制Qt使用EGL后端：export QT_XCB_GL_INTEGRATION=xcb_egl
  • 强制QML使用软件渲染（无硬件依赖，兼容性最高）：export QT_QUICK_BACKEND=software
    配置完成后再启动Qt应用即可正常运行。

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