Guzzle：如何设置非200状态码时禁止自动重试？

当然可以搞定！GuzzleHttp 默认确实会对某些失败场景自动重试（比如连接异常、5xx服务器错误），但你完全可以通过自定义重试逻辑来精准控制——比如像你遇到的这种400 Bad Request这类客户端错误，直接跳过重试。

下面给你两种实用的配置方式：

方式一：自定义重试判断函数（精准控制重试场景） #

你可以通过自定义重试中间件的判断逻辑，明确指定只有哪些情况才触发重试，彻底排除4xx错误。代码示例如下：

use GuzzleHttp\Client;
use GuzzleHttp\HandlerStack;
use GuzzleHttp\Middleware;
use Psr\Http\Message\RequestInterface;
use Psr\Http\Message\ResponseInterface;

// 创建自定义处理器栈
$stack = HandlerStack::create();

// 添加自定义重试中间件
$stack->push(Middleware::retry(function (
    int $retries,
    RequestInterface $request,
    ?ResponseInterface $response = null,
    ?\Throwable $exception = null
) {
    // 首先限制最大重试次数，避免无限重试
    if ($retries >= 3) {
        return false;
    }

    // 情况1：连接异常（比如网络断了），触发重试
    if ($exception instanceof \GuzzleHttp\Exception\ConnectException) {
        return true;
    }

    // 情况2：服务器返回5xx错误（服务端故障），触发重试
    if ($response && $response->getStatusCode() >= 500) {
        return true;
    }

    // 其他情况（包括所有4xx客户端错误），不重试
    return false;
}));

// 用自定义栈创建客户端
$client = new Client(['handler' => $stack]);

这段代码的核心是那个重试判断函数：它只会在连接异常或者服务器返回5xx错误时才允许重试，像400 Bad Request这类客户端错误直接跳过。同时还限制了最多重试3次，避免出现大量无效重试请求。

方式二：完全禁用所有重试（简单粗暴版） #

如果你在这个场景下完全不需要任何重试，直接移除重试中间件或者设置重试次数为0即可：

use GuzzleHttp\Client;
use GuzzleHttp\HandlerStack;

// 创建不带重试中间件的处理器栈
$stack = HandlerStack::create();
// 移除默认的重试中间件
$stack->remove('retry');

// 创建客户端
$client = new Client(['handler' => $stack]);

或者更简单的方式，通过retry选项直接设置重试次数为0：

$client = new Client([
    'retry' => 0
]);

这样无论什么错误，Guzzle都不会自动重试。

补充说明 #

Guzzle默认的重试逻辑本来就不会重试4xx错误，但如果你遇到了大量4xx重试的情况，大概率是项目里自定义了重试策略，或者使用了某些扩展修改了默认行为。上面的自定义方式可以完全覆盖原有逻辑，解决你的问题。

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