手动插入行后Google Sheets PHP API无法追加数据的解决方法

首先明确：你碰到的cURL error 6: Could not resolve host本质是DNS解析失败，和手动插入表格行没有直接逻辑关联，大概率是巧合触发了运行环境的DNS异常。不过可以通过以下步骤彻底解决，同时确保脚本不受表格结构变化影响：

一、先修复DNS解析问题 #

• 换用公共DNS服务器：在运行脚本的机器上，把DNS改成8.8.8.8或1.1.1.1，再测试脚本是否正常。
• 检查本地hosts文件：确认没有错误映射oauth2.googleapis.com的条目，有就删掉。
• 刷新DNS缓存：Linux执行systemctl restart network，Windows重启网卡或执行ipconfig /flushdns。

二、优化API调用逻辑（适配表格结构变化） #

就算DNS问题解决，也可以优化脚本，确保不管表格插行、加列都能稳定追加数据：

1. 强制指定插入新行
   原代码的追加逻辑默认会依赖表格自动识别的现有数据区域，改成强制插入新行，避免受手动操作影响：

   $options = [
       "valueInputOption" => "USER_ENTERED",
       "insertDataOption" => "INSERT_ROWS" // 明确告诉API插入新行，而非追加到现有区域末尾
   ];
   

2. 维护有效OAuth令牌
   旧令牌过期或异常可能间接导致网络请求失败，添加令牌自动刷新逻辑：

   // 初始化客户端后添加
   if ($client->isAccessTokenExpired()) {
       $client->fetchAccessTokenWithRefreshToken($client->getRefreshToken());
       // 把新令牌保存到文件，下次直接复用
       file_put_contents('token.json', json_encode($client->getAccessToken()));
   }
   

   注意第一次授权后要把refresh token保存下来，避免每次都重新走授权流程。

三、排查巧合关联的潜在原因 #

如果确实只有插行后才报错，可能是插行触发了表格同步，导致脚本执行时网络临时波动，可以加个重试机制：

// 给Google客户端设置带重试的HTTP客户端
$client->setHttpClient(new GuzzleHttp\Client([
    'middleware' => [
        GuzzleHttp\Middleware::retry(function ($retries, $request, $response, $exception) {
            // 最多重试3次，只重试连接类错误
            return $retries < 3 && ($exception instanceof GuzzleHttp\Exception\ConnectException);
        })
    ]
]));

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