Ruby 3.2.2升级至3.3.0后Heroku Rails应用Slug超限构建失败求助

一、Slug体积暴涨的核心原因 #

• Ruby 3.3.0默认启用YJIT：YJIT作为即时编译器，会附带额外的二进制依赖文件，Heroku的Ruby构建包在安装3.3.0时会包含这些组件，直接增加基础体积。
• Gem原生扩展编译差异：部分Gem在Ruby 3.3.0环境下编译时，会拉取更多系统依赖或生成更大的二进制文件，尤其是那些与Ruby内部API绑定较深的原生Gem。
• 构建缓存未彻底清理：升级Ruby版本后，Heroku会重新安装所有Gem，但旧版本Ruby的缓存文件可能未被完全清除，导致新旧依赖叠加。
• Ruby安装包本身体积增大：Ruby 3.3.0的官方发行包包含了更多调试信息、新增标准库组件，Heroku构建包未对其做精简处理。

二、查看Slug文件详情的实操方法 #

1. 本地模拟Heroku构建并分析 #

通过Heroku CLI的本地构建功能模拟线上流程，直接查看生成的slug结构：

# 在项目目录下启动本地构建
heroku local:build
# 构建完成后，查看slug目录的体积分布
du -h --max-depth=1 .slug

2. 在构建过程中插入体积检测脚本 #

在项目根目录创建bin/postinstall文件（需赋予执行权限），添加以下内容，让构建日志输出目录体积：

#!/bin/bash
set -e
# 输出/app目录下各子目录的大小
du -h --max-depth=1 /app
# 详细输出Gem依赖目录的体积
du -h --max-depth=2 /app/vendor/bundle

提交该文件后重新部署，构建日志会明确显示哪些目录占用了大量空间。

3. 下载Slug到本地分析 #

借助Heroku插件下载完整slug包，解压后逐一排查大文件：

# 安装slug下载插件
heroku plugins:install heroku-slug-downloader
# 下载当前应用的slug到本地
heroku slug:download -a empora-rails-staging
# 解压并分析体积分布
mkdir slug && tar -xf slug.tgz -C slug
du -h --max-depth=1 slug

三、针对性缩减Slug体积的方案 #

• 禁用YJIT（非必需场景）：在Heroku环境变量中设置RUBY_YJIT_ENABLE=0，或在config/application.rb中添加ENV['RUBY_YJIT_ENABLE'] = '0'，移除YJIT相关依赖。
• 清理无用Gem与依赖：执行bundle clean --force清理未使用的Gem；在Gemfile中明确指定--without development test排除非生产依赖。
• 优化原生Gem编译：检查Gemfile.lock中体积较大的原生Gem，尝试升级到适配Ruby 3.3.0的版本，或寻找轻量替代方案。
• 精简Ruby安装：通过Heroku构建包的自定义配置，移除Ruby安装包中的调试信息和不必要的组件。

内容的提问来源于stack exchange，提问作者jkwuc89