Laravel注册验证OTP后无法生成Sanctum Token问题排查

核心问题 #

你用DB::table('users')查询返回的是stdClass对象，而createToken()方法是Laravel API认证（比如Sanctum/Passport）给User模型实例提供的方法，原生stdClass没有这个方法，所以报错。

解决步骤 #

1. 确认User模型配置正确
   确保你的User模型引入了HasApiTokens trait，并且继承自Authenticatable，这是生成API Token的前提：

   use Illuminate\Foundation\Auth\User as Authenticatable;
   use Laravel\Sanctum\HasApiTokens;
   
   class User extends Authenticatable
   {
       use HasApiTokens, HasFactory, Notifiable;
   
       // 模型其他代码...
   }
   

2. 替换DB查询为模型查询
   把原来的DB门面查询改成User模型查询，这样得到的是User模型实例，就能调用createToken()了：

   // 错误写法：返回stdClass
   // $user = DB::table('users')->where('phone', $phone)->first();
   
   // 正确写法：返回User模型实例
   $user = User::where('phone', $phone)->first();
   

3. 生成Token的正确示例
   OTP验证通过后，直接用模型实例生成Token：

   // 生成带自定义名称的Token，plainTextToken是前端要用的明文Token
   $token = $user->createToken('mobile_auth_token')->plainTextToken;
   
   return response()->json([
       'access_token' => $token,
       'token_type' => 'Bearer'
   ]);
   

补充说明 #

Laravel的API Token生成依赖模型的trait扩展，只有通过Eloquent模型获取的实例才拥有这些扩展方法，直接用DB门面操作数据库返回的是基础对象，不具备这些能力——这也是你登录逻辑正常（应该是用了模型查询）但注册验证阶段报错的原因。

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