GitLab中使用kubectl patch时JSON字符无效问题排查

你的kubectl patch命令报错的核心原因有两个：

1. HTML转义引号不被Bash识别：原命令里的"是HTML实体转义的双引号，Bash会把它当作普通字符处理，直接破坏了JSON的语法结构，这就是错误提示中"invalid character 's' looking for beginning of object key string"的直接诱因。
2. 单引号内变量无法解析：${HELM_NAME}被包裹在单引号中，Bash不会对单引号内的变量做替换，最终传递给kubectl的是字符串${HELM_NAME}-blue而非变量实际值，进一步导致JSON格式失效。

正确写法示例 #

写法1：双引号包裹JSON，内部双引号转义 #

用双引号包裹整个-p参数内容，内部JSON的双引号用反斜杠转义，确保Bash正常解析变量的同时保留JSON结构：

kubectl --kubeconfig=$KUBECONFIG -n $NAMESPACE_NAME patch service $CI_PROJECT_NAME -p "{\"spec\": {\"selector\": {\"app.kubernetes.io/instance\": \"${HELM_NAME}-blue\"}}}"

写法2：单双引号嵌套拆分 #

将需要解析变量的部分单独用双引号包裹，其余JSON结构用单引号，避免大量转义操作：

kubectl --kubeconfig=$KUBECONFIG -n $NAMESPACE_NAME patch service $CI_PROJECT_NAME -p '{"spec": {"selector": {"app.kubernetes.io/instance": "'"${HELM_NAME}"'-blue"}}}'

这里的'"${HELM_NAME}"'是「单引号闭合+双引号包裹变量+单引号重新开启」的组合写法，既能让Bash正确解析变量，又能保证JSON格式合法。

写法3：使用--patch-file（可选） #

如果JSON内容复杂，可将其写入临时文件，通过--patch-file参数引用，彻底规避引号嵌套问题：

# 创建临时JSON文件
cat > patch.json <<EOF
{
  "spec": {
    "selector": {
      "app.kubernetes.io/instance": "${HELM_NAME}-blue"
    }
  }
}
EOF
# 执行patch操作
kubectl --kubeconfig=$KUBECONFIG -n $NAMESPACE_NAME patch service $CI_PROJECT_NAME --patch-file patch.json

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