SharePoint REST API查询站点下存在的列表时返回404找不到问题咨询

问题1解答 #

新创建的SharePoint Online列表无需长时间等待即可通过API查询，绝大多数场景下列表创建完成后即可立即调用接口访问，仅在极个别服务同步延迟的极端场景下会有最多5分钟以内的等待窗口。如果创建10分钟后仍无法查询到，可排除同步延迟的影响。

问题2解答 #

列表确实需要满足权限及配置要求才可正常响应API请求，常见导致404的配置/权限问题如下：

• 权限返回伪装：SharePoint Online默认对无访问权限的资源返回404而非403，避免攻击者枚举站点资源。即使你能调用/_api/lists接口拿到列表集合，也需要确认当前认证身份（用户/应用注册）对目标列表有至少「读取」级别的权限。
• 列表隐藏设置：如果列表被设置为隐藏（列表设置-高级设置中「在网站内容中显示此列表」未勾选），常规列表查询接口不会返回该列表，直接访问对应items接口会报404，需要在查询列表时加上includeHidden=true参数才可查询到隐藏列表。
• 应用权限范围限制：如果你使用的是应用程序权限而非用户委托权限，即使配置了租户级的列表读取权限，SharePoint管理员也可能限制了应用的可访问站点范围，未放开目标站点的访问权限时会返回404。
• 接口参数格式错误：注意调用guid查询的接口时，GUID参数不要携带大括号，正确格式为 https://company.sharepoint.com/sites/{site}/_api/lists(guid'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx')/items，带大括号会直接触发404。

排查建议 #

你可以先执行以下接口验证目标列表是否在API可见范围内：

GET https://company.sharepoint.com/sites/{site}/_api/lists?$select=Id,Title&includeHidden=true

检查返回结果中是否存在你要访问的列表的GUID和标题，再进一步定位问题。

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