You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

部署Flask应用至Heroku时出现构建错误

解决Heroku部署Flask应用时distribute依赖构建失败的问题

嘿,我帮你拆解下这个部署问题——从你贴的报错片段来看,核心问题出在distribute-0.6.24这个超老旧的依赖包上。这个包早在很多年前就被合并到setuptools里了,而且它只兼容Python 2.x和非常早期的Python 3版本,根本适配不了Heroku现在默认使用的现代Python环境(比如3.8及以上版本)。

给你一套具体的修复步骤:

  • 第一步:清理过时的依赖条目
    打开项目里的requirements.txt文件,把所有和distribute相关的行删掉。同时顺便检查下有没有其他标注了老版本的依赖(比如setuptools的旧版本),要么移除要么更新到支持Python 3的版本。

  • 第二步:明确指定Python版本
    在项目根目录新建一个runtime.txt文件,写上Heroku支持的稳定Python版本,比如:

    python-3.10.12
    

    这样能避免Heroku自动选择不兼容的版本。

  • 第三步:更新构建工具版本
    在requirements.txt的最顶部加上这两行,确保Heroku用最新的工具来处理依赖:

    setuptools>=65.5.0
    pip>=23.0.1
    
  • 第四步:本地验证+重新部署
    先在本地跑一遍依赖安装,确认没有问题:

    pip install -r requirements.txt
    

    没问题的话,提交代码重新部署到Heroku:

    git add .
    git commit -m "Fix outdated dependencies for Heroku deployment"
    git push heroku main
    

另外提醒下:如果你的项目里还有其他是针对Python 2开发的依赖,也得逐一排查更新,比如把Flask升级到2.x及以上版本(它完全支持Python 3.6+)。

内容的提问来源于stack exchange,提问作者Maverick

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.25 03:58:55