You need to enable JavaScript to run this app. Laravel 8 Sanctum下SPA与外部用户共用API路由的实现咨询
优惠活动
大模型
产品
解决方案
定价
更多

Laravel 8 Sanctum下SPA与外部用户共用API路由的实现咨询

Laravel 8 + Sanctum 有/无状态路由适配方案

初始场景与核心冲突

最初的规划是让SPA前端和外部API调用方复用同一套API路由,落地时碰到了不可调和的适配矛盾:
Sanctum框架要求将EnsureFrontendRequestsAreStateful中间件加入api中间件组,这个操作会让整个api路由组切换为有状态模式——该模式天然适配SPA基于cookie会话的访问逻辑,但对于靠API令牌做认证的外部调用场景,必须保持API的无状态特性,两种需求直接产生冲突。
最开始想到的简单解法是靠不同中间件组物理隔离SPA路由和外部路由,但总觉得这种方案会带来大量重复的路由定义代码,不够优雅,因此最终落地的是拆分路由结构、复用公共资源定义的实现思路。

具体配置实现

路由层拆分

  • 面向外部的无状态API路由定义(routes/api.php)
Route::middleware('auth:sanctum')->as('api.')->group(function () {
    require 'resources.php';
});
  • 面向SPA的有状态路由定义(routes/spa.php)
Route::middleware('auth:sanctum')->as('spa.')->group(function () {
    require 'resources.php';
});
  • 两套路由共用的公共资源路由定义(routes/resources.php)
Route::apiResources([
    'products' => 'Api\ProductController',
]);

通过公共文件复用的方式,业务控制器逻辑不需要重复写两份,两个路由组仅靠不同的路由名前缀、路径前缀做区分,从根源上减少重复维护成本。

路由服务提供者注册

在App\Providers\RouteServiceProvider的boot方法中注册SPA路由的加载规则:

public function boot()
{
    $this->routes(function () {
       // ...原有api、web等路由的注册逻辑
        Route::prefix('spa')
            ->middleware('spa')
            ->namespace($this->namespace)
            ->group(base_path('routes/spa.php'));
    });
}

配置完成后,SPA端的所有接口请求都会走/spa路径前缀,对应加载spa中间件组的逻辑。

中间件组拆分配置

在App\Http\Kernel的中间件组定义中,将原来混合的无状态、有状态逻辑彻底拆开:

protected $middlewareGroups = [
    // ...web等内置中间件组配置
    // 对外提供服务的无状态API组
    'api' => [
        'throttle:api',
        SubstituteBindings::class,
    ],
    // 适配SPA访问的有状态路由组
    'spa' => [
        EnsureFrontendRequestsAreStateful::class,
        'throttle:api',
        SubstituteBindings::class,
    ],
];

方案优势

这套实现既解决了中间件链的隔离问题:外部API请求走api组时是纯无状态的,不会加载会话相关的中间件逻辑,完全适配令牌认证的场景;SPA请求走spa组时能正常加载Sanctum要求的有状态中间件,保持原有SPA会话认证的完整流程,两套场景互不干扰。同时因为复用了公共路由定义,没有出现路由重复维护的冗余问题。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.11 18:45:03