手动删除argocd命名空间后Application资源异常问题排查

问题背景 #

手动删除argocd命名空间后，kubectl get ns已无法查到该命名空间，但kubectl get -n argocd application仍能返回残留的Application资源：

NAME      SYNC STATUS   HEALTH STATUS
grafana   OutOfSync     Missing

部分资源状态显示为Healthy或Progressing。

问题根源是这些Application的metadata.finalizers字段阻止了资源被自动清理，但尝试用常规patch命令移除该字段时失败：

kubectl patch -n argocd application grafana  -p '[ { "op": "remove", "path": "/metadata/finalizers" } ]' --type=json

返回错误：

Error from server (NotFound): namespaces "argocd" not found

执行以下命令确认当前仅残留Application类资源：

kubectl api-resources --verbs=list --namespaced -o name \
  | xargs -n 1 kubectl get --show-kind --ignore-not-found -n argocd

解决方法 #

由于命名空间已不存在，常规命名空间级操作会被拦截，需通过直接调用Kubernetes API的方式修改资源：

1. 交互式编辑单个资源 #

直接编辑目标Application资源，手动删除metadata.finalizers字段：

kubectl edit application.argoproj.io/grafana -n argocd

若命令提示命名空间不存在，改用raw API路径编辑：

kubectl edit --raw "/apis/argoproj.io/v1alpha1/namespaces/argocd/applications/grafana"

在编辑器中找到metadata.finalizers数组，删除其内容后保存退出，资源会被自动清理。

2. 非交互式patch单个资源 #

通过raw API路径执行patch操作，绕过命名空间存在性检查：

kubectl patch --raw "/apis/argoproj.io/v1alpha1/namespaces/argocd/applications/grafana" \
  -p '[{ "op": "remove", "path": "/metadata/finalizers" }]' --type=json

3. 批量清理所有残留Application #

若存在多个残留资源，执行以下命令批量移除finalizers：

kubectl get -n argocd applications -o name | while read app_path; do
  kubectl patch --raw "/apis/argoproj.io/v1alpha1/${app_path}" \
    -p '[{ "op": "remove", "path": "/metadata/finalizers" }]' --type=json
done

原理说明 #

命名空间删除时，Kubernetes会尝试清理其下所有资源，但如果资源带有finalizers且对应的处理控制器（如Argo CD控制器）已随命名空间被删除，资源会残留。直接通过API路径访问资源可绕过命名空间存在性校验，移除finalizers后，Kubernetes会自动完成资源清理。

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