Firebase报错custom token格式不正确，原有可用代码无法运行如何解决？

你使用的初始化代码本身符合官方规范，此前可正常运行说明报错和核心初始化逻辑无关，可按照以下优先级逐一排查：

• 校验服务账号凭证文件有效性
  首先确认serviceAccountKey.json的读取路径是否正确，有没有因为部署环境目录调整导致读取到错误文件。再检查文件内的*private_key、client_email、project_id*三个核心字段是否完整，private_key内的\n转义符是否被意外修改、有没有额外的前后空格，确认凭证文件和你当前使用的Firebase项目匹配，没有错用其他项目的凭证。如果近期你在控制台轮换过服务账号密钥，直接重新下载新的JSON文件替换即可。
• 检查firebase-admin依赖版本
  排查近期是否升级过firebase-admin包，不同大版本的JWT签发规则存在兼容性差异，浮动版本号可能导致自动升级后出现兼容问题。可将依赖回滚到此前正常运行的固定版本，执行命令npm install firebase-admin@<历史正常版本号>后重新测试。
• 同步服务器系统时间
  自定义令牌本质是JWT格式，依赖签发时间iat和过期时间exp校验，如果服务器/本地开发设备的系统时间和标准时间误差超过5分钟，Firebase服务端会直接判定令牌格式非法，将系统时间和NTP时间同步后再测试。
• 校验令牌生成与传递逻辑
  确认createCustomToken方法的入参符合要求：用户uid必须是不超过128字符的字符串，不能包含非法字符；自定义声明参数不能包含iss、sub、iat等JWT保留字段。另外确认令牌传递到客户端的过程中没有被截断、自动添加转义符或者额外的前后空格。
• 本地测试令牌有效性
  可运行以下最小测试代码，打印生成的令牌手动校验格式：

  admin.auth().createCustomToken('test-uid-001')
    .then(customToken => {
      console.log('生成的自定义令牌：', customToken)
      // 正常令牌为三段以「.」分隔的字符串，可直接判断格式是否正确
    })
    .catch(err => console.error('生成令牌报错：', err))
  

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