Docker构建JS项目时npmrc环境变量未替换致pnpm认证失败

核心问题：你挂载的本地.npmrc文件中的${MY_NPM_TOKEN}是静态字符串，Docker BuildKit的secret挂载不会自动替换其中的环境变量；而本地能正常运行，是因为你的shell已经加载了该变量，pnpm在本地环境中能正确解析替换。

以下是两种可行的解决方法：

方案1：动态生成.npmrc（最可靠） #

放弃挂载本地.npmrc，直接在Docker构建时生成包含有效令牌的配置文件，彻底避免变量替换问题：

修改Dockerfile的RUN命令 #

RUN --mount=type=secret,id=my-npm-token,env=MY_NPM_TOKEN \
    # 生成包含有效令牌的.npmrc
    echo "//artifactory.mystuff.io/artifactory/api/npm/npm-release-local/:_authToken=${MY_NPM_TOKEN}" > /root/.npmrc \
    # 执行依赖安装
    && pnpm install \
    # 安装完成后删除配置文件（可选，增强镜像安全性）
    && rm /root/.npmrc

简化构建脚本 #

去掉不必要的npmrc参数，修改package.json中的构建命令：

"build:server:docker": "DOCKER_BUILDKIT=1 docker build . -f apps/my-app/Dockerfile -t my-app --secret id=my-npm-token,env=$MY_NPM_TOKEN"

方案2：用envsubst替换.npmrc中的变量 #

如果需要保留本地.npmrc的其他配置，可以先将其挂载到临时位置，用envsubst替换变量后再放到目标路径：

1. 安装envsubst工具（Debian/Ubuntu镜像需执行） #

在Dockerfile中添加依赖安装步骤：

RUN apt-get update && apt-get install -y --no-install-recommends gettext-base && rm -rf /var/lib/apt/lists/*

2. 修改Dockerfile的RUN命令 #

RUN --mount=type=secret,id=my-npm-token,env=MY_NPM_TOKEN \
    --mount=type=secret,id=npmrc,target=/tmp/.npmrc \
    # 替换变量并生成最终的.npmrc
    envsubst < /tmp/.npmrc > /root/.npmrc \
    && pnpm install \
    && rm /root/.npmrc

这种方式会保留你本地.npmrc中的所有其他配置，仅替换${MY_NPM_TOKEN}为实际令牌值。

调试验证（可选） #

可以在RUN命令中添加调试步骤，直观确认环境变量和.npmrc内容：

RUN --mount=type=secret,id=my-npm-token,env=MY_NPM_TOKEN \
    --mount=type=secret,id=npmrc,target=/tmp/.npmrc \
    echo "当前MY_NPM_TOKEN值：$MY_NPM_TOKEN" \
    && echo "原始.npmrc内容：" && cat /tmp/.npmrc \
    && envsubst < /tmp/.npmrc > /root/.npmrc \
    && echo "替换后.npmrc内容：" && cat /root/.npmrc \
    && pnpm install

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