Docker运行Rails 6应用时Yarn包校验报错问题排查

我之前碰到过一模一样的问题，核心根源基本都是本地目录挂载覆盖了容器内的依赖文件，或者配置没有真正生效。结合你的配置细节，给你几个针对性的解决方案：

1. 阻止本地目录覆盖容器内的node_modules #

你的docker-compose.yml里把本地.挂载到了容器的/app，这会直接导致容器里安装好的node_modules被本地的（如果本地有这个目录的话）或者空目录覆盖，进而触发Yarn的完整性校验错误。

修改website服务的volumes配置，添加一个匿名卷来保留容器内的node_modules：

website:
  # ...其他原有配置
  volumes:
    - '.:/app'
    - '/app/node_modules'  # 新增这一行，阻止本地挂载覆盖容器内的依赖目录
    - gem_cache:/gems

这样Docker会优先使用容器内安装好的node_modules，不会被本地目录干扰。

2. 确保webpacker.yml的配置真正生效 #

虽然你已经设置了check_yarn_integrity: false，但要注意：因为挂载了本地目录，容器实际使用的是你本地的webpacker.yml文件，如果本地文件没保存修改、或者有缓存残留，可能导致配置不生效。

你可以尝试在启动命令里先清除Webpacker的缓存，确保配置加载最新的：

command: bash -c "rm -rf tmp/cache/webpacker && bundle exec rails s -p 3000 -b '0.0.0.0'"

3. 在容器启动时强制校验依赖 #

如果本地挂载导致依赖状态不一致，可以在启动Rails服务器前再次执行Yarn校验，确保依赖完全匹配。修改docker-compose.yml里的command：

command: bash -c "yarn install --check-files && bundle exec rails s -p 3000 -b '0.0.0.0'"

这样每次启动容器都会先检查并同步Yarn依赖，避免镜像构建时的依赖和启动时的环境不一致。

4. 优化Dockerfile的依赖安装顺序 #

为了利用Docker的缓存机制，减少重复构建时间，建议把依赖文件的COPY命令放在前面，修改后的Dockerfile大致如下：

FROM ruby:2.6.5-slim
LABEL maintainer="John van Arkelen <johnvanarkelen@fastmail.com>"

# 先安装系统依赖
RUN apt-get update -qq && apt-get install -y curl build-essential libpq-dev postgresql postgresql-contrib
RUN curl -sL https://deb.nodesource.com/setup_11.x | bash -
RUN apt-get install -y nodejs
RUN npm install -g yarn

# 创建工作目录
RUN mkdir /app
RUN mkdir -p /usr/local/nvm
WORKDIR /app

# 安装Ruby依赖
ENV BUNDLE_PATH /gems
RUN gem install bundler -v 2.0.2
COPY Gemfile Gemfile.lock ./
RUN bundle install

# 安装Yarn依赖
COPY package.json yarn.lock ./
RUN yarn install --check-files

# 最后复制应用代码（利用缓存，只有代码变化时才重新执行这一步）
COPY . /app

这样修改后，只有当package.json或yarn.lock变化时，才会重新执行yarn install，大幅提升构建效率。

试试以上方案，应该能彻底解决你的Yarn校验错误问题。

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