使用shutil.copyfile复制SharePoint映射盘文件时出现无效参数错误

错误原因 #

核心问题在于映射的SharePoint Z盘并非真正的本地文件系统：

• os.path.isfile仅做路径存在性校验，能识别虚拟映射盘的路径，但不会实际打开文件；
• shutil.copyfile依赖底层普通文件IO读写文件，而SharePoint映射的网络驱动器是基于SMB协议的虚拟挂载，本质是云端文件的“虚拟访问入口”，并非本地磁盘上的真实文件，这种虚拟盘的文件访问逻辑与本地磁盘不兼容，导致打开文件时抛出无效参数错误。

你用C盘的OneDrive同步路径能正常运行，是因为该路径指向本地同步缓存的真实文件，属于本地文件系统，所有标准文件操作均可正常执行。

解决办法 #

1. 优先使用OneDrive本地同步路径（最推荐） #

直接用已验证有效的C盘路径，稳定性最高，OneDrive会自动同步到云端SharePoint：

import shutil

src_path = 'C:/Users/john/OneDrive - company/Documents/abc/def.csv'
dst_path = 'C:/Users/john/OneDrive - company/Documents/def.csv'
shutil.copyfile(src_path, dst_path)

2. 尝试修复映射盘的文件操作兼容性 #

如果必须使用Z盘路径，可尝试以下调整：

• 改用Windows原生反斜杠路径（注意转义）：

  shutil.copyfile('Z:\\abc\\def.csv', 'Z:\\def.csv')
  

• 替换shutil.copyfile为shutil.copy或shutil.copy2，二者文件处理逻辑略有不同，可能兼容虚拟盘访问：

  shutil.copy('Z:/abc/def.csv', 'Z:/def.csv')
  

• 检查文件状态：确认目标文件未被其他用户锁定，且你的账号对Z盘拥有完整读写权限。

3. 直接调用SharePoint API（云端操作，无本地依赖） #

若无需依赖本地同步，可通过Microsoft Graph API直接操作云端文件：

1. 在Azure AD注册应用并获取认证凭证；
2. 使用msgraph-sdk-python库调用API复制文件，简化示例：

   from msgraph import GraphServiceClient
   from azure.identity import ClientSecretCredential
   
   # 配置认证信息
   tenant_id = '你的租户ID'
   client_id = '你的应用ID'
   client_secret = '你的应用密钥'
   credential = ClientSecretCredential(tenant_id, client_id, client_secret)
   graph_client = GraphServiceClient(credential)
   
   # 复制文件：替换对应ID参数
   await graph_client.drives.by_drive_id('你的DriveID').items.by_drive_item_id('源文件ID').copy.post({
       "parentReference": {"driveId": "你的DriveID", "id": "目标文件夹ID"},
       "name": "def.csv"
   })
   

这种方式绕过本地映射和同步，直接与云端交互，适合无本地文件依赖的自动化场景。

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