Symfony 5.4调用Soap接口无dump时出现502 Bad Gateway错误求助

基于PHP 7.4的Symfony 5.4应用（使用API Platform处理路由和转换），在调用包含SOAP请求的路由时遇到异常捕获异常：

• 当SOAP请求出错时，不使用dump()输出异常的情况下，程序不会进入catch块，直接返回502 Bad Gateway错误
• 添加dump()后能正常捕获异常，但这不是合理解决方案
• 错误在1-2秒内出现，排除超时问题
• 已尝试的无效方案：调整Nginx的fastcgi缓冲区大小、将SoapClient的trace设为false、重建后端Docker容器

相关代码示例：

try {
    $arrContextOptions=stream_context_create(
        [
            'ssl' => [
                'verify_peer'      => false,
                'verify_peer_name' => false,
            ],
        ]
    );
    
    $soapClient = new \SoapClient($clientUrl,
        array(
            'trace'          => false,
            'exceptions'     => true,
            'cache_wsdl'     => 0,
            'stream_context' => $arrContextOptions,
        ));

    $header = new \SoapHeader($auth,
        'Token',
        $token);
    $soapClient->__setSoapHeaders($header);

    $result = $soapClient->SendToApi($leadNormalize);
} catch (\Exception $e) {
    $this->logger->error($e->getMessage())
}

以下是几个针对性的排查和修复方向：

1. 捕获更具体的SOAP异常 #

PHP的SoapClient启用exceptions => true时，抛出的是SoapFault（虽继承自Exception），部分场景下可能存在异常逃逸。直接捕获SoapFault并保留通用Exception兜底：

catch (\SoapFault $e) {
    $this->logger->error('SOAP请求错误: ' . $e->getMessage());
    // 可添加客户端错误返回逻辑，比如API Platform的错误响应
} catch (\Exception $e) {
    $this->logger->error('未知错误: ' . $e->getMessage());
}

2. 处理PHP输出缓冲冲突 #

不使用dump()时，SOAP错误可能直接输出到PHP标准错误流，导致Nginx接收不完整响应触发502。可以在SOAP请求前后管理输出缓冲：

// try块开头开启缓冲
ob_start();

try {
    // 原SOAP请求代码
} catch (\Exception $e) {
    // 清空缓冲避免错误输出干扰响应
    ob_clean();
    $this->logger->error($e->getMessage());
    // 返回合法JSON响应适配API Platform
    return new JsonResponse(['error' => '第三方服务请求失败'], Response::HTTP_BAD_REQUEST);
} finally {
    ob_end_flush();
}

3. 排查PHP-FPM进程崩溃问题 #

502错误可能是PHP-FPM进程因SOAP扩展致命错误直接崩溃，而非异常未捕获：

• 查看PHP-FPM错误日志（Docker容器内通常在/var/log/php7.4-fpm.log），确认是否有段错误（Segmentation Fault）记录
• 尝试禁用SOAP连接的长连接：在stream_context中添加http配置

$arrContextOptions=stream_context_create(
    [
        'ssl' => [
            'verify_peer'      => false,
            'verify_peer_name' => false,
        ],
        'http' => [
            'keep_alive' => false,
        ]
    ]
);

4. 确保异常处理后返回合法响应 #

原代码catch块仅记录日志，未返回任何响应，API Platform因无法获取合法响应触发502。需在catch中返回符合规范的响应：

use Symfony\Component\HttpFoundation\JsonResponse;
use Symfony\Component\HttpFoundation\Response;

// ...

catch (\Exception $e) {
    $this->logger->error($e->getMessage());
    return new JsonResponse(
        ['detail' => '第三方服务请求失败'],
        Response::HTTP_SERVICE_UNAVAILABLE
    );
}

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