先从你提到的drive.files.list找不到文件的问题入手——这大概率和服务账号的权限配置有关，先把这个核心障碍解决，再实现完整的 upsert（更新/插入）逻辑。

一、排查drive.files.list查不到文件的常见原因 #

服务账号不是你的个人账号，它有自己独立的Drive存储空间，默认看不到你个人Drive或团队盘里的内容，你需要先确认这几点：

1. 共享目标文件夹给服务账号
   找到服务账号的邮箱（在Google Cloud控制台 → IAM与管理员 → 服务账号里查看），打开你要操作的Google Drive文件夹，把这个邮箱添加为编辑者或所有者。没共享的话，服务账号根本访问不到这个文件夹里的任何文件。

2. 检查drive.files.list的查询参数
   要精准定位目标文件，q参数必须写对，比如要找目标文件夹ID下名为test.txt且未被删除的文件，q应该是：

   q = f"name='test.txt' and '{你的文件夹ID}' in parents and trashed=false"
   

   注意文件名要用单引号包裹，trashed=false能排除已放入回收站的文件。

3. 如果是团队盘（Shared Drive），必须加这两个参数
   如果你操作的是团队盘，调用files.list时必须添加supportsAllDrives=True和includeItemsFromAllDrives=True，否则服务账号无法读取团队盘内容。

给你一个可直接测试的查询示例（用google-api-python-client）：

from googleapiclient.discovery import build
from google.oauth2.service_account import Credentials

# 加载服务账号凭证
creds = Credentials.from_service_account_file('你的服务账号密钥.json')
service = build('drive', 'v3', credentials=creds)

# 查询目标文件
response = service.files().list(
    q="name='test.txt' and '123abcXYZ' in parents and trashed=false",
    fields='files(id, name)',
    supportsAllDrives=True,
    includeItemsFromAllDrives=True
).execute()

files = response.get('files', [])
if files:
    print(f"找到文件：ID={files[0]['id']}, 名称={files[0]['name']}")
else:
    print("未找到目标文件，请检查共享权限和查询参数")

二、实现“存在更新，不存在新建”的完整逻辑 #

当能成功查询到文件后，就可以分两种情况处理：

• 找到文件：调用files.update上传新内容（默认会生成新版本，符合你的预期）
• 没找到文件：调用files.create在目标文件夹下新建文件

完整的Python实现代码：

from googleapiclient.http import MediaFileUpload

def upsert_drive_file(service, target_folder_id, filename, local_file_path):
    # 1. 查询目标文件夹下的同名文件
    query = f"name='{filename}' and '{target_folder_id}' in parents and trashed=false"
    response = service.files().list(
        q=query,
        fields='files(id)',
        supportsAllDrives=True,
        includeItemsFromAllDrives=True
    ).execute()
    existing_files = response.get('files', [])

    if existing_files:
        # 2. 文件存在，执行更新（自动生成新版本）
        file_id = existing_files[0]['id']
        media = MediaFileUpload(local_file_path, resumable=True)
        updated_file = service.files().update(
            fileId=file_id,
            media_body=media
        ).execute()
        print(f"✅ 文件已更新：{updated_file['name']}，新版本已生成")
        return updated_file
    else:
        # 3. 文件不存在，执行新建
        file_metadata = {
            'name': filename,
            'parents': [target_folder_id]
        }
        media = MediaFileUpload(local_file_path, resumable=True)
        new_file = service.files().create(
            body=file_metadata,
            media_body=media,
            fields='id, name'
        ).execute()
        print(f"✅ 文件已新建：ID={new_file['id']}, 名称={new_file['name']}")
        return new_file

# 调用示例
# upsert_drive_file(service, "你的文件夹ID", "test.txt", "./本地文件路径/test.txt")

额外提醒 #

• 文件名唯一性：如果目标文件夹下有多个同名文件，files.list会返回所有结果，建议确保文件夹内文件名唯一，或者根据文件修改时间选择最新的那个进行更新。
• API启用检查：在Google Cloud控制台的API库中，确认已经启用了Google Drive API，否则所有请求都会失败。
• 配额限制：Drive API有请求配额，批量操作时注意不要超过限制，避免被限流。

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