使用MSGraph API在Python中移动SharePoint文件遇403权限错误求助

核心错误分析 #

你的代码存在3个关键问题，直接导致403访问拒绝：

1. Site ID与Drive ID混淆：代码中直接将SharePoint站点的ID（src_site_id/dst_site_id）传入by_drive_id()方法，但Graph API中，Site ID和Drive ID是完全独立的资源标识符——站点的文档库是一个单独的Drive资源，不能用Site ID代替Drive ID。
2. 跨Drive移动的API方式错误：跨站点（即跨不同Drive）移动文件时，仅通过PATCH修改parentReference无效，必须使用Graph API专门的move动作端点。同一Drive内移动可以用PATCH，但跨Drive必须调用/move接口。
3. 目标文件夹路径遍历逻辑缺失：遍历目标文件夹路径时，未更新drive_items为当前文件夹的子项，导致无法正确嵌套查找深层文件夹（对比你同事的下载代码，其会递归获取子项）。

修复步骤与修正代码 #

步骤1：新增获取站点对应Drive ID的方法 #

每个SharePoint站点默认包含一个文档库（Drive），需通过Site端点获取对应的Drive ID：

async def get_site_drive_id(self, site_id):
    # 获取站点默认文档库的Drive ID
    drive = await self.user_client.sites.by_site_id(site_id).drive.get()
    return drive.id

步骤2：修正后的移动文件函数 #

async def _move_sharepoint_file(self, url, site_name, src_drive_path, file_name, dst_site_name, dst_drive_path, new_file_name=None):
    # 获取源站点ID
    sites = await self.user_client.sites.with_url(url).get()
    src_site_id = None
    dst_site_id = None
    for site in sites.value:
        if site.name == site_name:
            src_site_id = site.id
        if site.name == dst_site_name:
            dst_site_id = site.id
    if not src_site_id:
        raise ValueError(f"源站点 '{site_name}' 未找到")
    if not dst_site_id:
        raise ValueError(f"目标站点 '{dst_site_name}' 未找到")

    # 获取源/目标站点对应的Drive ID
    src_drive_id = await self.get_site_drive_id(src_site_id)
    dst_drive_id = await self.get_site_drive_id(dst_site_id)

    # 获取源文件ID
    src_item_id = await self.get_item_id(src_drive_id, src_drive_path, file_name)
    if not src_item_id:
        raise ValueError(f"源路径 '{src_drive_path}' 中未找到文件 '{file_name}'")

    # 获取目标文件夹ID（修复路径遍历逻辑）
    path_list = dst_drive_path.replace("\\", "/").split('/')
    current_folder_id = "root"  # 从Drive根目录开始
    for dir_name in path_list:
        if not dir_name:  # 处理空路径（如根目录）
            continue
        # 获取当前文件夹的子项
        children = await self.user_client.drives.by_drive_id(dst_drive_id).items.by_drive_item_id(current_folder_id).children.get()
        target_folder = next((item for item in children.value if item.name == dir_name and hasattr(item, 'folder')), None)
        if not target_folder:
            raise ValueError(f"目标路径中未找到文件夹 '{dir_name}'")
        current_folder_id = target_folder.id
    dst_folder_id = current_folder_id

    # 准备移动请求体
    request_body = {
        "parentReference": {
            "driveId": dst_drive_id,
            "id": dst_folder_id
        },
        "name": new_file_name if new_file_name else file_name
    }

    # 调用跨Drive移动API
    try:
        result = await self.user_client.drives.by_drive_id(src_drive_id).items.by_drive_item_id(src_item_id).move.post(body=request_body)
        print("文件移动成功")
        return result
    except Exception as e:
        print(f"移动失败: {str(e)}")
        return None

额外验证点 #

• 确认File.ReadWrite.All权限已授予管理员同意（应用权限场景），或当前用户确实拥有源/目标站点文档库的编辑权限（委托权限场景）。
• 若同一站点内移动，可复用原PATCH方式，但需确保传入的是Drive ID而非Site ID。

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