Docker构建中pnpm安装私有npm包提示授权头未设置的问题排查

尝试安装私有npm仓库中的包，已通过Postman和cURL验证：使用构建镜像时传入的NPM_TOKEN作为Bearer授权头，能够正常访问包的URL。但本地执行docker build时始终失败。

构建命令 #

docker build --build-arg NPM_TOKEN="**REDACTED**" -t docker-image-test . --no-cache

简化版Dockerfile #

FROM node:20-bookworm

ARG NODE_ENV=production
ARG NPM_TOKEN

....

RUN apt update

RUN npm install -g pnpm
RUN npm config set '//registry.npmjs.org/:_authToken' "${NPM_TOKEN}"

# 用cURL验证token有效性
RUN curl https://registry.npmjs.org/@**REDACTED**/test-client -H "Authorization: Bearer ${NPM_TOKEN}" && echo "获取包成功"

USER node

COPY --chown=node:node package.json package.json
COPY --chown=node:node tsconfig.json tsconfig.json
COPY --chown=node:node pnpm-lock.yaml pnpm-lock.yaml

RUN pnpm install

COPY --chown=node:node src src

错误信息 #

=> ERROR [14/15] RUN pnpm install

[14/15] 执行RUN pnpm install:

1.412 进度：解析0个，复用0个，下载1个，添加0个

1.997  ERR_PNPM_FETCH_404  请求 https://registry.npmjs.org/@REDACTED%2Ftest-client 失败：未找到 - 404

1.997
1.997 该错误发生在安装/REDACTED的直接依赖时
1.997
1.997 @REDACTED/test-client 不在npm仓库中，或你没有拉取权限。
1.997
1.997 请求未设置授权头。

已尝试操作 #

• 用echo //registry.npmjs.org/:_authToken=${NPM_TOKEN} > .npmrc替代npm config set命令，结果一致

疑问 #

1. 是否有调试命令可以查看pnpm install发出的请求头？
2. 还有哪些可能的遗漏点导致授权头未被设置？

内容的提问来源于stack exchange，提问作者sc-leeds