CakePHP 4.2.9 认证模块自定义finder未生效无法关联Userdata表

问题根源 #

• 你同时加载了CakePHP 4新的Authentication插件和已废弃的旧Auth组件，你将自定义finder的配置写在了旧Auth组件中，实际生效的是新Authentication插件，自然不会读取旧组件的配置
• 新插件的密码标识符没有配置自定义finder参数，不会自动调用你写的findAuth方法
• 新旧认证逻辑的用户名字段配置不一致，旧组件配置的是fmail，新插件配置的是email，会出现字段匹配错误

解决步骤 #

1. 移除AppController.php中加载旧Auth组件的全部代码，旧Auth组件在CakePHP 4中已被官方废弃，同时加载两套认证组件会造成逻辑冲突，最终完整AppController初始化代码如下：

public function initialize(): void
{
    parent::initialize();

    $this->loadComponent('RequestHandler');
    $this->loadComponent('Flash');
    $this->loadComponent('Authentication.Authentication');
}

2. 修改src/Application.php中的密码标识符配置，新增自定义finder参数，指定调用UsersTable中定义的auth finder：

$authenticationService->loadIdentifier('Authentication.Password', [
    'fields' => [
        'username' => 'email', // 此处保持和你实际用于登录的用户名字段一致
        'password' => 'password',
    ],
    'resolver' => [
        'className' => 'Authentication.Orm',
        'finder' => 'auth'
    ]
]);

3. 确认UsersTable.php中Userdata关联配置的外键符合实际表结构：如果Userdata表关联users表的外键不是默认的user_id，需要手动指定外键字段：

// 示例：外键为user_id时无需额外配置，非默认值按如下格式修改
$this->hasOne('Userdata', [
    'foreignKey' => '你的实际外键字段名'
]);

配置完成后重新测试登录，查询语句会自动调用findAuth方法关联Userdata表。

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