.NET Core中使用SharePoint Online CSOM访问库遇400错误求助

你在.NET Core环境里用Microsoft.SharePointOnline2016.CSOM包访问SharePoint文档库时碰到的400 Bad Request错误，我之前帮不少开发者排查过，大多是版本兼容、身份验证或配置细节出了问题，下面给你几个针对性的解决方案：

1. 先修正CSOM包的版本匹配问题 #

你当前用的Microsoft.SharePointOnline2016.CSOM是专门给SharePoint 2016本地部署版设计的，如果连接的是微软365中的SharePoint Online，版本不匹配就很容易触发请求错误。

解决步骤：

• 卸载旧包：Uninstall-Package Microsoft.SharePointOnline2016.CSOM
• 安装适配SharePoint Online的CSOM包：Install-Package Microsoft.SharePointOnline.CSOM -Version 16.0.24121.12000（可选择最新的.NET Core兼容版本）

2. 确认ClientContext初始化是否正确 #

400错误常出现在ClientContext身份验证配置错误或站点URL拼写失误的场景。SharePoint Online需要专用的凭据方式，这里给你一个标准的初始化示例：

using Microsoft.SharePoint.Client;
using System.Security;

string siteUrl = "https://yourtenant.sharepoint.com/sites/yoursite"; // 替换为你的实际站点URL
string userName = "your-account@yourtenant.onmicrosoft.com";
string password = "your-password";

// 将密码转换为SecureString格式
SecureString securePwd = new SecureString();
foreach (char c in password)
{
    securePwd.AppendChar(c);
}

// 初始化带有效凭据的ClientContext
ClientContext ctx = new ClientContext(siteUrl);
ctx.Credentials = new SharePointOnlineCredentials(userName, securePwd);

如果你的账号开启了MFA，普通用户名密码凭据会失效，建议改用PnP.Framework库的AuthenticationManager处理MFA认证。

3. 检查文档库名称的准确性 #

确保传入的libraryName是文档库的显示名称，大小写、空格必须完全匹配，不能使用文档库的URL别名。如果想更可靠，推荐用GetByUrl方法通过相对URL获取文档库：

// 示例：获取"共享文档"库，相对URL为/sites/yoursite/Shared Documents
List oList = ctx.Web.GetList("/sites/yoursite/Shared%20Documents");

4. 排查权限问题 #

虽然400是Bad Request，但权限不足有时也会被包装成这个错误。请确认当前账号对目标文档库至少拥有读取权限，上传文件则需要编辑权限。

5. 适配.NET Core的Http请求配置 #

.NET Core默认的HttpHandler可能和旧版CSOM存在兼容性问题，你可以尝试设置自定义的WebRequestExecutor：

ctx.WebRequestExecutorFactory = new WebRequestExecutorFactory();

最后给你修改后的完整测试代码，增加了错误日志便于排查：

using Microsoft.SharePoint.Client;
using System;
using System.Security;

public static void UploadDocumentContent(ClientContext ctx, string libraryName)
{
    try
    {
        // 先验证ClientContext凭据是否配置
        if (ctx.Credentials == null)
        {
            throw new InvalidOperationException("请先为ClientContext配置有效的SharePoint Online凭据");
        }

        List oList = ctx.Web.Lists.GetByTitle(libraryName);
        ctx.Load(oList.RootFolder);
        ctx.Load(oList.Fields);
        ctx.ExecuteQuery();

        Console.WriteLine($"成功访问文档库：{oList.Title}，根文件夹路径：{oList.RootFolder.ServerRelativeUrl}");
    }
    catch (Exception ex)
    {
        Console.WriteLine($"请求出错：{ex.Message}");
        Console.WriteLine($"详细堆栈信息：{ex.StackTrace}");
        // 若为WebException，可获取响应状态码
        if (ex is System.Net.WebException webEx)
        {
            var response = webEx.Response as System.Net.HttpWebResponse;
            if (response != null)
            {
                Console.WriteLine($"响应状态码：{(int)response.StatusCode} - {response.StatusDescription}");
            }
        }
    }
}

内容的提问来源于stack exchange，提问作者Saif ur Rehman