Firebase php-jwt添加JWT额外声明时抛出UnexpectedValueException异常求助

首先明确：Firebase的php-jwt库完全支持标准JWT声明（包括exp、sub）和自定义声明，你遇到的UnexpectedValueException: Wrong number of segments错误，本质是解析的token格式不合法（不是标准的三段式JWT结构），和声明的数量/类型无关。

下面是具体的排查和解决步骤：

1. 先确认Token生成环节是否正确 #

你贴出了token的payload数组，但没展示生成最终JWT的代码，务必确保你调用了库的JWT::encode方法，示例如下：

$key = "example_key";
// 你的payload数组
$token = array(
    "iss" => "http://example.com",
    "aud" => "http://example.com",
    "iat" => $issuedAt,
    "nbf" => $notBefore,
    "exp" => $expire,
    "gate" => "kanchanjuri",
    "tokenId" => $tokenId
);
// 生成JWT
$jwt = JWT::encode($token, $key);
// 打印生成的token，检查格式是否为三段式（两个英文点分隔）
var_dump($jwt);

正常的JWT格式应该是xxxx.yyyy.zzzz，如果输出不是这种结构，说明生成环节出错了。

2. 检查Token传输过程是否被篡改/截断 #

客户端（APP端）排查 #

在APP端发送请求前，打印完整的Authorization头内容，确认是"Bearer " + 完整的token，没有多余的空格、换行或转义字符：

String authHeader = "Bearer " + token;
Log.d("JWT_DEBUG", "Authorization Header: " + authHeader);
// 再发送请求
con.addRequestProperty("Authorization", authHeader);

如果打印的header里token不完整或有异常字符，说明客户端拼接token时出了问题。

服务端排查 #

在服务端提取token后，立即打印提取到的内容，确认和客户端生成的token完全一致：

if (!empty($headers)) {
    if (preg_match('/Bearer\s(\S+)/', $headers, $matches)) {
        $jwt = $matches[1];
        // 打印提取到的token
        var_dump($jwt);
    }
}

如果这里的$jwt和生成的token不一致（比如被截断），说明提取逻辑有问题。可以把正则表达式替换成更可靠的字符串截取方式：

if (strpos($headers, 'Bearer ') === 0) {
    $jwt = substr($headers, 7); // 跳过"Bearer "的7个字符
}

原正则的\S+会匹配到第一个空白字符为止，如果token意外包含空白（比如生成时的换行），就会只提取一部分，导致格式错误。

3. 排查TokenId生成的潜在问题 #

你用mcrypt_create_iv(32)生成随机值，然后base64_encode，但mcrypt扩展已经在PHP 7.1+被废弃，建议换成random_bytes：

// 生成安全的随机字节
$tokenBytes = random_bytes(32);
// 转成Base64URL格式（JWT要求的编码格式）
$tokenId = str_replace(['+', '/', '='], ['-', '_', ''], base64_encode($tokenBytes));

虽然原代码不会直接导致格式错误，但换成标准的Base64URL编码可以避免潜在的字符冲突问题。

4. 验证Token格式 #

把生成的token复制到本地的JWT解析脚本中，确认能正常拆分出Header、Payload、Signature三个部分，如果解析失败，说明生成的token本身就不合法。

总结：这个问题和php-jwt支持的声明无关，核心是token在生成、传输或提取环节出现了格式损坏，按照上面的步骤逐一排查就能解决。

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