Confluence API获取父页面子页面按日期范围筛选失效问题

• 最核心的问题是参数拼接逻辑错误：你URL里的日期条件是作为独立请求参数拼接在cql参数外的，不属于CQL查询语句的一部分。服务端解析CQL时只会读取到parent=2342344这一个条件，后面的两个created参数会被直接忽略，自然不会做日期过滤。
• CQL语法使用错误：就算把日期条件放进CQL语句内部，连续写两个created=xxx的等值判断也无法实现范围过滤。Confluence CQL的日期范围查询需要使用>=、<=比较运算符，等值判断只会精确匹配对应时间点，无法覆盖时间段。
• 隐式的边界匹配问题：Confluence的created字段存储精度到秒，直接写日期字符串不指定时分秒时，默认匹配该日期的00:00:00时间点，很容易漏掉边界日期的内容。

首先写对原生CQL语句，所有过滤条件都要放在CQL内部：

parent = 2342344 AND created >= "2021-01-01 00:00" AND created <= "2022-01-01 23:59"

将整段CQL做URL编码后，作为cql参数的值拼接请求地址，最终可直接调用的API端点为：

https://domain-name.atlassian.net/wiki/rest/api/content/search?cql=parent%3D2342344%20AND%20created%20%3E%3D%20%222021-01-01%2000%3A00%22%20AND%20created%20%3C%3D%20%222022-01-01%2023%3A59%22

• 不要把CQL的过滤字段拆成独立的URL请求参数，所有查询逻辑必须全部包含在cql参数的取值范围内，否则不会被CQL解析器识别。
• 日期值建议用双引号包裹，明确指定时分秒避免边界值偏差。如果需要包含2022年1月1日当天创建的所有页面，不要把上界设为2022-01-01 00:00，否则当天0点后创建的页面会被过滤掉。
• 调试阶段可以先在Confluence内置的高级搜索页面输入原生CQL验证结果，确认过滤逻辑符合预期后再做URL编码拼接API请求，能减少很多参数转义、拼接的低级错误。

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