如何在GitHub Action用actions/setup-node配置@gsap registry解决GSAP安装403错误

解决方案 #

你遇到的403报错确实是因为未正确配置@gsap域对应的私有源地址，有两种常用的解决方式：

方案一：提交.npmrc配置到代码仓库（推荐） #

在项目根目录新建.npmrc文件，写入以下内容后提交到仓库即可，无需修改现有工作流配置：

@gsap:registry=https://npm.greensock.com
//npm.greensock.com/:_authToken=${NPM_AUTH_TOKEN}

Yarn安装依赖时会自动读取该配置，并用你传入的NPM_AUTH_TOKEN环境变量替换配置中的占位符，完成私有包的鉴权拉取。

方案二：工作流中动态生成配置 #

如果不想把私有源配置提交到代码仓库，可以直接修改Install dependencies步骤，在安装依赖前动态生成配置文件：

- name: Install dependencies
  run: |
    # 写入GSAP私有源配置
    echo "@gsap:registry=https://npm.greensock.com" > .npmrc
    echo "//npm.greensock.com/:_authToken=${NPM_AUTH_TOKEN}" >> .npmrc
    composer install -o
    yarn
  env:
    NPM_AUTH_TOKEN: ${{ secrets.NPM_AUTH_TOKEN }}

额外说明 #

报错日志中的package-lock.json警告不影响本次安装，如果你项目确定只用Yarn，可以删除仓库根目录的package-lock.json文件，避免后续包管理器混用导致的依赖版本不一致问题。

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