PostMan正常的API POST请求在Laravel应用中报502 Bad Gateway错误

问题描述 #

调用Cloudways的updateAppAliases API添加域名别名时，PostMan中请求完全正常（能成功添加别名并返回200响应），但Laravel应用里无论是用curl还是Laravel Http客户端调用，都返回502 Bad Gateway错误。

已知信息：

• 通过oauth/access_token接口获取Bearer Token的逻辑在PostMan和Laravel中均正常
• PostMan采用Raw JSON格式提交server_id、app_id、aliases数组参数，无异常
• Laravel中尝试过硬编码参数、固定Token、调整请求方式，Cloudways支持方反馈问题出在代码端
• 使用Laravel Http客户端时，通过dd()查看的请求结构（头信息、参数）与PostMan一致，但发送请求后仍返回502

排查方向与解决方案 #

1. 强制指定Content-Type请求头 #

Laravel Http客户端可能自动推断请求头，但手动指定application/json确保和PostMan请求完全一致：

use Illuminate\Support\Facades\Http;

$response = Http::withToken($accessToken)
    ->withHeaders([
        'Content-Type' => 'application/json',
        'Accept' => 'application/json',
    ])
    ->post('https://api.cloudways.com/api/v1/app/manage/aliases', [
        'server_id' => 12345,
        'app_id' => 67890,
        'aliases' => ['example.com', 'sub.example.com']
    ]);

2. 手动编码JSON payload #

避免Laravel自动序列化可能带来的转义问题，手动生成JSON字符串后发送：

$payload = json_encode([
    'server_id' => 12345,
    'app_id' => 67890,
    'aliases' => ['example.com', 'sub.example.com']
]);

$response = Http::withToken($accessToken)
    ->withHeaders(['Content-Type' => 'application/json'])
    ->send('POST', 'https://api.cloudways.com/api/v1/app/manage/aliases', [
        'body' => $payload
    ]);

3. 临时禁用SSL验证（仅测试用） #

若服务器SSL证书在Laravel环境中验证失败，可能触发异常。临时禁用验证排查：

$response = Http::withToken($accessToken)
    ->withoutVerifying()
    ->post('https://api.cloudways.com/api/v1/app/manage/aliases', $payload);

如果测试成功，需在生产环境配置Laravel信任对应SSL证书。

4. 延长请求超时时间 #

Laravel Http客户端默认超时较短，若API响应慢可能触发超时导致502：

$response = Http::withToken($accessToken)
    ->timeout(30) // 设置30秒超时
    ->post('https://api.cloudways.com/api/v1/app/manage/aliases', $payload);

5. 对比请求日志与PostMan详情 #

记录完整请求日志，和PostMan的请求头、Body逐行对比（比如User-Agent等细节差异）：

use Illuminate\Support\Facades\Log;

$requestData = [
    'server_id' => 12345,
    'app_id' => 67890,
    'aliases' => ['example.com', 'sub.example.com']
];

Log::info('Cloudways API Request', [
    'headers' => ['Authorization' => 'Bearer ' . $accessToken, 'Content-Type' => 'application/json'],
    'body' => $requestData,
    'url' => 'https://api.cloudways.com/api/v1/app/manage/aliases'
]);

$response = Http::withToken($accessToken)
    ->withHeaders(['Content-Type' => 'application/json'])
    ->post('https://api.cloudways.com/api/v1/app/manage/aliases', $requestData);

Log::info('Cloudways API Response', [
    'status' => $response->status(),
    'body' => $response->body()
]);

6. 检查服务器防火墙/代理设置 #

确认Laravel部署服务器允许出站请求到api.cloudways.com的443端口，是否有防火墙或代理拦截了请求。

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