Xwiki REST调用中XWQL查询失效，需查询指定日期后创建的页面

我来帮你排查这个XWiki REST查询失效的问题——这种情况90%以上是查询语句的语法错误或者URL参数编码不对导致的，咱们一步步来解决：

核心问题分析 #

你说去掉查询语句调用正常，说明REST端点本身没问题，问题就出在q参数的内容或者配套的参数设置上，比如查询语法不匹配、日期格式错了、参数没编码这些。

具体解决方案 #

1. 选对查询语言并写对语法 #

XWiki REST查询支持多种类型（xwql/hql/lucene/solr），优先用XWQL，它是XWiki专门的查询语言，对页面属性的支持更直观。

针对“指定日期后创建的页面”，XWQL的正确语法是：

where doc.created > 'YYYY-MM-DDTHH:mm:ssZ'

• doc.created：XWiki文档的创建日期字段（注意不是doc.date，那是最后修改日期）
• 日期格式必须是ISO标准格式，比如2024-05-01T00:00:00Z，如果只需要日期也可以简化为2024-05-01

2. 必须对查询参数做URL编码 #

REST URL里的特殊字符（比如>、空格、单引号）必须编码，否则服务器会解析失败。比如上面的XWQL语句编码后会变成：

where%20doc.created%20%3E%20%272024-05-01T00:00:00Z%27

3. 完整的REST调用示例 #

假设你的wiki名称是xwiki，要查2024年5月1日之后创建的页面，完整的REST URL应该是：

/wikis/xwiki/query?q=where%20doc.created%20%3E%20%272024-05-01T00:00:00Z%27&type=xwql&prettyNames=true

这里额外加了prettyNames=true让返回的JSON字段名更友好，你可以根据需要添加其他参数（比如order=desc按创建时间倒序）。

常见坑点避坑 #

• 忘记指定type参数：如果不写&type=xwql，服务器可能默认用其他查询语言（比如HQL），语法不兼容就会报错
• 日期格式错误：别用MM/DD/YYYY这种美式格式，必须用YYYY-MM-DD开头的ISO格式
• 漏掉where关键字：XWQL查询条件必须以where开头，不能直接写doc.created > '2024-05-01'
• 手动编码出错：如果自己转码容易漏转，建议用Postman、curl这类工具，它们会自动帮你处理参数编码

测试小技巧 #

先在XWiki的后台高级搜索页面（Wiki → 搜索 → 高级搜索）测试你的XWQL语句，确认能查到正确的页面后，再把语句编码后放到REST URL里，这样能快速排除语法问题。

内容的提问来源于stack exchange，提问作者Gábor Csikós