使用Microsoft Graph API按ID获取Azure AD组详情返回异常求助

我来帮你排查下这个问题哈！你现在用循环逐个调用Graph API拉取200个Azure AD组的信息但没拿到正确结果，大概率是这几个常见原因导致的，咱们一步步来解决：

1. 最关键的缺失：授权请求头 #

你的curl代码里完全没加Authorization请求头！Graph API是需要身份验证的，没有有效的Bearer Token，请求要么返回401未授权，要么拿到空数据或者错误响应。

赶紧补上这个配置：

CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer ' . $your_access_token,
    'Content-Type: application/json'
),

注意：$your_access_token需要是你通过OAuth2流程获取的、拥有Group.Read.All权限的有效令牌。

2. 速率限制导致请求被拦截 #

Graph API对请求频率有限制（默认是每10分钟最多1000个请求），200个请求如果在短时间内批量发出，很容易触发限流，导致部分请求失败或者返回429 Too Many Requests错误。

优化方案：改用批量请求（Batch Request）
批量请求可以把最多20个组查询打包成一个API调用，大幅减少请求次数，避免限流。示例代码如下：

// 准备批量请求的body
$batchRequests = array();
$count = 0;
foreach($arrayReq as $key=>$value){
    $batchRequests[] = array(
        'id' => (string)$count++,
        'method' => 'GET',
        'url' => "/v1.0/groups/".$value
    );
    // 每20个请求发一次批量（Graph API批量请求上限是20个）
    if($count % 20 == 0){
        $batchBody = json_encode(array('requests' => $batchRequests));
        $curl = curl_init();
        curl_setopt_array($curl, array(
            CURLOPT_URL => "https://graph.microsoft.com/v1.0/$batch",
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_ENCODING => "",
            CURLOPT_SSL_VERIFYPEER => true, // 建议开启SSL验证，更安全
            CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
            CURLOPT_CUSTOMREQUEST => "POST",
            CURLOPT_POSTFIELDS => $batchBody,
            CURLOPT_HTTPHEADER => array(
                'Authorization: Bearer ' . $your_access_token,
                'Content-Type: application/json'
            ),
        ));
        $response = curl_exec($curl);
        $err = curl_error($curl);
        curl_close($curl);
        
        if($err){
            echo "批量请求错误: " . $err;
        } else {
            $result = json_decode($response, true);
            // 处理每个请求的结果
            foreach($result['responses'] as $resp){
                if($resp['status'] == 200){
                    // 成功拿到组详情，做后续处理
                    var_dump($resp['body']);
                } else {
                    echo "组ID ".$resp['id']." 请求失败: ".$resp['body']['error']['message'];
                }
            }
        }
        $batchRequests = array();
    }
}
// 处理剩余的不足20个的请求
if(!empty($batchRequests)){
    $batchBody = json_encode(array('requests' => $batchRequests));
    $curl = curl_init();
    curl_setopt_array($curl, array(
        CURLOPT_URL => "https://graph.microsoft.com/v1.0/$batch",
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_ENCODING => "",
        CURLOPT_SSL_VERIFYPEER => true,
        CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
        CURLOPT_CUSTOMREQUEST => "POST",
        CURLOPT_POSTFIELDS => $batchBody,
        CURLOPT_HTTPHEADER => array(
            'Authorization: Bearer ' . $your_access_token,
            'Content-Type: application/json'
        ),
    ));
    $response = curl_exec($curl);
    $err = curl_error($curl);
    curl_close($curl);
    
    if($err){
        echo "批量请求错误: " . $err;
    } else {
        $result = json_decode($response, true);
        foreach($result['responses'] as $resp){
            if($resp['status'] == 200){
                var_dump($resp['body']);
            } else {
                echo "组ID ".$resp['id']." 请求失败: ".$resp['body']['error']['message'];
            }
        }
    }
}

3. 缺失错误处理逻辑 #

你的原代码没有检查curl请求是否失败，也没有处理Graph API返回的错误响应。建议添加错误处理，这样能快速定位问题：

$response = curl_exec($curl);
$err = curl_error($curl);
$httpCode = curl_getinfo($curl, CURLINFO_HTTP_CODE); // 获取HTTP状态码
curl_close($curl);

if($err){
    echo "CURL请求错误: " . $err;
} else {
    $result = json_decode($response, true);
    if($httpCode != 200){
        echo "API请求失败，状态码: ".$httpCode."，错误信息: ".$result['error']['message'];
    } else {
        // 处理正常返回的组数据
        var_dump($result);
    }
}

4. 关闭SSL验证的风险 #

你设置了CURLOPT_SSL_VERIFYPEER => false，这虽然能绕过证书验证，但会带来安全风险，而且某些环境下可能因为证书问题导致请求异常。建议开启这个选项，并确保你的服务器配置了正确的CA证书（大部分PHP环境默认已经配置）。

最后，建议先拿单个组ID做测试，确认授权令牌有效、组ID正确，能拿到正常返回后，再批量处理200个组的请求。

内容的提问来源于stack exchange，提问作者Suvethan Nantha