PHP CURL调用登录API返回Invalid Parameters，表单POST正常的问题排查

触发Invalid Parameters错误的原因 #

• 代码中强制为CURL请求设置了Content-Type:application/json头，但实际提交的POST字段是username=1412&password=142487这种URL编码格式的表单内容。
• 服务端会根据请求头声明的Content-Type解析请求体：收到application/json的声明后，会按JSON格式规则解析body，完全无法识别格式不匹配的URL编码内容，最终判定参数缺失、无效。
• 原生HTML表单的默认提交格式就是application/x-www-form-urlencoded，和实际提交的字段格式完全匹配，所以浏览器提交表单时能正常读取参数。后续将Content-Type改为application/x-www-form-urlencoded后参数错误消失，逻辑是正确的。

触发Undefined index: HTTP_USER_AGENT错误的原因 #

• 服务端代码在UserController.php第61行直接读取请求对应的$_SERVER['HTTP_USER_AGENT']全局变量，没有做空值兼容判断。
• PHP的CURL扩展初始化请求时，默认不会主动携带User-Agent请求头，导致服务端收不到该头字段，对应全局变量不存在，就抛出了未定义索引的Notice错误。
• 浏览器提交HTML表单时会自动携带完整的请求头（包含User-Agent），所以走表单流程时不会触发该错误。

可正常运行的修正版CURL代码 #

$url = "https://hrtaskapi.dhwaniris.in/index.php/api/user/login";
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, 1);
// 用http_build_query生成标准url编码的表单字段，和请求头格式对应
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
    'username' => '1412',
    'password' => '142487'
]));
// 移除错误的json格式声明，使用表单默认的编码类型
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/x-www-form-urlencoded'
]);
// 补充CURL默认不携带的User-Agent头，对齐浏览器的请求行为
curl_setopt($ch, CURLOPT_USERAGENT, 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36');
$result = curl_exec($ch);
curl_close($ch);
$result = json_decode($result, true);
echo "<pre>";
print_r($result);

注意：如果后续服务端还校验其他浏览器默认携带的请求头（比如Referer、Accept等），按照相同方式在CURL请求中补充对应头即可，核心逻辑是让CURL的请求行为和浏览器发起的表单请求保持一致。

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