使用Microsoft Graph API访问个人OneDrive文件时出现间歇性404错误

架构老林

2026-6-14

间歇性404/UnknownError：Microsoft Graph API访问个人OneDrive文件异常

问题现象

调用Graph API获取个人OneDrive根目录文件时，请求间歇性失效：

多数时候返回404 Not Found或如下空消息的UnknownError：

{
  "error":
   {
     "code":"UnknownError",
     "message":"",
     "innerError":{
        "date":"2025-03-03T04:50:33",
        "request-id":"61528c8c-cc90-4efb-984b-dc92b3f2c3df",
        "client-request-id":"61528c8c-cc90-4efb-984b-dc92b3f2c3df"
     }
  }
}

偶尔返回200 OK并正常获取文件列表（未修改请求参数）
问题始于重置Microsoft账户密码后，已确认拥有Files.Read和Files.ReadWrite权限（无401错误）
尝试过禁用2FA、再次重置密码、联系微软支持，均未解决

排查与解决建议

验证令牌上下文一致性
解码你的访问令牌（用本地JWT解析工具），检查：
- tid（租户ID）是否为个人Microsoft账户的固定值：9188040d-6c67-4c5b-b112-36a304b66dad，确保不是工作/学校租户
- upn和name字段是否匹配你的个人账户信息，避免身份上下文混乱
清除令牌缓存并重新授权
如果使用SDK、Postman或自定义客户端，彻底清除已缓存的访问/刷新令牌，重新走OAuth授权流程获取新令牌后测试。密码重置后旧令牌可能存在失效或上下文冲突。
替换me端点为用户ID
避免me端点的身份解析问题，改用用户ID构造请求：
```
https://graph.microsoft.com/v1.0/users/{你的用户ID}/drive/root/children?$select=name, id
```
用户ID可通过调用https://graph.microsoft.com/v1.0/me获取。
检查OneDrive网页版状态
登录网页版OneDrive，确认文件结构正常，无同步任务卡住或文件损坏情况。密码重置后OneDrive可能存在短暂的同步锁定，导致API请求不稳定。
添加重试策略
针对404 Not Found和UnknownError添加指数退避重试机制，应对Graph API节点的临时故障。