PHP调用API获取JSON数据失败，求问题排查方案

以下是几种常见原因和对应的解决方法：

1. User-Agent被服务器拦截 #

很多API会校验请求的User-Agent字段，浏览器发送的UA会被识别为合法请求，而PHP的file_get_contents默认UA为空或带有PHP标识，被服务器拒绝。

解决方法：手动设置User-Agent，模拟浏览器请求：

$context = stream_context_create([
    'http' => [
        'header' => "User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36\r\n"
    ]
]);
$url = 'https://www.webminepool.com/api/PK_MgGG3Z8joogwr28PmkE9i/wmc_rate/1000';
$response = file_get_contents($url, false, $context);

if ($response === false) {
    // 打印错误信息排查
    var_dump(error_get_last());
} else {
    $data = json_decode($response, true);
    var_dump($data);
}

2. 未处理HTTPS证书验证 #

如果服务器的SSL证书配置有问题，或者PHP的openssl扩展未正确配置，file_get_contents会因证书验证失败而返回false。

解决方法：关闭证书验证（仅测试环境使用，生产环境建议配置正确的证书）：

$context = stream_context_create([
    'ssl' => [
        'verify_peer' => false,
        'verify_peer_name' => false
    ],
    'http' => [
        'header' => "User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36\r\n"
    ]
]);
$response = file_get_contents($url, false, $context);
// 后续解析代码同上

3. 未跟随重定向 #

部分API会返回3xx重定向响应，file_get_contents默认不会自动跳转，导致获取到的是重定向页面内容而非JSON。

解决方法：开启自动跟随重定向：

$context = stream_context_create([
    'http' => [
        'header' => "User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36\r\n",
        'follow_location' => true,
        'max_redirects' => 5 // 限制最大跳转次数
    ],
    'ssl' => [
        'verify_peer' => false,
        'verify_peer_name' => false
    ]
]);
$response = file_get_contents($url, false, $context);
// 后续解析代码同上

4. 响应内容被压缩 #

服务器可能返回gzip压缩后的内容，file_get_contents默认不会自动解压，导致拿到的是乱码，json_decode无法解析。

解决方法：请求时告知服务器不使用压缩，或者手动解压内容：

// 方法1：请求时禁用压缩
$context = stream_context_create([
    'http' => [
        'header' => "User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/114.0.0.0 Safari/537.36\r\nAccept-Encoding: identity\r\n"
    ]
]);
$response = file_get_contents($url, false, $context);

// 方法2：手动解压（如果服务器还是返回压缩内容）
if (function_exists('gzdecode') && strpos($response, "\x1f\x8b\x08") === 0) {
    $response = gzdecode($response);
}
$data = json_decode($response, true);
var_dump($data);

调试技巧 #

如果以上方法还不行，建议打印请求的错误信息和响应头，进一步排查：

$response = file_get_contents($url, false, $context);
if ($response === false) {
    var_dump(error_get_last());
} else {
    // 获取响应头
    $headers = $http_response_header;
    var_dump($headers);
    var_dump($response);
}

内容的提问来源于stack exchange，提问作者Oise Net Multiservices