
路径没有命中,先保留输入和表达式
拿到一份 JSON,想从中取出几项数据,表达式却没有得到预期结果。此时不要先把“没匹配到”解释成“接口没有返回数据”:输入可能不是同一份,路径层级可能写错,也可能是当前测试工具不接受你使用的语法。
AIGoCode 工具目录提供 JSONPath 在线测试,说明可以测试 JSONPath 表达式,查看匹配值及其字段路径。本文围绕这个入口给出一套定位流程。下文的小样本、查询思路和交接表都是调试建议,没有进行线上工具实测;某条语法能否使用,以当前工具页面说明和实际提示为准。
先把问题分成三类
第一类是输入没有进入查询阶段。例如 JSON 本身不完整,或者你复制的是带额外说明文字的日志片段。这时应先整理成准备查询的 JSON,保留原始材料,别在排查过程中把数据与表达式同时改掉。
第二类是表达式不能被当前工具接受。JSONPath 在不同工具中的实现范围可能有差异;从另一份教程复制的表达式,应先对照当前工具支持范围。页面若给出语法错误或不支持的提示,先处理提示,不把它记作“数据里没有该字段”。
第三类是表达式可以求值,却没有命中你想找的值。这时才逐层核对字段名、对象与数组的层级、索引以及你正在使用的那份样本。
这三类的下一步不同。把输入问题当路径问题,容易不停改表达式;把语法问题当数据问题,容易让后续程序误删本来存在的业务分支。
用一份虚构小样本缩小范围
假设原始数据里有一个 items 字段,它是一个数组。第一条记录的 id 为 demo-a,name 为“示例甲”;第二条记录的 id 为 demo-b,name 为空字符串。以上是为了说明排查思路构造的样本,不是 AIGoCode API 的响应结构。
先确认你在工具里放入的就是这个小样本,再依次尝试从根对象定位 items、定位其中一条记录、定位该记录的 name。每次只增加一层;具体表达式按当前工具说明填写,不一开始就用递归查找或复杂筛选覆盖整个文档。
每一步记录预期对象与观察结果。假如定位 items 就失败,先核对字段拼写、大小写和外层是否还包着其他对象;不要直接跳去调整 name。假如数组能定位、单条记录定位失败,先检查数组是否有相应元素,以及当前节点是不是数组。
这个过程的重点是缩小变化范围。先用一份你能人工看懂的小样本走通,再回到真实脱敏样本;不要用虚构样本的成功替代真实输入验收。
找到字段后,还要看它返回了什么
“没有命中字段”与“命中了一个空值”不是同一件事。进一步整理结果时,至少分别记录下面几种情形:
| 观察结果 | 应继续确认什么 | 不建议直接推断什么 |
|---|---|---|
| 没有找到目标字段 | 路径与当前样本是否一致 | 不能直接说业务永远没有该字段 |
| 找到空字符串 | 这是合法空值还是数据尚未填写 | 不自动当作字段缺失 |
| 找到 null | 当前接口怎样定义这个状态 | 不自动当作零或空数组 |
| 找到 0 或 false | 字段类型与业务含义是否正确 | 不因其是假值就丢弃 |
| 找到多个值 | 每个值属于哪条记录、哪条路径 | 不只取第一项就声称全部正确 |
这张表是数据核对建议,并不保证工具会以某种固定形式展示所有情形。你需要把页面观察结果与源 JSON 对照,才能判断是查询没命中,还是值本来就为空。
尤其不要在接收代码里只用“值是否为真”判断字段存在。决定如何处理之前,先明确你的任务到底需要“字段存在”“值非空”还是“业务状态有效”;三个判断应有各自的定义和样本。
值与路径一起保留,才能发现取错对象
目录明确提到工具可以查看匹配值及其字段路径。利用这两类信息一起核对:一个看起来正确的名称,可能来自另一个数组元素;同名字段也可能分布在不同层级。
建议把目标记录标识、实际字段路径和值放在同一份调试记录里。若一次命中很多项,先选几个位置人工回查源数据,再检查准备交付的完整结果。不要仅凭当前屏幕上看到的部分行推断匹配已经完整;界面预览和最终交付内容都应各自核对。
对于零项结果,记录当时的表达式和输入版本,而不是只留一张空白结果截图。这样下一位接手者才能重现你的问题,并判断是样本变化还是路径变化。
换回真实数据后,补三组对照
小样本走通后,用真实但已脱敏的输入复核。建议至少准备正常记录、可选字段缺失的记录,以及包含多个同名字段或多条数组元素的记录。字段并非都可选,是否允许缺失仍要按业务定义确认。
一次只替换输入或表达式中的一个因素。例如保持表达式不变,换一份样本;或者保持样本不变,逐层调整路径。把结果记成“这份样本在这个表达式下命中了什么”,不要扩大成“所有响应都能这样读”。
若最终要把查询迁移到代码或另一个 JSONPath 库,还需在目标环境运行同一组样本。浏览器工具中的观察有助于定位,但不能代替你所用解析库和业务脚本的测试。
交接时给出可以重现的最小记录
建议留下脱敏输入、表达式、当前工具提示、预期字段、实际路径和值,以及尚未确认的问题。若问题出在语法支持范围,注明查到的当前页面说明;若问题出在业务结构,注明对应的样本版本。
真正的完成条件是能解释差异:哪一步未进入查询、哪一段路径偏离了输入,或者命中的值为什么与预期不同。先得到这份解释,再修改正式取数代码,避免把一次空结果写成长期错误的业务判断。