Laravel 11 JWT认证配置：使用auth:api中间件时图片描述丢失

1. 动态注册JWT认证Guard #

在app/Providers/AuthServiceProvider.php的boot方法中添加以下代码，动态配置api guard使用JWT驱动，无需修改配置文件：

use Illuminate\Support\Facades\Auth;
use Tymon\JWTAuth\JWTGuard;

public function boot()
{
    $this->registerPolicies();

    // 注册JWT驱动
    Auth::extend('jwt', function ($app, $name, array $config) {
        return new JWTGuard(
            $app['tymon.jwt'],
            Auth::createUserProvider($config['provider']),
            $app['request']
        );
    });

    // 动态覆盖api guard的驱动配置
    config(['auth.guards.api.driver' => 'jwt']);
}

2. 确保User模型实现JWT接口并正确关联图片 #

你的User模型必须实现JWTSubject接口，同时确认图片关联关系定义正确：

use Illuminate\Foundation\Auth\User as Authenticatable;
use Tymon\JWTAuth\Contracts\JWTSubject;

class User extends Authenticatable implements JWTSubject
{
    // ... 模型原有代码

    // 实现JWT接口方法
    public function getJWTIdentifier()
    {
        return $this->getKey();
    }

    public function getJWTCustomClaims()
    {
        return [];
    }

    // 定义图片关联（根据实际表结构调整）
    public function image()
    {
        return $this->hasOne(Image::class);
    }
}

3. 自定义中间件预加载图片关联 #

若图片描述为空是因为未预加载关联，可自定义中间件处理，避免N+1查询问题：

1. 创建中间件app/Http/Middleware/JwtAuth.php：

namespace App\Http\Middleware;

use Closure;
use Illuminate\Support\Facades\Auth;

class JwtAuth
{
    public function handle($request, Closure $next)
    {
        $user = Auth::guard('api')->user();
        if (!$user) {
            return response()->json(['error' => 'Unauthorized'], 401);
        }

        // 预加载图片关联，确保$user->image能直接获取数据
        $request->setUserResolver(fn () => $user->load('image'));

        return $next($request);
    }
}

2. 在app/Http/Kernel.php的$routeMiddleware中注册：

protected $routeMiddleware = [
    // ... 其他中间件
    'jwt.auth' => \App\Http\Middleware\JwtAuth::class,
];

3. 路由中使用该中间件替代auth:api：

Route::get('/your-api-endpoint', [YourController::class, 'method'])->middleware('jwt.auth');

4. 验证登录生成Token的逻辑 #

确保登录时使用JWT正确生成Token：

use Tymon\JWTAuth\Facades\JWTAuth;
use Illuminate\Http\Request;

public function login(Request $request)
{
    $credentials = $request->validate([
        'email' => 'required|email',
        'password' => 'required'
    ]);

    if (!$token = JWTAuth::attempt($credentials)) {
        return response()->json(['error' => '无效的登录凭证'], 401);
    }

    return response()->json(['token' => $token]);
}

完成以上配置后，使用Bearer Token请求接口时，$request->user()就能正确返回包含图片描述的用户实例，且无需修改config/app.php文件。

内容的提问来源于stack exchange，提问作者Bùi Duy Thành