装不上 firebase/php-jwt 主因是 PHP 版本低于 7.4 或未启用 openssl 扩展；JWT::encode() 报 “Key must be a string” 是因传入路径而非密钥内容；JWT::decode() 错误模糊需检查算法、Key 对象、时间戳及时区；JWT payload 不可存敏感信息，且无法主动作废，需自行实现黑名单。
composer require firebase/php-jwt 装不上？先确认 PHP 版本和 OpenSSL
装不上 firebase/php-jwt，八成不是命令写错，而是环境卡住了。这个库最低要求 PHP 7.4，且必须启用 openssl 扩展——没开的话，composer require 会静默失败或报一堆依赖冲突，但错误信息里根本不会提“openssl”。
实操建议：
- 运行
php -v确认 PHP 版本 ≥ 7.4； - 运行
php -m | grep openssl（Linux/macOS）或php -m（Windows，手动搜openssl）确认扩展已加载； - 如果没启用，去
php.ini解开;extension=openssl这行的注释，重启 Web 服务或 CLI 环境； - 再试
composer require firebase/php-jwt:^6.10（推荐锁定 v6.x，v7+ 强制要求 PHP 8.1+ 且签名方式有变）。
JWT::encode() 报 “Key must be a string”？私钥/公钥路径没读对
firebase/php-jwt 的 JWT::encode() 不接受文件路径字符串，只接受**实际加载后的密钥内容**。很多人直接传 './key.pem'，结果报错 Key must be a string，其实是把路径当密钥用了。
实操建议：
- 用
file_get_contents('./key.pem')显式读取密钥内容； - 如果是 RSA 私钥，确保 PEM 文件包含完整头尾（
-----BEGIN PRIVATE KEY-----和-----END PRIVATE KEY-----），中间不能有空行或 BOM； - 别用
base64_encode(file_get_contents())—— 这是常见误解，库内部不处理 base64，它要的是原始 PEM 字符串； - 示例：
$token = JWT::encode($payload, file_get_contents('./private.key'), 'RS256');
JWT::decode() 验证失败却没报具体错？检查算法、密钥和时间戳
JWT::decode() 默认只抛出 DomainException 或 InvalidArgumentException，错误信息极简，比如 “Invalid token” 或 “Expired token”，根本看不出是算法不匹配、密钥不对，还是 nbf/exp 时间越界。
实操建议：
- 验证前先用
JWT::getPayload($token)提前看解码后的时间字段（iat,nbf,exp），确认是否过期或未生效； - 明确传入
new \Firebase\JWT\Key($publicKey, 'RS256')，别只传字符串——v6.9+ 后强制要求Key对象，否则会静默降级为 HMAC 验证逻辑； - 注意时区：PHP 默认用服务器本地时间比对
exp，如果服务器时间和客户端差太多，验证必失败； - 调试时临时加
ini_set('display_errors', '1');，让异常堆栈露出来。
Token 里放用户 ID 还是用户名？别在 payload 存敏感字段
JWT 是 Base64Url 编码，**不是加密**，任何人都能解码查看 payload 内容。把密码哈希、手机号、邮箱明文塞进 JWT::encode() 的 $payload，等于公开广播。
实操建议：
- 只放必要标识：如
'uid' => 123或'role' => 'admin'，且后端必须二次查库校验权限； - 绝对不要放
'email' => 'xxx@xx.com'、'phone' => '138...'这类可识别个人身份的字段； - 如果真需要传递少量敏感信息，用
firebase/php-jwt不支持的 JWE（加密 JWT），换web-token/jwt-framework； - 记得设短
exp（比如 30 分钟），配合 refresh token 机制，而不是靠长有效期硬扛。
最常被忽略的一点：JWT 一旦签发就无法主动作废，黑名单逻辑得自己实现，别以为删了客户端 token 就安全了。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
