Ubuntu24.04 Docker环境下Qt6与OpenGL渲染异常求助

问题分析 #

你遇到的failed to create drawable错误、部分Qt6 OpenGL示例黑屏/无法运行的问题，核心原因集中在三个方面：

• 部分Qt6 OpenGL示例依赖GLX（桌面OpenGL）后端，但Ubuntu 24.04默认可能启用EGL后端，导致兼容性问题
• XDG_RUNTIME_DIR未正确配置，引发Qt运行时环境异常警告
• 缺少Qt6 OpenGL及X11平台的关键依赖库

解决方案 #

1. 更新Dockerfile，补充依赖与环境配置

替换原Dockerfile为以下内容，解决依赖缺失和环境参数问题：

# Latest LTS Ubuntu
ARG BASE_IMAGE=ubuntu:24.04
FROM $BASE_IMAGE

# 明确指定Qt使用X11(xcb)平台插件
ENV QT_QPA_PLATFORM=xcb
# 强制Qt使用桌面OpenGL(GLX)后端，适配多数示例需求
ENV QT_OPENGL=desktop
# 配置XDG_RUNTIME_DIR并创建权限合规的目录
ENV XDG_RUNTIME_DIR=/tmp/runtime-user
RUN mkdir -p $XDG_RUNTIME_DIR && chmod 0700 $XDG_RUNTIME_DIR

WORKDIR /home/ubuntu

# 安装基础Qt6包+OpenGL依赖+X11平台补充库
RUN --mount=type=cache,target=/var/cache/apt,sharing=locked \
    --mount=type=cache,target=/var/lib/apt,sharing=locked \
    apt update \
    && apt install -y --no-install-recommends \
    qt6-base-dev \
    qt6-base-examples \
    qt6-opengl-dev \
    libgl1-mesa-glx \
    libegl1-mesa \
    mesa-utils \
    libxcb-xinerama0 \
    libxcb-cursor0 \
    && rm -rf /var/lib/apt/lists/*

2. 调整Docker运行命令，解决X11权限问题

使用以下命令启动容器，确保容器内用户与主机用户ID一致，避免X11服务器拒绝连接：

docker build -t ubuntu24-qt6 .
docker run -it --rm \
    -e DISPLAY=$DISPLAY \
    -v /tmp/.X11-unix:/tmp/.X11-unix \
    -u $(id -u):$(id -g) \
    ubuntu24-qt6:latest

3. 验证修复效果

进入容器后执行以下操作确认修复：

• 运行glxinfo | grep "OpenGL version"，确认输出正常的OpenGL版本信息
• 测试2dpainting、hellogl2等之前异常的示例，应能正常渲染画面
• 检查控制台是否还有XDG_RUNTIME_DIR相关警告

关键修改说明 #

• QT_OPENGL=desktop：强制Qt使用GLX后端，解决部分示例依赖GLX而非EGL的兼容性问题
• QT_QPA_PLATFORM=xcb：明确指定X11平台插件，避免Qt自动选择后端时出现异常
• -u $(id -u):$(id -g)：让容器内用户拥有与主机相同的ID，获得X11服务器的合法访问权限
• 补充依赖：libgl1-mesa-glx提供GLX的OpenGL实现，qt6-opengl-dev完善Qt6 OpenGL支持，libxcb-*库修复X11平台插件的依赖缺失

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