Google Drive API 复制Team Drive文件报404与NoneType异常

核心问题根因 #

• 关键参数传位错误：从你调试时打印的404请求URL可以看到，files.copy 接口的请求中完全没有携带跨盘权限标识。当前代码将supportsAllDrives作为请求体字段传递，实际该参数是接口的URL查询参数，这种写法下参数不会被附加到请求中，服务器识别不到共享盘（原Team Drive）的访问权限，对盘内的文件直接返回404错误。
• 接口字段版本不兼容：请求体中使用了Drive v2的旧语法结构（title命名字段、嵌套结构的parents对象），v3接口不识别这些字段，即使参数位置正确也无法正常完成复制操作。
• 空异常捕获掩盖真实错误：clone变量初始为None，一旦copy接口抛出HttpError，空捕获逻辑不会打印错误信息；且后续代码默认clone不为空直接调用clone.get("id")，此时会直接抛出AttributeError，把底层的404、403等真实接口错误完全掩盖，导致前期排查时只能看到表层的空指针错误。
• 逻辑漏洞：将create_folder的调用放在分页循环内部，一旦目标文件夹下文件数量超过分页阈值（单页默认返回100条），会在目标位置重复创建多个同名的父级文件夹。

规范修正实现 #

关键调整逻辑 #

• 所有涉及共享盘访问的接口（list、copy、update、create文件夹），将supportsAllDrives、includeItemsFromAllDrives作为URL查询参数传递，不要放入请求体字典。
• v3版本接口的请求体结构：
  • 文件名对应字段为name，替代v2的title
  • 父文件夹参数直接传递ID组成的字符串数组，无需嵌套kind等旧版结构
• 调整代码结构：将目标父文件夹的创建逻辑移到函数入口，在进入分页循环前完成一次创建，避免重复建文件夹。
• 细化异常捕获逻辑，输出真实的接口错误信息，不要空捕获所有异常导致问题被掩盖。

修正后的copy接口调用示例 #

clone = service.files().copy(
    fileId=file.get('id'),
    # 以下为查询参数，正确传递跨盘权限标识
    supportsAllDrives=True,
    includeItemsFromAllDrives=True,
    # 以下为请求体字段，使用v3兼容结构
    body={
        'name': file.get('name'),
        'parents': [dst_parent_id]
    },
    # 明确指定返回字段，避免默认响应缺字段
    fields='id, name, parents'
).execute()

补充注意事项 #

• 确认OAuth授权Scope覆盖https://www.googleapis.com/auth/drive，仅持有只读Scope的账号即使有盘内权限也无法完成copy、create等写操作。
• 共享盘内的第三方关联文件可能存在跨应用权限限制，copy时需单独捕获这类错误，避免中断整个递归流程。
• 针对大目录的递归复制场景，建议预先建好完整的文件夹层级结构后再遍历拷贝文件，减少重复的create接口调用，提升执行效率。
• 原代码中copy完成后额外调用update调整父子关系的逻辑可省略，直接在copy请求的body中指定目标父级即可，减少不必要的接口开销。

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