Laravel同应用内控制器调用本地Sanctum API超时问题求助

你遇到的本地控制器调用同项目Sanctum API超时的问题，核心原因是单线程服务器阻塞：当用php artisan serve启动内置服务器时，它是单线程的——原请求（渲染视图的控制器请求）还在处理中，同时发起的HTTP请求又占用了唯一的线程，导致两个请求互相等待，最终超时。Postman能正常调用是因为它是独立的外部请求，不会占用服务器的同一个线程。

下面是几种解决方案，按优先级排序：

方案一：直接调用内部逻辑（最优） #

没必要绕HTTP接口，直接在控制器里调用API的业务逻辑，既高效又避免阻塞问题：

方式1：直接调用控制器方法 #

// 引入ApiController
use App\Http\Controllers\Api\ApiController;

// 在你的视图控制器中
$apiController = new ApiController();
// 模拟请求参数，按需传递type等参数
$request = request()->merge(['type' => '2']);
$result = $apiController->sample($request);

dd($result);

方式2：抽离业务逻辑到服务类（更规范） #

把API的业务逻辑抽成独立的服务类，让API控制器和视图控制器都调用这个服务：

// app/Services/SampleService.php
namespace App\Services;

class SampleService
{
    public function handle($type)
    {
        // 这里写原来ApiController@sample里的业务逻辑
        return ['data' => 'sample data', 'type' => $type];
    }
}

然后在两个控制器里调用：

// API控制器
use App\Services\SampleService;

public function sample(Request $request)
{
    $service = new SampleService();
    return response()->json($service->handle($request->type));
}

// 视图控制器
use App\Services\SampleService;

$service = new SampleService();
$result = $service->handle('2');
dd($result);

方案二：改用多线程服务器 #

如果一定要用HTTP调用API，解决单线程阻塞问题：

• 使用PHP内置服务器的多线程模式（PHP 7.4+支持）：
  启动服务器时加上--workers参数：

  php artisan serve --workers=2
  

  这样服务器会启动多个线程，能同时处理多个请求。

• 使用Valet/Homestead等本地开发环境：
  这些环境默认是多进程/多线程的，不会出现单线程阻塞问题，直接调用本地域名的API即可。

方案三：检查Sanctum认证配置（辅助验证） #

确保你的Sanctum配置没有问题，避免因为认证失败导致的隐性阻塞：

• 确认.env里的SANCTUM_AUTH对应的token是有效的，且关联的用户账号状态正常。
• 检查config/sanctum.php中的stateful数组，确保本地开发的域名（比如127.0.0.1:8000）在列表里。
• 如果用内置服务器，确保HTTP请求的Origin头正确，Sanctum会验证请求来源的合法性。

内容的提问来源于stack exchange，提问作者Shaho