Agora Token生成报错：could not handle the request 问题排查求助

错误原因排查 #

以下是代码中导致请求处理失败的核心问题：

• 角色导入错误：agora-access-token包中角色的正确导出是RtcRole，代码中误写为RctRole，导致无法识别角色常量。
• 中间件参数顺序错误：nocache中间件参数顺序应为(req, res, next)，代码中写反成(res, resp, next)，且未调用next()，导致请求被挂起。
• 响应对象混淆：generateAccessToken函数中错误使用req（请求对象）调用status()和json()方法，这些方法属于resp（响应对象）。
• CORS头拼写错误：Acess-Control-Allow-Origin拼写错误，且已通过app.use(cors({origin: true}))配置CORS，无需重复设置。
• Firebase初始化错误：Firebase Functions环境中，admin.initializeApp()无需传入额外参数，默认会自动加载配置。
• 变量名拼写错误：privilegeExpiereTime应为privilegeExpireTime，虽不影响功能，但不符合代码规范。

修正后的完整代码 #

const { RtcTokenBuilder, RtcRole } = require("agora-access-token");
const admin = require("firebase-admin");
const express = require("express");
const cors = require("cors");

// Firebase Functions环境下无需额外参数初始化
admin.initializeApp();
const firestore = admin.firestore();
const app = express();

const appId = "83....c";
const appCertificate = "8d....5";
app.use(cors({ origin: true }));

const nocache = (req, res, next) => {
  res.header("Cache-Control", "private, no-cache, no-store, must-revalidate");
  res.header("Expires", "-1");
  res.header("Pragma", "no-cache");
  next(); // 必须调用next()传递请求
};

const generateAccessToken = (req, resp) => {
  const channelName = req.query.channelName;
  if (!channelName) {
    return resp.status(400).json({ "error": "channel Name is required" });
  }

  let uid = req.query.uid;
  if (!uid || uid === "") {
    uid = 0;
  } else {
    uid = parseInt(uid, 10); // 转为数值类型符合Agora要求
  }

  let role = RtcRole.SUBSCRIBER;
  if (req.query.role === "publisher") {
    role = RtcRole.PUBLISHER;
  }

  let expireTime = req.query.expireTime;
  if (!expireTime || expireTime === "") {
    expireTime = 3600;
  } else {
    expireTime = parseInt(expireTime, 10);
  }

  const currentTime = Math.floor(Date.now() / 1000);
  const privilegeExpireTime = currentTime + expireTime;

  const token = RtcTokenBuilder.buildTokenWithUid(appId, appCertificate, channelName, uid, role, privilegeExpireTime);
  return resp.json({ "token": token });
};

app.get("/access_token", nocache, generateAccessToken);
exports.tokenAgora = functions.https.onRequest(app);

额外注意事项 #

1. 确保已安装全部依赖：npm install agora-access-token firebase-admin express cors
2. 通过firebase functions:log查看详细部署日志，定位隐藏问题
3. 确认Agora的appId和appCertificate无拼写错误

内容的提问来源于stack exchange，提问作者Gbenga B Ayannuga