You need to enable JavaScript to run this app. Laravel Sanctum与Fortify结合使用方法及Laravel8 API登录配置
优惠活动
大模型
产品
解决方案
定价
更多

Laravel Sanctum与Fortify结合使用方法及Laravel8 API登录配置

核心路由选型实操判断
  • 首先说个很多人踩过的坑:Fortify默认提供的/login路由,本质是为Jetstream配套的Blade服务端渲染流程设计的。如果你把自研登录页的表单action直接指向这个路由,做传统的页面跳转提交,后端会直接返回完整的Blade HTML页面,走的是Session会话鉴权逻辑,你之前写的jQuery异步交互、登录态处理逻辑会全部失效。
  • 不是说不能用Fortify提供的/login接口,而是绝对不能用传统表单跳转的方式用,换对了请求方式,这个接口其实是最省开发成本的选择。
登录环节访问令牌的落地生成位置

这里直接给两个经过实际项目验证的落地方案,不用零散找资料拼凑逻辑:

  1. 零开发成本的复用方案(最推荐,适合大部分团队)
    直接复用Fortify内置的POST /login接口,根本不需要自己写账号校验逻辑。只要你的jQuery发请求的时候,主动带上Accept: application/json请求头,Fortify就会自动跳过Blade视图返回逻辑,校验完账号密码之后,自动对接Sanctum生成访问令牌,以JSON结构返回给你。
    实际的jQuery请求写法参考:
    $.ajax({
      url: '/login',
      method: 'POST',
      headers: {
        'Accept': 'application/json' // 这个头是触发Fortify返回JSON的核心
      },
      data: {
        email: '用户输入的邮箱',
        password: '用户输入的密码',
        device_name: 'pc-web' // 这个参数会被Fortify自动绑定为Sanctum令牌的设备标识
      },
      success: function(res) {
        // res.access_token 就是完整的访问令牌
        // 存到localStorage后续请求带在Authorization头里就行
      },
      error: function(err) {
        // 这里会拿到账号错误、限流拦截的结构化响应,直接做前端提示即可
      }
    })
    
    这个方案的额外好处是:Fortify内置的两步验证、登录限流、异常登录拦截逻辑会完全自动兼容,如果你给用户开了2FA,接口会自动返回要求输入验证码的结构化提示,你在前端做个输入弹框对接就行,不用从零写2FA流程。
  2. 完全可控的自定义方案
    如果你不想耦合Fortify的内置路由逻辑,就在routes/api.php里自定义一个独立的登录接口:在控制器方法里手动校验用户的账号密码,校验通过后直接调用$user->createToken('自定义设备标识')->plainTextToken生成令牌返回。这个方案的优势是返回结构、校验规则可以完全自定义,不受Fortify版本升级的逻辑变动影响;但需要你手动把Fortify的2FA、登录限流、密码合规校验逻辑手动对接进去,开发成本更高。
后续业务操作的鉴权注意事项
  • 登录拿到令牌之后,所有后续jQuery发起的业务请求,都要在请求头里加上Authorization: Bearer 你的访问令牌,同时同样要带上Accept: application/json头,Sanctum中间件才能正确识别当前登录用户。
  • 不要为了图省事把令牌存在Laravel的Session里,你这套纯HTML+jQuery的前端本来就和Session鉴权体系是两套逻辑,直接把令牌存在浏览器localStorage里就可以满足日常业务使用。
  • 如果遇到跨域拦截,只要把你前端页面的实际访问源加到config/cors.php的允许列表里就行,别直接把跨域配置设成全开放留安全隐患。

内容的提问来源于stack exchange,提问作者Matias Azar

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.10 20:36:06