为什么iOS应用使用Node.js生成的Agora令牌无法完成RTC认证

问题根因 #

你遇到的鉴权失败无响应问题核心是iOS端请求令牌的参数和实际加入频道的参数不匹配，具体有2处错误：

1. 令牌请求路径错误：Node服务暴露的令牌生成接口是/access_token，但iOS端拼接URL时没有加该路径，且参数后多余拼接了斜杠，导致生成令牌时使用的channelName、uid值末尾都带斜杠，和你调用joinChannel时传入的原始值完全不一致，Agora服务校验令牌不通过，自然不会触发回调。
2. 令牌角色未对齐：你当前请求令牌时没有传递rtcrole参数，Node服务默认生成的是听众（SUBSCRIBER）权限的令牌，如果你后续切换为主播角色，会出现权限不足问题。

修复方案 #

1. 修复iOS端AgoraToken的URL拼接逻辑 #

替换原来的硬拼接URL逻辑，使用URLQueryItem拼接参数，自动处理特殊字符编码，同时补全接口路径，移除多余斜杠：

static func fetchToken(
    urlBase: String, channelName: String, uid: UInt, role: AgoraClientRole,
    callback: @escaping (Result<String, Error>) -> Void
) {
    var components = URLComponents(string: urlBase)
    components?.path = "/access_token"
    // 拼接参数，自动处理编码
    components?.queryItems = [
        URLQueryItem(name: "channelName", value: channelName),
        URLQueryItem(name: "uid", value: "\(uid)"),
        URLQueryItem(name: "rtcrole", value: role == .broadcaster ? "publisher" : "subscriber")
    ]
    guard let fullURL = components?.url else {
        callback(.failure(TokenError.invalidURL))
        return
    }
    // 原有剩余请求逻辑保持不变
    print("fullURL yields \(fullURL)")
    var request = URLRequest(
        url: fullURL,
        timeoutInterval: 10
    )
    request.httpMethod = "GET"
    // 后续dataTask逻辑不变
    // ...
}

2. 调整调用fetchToken的传参 #

在调用获取令牌的方法时，传入当前的用户角色：

// joinChannelWithFetch方法内的调用修改为：
AgoraToken.fetchToken(
    urlBase: tokenBaseURL,
    channelName: self.channelName,
    uid: self.rtcId,
    role: rtckit.getClientRole()
) { result in
    // 原有结果处理逻辑不变
}

3. 可选优化：角色切换时自动刷新令牌 #

你可以在didClientRoleChanged回调里补充令牌刷新逻辑，避免切换主播时权限不足：

func rtcEngine(
    _ engine: AgoraRtcEngineKit,
    didClientRoleChanged oldRole: AgoraClientRole,
    newRole: AgoraClientRole
) {
    print("AgoraRtcEngineDelegate didClientRoleChanged triggered...old role: \(oldRole), new role: \(newRole)")
    // 角色变化后刷新令牌
    AgoraToken.fetchToken(
        urlBase: tokenBaseURL, channelName: self.channelName, uid: self.rtcId, role: newRole
    ) { result in
        switch result {
        case .failure(let err):
            print("刷新令牌失败：\(err)")
        case .success(let newToken):
            self.updateToken(newToken)
        }
    }
}

修改完成后重新测试，即可正常触发joinChannel回调，完成鉴权。

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