Flutter集成Agora SDK遇Error code 100：appkey is invalid错误求助

开发者阿泽

2026-7-19

解决Flutter集成Agora Chat SDK时"Error code 100, appkey is invalid"问题

错误码100本质是App Key验证失败，结合你的代码和排查情况，可以从以下几个方向再深挖：

核对App Key的完整性与格式
Agora Chat的App Key格式是前缀#后缀，必须包含中间的#分隔符。检查你代码里的b0fc8da1f9304*************是否完整复制了控制台生成的密钥，有没有漏掉后半段、多了空格或特殊字符。另外注意别把实时音视频的App ID当成Chat的App Key用，两者是不同凭证。
验证Token的生成匹配性
你用loginWithAgoraToken登录，这个Token必须是基于当前App Key和指定userId生成的。如果Token是用其他App Key生成的，哪怕userId正确也会验证失败。可以临时改用账号密码登录（控制台需开启该功能）测试，或者重新生成对应参数的Token。

调整初始化与登录的执行顺序
确保SDK初始化完成后再执行登录操作，避免异步调用导致的时序问题。可以把初始化和登录逻辑合并成一个流程：

void _setupAgoraChat() async {
  // 先完成SDK初始化
  ChatOptions options = ChatOptions(
    appKey: AgoraChatConfig.appKey,
    autoLogin: false,
  );
  await ChatClient.getInstance.init(options);
  
  // 再执行登录
  try {
    await ChatClient.getInstance.loginWithAgoraToken(
      AgoraChatConfig.userId,
      AgoraChatConfig.agoraToken,
    );
    _addLogToConsole("login succeed, userId: ${AgoraChatConfig.userId}");
  } on ChatError catch (e) {
    _addLogToConsole("login failed, code: ${e.code}, desc: ${e.description}");
  }
}

排查字符转义问题
代码里的App Key用了"转义，虽然Dart静态常量支持这种写法，但可以直接换成普通双引号试试，避免转义带来的隐性编码问题：
```
static const String appKey = "b0fc8da1f9304*************";
```
确认平台网络权限配置
检查Android的AndroidManifest.xml是否添加了网络权限：
```
<uses-permission android:name="android.permission.INTERNET"/>
```
iOS的Info.plist确保没有限制HTTPS请求（默认允许，若有特殊配置需调整）。