使用Databricks从SharePoint下载文件时获取应用令牌失败求助

开发者阿泽

2026-7-7

解决SharePoint与Databricks连接的Acquire app-only access token failed问题

针对你遇到的问题，从几个核心方向排查：

确认ClientCredential参数有效性
ClientCredential的参数顺序是对的：第一个是Client ID，第二个是Client Secret。重点要确认填入的是新应用注册对应的有效ID和密钥，检查是否有拼写错误、多余空格，或者密钥是否已过期（Azure AD应用密钥默认1年有效期）。
核查应用注册的权限配置
即使管理员配置了密钥，新应用注册可能缺失关键权限：
- 必须在Azure AD中给应用授予SharePoint的应用权限（而非委派权限），比如Sites.Read.All或Sites.FullControl.All，权限范围要匹配你的操作需求
- 所有应用权限必须经过租户管理员同意，未完成同意步骤会直接导致令牌获取失败
- 确认应用注册的受众范围是你的租户（而非多租户），除非你的场景明确需要跨租户访问
验证URL参数准确性
- site_url必须是SharePoint站点的完整URL，例如https://yourtenant.sharepoint.com/sites/yourtargetsite
- file_url是服务器相对路径，比如/sites/yourtargetsite/Shared Documents/YourFolder，要确保该路径真实存在且应用有权限访问
增强错误日志定位问题
当前代码只打印异常信息，无法获取细节，修改异常捕获逻辑获取完整堆栈：
```
except Exception as e:
    import traceback
    print(f"错误详情: {str(e)}")
    traceback.print_exc()
```
完整的堆栈信息会暴露隐藏问题，比如权限不足、URL无效、网络连通性问题等。
检查Databricks网络连通性
确保Databricks工作区能正常访问Azure AD（login.microsoftonline.com）和SharePoint站点域名，私网环境下需要配置防火墙或VPC出站规则允许这些端点的流量。