You need to enable JavaScript to run this app. Heroku-20栈部署Flask应用报Python运行时不可用错误求助
优惠活动
大模型
产品
解决方案
定价
更多

Heroku-20栈部署Flask应用报Python运行时不可用错误求助

报错核心根因

日志中解析出的Requested runtime (python-)并不是你配置的python-3.9.1版本,说明Heroku Python构建包在读取runtime.txt时发生了内容截断,完全没有获取到完整的版本标识,和你当前配置的官方Python构建包本身没有关联。

分步排查与修复
  • 核对runtime.txt的格式合规性
    Heroku构建包对runtime.txt的格式校验规则非常严格:

    • 文件必须放在项目根目录,不能嵌套在其他子文件夹内
    • 内容必须严格遵循python-<版本号>的单行格式,不能存在首尾空格、行尾注释、文件末尾多余的空行
    • 编码格式不能携带Windows系统常见的BOM头,否则会导致首个版本字符被异常截断
      你填写的python-3.9.1本身是符合heroku-20栈的Python版本兼容范围的,只要文件格式符合要求,就不会出现解析为空的问题。验证时可以直接用文本编辑器打开该文件,删除所有多余内容,仅保留python-3.9.1这一行后重新保存。
  • 核对runtime.txt的Git追踪状态
    很多场景下本地存在runtime.txt,但远程代码仓库中缺失该文件,也会触发这个空版本报错。可以在本地项目根目录执行以下命令逐一排查:

    • 运行git ls-files runtime.txt,如果没有返回对应文件路径,说明该文件根本没有被Git纳入追踪
    • 检查项目根目录下的.gitignore文件,确认没有将runtime.txt加入忽略规则
    • 运行git show HEAD:runtime.txt,确认Git仓库中存储的runtime.txt内容是完整的python-3.9.1,没有截断、乱码、多余空字符
  • 清理应用侧构建缓存后重新推送
    Heroku会在应用侧留存历史构建的临时缓存,如果之前因为文件格式异常生成了空的版本解析结果,哪怕后续修改了文件,旧缓存的解析结果也可能覆盖新的读取内容。可以先执行清缓存操作,再重新推送代码:

    heroku builds:cache:purge -a 你的Heroku应用名称
    git push heroku master
    

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.08 05:24:07