Dockerfile中使用HEREDOC生成.npmrc文件无内容输出的问题排查

看起来你遇到的问题是在Alpine镜像的Dockerfile里用HEREDOC生成.npmrc时，文件总是为空，但本地Mac的bash环境下完全正常。这大概率是因为Alpine默认使用的ash shell和你本地的bash对HEREDOC的处理逻辑有差异，或者Dockerfile里的HEREDOC写法有细节没注意到，下面给你几个排查和解决的方向：

• 检查HEREDOC结束标记的格式
  <<-EOF中的-符号只允许结束标记EOF前面有制表符（Tab），如果是空格的话，ash不会把它识别为有效的结束标记，导致HEREDOC无法正确闭合，自然不会写入任何内容。确保你的EOF是顶格写的（没有任何前导空格或Tab）；如果确实需要用Tab缩进EOF，就保留<<-EOF；如果用的是空格缩进，就改成<<EOF。

• 换用更可靠的写入方式
  直接通过cat命令来写入文件，比直接重定向HEREDOC更兼容ash的语法，在大多数shell环境下都能稳定工作：

  RUN cat > /root/.npmrc <<EOF
  registry=https://\${NPM_VIRTUAL_REGISTRY_REPO_URL}
  strict-ssl=false
  always-auth=true
  email=\${PUBLISHER_EMAIL}
  //\${NPM_VIRTUAL_REGISTRY_REPO_URL}:_auth=\${NPM_BASIC_AUTH}
  EOF
  

• 清理构建缓存重试
  从你的构建日志看，Step 2/3复用了缓存（Using cache），有可能之前的错误构建结果被缓存下来了。试试加上--no-cache参数重新构建，确保Docker重新执行所有RUN指令：

  docker build --no-cache -t base --target=base .
  

• 验证shell环境的差异
  你可以临时在Dockerfile里加一行指令，查看当前使用的shell：

  RUN echo $0
  

  Alpine默认是/bin/sh（即ash），它对HEREDOC的处理和bash确实有细微差别，比如对<<-的缩进支持更严格，这也是为什么本地bash能正常运行但Docker里不行的核心原因。如果实在需要bash的行为，可以先安装bash（RUN apk add --no-cache bash），然后显式用bash执行HEREDOC指令，但这会增加镜像体积，不推荐作为首选方案。

备注：内容来源于stack exchange，提问作者Christian Bongiorno