在Amazon Linux 2的EC2上运行Gremlin-Python绘图脚本遇Tkinter错误

问题根源 #

Amazon Linux 2作为无桌面环境的服务器系统，默认未安装Tkinter的系统级依赖；而Matplotlib默认使用TkAgg GUI后端，导致导入matplotlib.pyplot时触发ImportError。pip/pip3安装的tk包仅提供Python层绑定，无法替代系统级库。

解决方案 #

1. 安装系统级Tkinter依赖

通过yum安装对应Python版本的Tkinter系统包：

# 针对Python3
sudo yum install -y python3-tkinter
# 若使用Python2（不推荐）
sudo yum install -y tkinter

安装完成后可重新安装Matplotlib确保依赖关联：

pip3 install --force-reinstall matplotlib

2. 切换Matplotlib为无GUI后端

因为你需要为Web应用生成图形，无需桌面GUI显示，直接将Matplotlib后端切换为无GUI类型（如Agg、SVG）：

• 脚本内临时设置（推荐，仅当前脚本生效）：

  import matplotlib
  # 选择无GUI后端，Agg用于生成PNG/JPG，SVG用于矢量图
  matplotlib.use('Agg')
  import matplotlib.pyplot as plt
  
  # 后续正常绘图并保存
  plt.figure(figsize=(8,6))
  # 这里替换为你的Neptune数据绘图逻辑
  plt.plot([1,3,5], [2,4,6])
  # 保存为图片文件，供Web应用调用
  plt.savefig('/var/www/html/neptune_graph.png')
  plt.close()
  

• 全局配置（所有Python脚本生效）：
  创建Matplotlib配置文件：

  mkdir -p ~/.config/matplotlib
  echo "backend: Agg" > ~/.config/matplotlib/matplotlibrc
  

3. 验证功能

运行你的Python脚本，若不再出现Tkinter相关错误，且成功生成图片文件，则问题解决。生成的图片可直接通过Web服务器（如Nginx、Apache）对外提供访问。

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