为何基于同Python镜像构建的自定义Docker镜像无法显示matplotlib绘图？

核心原因：容器缺少X11图形转发配置 #

你直接运行官方镜像时，终端环境可能默认传递了X11访问权限（或你遗漏了相关运行参数），而自定义镜像运行时未配置容器访问主机的X11服务器，导致matplotlib无法将图形输出到主机屏幕。此外，镜像构建阶段无X环境，可能让matplotlib默认启用非交互式后端，也会引发显示失败。

具体解决方案 #

1. 运行自定义镜像时添加X11转发参数 #

执行以下命令，让容器获取访问主机X11服务的权限：

# 临时授权本地Docker容器访问主机X服务器（重启后需重新执行）
xhost +local:docker

# 运行自定义镜像，添加X11转发配置
docker run -e DISPLAY=$DISPLAY -v /tmp/.X11-unix:/tmp/.X11-unix py-polygon:0.01

• -e DISPLAY=$DISPLAY：传递主机的显示器环境变量，告诉matplotlib图形输出目标
• -v /tmp/.X11-unix:/tmp/.X11-unix：挂载主机的X11套接字文件，让容器与主机X服务器通信
• xhost +local:docker：解决容器访问X服务器的权限拒绝问题

2. 强制matplotlib使用交互式后端 #

若上述配置仍无效，可能是镜像构建时matplotlib默认使用了非交互式后端（如Agg），可通过两种方式修正：

方式一：在代码中指定后端

修改main.py，导入matplotlib前添加后端配置：

import matplotlib
matplotlib.use('TkAgg')  # 也可选择Qt5Agg，根据主机已安装的X后端调整
import matplotlib.pyplot as plt

方式二：在Dockerfile中设置环境变量

在Dockerfile里添加环境变量，指定matplotlib后端：

FROM python:3.11

WORKDIR /work
COPY . .
ENV MPLBACKEND=TkAgg
RUN pip install -r requirements.txt
CMD ["python3", "main.py"]

为什么直接运行官方镜像能显示？ #

你直接运行官方镜像的命令中，终端环境可能自动传递了X11相关的环境变量与挂载配置（比如部分Docker桌面环境或终端默认开启X11转发），或你实际运行时手动添加了这些参数但未在问题描述中提及。而自定义镜像运行时缺少这些配置，因此无法显示图形。

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