macos-12托管代理上NodeTool@0任务偶发权限错误求助

错误原因 #

1. 版本匹配逻辑触发下载：尽管你设置了checkLatest: false，但NodeTool@0的spec模式仍会尝试匹配16.x范围内的最新可用版本（比如16.18.1），而非直接复用代理缓存的16.8.1。当任务需要下载未缓存的版本时，就会尝试在/opt/hostedtoolcache下创建新目录。
2. 目录权限限制：macOS托管代理的/opt/hostedtoolcache目录默认由root用户拥有，而流水线任务通常以runner用户执行。runner用户没有该目录的写入权限，尝试创建子目录时就会抛出EACCES权限错误。
3. 非必现的原因：当流水线刚好命中缓存的16.8.1版本时，任务无需创建新目录，不会触发权限问题；只有当任务解析到更新的16.x版本并尝试下载时，才会出现错误。

解决方法 #

1. 直接指定缓存的具体版本 #

将versionSpec改为代理已缓存的16.8.1，让任务直接复用缓存版本，避免下载和目录创建操作：

- task: NodeTool@0
  inputs:
    versionSource: 'spec'
    versionSpec: '16.8.1'
    checkLatest: false

2. 修复目录权限 #

在NodeTool任务前添加脚本，修改/opt/hostedtoolcache的权限，让runner用户拥有读写权限：

- script: sudo chown -R $USER:$GROUP /opt/hostedtoolcache
  displayName: Fix hostedtoolcache directory permissions
- task: NodeTool@0
  inputs:
    versionSource: 'spec'
    versionSpec: '16.x'
    checkLatest: false

3. 改用actions/setup-node动作 #

GitHub官方的actions/setup-node对托管代理的缓存处理更完善，权限问题更少，推荐替换使用：

- uses: actions/setup-node@v3
  with:
    node-version: '16.8.1'

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