Jenkinsfile内嵌Shell脚本出现意外括号语法错误求助

错误原因 #

直接将Groovy变量拼接进Shell命令时，若变量（如usrPermission、usrName等）包含空格、括号、引号等特殊字符，会破坏Shell的语法结构，触发Syntax error: "(" unexpected这类解析错误。比如usrPermission的值如果是(admin, edit)，直接拼接后Shell会把括号当成语法符号，而非字符串的一部分。

解决方法 #

方法1：用Groovy插值+Shell单引号包裹内容 #

将Shell命令中的输出内容用单引号包裹，避免Shell解析变量内的特殊字符，同时用Groovy的${}语法完成变量插值：

sh(script: "echo '${project},${usrLogin},${usrName},${usrEmail},${usrPermission}' >> SBI_${params.permission_type}Access_Rights_Matrix.csv")

同时简化echo语句的写法（Groovy中无需转义双引号）：

echo "SBI PROJECT: ${project} | ${usrLogin} | ${usrName} | ${usrEmail} | PERMISSIONS: ${usrPermission}"

方法2：通过环境变量传递Groovy变量 #

将Groovy变量注入到Shell的环境变量中，避免直接拼接字符串，安全性更高：

sh(script: '''
  echo "${PROJECT},${USR_LOGIN},${USR_NAME},${USR_EMAIL},${USR_PERMISSION}" >> SBI_${PERMISSION_TYPE}Access_Rights_Matrix.csv
''', env: [
  PROJECT: project,
  USR_LOGIN: usrLogin,
  USR_NAME: usrName,
  USR_EMAIL: usrEmail,
  USR_PERMISSION: usrPermission,
  PERMISSION_TYPE: params.permission_type
])

方法3：提取重复代码到函数 #

将重复的日志输出逻辑封装成函数，减少代码冗余，同时统一处理变量拼接：

def logUserPermission(project, usrLogin, usrName, usrEmail, usrPermission, permissionType) {
  if (usrPermission) {
    sh(script: "echo '${project},${usrLogin},${usrName},${usrEmail},${usrPermission}' >> SBI_${permissionType}Access_Rights_Matrix.csv")
    echo "SBI PROJECT: ${project} | ${usrLogin} | ${usrName} | ${usrEmail} | PERMISSIONS: ${usrPermission}"
  }
}

// 原代码中调用函数
if (usrEmail == null) {
  usrEmail = 'N/A'
  logUserPermission(project, usrLogin, usrName, usrEmail, usrPermission, params.permission_type)
} else {
  logUserPermission(project, usrLogin, usrName, usrEmail, usrPermission, params.permission_type)
}

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