使用gspread提取Google Sheets指定工作表列数据报错及合并需求求助

一、解决"expected_headers are not uniques"错误 #

这个错误是因为你使用get_all_records()或类似依赖表头的方法时，指定的expected_headers存在重复值，或者目标工作表的A、B列表头本身重复。

修复方案： #

放弃依赖表头匹配，直接按列位置提取数据（A列对应索引0，B列对应索引1，get_all_values()返回的二维列表中，每个子列表的索引对应列顺序）：

# 获取单个工作表的A、B列数据示例
worksheet = client.open("你的表格名").worksheet("Sheet 1")
all_values = worksheet.get_all_values()
# 提取A、B列：每个行取索引0和1的元素
ab_columns = [row[:2] for row in all_values]

如果必须使用表头匹配，先检查目标工作表的A、B列表头是否重复，修改为唯一值后再使用：

# 确保表头唯一后调用
records = worksheet.get_all_records(expected_headers=["唯一表头1", "唯一表头2"])

二、多工作表数据合并逻辑 #

核心思路：循环遍历指定工作表列表，逐个提取A、B列数据，合并到统一数据集（注意处理表头，避免重复添加）。

完整代码示例 #

import gspread
from oauth2client.service_account import ServiceAccountCredentials

# 初始化gspread客户端
scope = ["https://spreadsheets.google.com/feeds", "https://www.googleapis.com/auth/drive"]
creds = ServiceAccountCredentials.from_json_keyfile_name("你的密钥文件.json", scope)
client = gspread.authorize(creds)

# 配置参数
spreadsheet_name = "你的Google Sheets文件名"
target_sheets = ['Sheet 1', 'Sheet 2', 'Sheet 3']

# 初始化合并数据集
merged_data = []

# 遍历目标工作表
for sheet_name in target_sheets:
    try:
        worksheet = client.open(spreadsheet_name).worksheet(sheet_name)
        all_values = worksheet.get_all_values()
        
        # 仅在第一次添加表头
        if not merged_data:
            merged_data.append(all_values[0][:2])  # 添加A、B列表头
        
        # 添加数据行（跳过表头行）
        for row in all_values[1:]:
            # 处理行长度不足的情况，避免索引越界
            a_value = row[0] if len(row) > 0 else ""
            b_value = row[1] if len(row) > 1 else ""
            merged_data.append([a_value, b_value])
            
    except gspread.exceptions.WorksheetNotFound:
        print(f"工作表 {sheet_name} 不存在，跳过")

# 输出合并后的数据（或保存到文件/数据库）
for row in merged_data:
    print(row)

关键细节： #

• 用try-except捕获工作表不存在的异常，避免程序崩溃
• 处理行长度不足的情况，防止索引越界报错
• 仅在合并数据集为空时添加表头，避免重复
• 如果不需要表头，直接从all_values[1:]开始遍历添加

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