Laravel Sanctum与Fortify结合使用方法及Laravel8 API登录配置
核心路由选型实操判断
- 首先说个很多人踩过的坑:Fortify默认提供的
/login路由,本质是为Jetstream配套的Blade服务端渲染流程设计的。如果你把自研登录页的表单action直接指向这个路由,做传统的页面跳转提交,后端会直接返回完整的Blade HTML页面,走的是Session会话鉴权逻辑,你之前写的jQuery异步交互、登录态处理逻辑会全部失效。 - 不是说不能用Fortify提供的
/login接口,而是绝对不能用传统表单跳转的方式用,换对了请求方式,这个接口其实是最省开发成本的选择。
登录环节访问令牌的落地生成位置
这里直接给两个经过实际项目验证的落地方案,不用零散找资料拼凑逻辑:
- 零开发成本的复用方案(最推荐,适合大部分团队)
直接复用Fortify内置的POST /login接口,根本不需要自己写账号校验逻辑。只要你的jQuery发请求的时候,主动带上Accept: application/json请求头,Fortify就会自动跳过Blade视图返回逻辑,校验完账号密码之后,自动对接Sanctum生成访问令牌,以JSON结构返回给你。
实际的jQuery请求写法参考:
这个方案的额外好处是:Fortify内置的两步验证、登录限流、异常登录拦截逻辑会完全自动兼容,如果你给用户开了2FA,接口会自动返回要求输入验证码的结构化提示,你在前端做个输入弹框对接就行,不用从零写2FA流程。$.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的内置路由逻辑,就在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
相关产品推荐
相关产品推荐

