Blazor Server用PnP.Core上传文件到SharePoint Online报401错误如何解决

问题根因 #

你遇到的401错误和浏览器安全机制没有关联，核心触发原因通常为以下三类：

• PnP上下文关联的身份凭证权限不足，没有目标SharePoint站点的文件写入权限
• 构造的服务器相对URL路径错误，导致请求命中了不存在的资源地址触发权限拦截
• Blazor默认的IBrowserFile流大小限制被触发，流被截断后导致上传请求格式异常触发鉴权失败

修复步骤 #

1. 校验权限配置 #

确保你的应用在Azure AD中已配置对应权限：

• 如果使用应用权限，需要授予Sites.ReadWrite.All或更细粒度的站点文件读写权限
• 如果使用委托权限，除了配置Azure AD权限外，还需要确保当前登录用户对目标PQI文件夹有编辑权限
  同时核对appsettings.json中PnP.Core的站点配置，确认认证信息（客户端密钥、证书、用户凭据等）填写正确。

2. 修正目标路径构造 #

你当前使用context.Uri.PathAndQuery拼接路径的方式存在问题，若站点为子站点（路径为/sites/xxx格式），会导致拼接后的路径重复，正确构造方式如下：

// 用Web对象的ServerRelativeUrl作为基础路径拼接，避免路径重复
string documentUrl = $"{context.Web.ServerRelativeUrl.TrimEnd('/')}/Documents/PQI";

3. 调整文件上传逻辑 #

Blazor的IBrowserFile.OpenReadStream()默认最大只允许读取500KB的内容，超出后会自动截断流，导致上传请求异常。需要手动指定允许的最大文件大小，同时使用带覆盖参数的上传重载，避免同名文件冲突。

// 示例最大允许上传100MB的文件，可根据业务需求调整
await using var fileStream = fileToUpload.OpenReadStream(maxAllowedSize: 100 * 1024 * 1024);
// 指定overwrite参数，同名文件直接覆盖，无需额外校验
await folder.Files.AddAsync(fileToUpload.Name, fileStream, overwrite: true);

完整修正代码 #

/// <summary>
/// 从本地上传文件到SharePoint Online文档库
/// </summary>
/// <param name="fileToUpload">用户选择的待上传文件</param>
/// <param name="pnpContextFactory">PnP上下文工厂</param>
/// <returns></returns>
public async Task<IActionResult> AddAttachment(IBrowserFile fileToUpload, PnPContextFactory pnpContextFactory)
{
    // 前置校验文件有效性
    if (fileToUpload == null || fileToUpload.Size == 0)
    {
        return BadRequest("请选择有效的文件");
    }

    using (var context = await pnpContextFactory.CreateAsync("SiteToWorkWith"))
    {
        // 构造正确的服务器相对路径
        string documentUrl = $"{context.Web.ServerRelativeUrl.TrimEnd('/')}/Documents/PQI";
        
        // 获取目标文件夹
        var folder = await context.Web.GetFolderByServerRelativeUrlAsync(documentUrl);
        if (folder == null)
        {
            return NotFound("目标存储文件夹不存在");
        }

        // 打开文件流，放开大小限制
        await using var uploadStream = fileToUpload.OpenReadStream(maxAllowedSize: 100 * 1024 * 1024);
        // 执行上传
        await folder.Files.AddAsync(fileToUpload.Name, uploadStream, overwrite: true);
    }
    return Ok("文件上传成功");
}

排查建议 #

如果修改后依然触发401错误，可以在获取文件夹前先执行一次await context.LoadAsync(p => p.Web)，如果拉取站点信息也报401，即可确认是身份认证配置问题，直接核对Azure AD权限和PnP配置即可。

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