使用jq从账号映射文件查询名称失败问题排查

核心问题：变量传递方式错误 #

硬编码能正常运行，但用bash变量就失效，绝大多数情况是因为没有使用jq官方的变量传递机制，而是直接将bash变量拼接进jq脚本，导致类型不匹配或语法解析错误。

错误写法示例（问题根源） #

假设你的账号映射JSON结构如下：

{
  "accounts": [
    {"account_id": "1001", "name": "运营部账号"},
    {"account_id": "1002", "name": "技术部账号"}
  ]
}

如果脚本写成这样，必然会失效：

#!/bin/bash
target_id=$1
# 错误：直接拼接bash变量，会被jq解析为语法而非字符串
jq '.accounts[] | select(.account_id == '$target_id') | .name' accounts.json

当target_id是字符串类型的账号（比如"1001"），拼接后jq会执行select(.account_id == 1001)，但JSON里的account_id是字符串类型，数字与字符串无法匹配，因此返回空结果，触发“未找到映射”提示。

正确写法：用--arg传递变量 #

jq提供--arg参数用于安全传递外部变量，它会自动将变量处理为jq的字符串类型，避免类型不匹配问题：

#!/bin/bash
target_id=$1
# 用--arg把bash变量target_id传给jq的$id变量
result=$(jq --arg id "$target_id" '.accounts[] | select(.account_id == $id) | .name' accounts.json)

if [ -z "$result" ]; then
  echo "未找到映射"
else
  echo "$result"
fi

其他可能的问题点 #

1. JSON字段类型不匹配
   如果你的JSON中account_id是数字类型（比如"account_id": 1001），需要将传递的字符串变量转为数字：

   jq --arg id "$target_id" '.accounts[] | select(.account_id == ($id | tonumber)) | .name' accounts.json
   

2. 输入变量含多余空格/换行
   如果输入的账号ID不小心带有空格或换行，可在jq中做去空格处理：

   jq --arg id "$target_id" '.accounts[] | select(.account_id == ($id | trim)) | .name' accounts.json
   

3. 脚本参数未正确获取
   检查运行脚本时是否正确传递了参数，比如是否执行./your_script.sh 1001，而非漏传参数。

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