Groovy流水线读取GitLab JSON文件并调用键值的问题排查

一、排查JSON语法错误 #

• 先验证JSON文件合法性：
  • 键名必须用双引号，不能用单引号
  • 对象、数组的括号必须配对
  • 最后一组键值对后不能加多余逗号
• 用本地命令快速定位错误：jq . your_config.json，命令会直接指出语法问题的位置
• 检查流水线复制文件的逻辑，避免复制过程中额外输出写入JSON文件导致损坏

二、Groovy流水线中正确读取并调用键值 #

假设你的JSON结构如下：

{
  "Upgrade": {
    "level": "prod",
    "domain": "upgrade.example.com"
  },
  "BV": {
    "level": "staging",
    "domain": "bv.example.com"
  }
}

按以下步骤处理：

1. 读取并解析JSON文件

def jsonContent = readFile(file: 'path/to/your/config.json')
def config = new groovy.json.JsonSlurper().parseText(jsonContent)

2. 根据环境参数获取对应值

// 假设流水线参数名为env，值为Upgrade或BV
def targetEnv = env
def envLevel = config[targetEnv].level
def envDomain = config[targetEnv].domain

// 验证输出
println "环境: ${targetEnv}"
println "Level: ${envLevel}"
println "Domain: ${envDomain}"

3. 补充流水线参数定义（如果还没加）

parameters {
  string(name: 'env', defaultValue: 'Upgrade', description: '选择目标环境：Upgrade/BV')
}

三、常见问题排查 #

• 若仍报JSON错误，确认流水线中文件路径正确，确保JSON文件存在
• 若键值返回null，检查环境参数的拼写与JSON内键名完全一致（大小写敏感）

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