Rails 6执行assets:precompile报yarn无--immutable选项错误

核心原因 #

这个--immutable参数不是你的项目代码直接调用的，而是Rails内部的gem（比如webpacker、sprockets-rails）在执行资产预编译时自动添加的。该参数是yarn 2.x及以上版本才支持的选项，如果你通过apt-get安装的是yarn 1.x版本，就会触发这个报错。

具体排查步骤 #

• 检查yarn版本：在Dockerfile中添加RUN yarn -v，或者进入运行中的容器执行该命令，确认是否为1.x版本。bullseye默认apt源中的yarn通常是1.x，这是最常见的诱因。
• 追踪调用栈：执行bundle exec rake assets:precompile --trace，打印完整的任务执行栈。从输出里可以清晰看到是哪个Rails内部任务（比如webpacker:install或assets:precompile的子任务）调用了带--immutable参数的yarn命令。
• 核对gem版本：查看项目Gemfile.lock中的webpacker或sprockets-rails版本。比如webpacker 5.4.0及以上版本，会在执行依赖安装时自动添加--immutable参数来保证依赖的一致性。
• 解释编译成功的原因：报错可能来自某个子命令（比如yarn install的前置检查），但Rails的资产预编译任务可能捕获了这个错误并继续执行后续的编译步骤，所以最终资产还是能生成。

解决/规避方案 #

• 升级yarn版本：替换apt-get安装方式，用yarn官方源安装最新稳定版：

  RUN curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | apt-key add - \
      && echo "deb https://dl.yarnpkg.com/debian/ stable main" | tee /etc/apt/sources.list.d/yarn.list \
      && apt-get update && apt-get install -y yarn nano cron nodejs
  

• 手动跳过参数调用：在执行rails assets:precompile前，先手动执行yarn install（不带--immutable），让依赖先安装完成，再执行预编译：

  COPY . .
  RUN yarn install
  RUN rails assets:precompile RAILS_ENV=production
  

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