为服务账户授权谷歌表格后仍报SpreadSheetNotFound异常的排查

核心问题：调用方法参数错误 #

gc.open() 方法接收的参数是谷歌表格的名称（即表格标题栏显示的文本），而非表格的URL。你当前传入GOOGLE_SHEET_URL，会导致gspread无法匹配到目标表格，直接抛出SpreadSheetNotFound异常。

修正后的代码示例 #

import gspread

gc = gspread.service_account(filename='./credentials.json')
# 替换为你的谷歌表格实际名称，比如"月度数据统计"
spreadsheet = gc.open("你的表格名称")
worksheet = spreadsheet.sheet1
values_list = worksheet.get_all_values()

print(values_list)

其他可能的排查点（若修正参数后仍报错） #

• 确认服务账户邮箱无误：复制GCP服务账户的完整邮箱地址，确保添加到表格共享列表时没有输入错误，且权限设置为「编辑者」
• 检查表格状态：确认目标表格未被删除、归档，且用服务账户邮箱对应的账号能在浏览器中正常打开该表格
• 验证凭证文件：确保credentials.json是从GCP服务账户正确下载的，文件路径无误、内容未被修改

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