Ansible代码中json_query参数的[@][]及@符号作用是什么

Ansible 的 json_query 过滤器底层基于 JMESPath 语法实现，你所询问的 [@][] 属于 JMESPath 表达式，各部分作用如下：

1. @ 符号的作用 #

在 JMESPath 语法中，@ 是当前节点引用符，指代管道符 | 前侧传递到当前位置的所有数据。你提供的代码中管道前侧是 response.result.job，因此 @ 就等价于 response.result.job 取到的完整值。

2. [@][] 完整语法的作用 #

我们可以拆成两段理解：

• 第一段 [@]：将当前节点（也就是 response.result.job 的值）包裹为一个单元素数组。
  • 如果 response.result.job 返回的是单个 Job 对象，那 [@] 会输出 [该Job对象]
  • 如果 response.result.job 返回的是 Job 对象数组，那 [@] 会输出 [原Job数组]，也就是把原数组套了一层，变成二维数组
• 第二段 []：是 JMESPath 的展平操作符，会脱掉数组的最外层嵌套。
  两者结合后的最终效果是：无论 response.result.job 返回的是单个对象，还是对象数组，都统一转换成一维的 Job 对象数组，避免后续处理出现兼容问题。

实际效果示例：

• 输入为单个Job对象：{"id":1,"status":"FIN"} → 输出：[{"id":1,"status":"FIN"}]
• 输入为Job对象数组：[{"id":1,"status":"FIN"},{"id":2,"status":"RUN"}] → 输出和输入数组一致
• 输入为嵌套的二维数组：[[{"id":1,"status":"FIN"}]] → 输出：[{"id":1,"status":"FIN"}]

结合代码上下文的作用 #

你这段任务的 until 逻辑需要先判断Job列表非空，再判断所有Job的状态都是 FIN，用 [@][] 做一层结构兼容，就可以避免设备返回的 response.result.job 结构不稳定（单对象/数组/嵌套数组）导致的查询报错、长度计算错误等问题。

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