
在 Laravel 的 api 路由中调用 Auth::id('api') 或 auth('api')->user() 报错“Auth guard [api] is not defined”,根本原因是 config/auth.php 中未正确定义 api 认证守卫;解决方案是手动配置 api guard,或直接使用默认守卫(推荐初学者先用 auth())。
在 laravel 的 `api` 路由中调用 `auth::id('api')` 或 `auth('api')->user()` 报错“auth guard [api] is not defined”,根本原因是 `config/auth.php` 中未正确定义 `api` 认证守卫;解决方案是手动配置 `api` guard,或直接使用默认守卫(推荐初学者先用 `auth()`)。
Laravel 默认在 config/auth.php 中已预置了 web 和 api 两种守卫(guard)配置,但 api 守卫是否生效,取决于你是否启用了 Sanctum 或 Passport 等 API 认证驱动。若项目未安装并配置这些包,'driver' => 'token'(旧版)或 'driver' => 'sanctum'(新版)将无法工作,而若你错误地保留了 api guard 配置但未设置对应 driver,或干脆完全删除了 api 配置项,此时显式调用 auth('api') 就会触发 Auth guard [api] is not defined 错误。
✅ 正确做法分两种场景:
① 若你确实需要基于 Token 的 API 认证(如移动端、SPA 前端):
请先安装并配置 Laravel Sanctum(官方推荐):
composer require laravel/sanctum php artisan vendor:publish --provider="Laravel\Sanctum\SanctumServiceProvider" php artisan migrate
然后确保 config/auth.php 中的 guards 包含:
'guards' => [
// ... 其他守卫(如 web)
'api' => [
'driver' => 'sanctum', // ✅ 推荐;Laravel 9+ 默认使用
'provider' => 'users',
],
],
同时,在 app/Http/Kernel.php 的 $middlewareGroups['api'] 中确认已包含 \Laravel\Sanctum\Http\Middleware\EnsureFrontendRequestsAreStateful::class(仅限 SPA 场景),或确保请求携带有效的 Authorization: Bearer {token}。
Laravel Cloud(cloud.laravel.com)。此技能用于处理所有 Laravel Cloud 请求,包括搜索和读取数据。只要任务涉及 Laravel Cloud,即使用此技能。
② 若你只是在测试阶段、或 API 实际仍依赖 Session(如 Postman 调试带 Cookie),且暂不启用 Token 认证:
? 最简单安全的做法是移除显式守卫名,直接使用默认守卫:
// 在 PayPalController@create 方法中
public function create(Request $request)
{
// ✅ 正确:使用默认守卫(通常为 'web',需确保 session 已启用)
if (Auth::check()) {
$userId = Auth::id(); // 或 Auth::user()->id
// 处理已登录用户逻辑
} else {
return response()->json(['error' => 'Unauthorized'], 401);
}
}
⚠️ 注意:routes/api.php 中的路由默认不启用 Session 中间件,因此即使你用 auth(),也大概率返回 false。解决方法是在路由定义时显式添加 middleware('auth:sanctum')(Token 方式)或 middleware('auth')(Session 方式,需额外启用):
// routes/api.php
use App\Http\Controllers\PayPalController;
Route::post('/paypal/order/create', [PayPalController::class, 'create'])
->middleware('auth:sanctum'); // ✅ 推荐:强制校验 Sanctum Token
? 总结:
- 错误
Auth guard [api] is not defined源于auth.php缺失对应守卫配置; - 不要盲目调用
auth('api'),先确认你真正需要的认证方式(Session 还是 Token); - 新项目强烈建议统一使用 Laravel Sanctum 管理 API 认证,它轻量、安全、开箱即用;
- 调试时可用
dd(auth()->guard('api')->check())快速验证守卫是否就绪。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










