Prismic查询谓词误判自定义Timestamp字段类型问题

问题根源分析 #

出现这个报错，主要有这几个可能：

• 本地用Slicemachine定义的字段类型没同步到Prismic云端：本地的index.json改了，但没推送到后台，导致Prismic识别这个字段不是Timestamp类型，而是其他（比如文本或者普通日期）。
• 后台字段类型没正确更新：就算本地同步了，有时候后台可能没刷新，字段类型显示不对。
• 用错了谓词：Timestamp字段更适配timestampAfter，虽然官方说dateAfter也支持，但实际查询时可能会有识别问题。
• Prismic客户端版本太老：旧版本的客户端对Timestamp字段的查询支持有bug。

一步步解决 #

1. 同步本地配置到Prismic后台
   打开项目根目录的终端，执行同步命令，把本地的自定义类型推到云端：

   npx slicemachine push
   

   然后登录Prismic后台，找到event这个自定义类型，确认end_date字段的类型确实是Timestamp，不是别的。

2. 替换为timestampAfter谓词
   把原来的dateAfter换成专门给Timestamp字段用的timestampAfter：

   const events = await client.getAllByType('event', {
       predicates : [
           prismic.predicate.timestampAfter("document.data.end_date", new Date()) 
       ]
   });
   

3. 检查字段路径正确性
   要是这个字段是嵌套在切片或者分组里的，路径得写对，比如字段在某个切片的items里，路径就得改成：

   prismic.predicate.timestampAfter("document.data.my_slice.items.0.end_date", new Date())
   

4. 升级Prismic客户端
   把@prismicio/client更到最新版，避免旧版本的兼容问题：

   npm install @prismicio/client@latest
   

5. 更换日期参数格式
   有时候日期格式不兼容，试试转成ISO字符串或者时间戳：

   // 使用ISO字符串
   prismic.predicate.timestampAfter("document.data.end_date", new Date().toISOString())
   // 或者使用时间戳
   prismic.predicate.timestampAfter("document.data.end_date", Date.now())
   

额外验证方法 #

要是上面都没用，去Prismic后台的API浏览器（路径：API & Security -> API Browser）直接写查询语句测试：

[[timestamp.after(document.data.end_date, 1677426405339)]]

如果API浏览器能正常返回结果，那问题就在你的客户端代码或者版本；要是还是报错，那肯定是后台的字段类型配置有问题，得重新检查同步。

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