无法捕获GuzzleHttp ConnectException并展示自定义消息求助

云原生阿岚

2026-5-14

解决Laravel中web3php无法捕获Guzzle ConnectException的问题

你遇到的核心问题是异常类的命名空间未正确引用，导致代码无法识别到要捕获的ConnectException，咱们一步步来修复：

1. 修复异常类的命名空间问题

你代码里的catch(ConnectException $e)默认会去当前文件的命名空间找这个类，但实际抛出的是GuzzleHttp\Exception\ConnectException，有两种简单的解决方式：

方式一：使用完全限定类名

直接在catch里写全异常类的命名空间：

try {
    $eth = $eth->eth_getBalance('0x8fbb99e9e73cd62bb3adea5365ff0f9d90c9e532', $block='latest', $decode_hex=false);
} catch(\GuzzleHttp\Exception\ConnectException $e) {
    echo 'Message: ' .$e->getMessage();
    exit;
}

方式二：在文件顶部引入命名空间

在PHP文件最开头添加use语句，后续就可以直接用类名捕获：

use GuzzleHttp\Exception\ConnectException;

// 你的其他代码
$eth = new \IlyasDeckers\Web3PHP\Ethereum(env('WEB3_URL'), env('WEB3_PORT'));
try {
    $eth = $eth->eth_getBalance('0x8fbb99e9e73cd62bb3adea5365ff0f9d90c9e532', $block='latest', $decode_hex=false);
} catch(ConnectException $e) {
    echo 'Message: ' .$e->getMessage();
    exit;
}

2. 兜底测试（排查用）

如果还是无法捕获，可以先捕获所有Exception来确认实际抛出的异常类型，排查是否是web3php内部对异常做了封装：

try {
    $eth = $eth->eth_getBalance('0x8fbb99e9e73cd62bb3adea5365ff0f9d90c9e532', $block='latest', $decode_hex=false);
} catch(\Exception $e) {
    // 打印异常的完整类名，确认真实异常类型
    echo '异常类名：' . get_class($e) . '<br>';
    echo '错误信息：' .$e->getMessage();
    exit;
}

通过这个方法你能精准定位到要捕获的异常类，再针对性调整catch语句。