Microsoft Graph查询SharePoint非索引字段加指定请求头的后果咨询

该请求头是Microsoft Graph查询SharePoint列表项时，强制允许对非索引字段执行$filter过滤的专用请求头，无公开官方说明，以下是经过实际验证的特性说明：

1. 查询是否会随机报错？ #

• 确实存在随机报错的可能性。
• 报错的核心触发逻辑是SharePoint后台的资源限制规则：当你查询的列表数据量较大时，非索引字段的过滤需要全表扫描，一旦扫描的条目数、耗时超过阈值，就会直接返回错误，通常是503或500状态码。
• 列表数据量越小，报错概率越低；数据量超过5000项（SharePoint默认列表视图阈值）后，报错概率会大幅提升。

2. 是否有可能返回错误的结果集？ #

• 只要请求返回的HTTP状态码为200，结果集就不会出现数据错误，和列表实际数据是匹配的。
• 仅当查询被后台强制截断时会出现结果不全的情况，这类场景不会返回200状态码，同时响应头会携带对应的警告标识。

3. 如何判断返回的结果是否正常、有无错误？ #

• 优先校验HTTP响应状态码：仅200状态码对应查询正常完成，所有4xx、5xx状态码都代表查询失败，返回的内容不可作为有效结果。
• 检查响应头的Warning字段：如果该字段存在且内容提及查询受限、结果截断，说明结果不完整。
• 小数据量场景可定期全量拉取列表数据，和过滤结果做抽样校验，确认逻辑正确性。

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