使用扩展返回的OAuth凭证生成Token时出现401错误

针对你遇到的「应用安装返回的密钥无法生成OAuth Token，但手动创建的访问密钥可以」的401问题，可以按以下步骤排查：

• 核对应用权限配置

  1. 进入Shopware后台「设置 > 系统 > 集成」，找到该应用对应的集成条目，确认权限范围是否包含OAuth相关权限（如oauth、write等），且权限未被误禁用。
  2. 如果近期修改过应用的权限声明，需卸载并重新安装应用，确保权限同步生效。

• 验证OAuth请求参数与格式

  1. 确认请求Token的端点为/api/oauth/token，且请求域名与当前Shopware环境匹配（区分开发/生产环境）。
  2. 检查请求的grant_type是否为client_credentials，这是Shopware应用获取Token的标准授权类型，同时确保client_id、client_secret完全匹配安装响应返回的值，没有字符遗漏或拼写错误。
  3. 确保请求头设置了Content-Type: application/x-www-form-urlencoded，所有参数按表单格式编码提交，而非JSON格式。

• 检查集成状态与密钥有效性

  1. 确认应用对应的集成状态为「活跃」，若状态为「未激活」或「已禁用」，会直接导致401权限错误。
  2. 对比手动创建的集成与应用生成的集成的权限列表，检查是否存在关键权限缺失（如API访问权限、OAuth权限）。
  3. 若怀疑密钥被篡改，可卸载应用后重新安装，获取新的密钥再测试。

• 查看Shopware日志定位具体原因

  1. 查看Shopware的日志文件（生产环境为var/log/prod.log，开发环境可直接查看后台日志面板），日志中会记录401错误的具体原因，比如「权限不足」「无效的客户端凭证」等，帮助精准定位问题。

• 排查版本更新带来的逻辑变化

  1. 若近期升级了Shopware版本，查阅对应版本的官方文档，确认OAuth2凭证生成流程是否有调整，比如权限范围、请求签名要求等。

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