Microsoft GraphAPI过滤器异常：第二个时间筛选查询返回空结果

现有查询逻辑 #

第一个查询（返回非空结果） #

筛选条件：sharedTimeOff/startDateTime >= formattedTodayDateTime 且 sharedTimeOff/endDateTime <= formattedRequiredEndDateTime，对应业务逻辑为今日及之后开始、且在指定结束时间前结束的timeOff条目。

代码实现：

// headers 和 accessTokens 已正确配置
params = Map();
params.put("$filter","sharedTimeOff/startDateTime ge " + formattedTodayDateTime + " and sharedTimeOff/endDateTime le " + formattedRequiredEndDateTime + "");
response = invokeurl
[
    url :graphUrl
    type :GET
    parameters:params
    headers:headers
];

第二个查询（返回空结果，不符合预期） #

预期筛选逻辑：formattedTodayDateTime <= timeOff的end_date <= formattedRequiredEndDateTime，即结束时间在今日到指定结束时间区间内的timeOff条目（理论上应包含第一个查询的所有结果，再加上开始时间早于今日但结束时间符合范围的条目）。

对应的过滤器语句：sharedTimeOff/endDateTime ge " + formattedTodayDateTime + " and sharedTimeOff/endDateTime le " + formattedRequiredEndDateTime

代码实现：

params = Map();
params.put("$filter","sharedTimeOff/endDateTime ge " + formattedTodayDateTime + " and sharedTimeOff/endDateTime le " + formattedRequiredEndDateTime + "");
response = invokeurl
[
    url :graphUrl
    type :GET
    parameters:params
    headers:headers
];

问题：第二个查询预期应返回更多条目，但实际返回空结果，调整查询逻辑后仍为空。

排查方向 #

• 日期格式校验
  确认formattedTodayDateTime和formattedRequiredEndDateTime是否严格遵循ISO 8601格式（如2024-05-20T00:00:00Z），检查是否遗漏时区标识Z，避免因时区偏移导致筛选范围偏差。
• 权限与数据范围验证
  核对当前API令牌的权限是否覆盖所有符合条件的timeOff条目，同时手动确认第一个查询返回的条目，其endDateTime是否确实落在目标区间内。
• 过滤器语法调整
  尝试用单引号包裹日期字符串，或对空格进行URL编码（替换为%20），比如修改过滤器为：

  sharedTimeOff/endDateTime ge '" + formattedTodayDateTime + "' and sharedTimeOff/endDateTime le '" + formattedRequiredEndDateTime + "'
  

  也可直接在Graph Explorer中测试该过滤器，排除代码参数拼接问题。
• 数据存在性确认
  核实是否真的存在开始时间早于今日但结束时间在目标区间的timeOff条目，避免预期的额外数据实际不存在。

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