使用Python从SharePoint下载文件返回200却得到错误HTML页面

可能原因 #

• ClientContext初始化URL错误：你用了文档库的列表视图页面（AllItems.aspx）作为ClientContext的URL，而SharePoint ClientContext需要指向站点根URL（而非具体页面），这会导致后续API请求路径解析出错。
• 文件路径格式不正确：File.open_binary接收的是服务器相对路径，直接写/folder/filename.docx可能无法正确定位文件，因为缺少站点前缀或路径层级不匹配。
• 应用权限不足：你的应用可能未被授予目标站点的读取权限，导致SharePoint返回伪装成200响应的错误页面。

解决步骤 #

1. 修正ClientContext的初始化URL #

将ClientContext的URL改为站点根地址，去掉末尾的页面路径：

site_url = 'https://<tenant>/sites/sitesname'
ctx_auth = AuthenticationContext(site_url)
ctx_auth.acquire_token_for_app(client_id='CLIENT_ID', client_secret='CLIENTSECRET')
ctx = ClientContext(site_url, ctx_auth)

2. 正确指定文件路径 #

推荐两种可靠的文件定位方式：

方式一：使用完整服务器相对路径

路径需包含站点前缀，确保SharePoint能准确定位：

file_path = "/sites/sitesname/folder/filename.docx"
response = File.open_binary(ctx, file_path)

方式二：通过文档库+文件夹获取文件（更稳健）

这种方式可避免路径拼写错误，同时能主动确认文件存在性：

# 替换为你的文档库标题，比如默认的"Documents"
library = ctx.web.lists.get_by_title("Documents")
# 获取目标文件夹
folder = library.root_folder.folders.get_by_url("folder")
# 获取目标文件
file = folder.files.get_by_url("filename.docx")
ctx.load(file)
ctx.execute_query()
# 下载文件
response = File.open_binary(ctx, file.serverRelativeUrl)

3. 验证并配置应用权限 #

确保Azure AD应用已获得目标站点的读取权限：

• 访问站点的应用权限管理页面：https://<tenant>/sites/sitesname/_layouts/15/appinv.aspx
• 输入应用Client ID，在权限请求XML中添加读取权限：

  <AppPermissionRequests AllowAppOnlyPolicy="true">
    <AppPermissionRequest Scope="http://sharepoint/content/sitecollection" Right="Read" />
  </AppPermissionRequests>
  

• 提交并完成授权确认。

4. 添加错误校验逻辑 #

下载前可先检查响应类型，避免写入错误的HTML内容：

if response.headers.get('Content-Type') == 'text/html':
    print("请求出错，返回错误页面")
    # 打印完整HTML可查看具体错误详情
    print(response.content.decode('utf-8'))
else:
    with open("./TEST.docx", "wb") as local_file:
        local_file.write(response.content)

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