测试Catalyst Function中Stratus时出现OAUTH_SCOPE_MISMATCH错误

问题详情 #

已获取Stratus功能提前访问权限，在Catalyst Node.js高级I/O函数中安装了Beta SDK，执行以下代码初始化并调用存储桶接口：

const bucketInstance = await stratusInstance.bucket("mybucket");
const bucketDetails = await bucketInstance.getDetails();

本地通过catalyst serve命令运行函数时，触发401权限错误：

Error in getting bucket details: {statusCode: 401, code: 'OAUTH_SCOPE_MISMATCH', message: 'invalid oauth scope to access this URL'}

排查与解决步骤 #

• 重新认证CLI并确认权限范围
  本地CLI的认证会话可能未包含Stratus相关权限。执行catalyst login重新登录账号，在授权流程中确保勾选Stratus功能对应的权限范围（如ZohoCatalyst.stratus.read或ZohoCatalyst.stratus.*）。

• 更新Beta SDK至最新版本
  旧版SDK可能存在权限配置缺陷。执行以下命令更新SDK：

  npm update @zohocatalyst/stratus@beta
  

  若更新无效，可重新安装最新Beta版本：

  npm uninstall @zohocatalyst/stratus && npm install @zohocatalyst/stratus@beta --save
  

• 检查存储桶与函数权限配置
  登录Catalyst控制台，确认：

  • 目标Stratus存储桶mybucket已为当前账号分配读取权限；
  • 高级I/O函数所属项目已启用Stratus功能；
  • 函数的执行角色具备访问Stratus服务的权限。

• 升级Catalyst CLI版本
  旧版CLI可能不支持Stratus Beta的权限流程。执行以下命令更新CLI：

  npm update -g zcatalyst-cli
  

  更新完成后，执行catalyst --version确认版本为支持Stratus Beta的最新版。

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