在Bazel环境中导入matplotlib.pyplot触发Tkinter初始化失败

问题原因 #

在Bazel沙箱环境中导入matplotlib.pyplot时，Matplotlib默认会尝试使用tkinter作为图形后端，但Bazel打包的Python环境里，_tkinter作为内置模块存在，没有__file__属性，直接触发了AttributeError报错。

解决方案 #

1. 切换为非交互式后端（推荐） #

Matplotlib支持无需GUI的非交互式后端（如Agg、SVG等），完全避开tkinter依赖，适合Bazel构建的无GUI场景：

• 代码内直接设置：在test.py开头添加后端切换代码：

  import matplotlib
  # 切换为Agg后端，适用于生成图片文件的场景
  matplotlib.use('Agg')
  import matplotlib.pyplot as plt
  

• 通过Bazel配置注入环境变量：修改py_binary目标，添加MPLBACKEND环境变量全局指定后端：

  py_binary(
      name = "test",
      srcs = ["test.py"],
      deps = ["@matplotlib_py38//:lib"],
      env = {
          "MPLBACKEND": "Agg",
      },
  )
  

2. 适配tkinter后端（仅当必须使用GUI时） #

如果业务场景确实需要tkinter后端，需让Bazel正确识别tkinter的系统依赖：

• 确认你的Python工具链包含tkinter组件：若使用rules_python的python_register_toolchains，需选择带tkinter的Python预编译包（部分精简版Python可能默认不含tkinter）。
• 在py_binary的data字段中添加系统级tkinter库文件（路径需根据操作系统调整），例如Linux环境：

  py_binary(
      name = "test",
      srcs = ["test.py"],
      deps = ["@matplotlib_py38//:lib"],
      data = [
          "/usr/lib/x86_64-linux-gnu/libtk8.6.so",
          "/usr/lib/x86_64-linux-gnu/libtcl8.6.so",
      ],
  )
  

  注意：这种方式依赖本地系统环境，可移植性差，不建议在CI或跨平台场景使用。

3. 检查Matplotlib依赖导入配置 #

确保@matplotlib_py38是通过rules_python的标准方式导入的，避免依赖缺失：

# WORKSPACE文件中配置
load("@rules_python//python:pip.bzl", "pip_install")

pip_install(
    name = "matplotlib_py38",
    requirements = "//path/to:requirements.txt",
    python_interpreter = "python3.8",
)

同时确保requirements.txt中指定了对应版本的Matplotlib：

matplotlib==3.5.3

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