FileHandler无法注册或更新 配置变更后不生效问题咨询

• 优先确认缓存时效：OneDrive 服务端对 FileHandler 应用清单默认存在最长24小时的边缘节点缓存，即使调用强制刷新接口，也可能存在区域缓存未同步的情况，建议最后一次修改配置后等待24小时再验证效果
• 校验应用注册配置合法性：
  • 检查应用注册web节点下的redirectUris是否包含你修改后的所有回调域名，域名必须与FileHandler配置中的URL完全匹配，包括协议、端口、路径前缀，任一不匹配都会导致新配置被拦截
  • 检查FileHandler清单的所有字段是否符合格式要求，存在非法字符、必填字段缺失时，系统会静默沿用最后一次有效的旧配置，不会抛出明确报错
• 确认刷新接口调用符合权限要求：
  • 普通刷新接口 GET https://{tenant}-my.sharepoint.com/_api/v2.0/drive/apps?forceRefresh=1 必须由持有目标OneDrive读写权限的普通用户调用，需携带对应用户的有效访问令牌，不支持应用权限令牌调用
  • 管理员刷新接口 GET https://{tenant}.sharepoint.com/_api/v2.0/drive/apps?adminForceRefresh=1 必须由全局管理员或SharePoint管理员身份调用，调用完成后需等待15-30分钟再进行测试
• 清理客户端缓存：
  • 网页端测试前需清除浏览器站点缓存、Cookie后重新登录账号
  • 桌面端OneDrive需退出账号、重启客户端后重新登录，部分老旧版本需要重置客户端配置后再验证
• 排查环境错配问题：确认你修改配置的应用注册环境，与测试的租户环境完全一致，避免出现测试环境修改、生产环境验证的错配情况

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