🔧 修复 Token 错误

快速解决 "CAN_NOT_GET_GATEWAY_SERVER" 错误

❌ AgoraRTCError CAN_NOT_GET_GATEWAY_SERVER: dynamic use static key
⚠️ 错误原因: 你的 Agora 项目启用了安全模式(需要 Token),但加入频道时没有提供有效的 Token。

✅ 方案 1:切换到调试模式(最简单)

适用场景: 测试和开发环境

  1. 登录 Agora Console
    访问 https://console.agora.io 并登录
  2. 进入项目管理
    点击左侧菜单的"项目管理"
  3. 找到你的项目
    在项目列表中找到你正在使用的项目
  4. 点击配置按钮
    点击项目右侧的"配置"或"编辑"按钮
  5. 关闭 App 证书
    找到"主要证书"或"App 证书"部分
    如果显示"已启用",点击"禁用"按钮
    确认禁用操作
  6. 等待生效
    等待 2-3 分钟让设置生效
  7. 重新测试
    刷新页面,重新加入房间(Token 留空)
✅ 完成! 现在你可以不使用 Token 直接加入房间了。
返回应用

🔑 方案 2:使用临时 Token

适用场景: 快速测试,不想修改项目设置

  1. 进入项目详情
    在 Agora Console 的项目列表中,点击项目名称
  2. 找到 Token 生成器
    找到"临时 Token 生成器"或"生成临时 Token"部分
  3. 填写信息
    • 频道名称:输入你要加入的房间名称(例如:room001
    • UID:填 0(表示自动分配)
  4. 生成 Token
    点击"生成临时 Token"按钮
  5. 复制 Token
    复制生成的 Token 字符串(一长串字符)
  6. 使用 Token
    在登录页面的 Token 输入框中粘贴
    重要: 确保频道名称与生成 Token 时使用的名称完全一致
  7. 加入房间
    点击"加入房间"按钮
⚠️ 注意: 临时 Token 有效期为 24 小时,过期后需要重新生成。
返回应用

🚀 方案 3:部署 Token 服务器

适用场景: 生产环境(必须)

生产环境必须使用 Token 服务器来动态生成 Token,不能使用临时 Token。

  1. 克隆 Token 服务器项目
    git clone https://github.com/AgoraIO-Community/agora-token-service.git
  2. 安装依赖
    npm install
  3. 配置环境变量
    创建 .env 文件,填入你的 App ID 和 App Certificate
  4. 启动服务
    npm start
  5. 集成到应用
    修改应用代码,从 Token 服务器获取 Token

详细步骤请查看:

查看部署文档 Token 服务器项目

💡 常见问题

Q: 我应该选择哪个方案?

测试/开发: 使用方案 1(调试模式)最简单

演示/短期: 使用方案 2(临时 Token)

生产环境: 必须使用方案 3(Token 服务器)

Q: 关闭 App 证书后还是报错?

设置可能需要 2-3 分钟才能生效,请耐心等待。如果还是不行,尝试:

  • 清除浏览器缓存
  • 使用隐身模式重试
  • 检查是否选择了正确的项目
Q: 频道名称必须一致吗?

是的! 使用临时 Token 时,生成 Token 时使用的频道名称必须与加入频道时使用的名称完全一致(区分大小写)。

Q: 临时 Token 过期了怎么办?

临时 Token 有效期为 24 小时。过期后需要重新生成。如果需要长期使用,建议:

  • 使用调试模式(测试环境)
  • 部署 Token 服务器(生产环境)

需要更多帮助?

完整故障排查指南 项目文档 Agora 官方文档