使用CSOM执行CRUD操作时403禁止错误的排查与解决

我在使用CSOM（C#操作SharePoint/Microsoft List的编程技术）执行CRUD操作时，调用ClientContext.ExecuteQuery()抛出403 Forbidden错误，错误类型为System.Net.WebException（HResult=0x80131509），堆栈信息显示错误发生在获取响应阶段。当前凭据配置代码如下：

using (ClientContext ctx = new ClientContext("(URL TO THE SHAREPOINT SITE)"))
{
    ctx.Credentials = new System.Net.NetworkCredential(txtUsername.Text, txtPassword.Text);
}

已尝试设置System.Net.ServicePointManager.Expect100Continue = false;但无效，怀疑密码字符串格式问题，同时针对排查方案有以下疑问及对应解决方法：

1. 服务器状态与网络检查步骤 #

• 直接在浏览器访问SharePoint站点的_api/web端点，确认返回正常的JSON响应，排除站点本身不可用的情况
• 用ping <站点域名>命令测试服务器连通性，检查是否存在网络丢包
• 用telnet <站点域名> 443命令测试HTTPS端口是否能正常连通
• 联系管理员确认当前机器IP不在SharePoint站点的IP黑名单中
• 换一台机器用同一账号访问站点，排查是否是当前机器的网络环境限制

2. 启用网络追踪查看传输过程 #

在项目的App.config或Web.config中添加以下配置，运行程序后会生成network_trace.log文件，完整记录HTTP请求和响应细节：

<system.diagnostics>
  <sources>
    <source name="System.Net" tracemode="includehex" maxdatasize="1024">
      <listeners>
        <add name="System.Net"/>
      </listeners>
    </source>
    <source name="System.Net.Sockets">
      <listeners>
        <add name="System.Net"/>
      </listeners>
    </source>
    <source name="System.Net.Cache">
      <listeners>
        <add name="System.Net"/>
      </listeners>
    </source>
  </sources>
  <sharedListeners>
    <add name="System.Net"
      type="System.Diagnostics.TextWriterTraceListener"
      initializeData="network_trace.log"
    />
  </sharedListeners>
  <switches>
    <add name="System.Net" value="Verbose"/>
    <add name="System.Net.Sockets" value="Verbose"/>
    <add name="System.Net.Cache" value="Verbose"/>
  </switches>
  <trace autoflush="true"/>
</system.diagnostics>

触发错误后打开日志文件，查看请求头、认证信息、响应状态码等内容，定位认证过程是否异常。

3. 确认.NET Framework版本并升级 #

查看当前版本 #

• 打开项目属性的「应用程序」标签页，查看「目标框架」的当前值
• 或在代码中添加以下语句，运行后输出当前运行时版本：

Console.WriteLine(System.Runtime.InteropServices.RuntimeEnvironment.GetSystemVersion());

升级到最新版本 #

• 通过Visual Studio的「工具」->「获取工具和功能」，在安装程序中选择对应.NET Framework组件更新
• 或通过官方渠道下载对应版本的安装包进行安装

4. 重写ClientContext的GetWebRequest方法 #

创建自定义ClientContext类，重写GetWebRequest方法以修改请求属性：

public class CustomClientContext : ClientContext
{
    public CustomClientContext(string siteUrl) : base(siteUrl) { }

    protected override WebRequest GetWebRequest(Uri url)
    {
        WebRequest request = base.GetWebRequest(url);
        // 可在此添加自定义逻辑，比如修改请求头、调整认证参数
        request.Headers.Add("X-Custom-Header", "Value");
        return request;
    }
}

使用时替换原有ClientContext：

using (CustomClientContext ctx = new CustomClientContext("(URL TO THE SHAREPOINT SITE)"))
{
    ctx.Credentials = new System.Net.NetworkCredential(txtUsername.Text, txtPassword.Text);
    // 执行CRUD操作
}

额外问题：获取Microsoft List编辑权限链接仍报403 #

• 确认账号拥有该List的编辑权限，而非仅站点访问权限，可通过SharePoint站点的List设置->权限设置查看
• 若账号启用MFA（多因素认证），NetworkCredential无法直接认证，需改用SharePointOnlineCredentials：

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

SecureString securePassword = new SecureString();
foreach (char c in txtPassword.Text)
{
    securePassword.AppendChar(c);
}
ctx.Credentials = new SharePointOnlineCredentials(txtUsername.Text, securePassword);

• 检查List权限是否继承自站点，若已断开继承，需单独给账号分配List编辑权限

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