Laravel中如何移除主键前缀？认证时主键出现user_前缀问题

看起来你已经给User模型配置了主键和表名，但认证系统还是莫名给主键加上了user_前缀，别慌，咱们一步步排查解决：

1. 补全模型的主键相关配置 #

首先确认你的User模型配置是否完整，尤其是当主键不是自增整数时，需要额外声明：

class User extends Authenticatable {
    use Notifiable;

    /**
     * 关联的数据表
     *
     * @var string
     */
    protected $table = 'Users';

    /**
     * 模型的主键字段
     *
     * @var string
     */
    protected $primaryKey = 'UserId';

    // 若主键不是自增ID（比如字符串类型的UUID），添加这一行
    protected $incrementing = false;

    // 若主键是字符串类型，添加这一行
    protected $keyType = 'string';
}

2. 显式重写认证标识符名称方法 #

Laravel的Authenticatable trait默认会读取模型的主键名作为认证标识符，但偶尔会因为命名转换逻辑出现偏差，你可以在User模型里直接重写方法，强制指定主键名：

/**
 * 获取用户的唯一标识字段名
 *
 * @return string
 */
public function getAuthIdentifierName()
{
    return 'UserId';
}

3. 核对认证配置文件 #

检查config/auth.php里的用户提供者配置，确保指向的是你当前使用的User模型：

'providers' => [
    'users' => [
        'driver' => 'eloquent',
        'model' => App\User::class, // 确认这个模型路径完全正确
    ],
],

4. 清除配置缓存 #

有时候Laravel的配置缓存会导致新的模型设置无法生效，运行以下命令清空缓存：

php artisan config:clear
php artisan cache:clear

完成以上步骤后，Laravel认证系统应该就会直接使用Users.UserId作为主键标识，不会再自动添加user_前缀了。

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