jq报错Cannot iterate over null (null) 加?运算符无效问题咨询

报错Cannot iterate over null (null)的核心是你执行迭代操作的.items字段本身就是null，根本不是可迭代的数组。
你查到的在[]前加?的方案逻辑本身没有错，但这个语法的作用只是让jq遇到null值迭代时不抛出错误，不会凭空生成有效数据。如果.items字段本身不存在、或者值为null，加完容错后jq会直接跳过迭代流程，最后自然只会生成空的结果文件。

排查&修复步骤 #

1. 先确认接口原始返回结构 #

不要上来就把curl结果直接管道给jq处理，先把原始响应落盘看实际结构，90%的这类问题都是想当然写字段路径导致的：

# 先把接口原始返回存到本地文件
getPage > raw_resp.json
# 查看返回的顶层字段，确认是否存在items字段
jq 'keys' raw_resp.json

常见的返回异常场景：

• 接口鉴权失败/参数错误，返回的是{"code":401,"msg":"invalid token"}这类错误结构，根本没有items字段
• 实际数据列表嵌套在其他父字段下，比如路径是data.list、result.items，不是顶层的items
• 分页参数传错，当前请求的页码本身没有数据，items字段返回null

2. 正确编写带容错的jq命令 #

?运算符需要加在可能出现null的取值链路上，不要只给迭代操作加，修正后的命令如下：

getPage \
| jq -c '.items[]? // empty | {landing_id: .landing_id, submitted_at: .submitted_at, answers: .answers, email: .hidden.email}' \
> testpush.json

语法说明：

• .items[]?：对.items的迭代操作加容错，如果.items不是数组、值为null，不会抛出迭代错误，直接返回null
• // empty：过滤掉上一步产生的null值，不会往结果文件里写入空行或者null内容
  如果排查后发现列表字段不在.items路径下，把路径替换成实际的即可，比如嵌套在data下就写.data.items[]?

3. 补全curl请求的错误判断 #

你当前写的getPage函数有逻辑隐患：加了--fail参数后，curl遇到4xx/5xx错误会直接返回非0退出码，不会把错误响应体传给后续的jq，很容易出现接口报错了你完全无感知的情况，可以优化下函数逻辑：

getPage() {
  local resp
  # 加-s参数关掉curl的进度条输出
  resp=$(curl --fail -s -X GET 'https://api.app.com/v1/test?page=1&pageSize=1000&sort=desc' \
    -H 'Authorization: Bearer 123abc456pickupsticks789' \
    -H 'cache-control: no-cache')
  # curl请求失败时直接打印错误信息退出，不要继续往后执行
  if [ $? -ne 0 ]; then
    echo "接口请求失败，响应内容：$resp"
    exit 1
  fi
  echo "$resp"
}

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