Laravel 11集成API Platform后Swagger UI认证请求无Authorization头问题

问题根源 #

你当前的Swagger UI配置仅声明了API Key的基本结构，但未与OpenAPI的安全方案绑定，导致授权后请求不会自动携带Authorization头；同时用apiKey类型适配Laravel的Bearer Token认证，兼容性不如专门的http bearer类型。

解决步骤 #

1. 修改API Platform配置文件
   打开config/api-platform.php，更新swagger_ui并新增openapi配置段，让Swagger UI正确识别并携带Bearer Token：

   'swagger_ui' => [
       'enabled' => true,
       'apiKeys' => [
           'BearerAuth' => [
               'type' => 'http',
               'name' => 'Authorization',
               'in' => 'header'
           ]
       ],
   ],
   
   'openapi' => [
       'info' => [
           'title' => '你的API名称',
           'version' => '1.0.0',
       ],
       'components' => [
           'securitySchemes' => [
               'BearerAuth' => [
                   'type' => 'http',
                   'scheme' => 'bearer',
                   'bearerFormat' => 'API Token',
               ],
           ],
       ],
       'security' => [
           ['BearerAuth' => []], // 全局启用授权，所有接口自动携带头
       ],
   ],
   

2. 清除Laravel配置缓存
   执行命令让新配置生效：

   php artisan config:clear
   

3. 重新授权并测试请求
   刷新Swagger UI页面，点击右上角「Authorize」按钮，找到BearerAuth项，直接输入你的API Token（不需要加Bearer 前缀，Swagger会自动拼接），授权后再发起请求，此时Authorization头会被自动携带。

额外检查项 #

• 确认你的用户模型已经引入HasApiTokens trait：

  use Laravel\Sanctum\HasApiTokens;
  
  class User extends Authenticatable
  {
      use HasApiTokens, HasFactory, Notifiable;
  }
  

• 确保路由使用了auth:sanctum中间件，比如在routes/api.php中：

  Route::middleware('auth:sanctum')->group(function () {
      // 你的API路由
  });
  

内容的提问来源于stack exchange，提问作者Максим Шептуха