Streamlit应用Heroku部署成功但运行报错：Python未配置tkinter

问题详情 #

本地Windows Anaconda Python 3.9.13环境中Streamlit应用运行正常，但部署到Heroku后出现以下报错：

File "/app/.heroku/python/lib/python3.9/tkinter/init.py", line 37, in
import _tkinter # If this fails your Python may not be configured for Tk

已尝试但无效的操作：

• 更换Python版本
• 通过Anaconda重装tkinter
• 将libtk8.6添加到Heroku的runtime.txt文件
• 曾在Streamlit Share通过packages.txt添加libtk8.6解决同类问题，但该服务需订阅无法共享给用户

解决方案建议 #

• 使用Aptfile安装系统级tk依赖
  Heroku的Python环境不支持通过runtime.txt安装系统包，正确方式是创建Aptfile：

  1. 在项目根目录新建名为Aptfile的文件
  2. 文件内写入：libtk8.6
  3. 将该文件提交到Git仓库，重新部署Heroku应用

• 避免不必要的tkinter依赖加载
  如果应用本身不需要GUI，排查是否是第三方库触发了tkinter导入：

  • 若使用matplotlib，设置非tkinter后端：

    import matplotlib
    matplotlib.use('Agg')
    

  • 检查代码中tkinter的导入逻辑，改为仅本地运行时加载（可通过判断环境变量实现）：

    import os
    if os.environ.get("STREAMLIT_RUN_LOCALLY"):
        import tkinter as tk
    

• 确认Heroku buildpack配置
  确保应用使用官方Python buildpack，执行以下Heroku CLI命令：

  heroku buildpacks:set heroku/python
  

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