发布至Azure App Service后无法加载Microsoft.SharePoint.Client程序集

为什么会出现这个错误？ #

这个问题本质是Azure App Service的运行环境中缺少Microsoft.SharePoint.Client.dll，而本地能正常运行的原因通常有两个：

• 你的开发机器的GAC（全局程序集缓存）里已经安装了这个程序集，所以即使项目输出目录没有，也能加载
• 之前的部署中这个dll被正确上传，但后来的部署或环境变更导致它丢失了

具体到你的情况，Kudu里只看到SharePoint.Client.Runtime，说明Microsoft.SharePoint.Client没有被包含在部署包中，大概率是依赖配置的问题。

如何确保所有依赖库随项目一同发布？ #

按以下步骤排查和修复：

1. 检查引用的「复制本地」属性

   • 在Visual Studio中，找到项目对Microsoft.SharePoint.Client的引用，右键选择「属性」
   • 将「复制本地」设置为True（这个属性决定编译时是否把dll复制到输出目录）
   • 同样检查Microsoft.SharePoint.Client.Runtime的「复制本地」属性，确保也是True

2. 验证NuGet包的完整性

   • 打开NuGet包管理器，确认Microsoft.SharePoint.Client和Microsoft.SharePoint.Client.Runtime两个包都已正确安装，且版本一致（都是16.0.0.0）
   • 如果有异常，尝试先卸载这两个包，清理项目的packages目录，再重新安装

3. 本地预验证

   • 切换到发布配置（比如Release），重新编译项目
   • 进入项目的bin\Release目录，确认Microsoft.SharePoint.Client.dll存在
   • 只有本地输出目录有这个dll，部署到Azure后才会被上传

4. CI/CD部署的额外检查

   • 如果用的是Azure DevOps、GitHub Actions等自动化部署工具，检查部署任务的配置，确保它会将bin目录下的所有文件（包括这个dll）都上传到Azure
   • 避免在部署脚本中添加了过滤特定dll的规则

为什么突然出现这个问题？ #

常见的触发原因有：

• 最近的代码变更：比如合并分支时，不小心覆盖了项目的引用配置，把「复制本地」改成了False
• NuGet包更新：如果最近更新了Microsoft.SharePoint.Client相关包，新版本的默认「复制本地」属性可能被修改
• 部署缓存异常：Azure App Service的部署缓存偶尔会出现问题，导致部分文件没有被正确上传
• 本地环境依赖：你的开发机器GAC里有这个dll，之前即使「复制本地」是False也能正常运行，但某次项目清理或环境变更后，你没注意到配置问题，部署到Azure就暴露了

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