Laravel 5.6自定义用户表内置Auth认证失败问题求助

嘿，我之前也踩过Laravel Auth自定义字段的坑，你的情况很典型——默认的Auth组件硬绑定了email和password字段名，当你的表用了UserEmail和UserPassword这种自定义字段时，必须手动给Auth指认这两个字段才行。咱们一步步来搞定：

1. 调整User模型的认证字段配置 #

Laravel的Authenticatable trait默认依赖email和password字段，所以咱们要在User模型里覆盖两个关键方法，告诉Auth该用哪两个字段：

namespace App;

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

class User extends Authenticatable
{
    use Notifiable;

    // 如果你表名是大写的Users（Laravel默认找小写users），一定要指定表名
    protected $table = 'Users';

    // 定义登录时用的「用户名」字段
    public function username()
    {
        return 'UserEmail';
    }

    // 定义认证时用的「密码」字段
    public function getAuthPassword()
    {
        return $this->UserPassword;
    }

    // 其他模型代码（比如$fillable）保持不变...
}

这里的username()方法是Laravel 5.3+专门用来指定登录标识字段的，而getAuthPassword()则是告诉Auth从哪个字段取哈希后的密码。

2. 确保登录请求的凭证字段匹配 #

如果你的登录表单里的输入框name属性是email和password（比如默认的Auth视图），还需要在LoginController里调整凭证映射，让请求参数对应到你的自定义字段：

namespace App\Http\Controllers\Auth;

use Illuminate\Http\Request;
use App\Http\Controllers\Controller;
use Illuminate\Foundation\Auth\AuthenticatesUsers;

class LoginController extends Controller
{
    use AuthenticatesUsers;

    // ...其他默认代码

    // 覆盖默认的credentials方法，返回正确的字段映射
    protected function credentials(Request $request)
    {
        return [
            'UserEmail' => $request->input('email'),
            'UserPassword' => $request->input('password')
        ];
    }
}

如果你的表单输入框name已经是UserEmail和UserPassword，这一步可以跳过，但大部分情况默认表单用的是email和password，所以这个映射很有必要。

3. 检查密码哈希与数据库字段的正确性 #

你用Hash::make('1234')生成哈希是对的，但要注意两个细节：

• 确保UserPassword字段的数据库类型是VARCHAR(255)，Laravel的BCrypt哈希值长度在60左右，字段太短会导致哈希值被截断，直接匹配失败；
• 用Hash::check('1234', $user->UserPassword)手动验证一下哈希是否正确——比如在tinker里执行：

  $user = App\User::first();
  var_dump(Hash::check('1234', $user->UserPassword));
  

  如果返回true，说明哈希没问题，问题出在Auth的字段配置上；如果返回false，那就是哈希生成或存储的环节出了问题。

4. 调试认证过程的小技巧 #

可以在登录逻辑里打印出传给Auth::attempt()的凭证数组，确认字段名和值都正确：

// 比如在LoginController的login方法里或者路由里测试
$credentials = [
    'UserEmail' => '你的测试邮箱',
    'UserPassword' => '1234'
];
var_dump($credentials); // 确认字段名是UserEmail和UserPassword，值正确
var_dump(Auth::attempt($credentials));

这样能快速定位是凭证传错了，还是Auth的配置没生效。

按上面的步骤调整后，应该就能正常通过Auth::attempt()完成登录认证了。

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