用 client-go List() 获取 Pod 列表必须指定 namespace，查单个命名空间传如"default"，查所有命名空间须传metav1.NamespaceAll而非""；Pod是namespaced资源，不传或传空字符串会panic或返回空，常见错误是遗漏NamespaceAll常量。
用 client-go List() 获取 Pod 列表必须指定 namespace
直接调用 clientset.CoreV1().Pods("").List() 会 panic 或返回空，因为 Pod 是 namespaced 资源，"" 不是合法的 namespace 名——哪怕你想查所有命名空间，也得用 metav1.NamespaceAll。常见错误是抄示例时漏掉这个常量，结果本地跑通、集群里查不到任何 Pod。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 查单个命名空间：传入具体 namespace 字符串，比如
"default" - 查所有命名空间：传
metav1.NamespaceAll（不是""或"*"） - 务必检查
err，List 失败通常是因为 RBAC 权限不足，报错类似Forbidden: User "system:serviceaccount:myop:default" cannot list resource "pods" in API group "" at the cluster scope
Operator 中推荐用 dynamic client 还是 typed client？
用 typed client（即 clientset）更稳妥。dynamic client 虽然灵活，但对 Pod 这类核心资源反而多此一举：类型安全丢失、字段访问要靠 unstructured.Unstructured 反射、没法直接用 pod.Status.Phase 这样的结构体字段。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 在 Operator 的
SetupWithManager里注册scheme.AddToScheme时确保已导入_ "k8s.io/client-go/applyconfigurations/core/v1"和_ "k8s.io/client-go/kubernetes/scheme" - 从
mgr.GetClient()拿到的是 controller-runtime 的client.Client，它底层封装了 typed client，支持client.List()，比直接用 rawclientset更符合 Operator 开发习惯 - 如果坚持用 raw
clientset，记得初始化时传对rest.Config，别误用ctrl.GetConfigOrDie()（它只适用于本地开发环境）
controller-runtime 的 client.List() 怎么过滤 Pod？
不能像 SQL 那样写 WHERE，而是靠 client.MatchingFields 或 client.MatchingLabels。但注意：MatchingFields 默认只支持 metadata.name 和 metadata.namespace，想按 status.phase 过滤，得提前在 CRD 或 kube-apiserver 开启 field index（不推荐），更实际的做法是 List 后 in-memory 筛选。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 标签筛选最常用：
client.MatchingLabels{"app": "nginx"} - 精确匹配 name + namespace：用
client.ObjectKey{Namespace: "x", Name: "y"}加Get()，比 List 再遍历快得多 - 按 phase 过滤（如只取 Running Pod）：List 完后用
if pod.Status.Phase == corev1.PodRunning手动过滤，简单直接，小规模集群无压力
为什么 List 返回的 Pod 没有 Status 或 Conditions？
默认 List 不一定填充完整 Status，尤其当 Pod 处于 Pending 或刚创建时，Status 可能为空或不全。这不是 bug，是 Kubernetes API 的设计：Status 字段由 kubelet 异步上报，List 响应只保证 metadata 和 spec 必填。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 不要依赖 List 结果里的
pod.Status.ContainerStatuses做关键判断，它可能为 nil - 需要准实时状态（比如等 Pod Ready），应该用
client.Get()单独拉取，或 watch + 缓存（如cache.Indexer） - 若用 controller-runtime 的
client.List()，确保传的listOpts没误加client.Limit(1)之类干扰字段的选项
真正麻烦的从来不是怎么列出 Pod，而是你拿到列表后，没意识到其中很多 Pod.Status 是“过期快照”——尤其是做健康检查或批量重启时，得额外加一层 Get 校验。
