Shell脚本中jq命令管道报错及变量未定义问题求助

错误原因拆解 #

1. 变量未找到错误：Shell定义包含空格、JSON特殊字符（大括号、冒号等）的变量时，若未用正确的引号包裹，Shell会将变量赋值语句拆分成多个命令，导致变量名被识别为独立命令执行。
2. jq语法错误：多数是因为传递给jq的JSON内容未正确引用，或jq验证表达式写法有误，Shell的引号嵌套问题导致jq收到不完整的参数，触发语法错误。

修复步骤 #

1. 正确定义JSON变量 #

用单引号包裹JSON内容，避免Shell解析内部特殊字符；若JSON含单引号，需用\'转义：

# 预期JSON模板（字段类型定义）
expected_template='{
  "name": "string",
  "age": "number",
  "active": "boolean"
}'

# 实际JSON数据
actual_json='{
  "name": "Alice",
  "age": 30,
  "active": true
}'

# 含单引号的JSON示例
actual_json='{
  "name": "O\'Neil"
}'

2. 修复jq验证逻辑 #

使用jq的--argjson参数传递JSON变量（彻底规避引号嵌套问题），编写正确的验证表达式：

validate_json() {
  local expected="$1"
  local actual="$2"

  # 用--argjson传递JSON，让jq直接解析，避免Shell引号干扰
  jq -n --argjson exp "$expected" --argjson act "$actual" '
    $act | to_entries | all(.value | type == $exp[.key])
  ' > /dev/null 2>&1

  if [ $? -eq 0 ]; then
    echo "JSON validation passed."
    return 0
  else
    echo "The actual JSON does not match the expected template."
    return 1
  fi
}

• 验证逻辑：将实际JSON转为键值对，检查每个字段的类型是否与模板中对应字段的类型一致。

完整可运行脚本示例 #

#!/bin/bash

# 定义预期JSON模板（字段类型）
expected_template='{
  "name": "string",
  "age": "number",
  "active": "boolean"
}'

# 定义实际JSON数据
actual_json='{
  "name": "Alice",
  "age": 30,
  "active": true
}'

validate_json() {
  local expected="$1"
  local actual="$2"

  # 使用jq验证JSON结构与类型
  jq -n --argjson exp "$expected" --argjson act "$actual" '
    $act | to_entries | all(.value | type == $exp[.key])
  ' > /dev/null 2>&1

  if [ $? -eq 0 ]; then
    echo "JSON validation passed."
    return 0
  else
    echo "The actual JSON does not match the expected template."
    return 1
  fi
}

# 调用验证函数
validate_json "$expected_template" "$actual_json"

运行说明 #

保存脚本后赋予执行权限：

chmod +x validation-example.sh
./validation-example.sh

额外注意事项 #

• 若需验证复杂规则（必填字段、取值范围），可扩展jq表达式，比如用has("字段名")检查必填项。
• 始终优先用--argjson传递JSON变量，减少手动处理引号的麻烦。

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