使用C#结合Microsoft Graph证书认证上传文件至SharePoint遇阻

问题概述 #

• 客户提供PFX证书、ClientID、TenantID，允许访问其SharePoint站点，需用C#实现文件上传（客户已通过PowerShell测试成功）
• 程序需每日定期运行，跨系统复制文件，不需要异步方案
• 当前代码编译失败，最后一行await相关代码无法通过，多方查找示例均无效，询问C#是否可行

编译失败原因及修正方案 #

1. 异步方法返回值错误 #

原方法用async void，仅适用于事件处理场景，await需要在async Task或async Task<T>方法中执行。如果不需要异步，可改用同步调用方式。

2. 文件路径参数错误 #

ItemWithPath(fileName)传入了本地完整路径，会导致SharePoint尝试创建对应嵌套目录，应仅传入文件名（如upload.doc）。

3. 权限与证书加载问题 #

• 确保Azure AD应用注册已添加应用权限（非委托权限）：Files.ReadWrite.All或Sites.ReadWrite.All，且已获得管理员同意
• 加载证书时添加X509KeyStorageFlags参数，避免权限不足问题

修正后的同步代码示例 #

using System.IO;
using System.Security.Cryptography.X509Certificates;
using Azure.Identity;
using Microsoft.Graph;

public static void TestClientCert()
{
    var scopes = new[] { "https://graph.microsoft.com/.default" };
    var clientId = "你的ClientID";
    var tenantId = "你的TenantID";
    // 加载证书，添加存储标志避免权限问题
    var clientCertificate = new X509Certificate2(
        @"c:\work\Test.pfx", 
        "证书密码", 
        X509KeyStorageFlags.Exportable | X509KeyStorageFlags.PersistKeySet);

    var options = new ClientCertificateCredentialOptions
    {
        AuthorityHost = AzureAuthorityHosts.AzurePublicCloud,
    };

    var clientCertCredential = new ClientCertificateCredential(
        tenantId, 
        clientId, 
        clientCertificate, 
        options);

    var gc = new GraphServiceClient(clientCertCredential, scopes);

    var localFilePath = @"c:\work\fileToUpload\upload.doc";
    var fileName = Path.GetFileName(localFilePath); // 提取仅文件名

    using (Stream fileStream = new FileStream(
        localFilePath,
        FileMode.Open,
        FileAccess.Read))
    {
        // 同步调用，避免异步
        var resultDriveItem = gc.Sites["你的SiteID"]
                .Drives["目标DriveID或索引"].Root.ItemWithPath(fileName)
                .Content.Request().PutAsync<DriveItem>(fileStream).Result;
    }
}

额外注意事项 #

• SiteID验证：SiteID格式为{租户域名},{站点ID},{WebID}，可通过Graph Explorer查询获取
• Drive定位：若站点有多个文档库，不建议用Drives[0]，应直接使用目标文档库的Drive ID，避免索引变化导致错误
• 证书权限：若运行时出现证书私钥访问错误，确保运行程序的账户有证书读取权限

内容的提问来源于stack exchange，提问作者D. Kelly