Laravel Breeze API中邮箱已验证仍返回未验证错误如何解决

核心诱因 #

• 用户表email_verified_at字段未更新：邮箱验证通过后逻辑缺失，没有将该字段写入对应时间戳，系统仍判定用户未验证
• 路由中间件配置异常：受保护路由的中间件顺序错误，verified中间件执行在auth:sanctum之前，无法获取已认证的用户状态
• Sanctum 认证态未同步：用户完成验证前生成的Token关联的用户缓存没有更新，仍读取旧的未验证状态
• 邮箱验证逻辑缺陷：验证链接的签名校验通过后，未执行用户状态更新的逻辑，也未触发官方的邮箱验证事件

排查步骤 #

• 确认数据库字段状态：执行SQL查询SELECT email, email_verified_at FROM users WHERE id = 目标用户ID;，确认email_verified_at是否为非空的合法时间值
• 核对路由中间件配置：检查routes/api.php中受保护路由组的中间件配置，是否按照auth:sanctum在前、verified在后的顺序挂载
• 检查验证接口逻辑：打开app/Http/Controllers/Auth/VerifyEmailController.php，确认验证通过的分支中是否调用了$user->markEmailAsVerified()方法
• 校验请求认证信息：确认访问受保护路由时，请求头是否携带了正确的Authorization: Bearer <Sanctum Token>，Token是否对应已完成验证的用户

修复方案 #

• 字段未更新问题：在邮箱验证通过的逻辑分支中，补充调用$user->markEmailAsVerified()方法，强制更新email_verified_at字段
• 中间件顺序问题：调整路由组中间件顺序，示例配置如下：

Route::middleware(['auth:sanctum', 'verified'])->group(function () {
    // 此处放置需要登录且验证邮箱的业务路由
});

• 认证态未同步问题：用户完成邮箱验证后，调用$user->tokens()->delete()清空现有Token，要求用户重新登录获取新Token，确保状态同步
• 验证逻辑缺陷问题：复用Laravel官方的邮箱验证逻辑，确保签名校验通过后触发Illuminate\Auth\Events\Verified事件，同步更新用户状态

内容的提问来源于stack exchange，提问作者Isaac Newton Aranas