You need to enable JavaScript to run this app. 本地项目体积远低于限额却触发Heroku构建slug大小超限报错求助
优惠活动
大模型
产品
解决方案
定价
更多

本地项目体积远低于限额却触发Heroku构建slug大小超限报错求助

问题根因说明
  • 本地执行du -sh *仅统计了当前目录下非隐藏的普通文件,漏算了Git仓库历史对象、Heroku构建时安装的全部依赖体积——最终的slug是「项目源码 + 所有安装的Python依赖 + 构建时生成的缓存文件」的打包总大小,和本地看到的44M源码体积没有直接对应关系
  • 从你提供的原始requirements.txt可直接定位到体积超标的核心来源:
    • 冗余调试类依赖:ipython、ipykernel、ipython-genutils、jupyter-client、jupyter-core、parso、pickleshare、prompt-toolkit、Pygments、tornado、traitlets、wcwidth 这些全是本地开发调试、运行Jupyter笔记本需要的包,生产环境运行项目完全用不到
    • 超大体积依赖:pystan==2.19.1.1、cmdstanpy==0.9.5 两个包安装时会编译整套C++后端运行库,单这两个包编译完成后就能占600M以上空间,是slug超标的核心元凶
    • 平台不兼容冗余依赖:wincertstore是Windows系统专属的证书工具,Heroku运行的Linux环境根本用不上
  • 之前你换干净虚拟环境仅安装4个核心依赖后构建仍报错,是因为修改后的requirements.txt没有同步推送到Git远程仓库,构建流程拉取的还是旧的带全量冗余包的依赖清单
可落地解决方案

1. 彻底精简requirements.txt

删除所有非运行必需的依赖,只保留项目实际逻辑用到的包,精简后的参考清单如下:

backcall==0.2.0
certifi==2020.12.5
click==7.1.2
convertdate==2.3.0
ephem==3.7.7.1
Flask==1.1.2
geographiclib==1.50
geopy==2.1.0
hijri-converter==2.1.1
holidays==0.10.5.2
itsdangerous==1.1.0
Jinja2==2.11.3
korean-lunar-calendar==0.2.1
LunarCalendar==0.0.9
MarkupSafe==1.1.1
numpy==1.20.2
pandas==1.2.4
PyMeeus==0.3.7
python-dateutil==2.8.1
pytz==2021.1
six==1.15.0
Werkzeug==1.0.1

重点提醒:如果业务代码没有用到pystan、cmdstanpy相关的贝叶斯建模逻辑,直接删除这两个依赖即可;如果确实需要用到相关功能,不要直接在项目里安装这类重编译包,改成调用外部服务接口,否则体积根本无法压到Heroku的500M限制以内

2. 配置.slugignore排除无关文件

在项目根目录新建.slugignore文件,把不需要打进最终slug的文件、目录全部列进去,配置参考:

__pycache__/
*.pyc
.git/
.gitignore
*.ipynb
.venv/
data_prep/

这个配置会让Heroku构建时直接跳过对应内容,不会把它们算进最终的slug体积里。同时记得删掉本地项目目录下的__pycache__文件夹,避免被误打包。

3. 清理仓库残留后重新触发构建

  • 确认修改后的requirements.txt、.slugignore文件已经通过Git推送到远程仓库,避免构建流程拉取到旧的版本文件
  • 如果之前有大文件被提交进过Git历史,哪怕现在本地已经删除,Git拉取代码时还是会把全量历史对象拉取下来占用空间,这时候需要先压缩Git仓库的历史对象,再重新推送代码触发构建
  • 正常精简完成后,最终的slug体积会降到100M以内,远低于500M的平台限制

内容的提问来源于stack exchange,提问作者ARTHUR MENDONCA LINS CALDAS

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.23 19:45:04