Docker构建时yarn install失败，容器内执行却成功的问题排查

核心原因 #

你的问题出在Docker构建阶段缺少私有包仓库的配置：构建时仅复制了package.json，但没有同步.yarnrc/.npmrc这类私有仓库配置文件，导致yarn默认去公共registry（yarnpkg.com）查找@myrepo/my-package，自然找不到对应的包；而进入容器后，本地挂载的项目目录包含了这些配置文件，yarn能识别到要去私有仓库拉取依赖，因此执行成功。

错误日志里的https://registry.yarnpkg.com/@myrepo%2fmy-package: Not found也能佐证这一点——如果配置正确，请求地址应该指向你的私有仓库，而非公共的yarnpkg.com。

具体解决方案 #

1. 复制私有仓库配置文件到镜像 #

如果项目根目录存在.yarnrc或.npmrc文件（里面配置了@myrepo对应的私有仓库地址），修改Dockerfile，在复制package.json后同步配置文件：

COPY package.json ./
COPY .yarnrc ./  # 若使用npm管理则替换为 COPY .npmrc ./
RUN yarn install

这样构建时yarn就能读取到私有仓库的配置，去正确的地址拉取依赖包。

2. 处理私有仓库的认证问题 #

如果私有仓库需要身份认证（SSH密钥或访问Token），需确保构建阶段能获取到认证信息：

• SSH认证场景：参考你处理bundle install的方式，给yarn install加上SSH挂载：

  COPY package.json ./
  COPY .yarnrc ./
  RUN --mount=type=ssh yarn install
  

  构建时执行docker build --ssh default .传递SSH代理。

• Token认证场景：通过构建参数传递Token，在镜像内生成临时配置文件：

  ARG PRIVATE_REGISTRY_TOKEN
  COPY package.json ./
  RUN echo "@myrepo:registry=https://your-private-registry.com/" > .npmrc \
      && echo "//your-private-registry.com/:_authToken=${PRIVATE_REGISTRY_TOKEN}" >> .npmrc \
      && yarn install \
      && rm .npmrc  # 可选：构建完成后删除敏感配置
  

  构建时执行：

  docker build --build-arg PRIVATE_REGISTRY_TOKEN=your-token-value .
  

3. 额外检查点 #

• 确认package.json中@myrepo/my-package的版本号在私有仓库中真实存在；
• 若使用yarn 2+版本，需同步.yarn目录或yarn.lock文件（你的日志显示No lockfile found，应该是yarn 1.x版本，可忽略此点）。

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