PHP调用Google OAuth接口报unsupported_grant_type错误求助

开发者阿泽

2026-10-10

问题根因

当你给PHP cURL的CURLOPT_POSTFIELDS选项传递数组类型的值时，cURL会自动将请求Content-Type覆盖为multipart/form-data，你手动设置的application/x-www-form-urlencoded会失效，同时参数不会按表单urlencoded格式编码，导致接口无法正确解析参数，因此返回grant_type无效的报错。

解决方案

将参数数组通过http_build_query()处理为URL编码后的字符串，再传递给CURLOPT_POSTFIELDS即可，修正后的代码如下：

$data = [
    "client_id" => "id-here",
    "client_secret" => "secret-here",
    "refresh_token" => "refresh-token-here",
    "grant_type" => "refresh_token"
];
$ch = curl_init( 'https://www.googleapis.com/oauth2/v4/token' );
// 显式声明POST请求，避免不同环境的兼容性问题
curl_setopt( $ch, CURLOPT_POST, true );
curl_setopt( $ch, CURLOPT_HTTPHEADER, array('Content-Type:application/x-www-form-urlencoded'));
// 数组转为urlencoded格式字符串
curl_setopt( $ch, CURLOPT_POSTFIELDS, http_build_query($data) );
curl_setopt( $ch, CURLOPT_RETURNTRANSFER, true );

$result = curl_exec($ch);
curl_close($ch);

dd($result);