配置Google OAuth2时Appwrite报错：success参数无效

问题分析 #

你遇到的错误是因为Appwrite的OAuth2回调URL校验逻辑需要同时满足两个条件：项目已配置对应的自定义域名，且SDK初始化时使用该自定义域名作为Endpoint。仅添加自定义域名但SDK仍用默认cloud.appwrite.io的话，校验会限制在默认允许的host列表内。

分步解决方案 #

1. 确认自定义域名验证状态

   • 登录Appwrite控制台，进入目标项目 → 设置 → 自定义域名
   • 检查mybot.mywebsite.com的状态是否为已验证：
     • 确保DNS解析记录（CNAME或A记录）已正确配置并生效
     • SSL证书已成功颁发（Appwrite会自动申请Let's Encrypt证书）

2. 修正SDK初始化配置

   • 初始化Appwrite SDK时，必须使用你的自定义域名作为Endpoint，而不是默认的cloud.appwrite.io
   • 以Web SDK为例：

     const client = new Client()
         .setEndpoint('https://mybot.mywebsite.com/v1') // 自定义域名 + /v1路径
         .setProject('你的项目ID');
     

   • 其他语言SDK同理，确保Endpoint指向你的自定义域名接口地址

3. 校验回调URL格式

   • 确保传入createOAuth2Session的success和failureURL完全匹配自定义域名：
     • 无多余的斜杠、空格或大小写错误（URL不区分大小写，但严格匹配可避免意外问题）
     • 正确示例：https://mybot.mywebsite.com/callback.html

4. 刷新配置（自托管场景）

   • 如果你是自部署的Appwrite实例，添加自定义域名后需要重启Appwrite容器，让配置生效：

     docker-compose restart
     

   • 云托管Appwrite无需此操作，但若问题持续，可尝试重新保存自定义域名配置

5. 补充OAuth提供商配置（后续验证）

   • 完成上述步骤后，需确保在Google等OAuth2提供商的控制台中，将https://mybot.mywebsite.com/callback.html添加到授权回调URL列表中，避免后续授权流程出错

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