Heroku上传发布版本报错：cannot load such file -- mimemagic/overlay

核心原因说明 #

• 这个报错来自mimemagic 0.3.5~0.3.9版本区间的打包缺陷：该段版本的gem包没有正确将mimemagic/overlay模块文件包含进发布包，在Heroku这类类Unix运行环境下加载时会直接触发LoadError。
• 执行bundle exec rake -P看不到mimemagic相关输出是完全正常的：这个命令只会列出Rakefile里定义的顶层任务的直接依赖，mimemagic是carrierwave等gem引入的传递依赖，不会出现在任务依赖清单里，不代表项目没有安装这个gem。
• 你观察到的近期版本破坏性变更确实是问题触发源：你没有主动在Gemfile里声明mimemagic，是其他依赖在版本更新后自动拉取了存在缺陷的mimemagic版本，才引发了本次部署报错。

实操解决步骤 #

• 最直接的修复方式是在Gemfile中锁定无缺陷的mimemagic版本，阻断有问题的版本被自动拉取：
  在Gemfile中添加一行声明：gem 'mimemagic', '~> 0.3.10'
  本地执行bundle update mimemagic更新Gemfile.lock，将两个文件一并提交到代码仓库，重新触发Heroku部署即可解决报错。
• 如果直接锁定mimemagic版本引发依赖冲突，可以反向固定上层依赖的版本：比如自动拉取最新代码的carrierwave，锁定到与当前Rails版本匹配的稳定release版本，从依赖源头上切断有缺陷的mimemagic版本的引入路径。

注意：不要尝试在本地手动补写mimemagic的overlay文件解决问题，Heroku的部署流程不会保留这类手动修改的文件，最终还是会触发加载失败。

内容的提问来源于stack exchange，提问作者Malcolm Johnson-Brown