WordPress中cURL请求出现504 Gateway Time-out错误求助

1. 修复cURL超时配置 #

你的代码中CURLOPT_TIMEOUT => 0会让请求无限等待，直接触发网关超时规则。修改为合理的超时值，并添加连接超时设置：

CURLOPT_TIMEOUT => 30, // 整体请求超时时间（秒）
CURLOPT_CONNECTTIMEOUT => 10, // 连接服务器超时时间（秒）

2. 移除init钩子的同步执行 #

init钩子会在页面加载时同步执行API请求，一旦Wolkvox API响应缓慢，就会阻塞整个页面渲染导致超时。解决方法：

• 改用AJAX触发：前端通过交互事件调用WP AJAX接口，在后端处理API请求；
• 改用WP Cron：如果是定时同步数据，用WP Cron异步执行任务。

3. 补充请求头的Content-Type #

你的POST数据是JSON格式，但没有明确告诉API服务器，可能导致对方无法解析请求，引发响应延迟。在请求头中添加：

CURLOPT_HTTPHEADER => array(
  'wolkvox-token: {{token}}',
  'Content-Type: application/json' // 新增这个头
),

4. 排查AWS网络与服务器配置 #

• 检查AWS安全组：确认出站规则开放了443端口（HTTPS），允许访问Wolkvox的域名；
• 调整服务器超时参数：如果用Nginx，修改proxy_read_timeout为60秒；如果用Apache，修改Timeout参数为60秒；
• 命令行测试连通性：在AWS服务器上执行以下命令，直接测试API端点是否可达：

curl -X POST -H "wolkvox-token: YOUR_ACTUAL_TOKEN" -H "Content-Type: application/json" -d '[{"customer_name":"test","customer_last_name":"test"}]' "https://wvYOUR_SERVER.wolkvox.com/api/v2/campaign.php?api=add_record&type_campaign=YOUR_TYPE&campaign_id=YOUR_ID&campaign_status=YOUR_STATUS"

如果命令行也超时，说明是网络或API端的问题；如果能正常响应，再回到WP代码排查。

5. 添加错误捕获与日志 #

不要直接echo响应，而是记录错误信息到WP日志，方便排查：

$response = curl_exec($curl);
if(curl_errno($curl)){
    error_log('Wolkvox API请求错误: ' . curl_error($curl));
}
curl_close($curl);
// 不要在init钩子echo，避免干扰页面输出
// echo $response;

1. 优先使用WP原生HTTP函数 #

WordPress提供的wp_remote_post/wp_remote_get比原生cURL更适配WP环境，自动处理SSL、代理等问题，示例改写你的请求：

function welkvoxapi() {
    $url = 'https://wv{{wolkvox_server}}.wolkvox.com/api/v2/campaign.php?api=add_record&type_campaign={{type_campaign}}&campaign_id={{campaign_id}}&campaign_status={{campaign_status}}';
    $body = json_encode([
        [
            "customer_name" => "namewv",
            "customer_last_name" => "field_3d8268c",
            // 其他字段...
        ]
    ]);
    $args = [
        'method' => 'POST',
        'headers' => [
            'wolkvox-token' => '{{token}}',
            'Content-Type' => 'application/json'
        ],
        'body' => $body,
        'timeout' => 30,
        'connect_timeout' => 10
    ];
    $response = wp_remote_post($url, $args);
    if(is_wp_error($response)){
        error_log('Wolkvox API请求失败: ' . $response->get_error_message());
        return;
    }
    $response_body = wp_remote_retrieve_body($response);
    // 处理响应，不要直接echo
}
// 不要用init钩子，改用AJAX或Cron
// add_action('init', 'welkvoxapi');

2. 绝对避免同步阻塞页面 #

所有远程API请求都应该异步执行：

• 前端AJAX：注册WP AJAX动作，前端触发后后端执行请求；
• WP Cron：适合定时任务，比如每天同步一次数据；
• 第三方队列插件：复杂任务可以用队列处理，避免阻塞服务器。

3. 敏感信息安全存储 #

不要把token、API密钥硬编码到functions.php，用WP的选项存储：

// 后台设置页面保存token后，用以下方式获取
$token = get_option('wolkvox_api_token');

4. 开启调试日志 #

在wp-config.php中开启日志，方便排查问题：

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

请求错误会自动写入wp-content/debug.log。

5. 限制请求频率 #

不要频繁调用API，避免触发对方的限流机制，同时减轻服务器负担。如果是批量数据同步，分批次处理，每次请求间隔1-2秒。

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