创建Shopify Checkout UI扩展时遇权限访问错误的问题求助

问题概述 #

开发PHP Shopify应用时，添加Checkout UI扩展触发权限错误：Looks like you need access to this dev store (https://myshopname.myshopify.com)，按提示手动登录商店后台、更换浏览器、尝试其他扩展均无效，仅删除Checkout UI扩展后CLI可正常登录。

排查与解决方案 #

• 检查应用权限范围
  进入Shopify后台的应用设置，确认你的PHP应用已申请并获得write_checkout_ui_extensions（或对应Checkout扩展所需的权限），如果权限缺失，更新应用的权限范围并重新授权。

• 重新授权应用
  在Shopify后台删除当前应用，通过CLI重新执行安装授权流程，确保授权过程中明确勾选Checkout UI扩展相关的权限选项，避免旧令牌缺少扩展权限。

• 校验CLI登录上下文
  执行shopify whoami查看当前CLI绑定的商店，若不是目标开发商店，执行shopify login --store=myshopname.myshopify.com重新指定商店登录，确保上下文匹配。

• 检查扩展配置文件
  查看Checkout UI扩展的extension.config.yml文件，确认商店域名拼写正确，扩展类型设置为checkout_ui_extension，无错误配置项导致权限校验失败。

• 清除CLI缓存

  • macOS/Linux：删除~/.shopify-cli目录
  • Windows：删除%USERPROFILE%\.shopify-cli目录
    清除缓存后重新登录CLI，再尝试添加扩展。

• 确认商店结账扩展设置
  进入开发商店后台设置 > 结账 > 扩展，确认允许第三方应用添加Checkout UI扩展，若有相关限制需手动解除。

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