自定义表名与字段名的Laravel Auth登录异常排查

这个报错Undefined index: password的核心原因是：Laravel的默认认证系统会期望用户模型中存在password字段，但你的表用的是user_pwd，所以我们需要明确告诉认证系统使用哪个字段作为密码，同时调整登录相关的配置适配自定义字段。

下面是一步步的解决方案：

1. 定义密码字段映射（解决核心报错） #

在你的User模型中添加getAuthPassword()方法，这是Laravel认证契约要求的方法，用来指定认证时使用的密码字段：

public function getAuthPassword()
{
    return $this->user_pwd;
}

添加这个方法后，EloquentUserProvider就会从user_pwd字段获取密码，而不是默认的password，直接解决Undefined index: password的问题。

2. 配置登录标识字段（适配user_name/user_email） #

如果你的登录逻辑是用user_email或user_name而不是默认的email，需要在User模型中添加username()方法来指定登录使用的字段：

// 如果用邮箱登录
public function username()
{
    return 'user_email';
}

// 如果用用户名登录，改成下面这样
// public function username()
// {
//     return 'user_name';
// }

这个方法会告诉Laravel的登录控制器，用哪个字段作为用户的登录标识。

3. 完善模型配置（确认已有设置） #

你已经配置的$table、$fillable、$hidden是正确的，这里再确认一遍完整的模型示例，确保没有遗漏：

namespace App\Models;

use Illuminate\Foundation\Auth\User as Authenticatable;
use Illuminate\Notifications\Notifiable;

class User extends Authenticatable
{
    use Notifiable;

    // 指定自定义表名
    protected $table = 'tb_users';

    // 允许批量赋值的字段
    protected $fillable = [
        'user_name', 'user_email', 'user_pwd',
    ];

    // 隐藏敏感字段（不会在API/JSON响应中返回）
    protected $hidden = [
        'user_pwd', 'remember_token',
    ];

    // 自定义认证密码字段
    public function getAuthPassword()
    {
        return $this->user_pwd;
    }

    // 自定义登录标识字段（根据你的登录逻辑选择）
    public function username()
    {
        return 'user_email';
    }
}

4. 调整登录与注册的逻辑适配 #

登录控制器（LoginController） #

默认的LoginController会验证email和password字段，我们需要调整验证规则适配自定义字段，重写validateLogin方法：

use Illuminate\Http\Request;

protected function validateLogin(Request $request)
{
    $request->validate([
        $this->username() => 'required|string',
        'password' => 'required|string',
    ]);
}

这样不管你用user_email还是user_name作为登录标识，都能正确验证。

注册逻辑 #

注册用户时，务必使用Hash::make()加密密码后存入user_pwd字段，比如在注册控制器中：

use Illuminate\Support\Facades\Hash;

// ...

$user = User::create([
    'user_name' => $request->input('user_name'),
    'user_email' => $request->input('user_email'),
    'user_pwd' => Hash::make($request->input('password')),
]);

完成以上配置后，你的自定义用户表就能正常适配Laravel的Auth系统了，不会再出现密码字段未定义的错误。

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