Clasp CLI无法关联Google账号 登录鉴权报错无法创建App Script

问题描述 #

为Google Sheets开发App Script时使用官方clasp CLI做本地开发，执行clasp login、clasp login --no-localhost两类登录命令，选择目标Google账号后均返回未知鉴权错误。
已完成排查操作：

• 清除Firefox v100浏览器缓存
• 重启计算机
• 切换网络环境
• 更换其他Google账号登录
• 确认账号侧已启用Google App Script服务
  以上操作均未解决问题，阻塞开发流程。

环境信息 #

Node版本：v18.4.0
clasp版本：v2.4.1
操作系统：Linux PopOS v22.04（Ubuntu类发行版）

修复方案 #

按优先级依次尝试：

• 重装兼容版本clasp并清除旧凭证
  v2.4.1版本clasp内置的google-auth-library与Node 18、Linux桌面环境存在已知兼容bug，先执行全局卸载重装稳定版：

  npm uninstall -g @google/clasp
  npm install -g @google/clasp@2.3.0
  

  重装完成后删除本地残留的旧鉴权文件：rm ~/.clasprc.json，再重新执行登录命令测试。
• 使用自定义OAuth凭证绕过公共授权流
  进入Google Cloud控制台新建项目，启用Apps Script API，在凭据页创建桌面应用类型的OAuth客户端ID，下载生成的凭证JSON文件，执行以下命令走自定义凭证授权：

  clasp login --creds 本地凭证JSON文件路径
  

  该方式可规避clasp官方公共OAuth客户端的配额限制、风控拦截问题。
• 修复Node 18 IPv6解析兼容问题
  Node 18默认优先解析IPv6地址，会导致本地回调监听失败，执行登录前指定IPv4优先：

  NODE_OPTIONS=--dns-result-order=ipv4first clasp login
  

  同时检查系统防火墙是否拦截clasp临时启动的3000-4000端口段的本地回调服务，可临时关闭防火墙测试，登录完成后再重新启用。
• 关闭Firefox拦截规则
  Firefox v100默认开启的增强型跟踪保护、第三方Cookie拦截会截断授权完成后的回调参数，执行登录前临时关闭增强型跟踪保护，将Google相关域名加入Cookie白名单，不要使用隐私浏览窗口完成授权流程。
• 校验系统时间同步状态
  本地系统时间与标准时间偏差超过5分钟会导致鉴权签名失效，执行命令开启时间同步：

  sudo timedatectl set-ntp true
  

  执行timedatectl status确认System clock synchronized字段显示为yes后，再尝试登录。

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