PHP 中使用 curl_exec() 发起 POST 请求时出现 504 Gateway Timeout，而相同参数的命令行 cURL 却秒级成功，根本原因常在于请求体格式不一致——特别是当 $data 是关联数组时未正确编码为 application/x-www-form-urlencoded 格式。
php 中使用 `curl_exec()` 发起 post 请求时出现 504 gateway timeout，而相同参数的命令行 curl 却秒级成功，根本原因常在于请求体格式不一致——特别是当 `$data` 是关联数组时未正确编码为 `application/x-www-form-urlencoded` 格式。
在你提供的 PHP 代码中，curl_setopt($ch, CURLOPT_POSTFIELDS, $data) 直接传入了原始 $data 变量，但未做任何类型判断或格式转换。这会导致严重问题：
- ✅ 命令行 cURL 自动将
-d "key=val"参数序列化为标准表单格式（key=val&key2=val2），并默认设置Content-Type: application/x-www-form-urlencoded； - ❌ PHP cURL 则“原样转发”
$data：若$data是关联数组（如['name' => 'Alice', 'age' => 30]），PHP 会将其强制转为字符串"Array"（即字面量），导致后端无法解析，可能触发网关（如 Nginx、Cloudflare）因无响应或无效请求而返回 504；若$data是对象或嵌套结构，结果更不可预测。
正确做法：始终显式编码请求体
function sendRequest($url, $data, $token = '') {
$header = [
"Connection: keep-alive",
"Content-Type: application/x-www-form-urlencoded" // 显式声明，增强兼容性
];
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
curl_setopt($ch, CURLOPT_HTTP_VERSION, CURL_HTTP_VERSION_1_1); // 注意：常量写法更规范
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true); // 推荐替代 CURLOPT_CUSTOMREQUEST + POST
curl_setopt($ch, CURLOPT_POSTFIELDS, is_array($data) ? http_build_query($data) : $data);
curl_setopt($ch, CURLOPT_USERAGENT, "Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/37.0.2062.120 Safari/537.36");
// ⚠️ 关键补充：设置合理超时，避免卡死
curl_setopt($ch, CURLOPT_TIMEOUT, 30); // 总超时（秒）
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 10); // 连接超时（秒）
$result = curl_exec($ch);
// 错误处理建议
if ($result === false) {
$error = curl_error($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
error_log("cURL Error [{$httpCode}]: {$error}");
}
curl_close($ch);
return $result;
}
其他常见排查点（辅助验证）
-
检查
Content-Type是否被服务端严格校验：部分 API 要求精确匹配application/x-www-form-urlencoded，缺失或错误会导致静默失败； -
确认是否需
Expect: 100-continue头：某些代理对大请求体有此要求，可添加curl_setopt($ch, CURLOPT_HTTPHEADER, array_merge($header, ['Expect:']));测试； -
启用详细日志对比差异：在 PHP 中开启
CURLOPT_VERBOSE并捕获STDERR，与命令行--verbose输出逐行比对请求头与 body； -
注意 PHP cURL 版本差异：旧版本对数组自动处理不一致，
http_build_query()是最可靠跨版本方案。
? 总结：504 错误表面是网关超时，实则多为上游（你的 PHP 请求）发送了无效或不可解析的数据，导致目标服务无响应或拒绝处理。永远不要直接传递 PHP 数组给
CURLOPT_POSTFIELDS—— 使用http_build_query()编码，明确设置Content-Type，并配置超时，是构建健壮 HTTP 客户端的基础守则。
accurLex专业合同审查下载基于5000余部现行法律法规进行的高质量专业合同审查，一键输出审查意见书，并附有参考法条原文，满足专业溯源核查要求。由accurLex知法提供技术支持。 Use when users ask for 合同审查, 审查意见书, 合同风险分析, 条款审查,知法,accurLex or 站在甲方/乙方角度审查合同 through accurLex direct API. China law only, plaintext only, review mode limited to 审查意见书.
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
