部分租户SharePoint Online文件LastModifiedDateTime设置及重命名失败求助

首先，我注意到从周三开始不少多租户应用开发者都碰到了这个共性问题——用Graph API（.NET SDK+应用权限）操作SharePoint文档库时，上传文件一切正常，但修改fileSystemInfo.lastModifiedDateTime匹配原文件时间戳，或是重命名文件时，就会触发Microsoft.Graph.ServiceException: Code: generalException Message: An unspecified error has occurred，而此前该功能一直稳定可用。结合我处理这类问题的经验，给你几个排查和解决的方向：

1. 先确认应用权限是否仍有效 #

这类模糊的generalException有时候是权限悄悄失效导致的。你需要检查Azure AD应用注册里的权限配置：

• 确保应用拥有Sites.FullControl.All或者Sites.Manage.All权限（这两个是修改文件元数据、重命名操作的必要权限）
• 如果近期租户管理员调整过权限审批，说不定权限被撤回了，去「权限」页面确认下已授予的权限状态，要是失效了就得重新申请审批

2. 升级Graph SDK到最新稳定版 #

旧版本的.NET SDK可能和SharePoint Online最新的服务端API存在兼容性冲突，尤其是服务端有版本更新之后。建议：

• 把Microsoft.Graph NuGet包更新到最新的稳定版（目前推荐v5.x系列）
• 升级命令很简单：

  Update-Package Microsoft.Graph
  

• 另外，确保请求使用的是v1.0版本的API，别用beta版——beta版本本身就不稳定，容易触发各种不可预期的错误

3. 检查请求参数的格式是否合规 #

有时候错误是因为参数格式不符合服务端要求：

• 修改lastModifiedDateTime时，必须使用ISO 8601标准格式的时间（比如2024-05-20T14:30:00Z），别用自定义时间格式
• 重命名文件时，要确认新文件名里没有SharePoint禁止的字符：\ / : * ? " < > |
• 给你一个修改lastModifiedDateTime的正确代码示例参考：

  var targetFile = await graphClient.Sites[siteId].Drives[driveId].Items[fileItemId]
      .Request()
      .UpdateAsync(new DriveItem
      {
          FileSystemInfo = new FileSystemInfo
          {
              LastModifiedDateTime = DateTimeOffset.Parse("2024-05-20T14:30:00Z")
          }
      });
  

4. 排查租户端的服务健康状态 #

这个问题从周三集中出现，大概率和SharePoint Online的区域性服务更新有关。你可以：

• 登录Microsoft 365管理中心，查看「服务健康」板块，确认SharePoint Online有没有已知的服务中断或者警告
• 如果是微软服务端的问题，一般几个小时内会修复，多留意下服务健康公告即可

5. 开启调试日志抓取详细错误信息 #

要是上面的方法都没解决问题，就开启SDK的调试日志，查看完整的请求和响应内容，说不定能找到更具体的错误提示：

• 给你一个.NET环境下配置调试日志的示例：

  var loggerFactory = LoggerFactory.Create(builder =>
  {
      builder.AddConsole();
      builder.SetMinimumLevel(LogLevel.Debug);
  });
  
  var graphClient = new GraphServiceClient(authProvider, new[] { new DebugLoggingHandler(loggerFactory) });
  

• 日志里会显示请求头、响应体的详细信息，能帮你精准定位问题根源

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