Google Classroom API 401认证失败求助：OAuth2令牌本地请求无效

我一眼就看到你代码里的核心问题了——你把令牌文件的路径当成了令牌本身传给请求头！咱们先揪出这个错误，再一步步完善解决方案。

1. 修正令牌取值的致命错误 #

你已经成功从token.json里解析出了包含令牌信息的数组，但后续错误地把文件路径赋值给了$token，导致请求头传递的不是有效的access_token。修正后的代码如下：

$tokenPath = '../token.json';
if (file_exists($tokenPath)) {
    $accessToken = json_decode(file_get_contents($tokenPath), true);
    $client->setAccessToken($accessToken);
    
    // 新增：自动处理令牌过期问题
    if ($client->isAccessTokenExpired()) {
        if ($client->getRefreshToken()) {
            // 用刷新令牌获取新的访问令牌
            $client->fetchAccessTokenWithRefreshToken($client->getRefreshToken());
            // 把新令牌重新保存到文件，避免下次重复过期
            file_put_contents($tokenPath, json_encode($client->getAccessToken()));
            // 更新当前使用的令牌值
            $accessToken = $client->getAccessToken();
        } else {
            die("令牌已过期且无刷新令牌，请重新完成授权流程");
        }
    }
    
    // 正确提取access_token字段，这才是要传递的令牌值
    $validToken = $accessToken['access_token'];
} else {
    die("找不到令牌文件，请先完成OAuth授权获取token.json");
}

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    'Content-Type: application/json',
    'Authorization: Bearer ' . $validToken // 这里传递正确的access_token
));
$data = curl_exec($ch);
$info = curl_getinfo($ch);

// 新增：排查curl请求本身的错误
if(curl_errno($ch)){
    echo 'CURL请求错误：' . curl_error($ch);
}
curl_close($ch);

return $data;

2. 若修正后仍报错，检查这些关键点 #

• 令牌权限范围（Scope）是否足够：你申请的OAuth令牌必须包含Google Classroom API所需的权限，比如classroom.courses.readonly、classroom.students.readonly等。如果权限不足，即使令牌有效也会返回401/403错误。
• 本地环境OAuth配置是否正确：在Google Cloud Console的OAuth客户端ID设置里，务必把http://localhost（或你测试用的具体端口，比如http://localhost:8080）添加到已授权的重定向URI和已授权的JavaScript来源中。
• Postman测试的正确姿势：用Postman测试时，要复制token.json里的access_token字段值，粘贴到Authorization头的Bearer后面，不要直接复制整个JSON内容或refresh_token。
• 验证令牌有效性：可以把你的access_token放到Google OAuth 2.0验证工具里（不用跳转，直接在工具里输入），确认令牌是否有效、包含的权限是否符合要求。

内容的提问来源于stack exchange，提问作者Abidus Sattar Aziz