使用curl PATCH更新Kubernetes Endpoint IP返回422错误如何解决

422错误代表请求语法合法但语义不符合Kubernetes API要求，按优先级排查以下问题：

1. JSON Patch路径格式错误（核心原因） #

JSON Patch使用的路径是JSON Pointer格式，强制要求以/开头，你当前的路径subsets/0/addresses/0/ip缺少开头的斜杠，会直接导致API解析失败触发422错误。

2. Shell中JSON转义错误 #

你贴出的代码里JSON内容使用了HTML转义的"，如果实际Shell脚本中也保留了转义字符，会导致服务器无法解析JSON结构。单引号包裹的JSON内部不需要转义双引号，直接写即可。

3. 确认目标路径真实存在 #

replace操作要求修改的路径必须预先存在，可执行以下命令确认当前Endpoint结构符合预期：

kubectl get endpoints cfdb-ccdb -n cf-db -o jsonpath='{.subsets[0].addresses[0].ip}'

如果返回为空，说明路径不存在，需要把操作类型改为add：

BODY='[{"op": "add", "path": "/subsets/0/addresses/0", "value": {"ip": "172.16.140.18"}}]'

4. 补全必填字段校验 #

Kubernetes要求Endpoints的每个subset必须同时包含addresses和ports字段，如果原始Endpoint的subsets[0]缺少ports字段，修改后也会触发422错误，可执行以下命令确认ports存在：

kubectl get endpoints cfdb-ccdb -n cf-db -o jsonpath='{.subsets[0].ports}'

修正后的完整请求示例 #

KUBE_SERVICE_DIR="/var/run/secrets/kubernetes.io/serviceaccount"
KUBE_TOKEN_FILENAME="${KUBE_SERVICE_DIR}/token"
KUBE_CA_CERT="${KUBE_SERVICE_DIR}/ca.crt"
# 优化token读取逻辑，避免多余换行符
KUBE_TOKEN=$(<"${KUBE_TOKEN_FILENAME}")
# 路径开头补全斜杠，无多余转义
BODY='[{"op": "replace", "path": "/subsets/0/addresses/0/ip", "value": "172.16.140.18"}]'
curl -XPATCH \
  --cacert "${KUBE_CA_CERT}" \
  -H "Content-Type: application/json-patch+json" \
  -H "Authorization: Bearer ${KUBE_TOKEN}" \
  --data "${BODY}" \
  "https://${KUBERNETES_API_HOST}:${KUBERNETES_API_PORT}/api/v1/namespaces/cf-db/endpoints/cfdb-ccdb"

内容的提问来源于stack exchange，提问作者Salvatore D'angelo