如何确保Rails Shakapacker在不同环境构建的runtime哈希文件一致？

要让Docker和GitLab CI环境下预编译出的Rails资产文件名哈希完全一致，核心是消除两个环境中影响资产哈希计算的所有变量差异，具体可以从以下几个方向入手：

1. 完全锁定依赖版本 #

• Ruby Gem依赖：确保Gemfile.lock在两个环境中完全一致，Docker构建时先复制Gemfile和Gemfile.lock，再执行bundle install --frozen（禁止更新依赖），避免不同环境拉取到不同版本的gem导致编译逻辑变化。
• 前端依赖：如果使用Webpacker、jsbundling-rails等工具，必须同步package-lock.json或yarn.lock文件，在两个环境中用npm ci（npm）或yarn install --frozen-lockfile（Yarn）安装依赖，保证前端包版本完全统一。

2. 统一编译环境的上下文与配置 #

• 一致的Rails环境变量：两个环境都设置相同的RAILS_ENV（通常为production），不同环境变量会触发不同的编译逻辑，比如调试模式会影响资产打包的哈希计算。
• 统一文件属性：Docker镜像内的文件权限、修改时间可能和GitLab CI环境存在差异，导致Webpack等工具计算出不同哈希。可以在Docker构建时用COPY --chown=app:app . .保持文件权限一致；极端情况下，可在预编译前执行touch -t 202001010000 app/assets/**/* packs/**/*统一文件修改时间。
• 相同的工作目录：确保Docker和GitLab CI的编译工作目录完全一致，路径差异可能导致部分工具的哈希计算逻辑出错。

3. 固定资产编译的密钥/哈希种子 #

• Rails核心密钥：Rails的资产哈希计算依赖secret_key_base，在两个环境中配置相同的secret_key_base值（可通过环境变量RAILS_SECRET_KEY_BASE传递），保证Rails层面的哈希生成逻辑一致。
• Webpacker专属哈希变量：如果使用Webpacker，可在构建时设置固定的WEBPACKER_ASSET_HASH环境变量，比如在Dockerfile中添加ENV WEBPACKER_ASSET_HASH=$(git rev-parse HEAD)，同时在GitLab CI的构建步骤中也设置相同的变量（用当前Git commit hash作为固定种子，既保证同一代码哈希一致，又能在代码变更时自动更新哈希）。

4. 统一构建工具版本 #

• 确保Docker和GitLab CI使用完全相同版本的Ruby、Node.js、Bundler、Webpack等工具。比如Dockerfile指定ruby:3.2.2-slim镜像，GitLab CI也使用同版本的Ruby镜像；Node.js通过.nvmrc文件固定版本，两个环境都读取该文件安装对应版本。

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