CakePHP认证插件返回空Identity对象问题求助

我之前也碰到过类似的JWT认证后拿不到用户Identity的问题，结合你给出的环境（CakePHP 3.5.14 + 官方JWT插件v1.0.0-rc4），咱们一步步排查可能的原因：

既然令牌生成和验证都正常，问题大概率出在用户身份解析的环节，以下是几个关键检查点：

1. 确认Auth组件的ORM解析器配置 #

确保你在AppController或对应控制器里的Auth组件配置，正确启用了ORM解析器的数据库查询功能：

$this->loadComponent('Auth', [
    'storage' => 'Memory', // API场景必须用Memory存储，不能用Session
    'authenticate' => [
        'ADmad/JwtAuth.Jwt' => [
            'userModel' => 'Users', // 必须和你的模型名一致，注意大小写
            'fields' => ['id' => 'id'],
            'parameter' => 'token',
            'queryDatasource' => true, // 这个参数是核心！设为false只会解析令牌ID，不会查数据库
        ]
    ],
    'unauthorizedRedirect' => false,
    'checkAuthIn' => 'Controller.initialize',
]);

重点检查queryDatasource，如果不小心设为false，插件只会解析令牌里的用户ID，不会去数据库拉取完整用户数据，自然返回空Identity。

2. 验证JWT令牌中的用户ID有效性 #

生成令牌时，要确保存入sub字段（插件默认的用户ID字段）的是数据库中存在的用户ID：

use Firebase\JWT\JWT;

// 生成令牌的示例代码
$token = JWT::encode([
    'sub' => $user->id, // 这里必须是users表中存在的有效ID
    'exp' => time() + 3600 // 过期时间
], Configure::read('Security.salt'));

如果令牌里的sub对应的用户不存在，ORM解析器查询不到数据，就会返回空Identity。

3. 检查User模型的主键配置 #

你的users表主键是id，要确保User模型没有修改默认主键设置。如果模型里手动指定了其他主键，会导致查询失败：

// 错误示例，如果没写这段就忽略
public $primaryKey = 'user_id';

4. 确认控制器中正确调用认证逻辑 #

在需要认证的控制器方法或beforeFilter里，要确保执行了身份识别并设置用户：

if ($user = $this->Auth->identify()) {
    $this->Auth->setUser($user);
    // 这里的$user应该包含完整的用户数据，可var_dump($user)调试
} else {
    // 认证失败的处理逻辑
}

5. 开启查询日志调试 #

如果以上都没问题，开启CakePHP的查询日志，看看ORM解析器是否执行了用户查询：
在config/app.php的数据源配置中开启日志：

'Datasource' => [
    'default' => [
        // 其他配置项
        'log' => true,
    ],
],

然后查看日志：如果没有查询users表的语句，说明queryDatasource未启用或解析器未触发；如果有查询但无结果，说明令牌里的用户ID无效。

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