本地项目体积远低于限额却触发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
相关产品推荐
相关产品推荐

