Jenkins上传构建产物至SharePoint：REST API与OneDrive同步方案选型咨询

关于 SharePoint 文件上传 REST API 的问题 #

SharePoint 官方提供了完整的文件上传 REST API，完全支持通过接口实现文件上传操作，核心信息如下：

• 基础上传逻辑：通过POST请求到/_api/web/getfolderbyserverrelativeurl('<文件夹路径>')/files/add(overwrite=true,url='<文件名>')接口，将文件内容作为请求体上传即可。
• curl 示例（适配 SharePoint Online/2019+）：

  curl -X POST \
    "https://<你的SharePoint站点>/_api/web/getfolderbyserverrelativeurl('/Shared%20Documents/构建产物')/files/add(overwrite=true,url='app-v1.0.zip')" \
    -H "Authorization: Bearer <你的访问令牌>" \
    -H "Content-Type: application/octet-stream" \
    --data-binary "@./dist/app-v1.0.zip"
  

• 简化开发的工具/库：
  • Python 可用office365-rest-python-client库，封装了SharePoint REST API的调用逻辑，无需手动拼接请求和处理令牌；
  • PowerShell 可用PnP PowerShell模块，专门针对SharePoint自动化操作，上传文件仅需几行命令。

更优方案及两种方案对比 #

更优替代方案 #

可以直接使用 Jenkins 社区的 SharePoint Upload Plugin，这个插件专为Jenkins流水线设计，支持在Jenkinsfile中直接配置SharePoint站点信息、本地文件路径和上传目标，无需手动编写REST API请求或依赖服务器端的OneDrive同步，完全符合流水线即代码原则，移植性更强。

原有两种方案对比 #

如果不考虑插件方案，方案1（REST API）长期来看更可靠、易维护，原因如下：

• 完全贴合流水线即代码理念，所有配置都在Jenkinsfile中，服务器无需额外配置，迁移到云IaaS时只需调整API地址和令牌信息即可；
• 依赖标准REST接口，稳定性高，不会受OneDrive客户端版本、同步异常（如文件冲突、同步延迟）等问题影响；
• 可扩展性强，后续可基于API实现创建文件夹、修改文件权限等更多操作，而OneDrive同步仅能实现基础文件同步。

方案2的弊端很突出：需要在Jenkins服务器部署OneDrive客户端并配置同步，属于基础设施变更，违背流水线即代码原则；迁移时需重新配置同步关系，且同步过程中可能出现文件锁、同步失败等不可控问题，维护成本高。

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