PHP调用Google Sheets API创建表格后追加数据报404错误排查

问题根因 #

核心触发原因和重复初始化客户端无关，你传递给追加接口的spreadsheetID末尾携带了不可见的换行符：
你在create_spreadsheet()中给全局变量赋值时写了$var1=sprintf("%s\n", $spreadsheet->spreadsheetId);，格式串里的\n会在ID字符串末尾追加一个换行符。你用echo输出时肉眼看不到这个换行，会误以为ID完全正确，但实际传给API的ID多了无效空白字符，接口匹配不到对应表格就会返回Requested entity was not found的404错误。

另外你的代码里还有两个不影响本次报错但存在隐患的问题：

• 两个函数重复初始化$client、$db、$service实例属于冗余逻辑，会增加不必要的token拉取、实例创建开销
• 用全局变量跨函数传ID的写法非常容易出现变量覆盖、值污染的问题，你同时给append_to_sheet()定义了同名入参又在函数内声明同名全局变量，本身就存在变量冲突风险

修复步骤 #

1. 移除spreadsheetId赋值时的换行符，不要在ID字符串后拼接\n
2. 废弃全局变量传值逻辑，让create_spreadsheet()直接返回新建得到的spreadsheetId，调用时把返回值作为参数传入append_to_sheet()
3. 把Google客户端、服务实例的初始化抽为公共复用逻辑，避免重复初始化

修正后代码参考 #

// 公共初始化逻辑，抽离复用
function get_sheets_service() {
    $client = new Google_Client();
    $db = new DB();
    $arr_token = (array) $db->get_access_token();
    $accessToken = [
        'access_token' => $arr_token['access_token'],
        'expires_in' => $arr_token['expires_in'],
    ];
    $client->setAccessToken($accessToken);
    return new Google_Service_Sheets($client);
}

// 新建表格，直接返回表格ID
function create_spreadsheet() {
    $service = get_sheets_service();
    // ... 原有的新建表格逻辑 ...
    printf("Spreadsheet ID: %s\n", $spreadsheet->spreadsheetId);
    // 直接返回ID，不要加换行符
    return $spreadsheet->spreadsheetId;
}

// 追加数据，通过入参接收表格ID
function append_to_sheet($spreadsheetId) {
    $service = get_sheets_service();
    echo "当前操作的表格ID: " . $spreadsheetId;
    // ... 原有的追加数据逻辑，注意追加范围要写对，一般格式为'Sheet1!A:Z'，匹配实际工作表名称即可
}

// 调用逻辑
$newSheetId = create_spreadsheet();
// 如果遇到极个别新建后立刻访问提示不存在的情况，可以加1-2秒的等待适配API的最终一致性传播
// sleep(2);
append_to_sheet($newSheetId);

补充说明：如果移除换行符后仍偶发报错，可以在新建表格和追加操作之间加1-2秒的等待，适配Google API的多区域数据最终一致性传播延迟，这种情况出现概率极低。

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