使用PHP SDK调用Google Drive API复制文件触发用户速率限制问题

看起来你遇到的核心问题是Google Drive API的用户级速率限制——这个限制和你的Drive存储空间完全无关，哪怕是无限空间的账号，API调用的频率和次数也会被严格管控。从你提供的API仪表盘数据（1小时344次请求）来看，不是总请求数超限，而是短时间内的请求频率超过了Google的限制（通常是每分钟100次左右的用户级配额）。另外，你的批量请求代码还存在一个关键错误，导致它并没有真正发挥批量请求的优势，反而和单文件请求一样在短时间内触发了限制。

下面是具体的解决方案：

1. 修复批量请求的代码错误 #

你当前的批量代码其实是逐个执行了每个copy请求，再把结果塞进batch里，这完全没用到批量请求的核心特性（一次性发送多个操作，降低请求频率）。正确的批量请求应该是先把所有copy操作添加到batch对象，再一次性执行。

修正后的批量代码：

$batchSize = 20; // 先降低单次批量的数量，避免触发频率限制
$qrun = $conn->prepare("SELECT * FROM episode WHERE drive!='' and mydrive is null limit ?");
$qrun->bind_param("i", $batchSize);
$qrun->execute();
$episode = $qrun->fetchAll();

$batch = $service->createBatch();
$num = 0;

foreach($episode as $item){
    $fileMetadata = new Google_Service_Drive_DriveFile(array(
        'parents' => array('parent folder id') // 替换为你的目标文件夹ID
    ));
    
    // 构建copy请求对象（不立即执行）
    $copyRequest = $service->files->copy($item['drive'], $fileMetadata);
    // 将请求添加到batch队列
    $batch->add($copyRequest, 'copy-' . $num);
    $num++;
}

// 一次性执行所有批量请求
try {
    $results = $batch->execute();
    
    // 处理结果并安全更新数据库
    foreach($results as $key => $response) {
        $index = str_replace('response-copy-', '', $key);
        $episodeId = $episode[$index]['id'];
        $newDriveId = $response->id;
        
        // 使用参数绑定避免SQL注入风险
        $qrun2 = $conn->prepare("UPDATE episode SET mydrive = ? WHERE id = ?");
        $qrun2->bind_param("si", $newDriveId, $episodeId);
        $qrun2->execute();
    }
} catch (Google_Service_Exception $e) {
    echo "批量请求错误: " . $e->getMessage();
}

2. 添加速率控制与重试机制 #

即使修复了批量代码，仍然可能遇到速率限制，这时候需要添加请求间隔控制和指数退避重试（Google官方推荐的错误处理策略）：

方案A：分批次处理+固定间隔 #

如果你的文件数量较多，不要一次性处理所有，分批次执行，每处理完一批就等待一段时间：

$batchSize = 20;
$totalProcessed = 0;

while(true) {
    // 查询未处理的文件
    $qrun = $conn->prepare("SELECT * FROM episode WHERE drive!='' and mydrive is null limit ?");
    $qrun->bind_param("i", $batchSize);
    $qrun->execute();
    $episode = $qrun->fetchAll();
    
    if(empty($episode)) break; // 没有更多文件，退出循环
    
    // 执行批量请求（代码同上面修正后的批量代码）
    // ...批量请求代码...
    
    $totalProcessed += count($episode);
    echo "已处理 {$totalProcessed} 个文件，等待60秒...";
    sleep(60); // 等待1分钟再处理下一批，避免触发频率限制
}

方案B：指数退避重试（处理单个请求失败的情况） #

对于偶尔出现的403错误，可以添加重试逻辑，每次失败后等待更长的时间：

function copyDriveWithRetry($service, $driveId, $folderId, $maxRetries = 5) {
    $retryDelay = 1; // 初始延迟1秒
    
    for($i=0; $i<$maxRetries; $i++) {
        try {
            $fileMetadata = new Google_Service_Drive_DriveFile(array(
                'parents' => array($folderId)
            ));
            $result = $service->files->copy($driveId, $fileMetadata);
            return $result->id;
        } catch (Google_Service_Exception $e) {
            if($e->getCode() == 403 && strpos($e->getMessage(), 'User rate limit exceeded') !== false) {
                // 速率限制错误，等待后重试
                sleep($retryDelay);
                $retryDelay *= 2; // 指数退避，下次等待时间翻倍
            } else {
                // 其他错误，直接抛出
                throw $e;
            }
        }
    }
    
    throw new Exception("超过最大重试次数，无法复制文件 {$driveId}");
}

// 使用这个重试函数替代原来的copydrive
$newid = copyDriveWithRetry($GLOBALS['service'], $episode['drive'], $folderid);

3. 检查并调整API配额 #

你可以登录Google Cloud控制台，找到你的项目，进入API和服务 -> 配额页面，查看Drive API的用户级配额限制：

• 通常默认的用户级配额是每分钟100次请求
• 如果你的业务需要更高的配额，可以点击配额旁边的"编辑配额"按钮，提交申请提升限额（需要说明你的使用场景）

总结 #

• 先修复批量请求的代码错误，确保真正利用批量请求的特性
• 添加速率控制（分批次+间隔）和重试机制，避免短时间内发送过多请求
• 检查API配额，必要时申请提升限额

内容的提问来源于stack exchange，提问作者John Doe