为何QuickBooks PHP SDK OAuth2LoginHelper异常无法被try-catch捕获？

问题原因 #

你使用try-catch(Exception $e)无法捕获ServiceException，是因为该异常属于QuickBooksOnline\API\Exception命名空间，而你捕获的是全局命名空间下的Exception，PHP无法识别跨命名空间的异常类型。

解决方案 #

方案一：引入异常类并捕获具体类型

首先在代码顶部引入ServiceException类：

use QuickBooksOnline\API\Exception\ServiceException;

然后修改try-catch块，针对性捕获异常并处理令牌无效的场景：

try {
    // Refresh the token
    $OAuth2LoginHelper = $dataService->getOAuth2LoginHelper();
    $refresh = $accessToken->getRefreshToken();
    $accessTokenObj = $OAuth2LoginHelper->refreshAccessTokenWithRefreshToken($refresh);
    $accessTokenObj->setRealmID($currentServiceContext->realmId);
    $dataService->updateOAuth2Token($accessTokenObj);
    $_SESSION['sessionAccessToken'] = serialize($accessTokenObj);
} catch (ServiceException $e) {
    // 识别无效授权错误
    if ($e->getCode() === 400 && str_contains($e->getMessage(), 'invalid_grant')) {
        // 清除无效会话令牌
        unset($_SESSION['sessionAccessToken']);
        // 跳转到QuickBooks重新连接页面
        header("Location: /connect-quickbooks.php");
        exit;
    } else {
        // 处理其他服务异常
        error_log("QuickBooks服务错误: " . $e->getMessage());
        echo "服务异常，请稍后重试。";
    }
} catch (Exception $e) {
    // 捕获其他全局异常
    error_log("系统错误: " . $e->getMessage());
    echo "系统异常，请稍后重试。";
}

方案二：使用完整命名空间捕获异常

如果不想引入类，可以直接在catch中指定完整命名空间：

try {
    // ... 原有刷新令牌代码
} catch (\QuickBooksOnline\API\Exception\ServiceException $e) {
    // 无效授权处理逻辑同上
} catch (\Exception $e) {
    // 全局异常处理
}

额外优化建议 #

• 提前校验令牌有效期，减少刷新失败场景：

// 提前5分钟检查令牌是否即将过期
$expiresAt = $accessToken->getAccessTokenExpiresAt();
if (time() >= strtotime($expiresAt) - 300) {
    // 执行令牌刷新逻辑
}

• 生产环境关闭display_errors，依赖错误日志排查问题，避免暴露敏感信息。

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