Go写Kubernetes Operator需直面client-go权限、Reconcile触发逻辑、CRD scope与client.Get匹配问题；常见失败源于状态未对齐、事件未监听、权限静默拒绝。
用 Go 写 Kubernetes Operator 不是“搭个脚手架跑起来就行”，而是必须直面 client-go 权限、controller-runtime 的 Reconcile 触发逻辑、CRD scope 与 client.Get 调用方式的匹配问题。多数失败不是语法错，而是状态没对齐、事件没监听到、权限被静默拒绝。
operator-sdk init 报 “kubebuilder not found” 怎么办
这不是 operator-sdk 安装错了，而是它启动时要调用 kubebuilder 二进制生成 scaffold，但根本找不到可执行文件。
- 先运行
kubebuilder version确认是否在 PATH 中；没输出就说明没装或路径不对 - operator-sdk v1.30+ 明确要求
kubebuilder@v3.20+，别用 Homebrew 默认装的 v4 —— macOS 上得显式执行：brew install kubebuilder@3 - Windows 用户改完 PATH 后必须重启 PowerShell 或手动更新：
$env:PATH += ";C:\path\to\kubebuilder\bin" - Linux/macOS 可直接下载二进制：
curl -L https://go.kubebuilder.io/dl/latest/$(go env GOOS)/$(go env GOARCH) | tar -xz -C /usr/local/bin/
Reconcile 函数里 client.Get 拿不到自定义资源
常见现象是 err 非空但不是 errors.IsNotFound，或者始终返回 NotFound 即使资源明明存在。本质是权限或作用域错配。
- RABC 权限没开全：检查
config/rbac/role.yaml是否包含对你 CRD 的get、list、watch权限，资源名必须和 CRD 文件中spec.names.plural一致（比如redisclusters，不是RedisCluster） - scope 不匹配：如果 CRD 定义了
scope: Cluster，但你在 Reconcile 里用client.Get(ctx, req.NamespacedName, &myCR)，它会去 namespace 下找 —— 正确写法是client.Get(ctx, types.NamespacedName{Name: req.Name}, &myCR)（去掉 Namespace 字段） - 快速验证权限：
kubectl auth can-i get redisclusters --list --all-namespaces，返回 yes 才算过
Manager 启动后 Reconcile 完全不触发
日志显示 manager running，但你删 CR、改 spec，Reconcile 函数一毛不动。这不是代码没写，是 Watch 没注册上。
- 确认
SetupWithManager方法里是否调用了Watches或Owns：比如mgr.GetFieldIndexer().IndexField(...)后，必须显式Watches(&source.Kind{Type: &appsv1.Deployment{}}, ...)，否则 Deployment 变更不会推给你的 Reconcile - 检查 Predicate 是否误过滤：比如用了
predicate.GenerationChangedPredicate{}，但它只在metadata.generation变时触发 —— 而 CR 的 annotation 或 label 修改不会触发 generation 变更 - 确保 CRD 已成功 apply：
kubectl get crd redisclusters.example.com返回 READY 为 True，否则 controller 根本不认识这个类型
本地调试时 client.List 返回空列表
不是集群没资源，而是 client 没连对上下文，或缓存没热起来。
- 本地运行
make run时，默认用~/.kube/config，但如果你有多个 context，得加CTRL_CONFIG_CONTEXT=kind-kind make run显式指定 - controller-runtime 的 client 默认走 cache，首次 List 可能返回空 —— 加个
time.Sleep(2 * time.Second)看是否后续正常（仅调试用，生产勿留） - 绕过 cache 直连 API Server：用
mgr.GetAPIReader()替代mgr.GetClient()，但性能差，仅用于验证数据是否存在
最易忽略的一点：CRD 的 spec.version 和 Go struct tag 中的 json:"..." 字段名必须严格对应，否则 client.Get 解码失败，错误被吞掉，表现就是“资源存在但读不到字段”。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
