Laravel 8 Sanctum下SPA与外部用户共用API路由的实现咨询
初始场景与核心冲突
最初的规划是让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

