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
相关产品推荐
相关产品推荐

