Laravel登录异常：凭证（document）超过10字符时无法登录

看起来你遇到的问题核心是对Auth::loginUsingId()方法的使用场景理解有误，咱们一步步拆解解决：

问题根源 #

Auth::loginUsingId()方法的设计初衷是通过用户模型的主键ID来完成登录，而不是自定义的document字段。如果你的users表主键是默认的自增id（整数类型，通常最多存10位数字），当你把长度超过10字符的document传给这个方法时：

• 如果document是数字字符串，会被强制转换为整数，导致值截断或失真，无法匹配到正确的用户；
• 如果document包含非数字字符，转换后会变成0，自然找不到对应用户。
  因为你没有添加用户不存在的判断逻辑，所以登录失败后只会返回登录视图，没有任何错误提示。

解决方案 #

方案1：通过document字段查找用户后登录（推荐） #

放弃直接使用loginUsingId()，改为先通过document字段定位用户，再调用Auth::login()完成登录，同时添加错误处理：

public function login(Request $request)
{
    // 先做表单验证，确保输入合法
    $request->validate([
        'document' => 'required|string',
    ]);

    $user = User::where('document', $request->document)->first();

    if ($user) {
        Auth::login($user);
        // 跳转到用户原本想要访问的页面，或者指定的仪表盘
        return redirect()->intended('/dashboard');
    }

    // 如果用户不存在，返回登录页并携带错误信息
    return back()->withErrors([
        'document' => '无效的登录凭证，请检查后重试',
    ]);
}

方案2：将document设为用户模型的主键（仅当业务需要时） #

如果你的业务逻辑确实需要把document作为用户表的主键，需要修改User模型的配置：

namespace App\Models;

use Illuminate\Foundation\Auth\User as Authenticatable;

class User extends Authenticatable
{
    // 指定主键为document字段
    protected $primaryKey = 'document';
    // 主键类型为字符串
    protected $keyType = 'string';
    // 关闭自增（因为document不是自增整数）
    public $incrementing = false;

    // ...其他模型代码
}

修改后，你可以继续使用Auth::loginUsingId($request->document)，但依然建议添加用户存在性判断，避免无提示的失败：

$user = User::find($request->document);
if ($user) {
    Auth::loginUsingId($request->document);
    return redirect()->intended('/dashboard');
}
return back()->withErrors(['document' => '无效的登录凭证']);

额外提示 #

• 确保你的users表中document字段是唯一索引，避免出现重复值导致登录逻辑混乱；
• 登录视图中要记得显示错误信息，比如添加：

@error('document')
    <div class="text-red-500">{{ $message }}</div>
@enderror

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