Laravel控制器中API请求失败时如何手动捕获异常并重试？

你的问题核心在于**file_get_contents请求失败时默认不会抛出Exception，而是返回false并触发PHP警告**，这导致你的try/catch块无法捕获到错误；另外，递归重试的写法存在返回值丢失和栈溢出的风险，Laravel的全局错误处理也会接管未捕获的警告/异常，导致执行中止。

下面是两种可行的解决方案，推荐使用更可靠的Guzzle HTTP客户端：

方案一：使用Guzzle HTTP客户端（推荐） #

Laravel 5.6默认集成了Guzzle，它会自动为HTTP请求失败（超时、4xx/5xx错误等）抛出对应的异常，异常处理更完善，也更容易实现重试逻辑：

private function fetchAPI($id, $maxRetries = 3) {
    $client = new \GuzzleHttp\Client([
        'timeout' => 10, // 设置请求超时时间，避免长时间等待
    ]);
    $retryCount = 0;

    while ($retryCount < $maxRetries) {
        try {
            // 发送GET请求
            $response = $client->get("http://example.com/{$id}?key=5453");
            // 解析JSON响应并返回
            return json_decode($response->getBody()->getContents(), true);
        } catch (\GuzzleHttp\Exception\RequestException $e) {
            // 请求失败，计数加1
            $retryCount++;
            
            // 达到最大重试次数时，抛出异常或返回默认值
            if ($retryCount >= $maxRetries) {
                // 根据业务需求选择：抛出异常让上层处理，或者返回空数组/默认值
                throw $e;
                // return [];
            }
            
            // 等待5秒后重试
            sleep(5);
        }
    }

    // 兜底返回（理论上不会走到这里）
    return null;
}

这个方案的优势： #

• 自动捕获所有HTTP相关错误（超时、连接失败、服务器错误等）
• 用循环代替递归，避免栈溢出风险
• 可配置超时时间、最大重试次数，更灵活可控

方案二：修复file_get_contents的重试逻辑 #

如果你坚持使用file_get_contents，需要解决两个问题：将PHP警告转换为可捕获的异常，以及确保递归调用的返回值正确传递：

private function fetchAPI($id, $maxRetries = 3) {
    $retryCount = 0;

    while ($retryCount < $maxRetries) {
        // 临时将PHP警告转换为ErrorException
        set_error_handler(function ($errno, $errstr) {
            throw new \ErrorException($errstr, $errno);
        });

        try {
            $rawResult = file_get_contents("http://example.com/{$id}?key=5453");
            // 恢复Laravel默认的错误处理
            restore_error_handler();

            if ($rawResult !== false) {
                return json_decode($rawResult, true);
            }
        } catch (\ErrorException $e) {
            restore_error_handler();
            $retryCount++;

            if ($retryCount >= $maxRetries) {
                throw $e;
                // return [];
            }

            sleep(5);
        }
    }

    return null;
}

为什么原来的代码无效？ #

1. try/catch无法捕获file_get_contents的错误：它失败时不会抛出Exception，只会触发警告，需要手动将警告转换为ErrorException才能被捕获。
2. 递归调用丢失返回值：你原来的递归代码中，$this->fetchAPI($id)没有加return，导致递归成功后的返回值无法传递到外层函数，最终返回的是json_decode(false, true)（即null）。

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