Docker容器运行tcod库提示SDL初始化失败问题求助

我正参考Roguelike开发教程编写一款简易Python游戏，为统一管理依赖版本选择Docker作为运行环境，但启动Docker镜像时出现如下报错：

The path /dev/dri/ cannot be opened or is not available
The path /dev/dri/ cannot be opened or is not available
The path /dev/dri/ cannot be opened or is not available
The path /dev/dri/ cannot be opened or is not available
Traceback (most recent call last):
File "/app/main.py", line 32, in <module>
main()
File "/app/main.py", line 13, in main
with tcod.context.new_terminal(
File "/usr/local/lib/python3.9/site-packages/tcod/_internal.py", line 29, in wrapper
return func(*args, **kwargs)
File "/usr/local/lib/python3.9/site-packages/tcod/context.py", line 616, in new_terminal
return new(
File "/usr/local/lib/python3.9/site-packages/tcod/context.py", line 569, in new
_check_warn(error)
File "/usr/local/lib/python3.9/site-packages/tcod/_internal.py", line 75, in _check_warn
if _check(error) > 0:
File "/usr/local/lib/python3.9/site-packages/tcod/_internal.py", line 62, in _check
_raise_tcod_error()
File "/usr/local/lib/python3.9/site-packages/tcod/_internal.py", line 56, in _raise_tcod_error
raise RuntimeError(ffi.string(lib.TCOD_get_error()).decode("utf-8"))

RuntimeError: libtcod 1.20.1 libtcod/src/libtcod/renderer_sdl2.c:902
Could not initialize SDL:
dummy not available
Video driver 'x11' is not working.
Video driver 'wayland' is not working.
Video driver 'KMSDRM' is not working.
Video driver 'KMSDRM_LEGACY' is not working.
Video driver 'dummy' is not working.

相关环境与代码信息如下：

• 宿主机系统：Ubuntu 20.04
• 相同代码在宿主机非Docker环境可正常运行，更换Docker镜像内Python版本后报错依旧
• 使用的Dockerfile内容：

# syntax=docker/dockerfile:1

FROM python:3.9.0

WORKDIR /app

COPY requirements.txt requirements.txt

RUN python3 -m pip install -r requirements.txt

COPY . .

CMD [ "python3", "main.py", "--host=0.0.0.0"]

• 依赖配置requirements.txt内容：

tcod
numpy

• 项目入口main.py代码：

#!/usr/bin/env python3
import tcod


def main() -> None:
    screen_width = 80
    screen_height = 50

    tileset = tcod.tileset.load_tilesheet(
        "assets/dejavu10x10_gs_tc.png", 32, 8, tcod.tileset.CHARMAP_TCOD
    )

    with tcod.context.new_terminal(
        screen_width,
        screen_height,
        tileset=tileset,
        title="Yet Another Roguelike Tutorial",
        vsync=True,
    ) as context:
        root_console = tcod.Console(screen_width, screen_height, order="F")
        while True:
            root_console.print(x=1, y=1, string="@")

            context.present(root_console)

            for event in tcod.event.wait():
                if event.type == "QUIT":
                    raise SystemExit()


if __name__ == "__main__":
    main()

报错根因是Docker容器默认隔离了宿主机的图形服务、硬件设备，python基础镜像也缺少SDL2运行依赖，导致tcod依赖的SDL2库找不到可用的视频驱动，无法初始化图形窗口。你在启动命令里加的--host=0.0.0.0是Web服务类程序用的参数，对tcod这类桌面图形程序完全无效。

1. 修改Dockerfile，安装系统级依赖 #

原版python:3.9镜像没有自带SDL2、X11相关的运行库，需要在镜像构建阶段提前安装，同时删除无效的启动参数：

# syntax=docker/dockerfile:1

FROM python:3.9.0

WORKDIR /app

# 安装SDL2相关运行依赖
RUN apt update && apt install -y --no-install-recommends \
    libsdl2-2.0-0 \
    libsdl2-image-2.0-0 \
    && rm -rf /var/lib/apt/lists/*

COPY requirements.txt requirements.txt
RUN python3 -m pip install -r requirements.txt

COPY . .

# 删除无效的--host参数
CMD [ "python3", "main.py"]

修改完成后重新构建镜像：

docker build -t roguelike-demo .

2. 运行容器时挂载图形相关资源 #

Ubuntu 20.04默认使用X11显示服务，执行以下命令运行容器即可正常加载图形窗口：

# 临时给本地root用户开放X服务访问权限
xhost +local:root
docker run -it --rm \
  -e DISPLAY=$DISPLAY \
  -v /tmp/.X11-unix:/tmp/.X11-unix \
  --device /dev/dri:/dev/dri \
  roguelike-demo

参数说明：

• -e DISPLAY=$DISPLAY：将宿主机的显示编号传入容器，让程序知道输出到哪个显示器
• -v /tmp/.X11-unix:/tmp/.X11-unix：挂载X11的Unix通信套接字，让容器内程序可以和宿主机的X显示服务通信
• --device /dev/dri:/dev/dri：挂载宿主机显卡设备，解决/dev/dri/路径不存在的报错

注意：测试完成后可执行xhost -local:root收回X服务访问权限，避免不必要的安全风险。

如果使用Wayland显示环境，需要额外开启XWayland兼容层，Ubuntu 20.04默认使用X11无需额外调整。

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