使用Graph API过滤SharePoint列表时出现400错误求助

API 探路者

2026-8-7

问题原因与解决方法

你的带过滤条件的请求返回400错误，大概率是字段类型不匹配或URL参数编码异常导致的，具体分析和解决方法如下：

原因1：字段类型不匹配

如果SharePoint列表里的isScheduled是「是/否」类型字段，在Microsoft Graph中它对应的是布尔值（true/false），而非数字1/0。你用eq 1会触发类型不匹配错误——Graph Explorer可能做了自动兼容，但实际API调用不会识别数字与布尔值的等价关系。

原因2：URL参数编码问题

手动拼接URL字符串时，部分字符可能被错误转义（比如你看到的单引号被编码为%27），虽然Graph Explorer能兼容这种编码，但fetch的请求编码逻辑会导致API无法正确解析参数。

解决方法

方法1：改用布尔值匹配字段

直接将过滤条件中的1替换为布尔值true：

const urls = {
    demos: GRAPH_ENDPOINT + `sites/${ids.siteMain}/lists/${ids.listDemos}/items?expand=fields`,
    demosScheduled: GRAPH_ENDPOINT + `sites/${ids.siteMain}/lists/${ids.listDemos}/items?expand=fields&$filter=fields/isScheduled eq true`,
}

方法2：用`URLSearchParams`构造参数（更推荐）

使用浏览器原生API处理查询参数，避免手动拼接导致的编码错误：

// 基础URL
const baseDemoUrl = `${GRAPH_ENDPOINT}/sites/${ids.siteMain}/lists/${ids.listDemos}/items`;

// 处理全量数据请求
const demosUrl = new URL(baseDemoUrl);
demosUrl.searchParams.append('expand', 'fields');

// 处理过滤请求
const demosScheduledUrl = new URL(baseDemoUrl);
demosScheduledUrl.searchParams.append('expand', 'fields');
demosScheduledUrl.searchParams.append('$filter', 'fields/isScheduled eq true');

// 定义最终urls对象
const urls = {
    demos: demosUrl.toString(),
    demosScheduled: demosScheduledUrl.toString(),
}