Reconcile 函数常见错误源于类型未注册、权限缺失或 status 更新方式错误：需在 NewManager 前调用 AddToScheme 注册类型，用 Status().Update() 更新 status，确保 RBAC 与 CRD scope 一致，并正确配置 Watch 和 Predicate。
直接写 Reconcile 函数不难，难的是它一跑就错、一错就静默、一静默就找不到日志在哪——绝大多数问题根本不是逻辑写错了，而是类型没注册、权限没配全、或 status 更新方式不对。
Reconcile 报 no kind "MyApp" is registered 怎么办
这不是 CRD 没 kubectl apply，而是 controller-runtime 根本不认识你的 Go 类型。Scheme 没注册，mgr.GetClient().Get() 就会 panic。
- 确认
main.go中ctrl.NewManager()之前调用了myappv1.AddToScheme(scheme.Scheme) -
AddToScheme函数由controller-gen自动生成，通常在api/v1/register.go或zz_generated.deepcopy.go同级目录 - 检查 CRD YAML 中
spec.versions[0].name（如v1）和 Go struct 的GroupVersionKind().Version是否完全一致 - 多版本 CRD 下，scheme 只认存储版本；其他版本需 Conversion Webhook，client 不自动转
Reconcile 里更新 status 为什么失败还静默
Status().Update() 失败不会报错到终端，但 APIServer 会拒绝请求，且不改 spec —— 最常见表现是 status 字段始终为空，或报 Operation cannot be fulfilled。
- 必须用
r.Status().Update(ctx, &myApp)，不能用r.Client.Update()全量提交 -
Status().Update()只比对status.resourceVersion，天然绕过 spec 校验 - 确保
MyAppStatus结构体字段可序列化：无嵌套指针、无函数类型、所有字段首字母大写（导出） - 如果
Status().Update()返回 error，直接return ctrl.Result{}, err，不要重试或 sleep
Operator 不触发 Reconcile 的真实原因
Manager 启动成功 ≠ Controller 开始干活。90% 是 Watch 没注册对，或者 Predicate 过滤掉了事件。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 在
SetupWithManager里显式调用.For(&MyApp{})和.Owns(&appsv1.Deployment{})，漏掉Owns就收不到子资源变更 - 用
predicate.GenerationChangedPredicate{}时注意：ConfigMap/Secret 更新不会触发 generation 变更，得换LabelChangedPredicate或自定义 Predicate - 若为 ConfigMap 建索引（如按 label），必须先
mgr.GetFieldIndexer().IndexField()，再显式Watches()注册 EventHandler - 检查 RBAC：用
kubectl auth can-i list redisclusters --all-namespaces验证权限是否生效；Kubernetes 对权限不足常返回NotFound而非明确拒绝
CRD scope 是 ClusterScoped，但 Reconcile 里 Get 报 NotFound
CRD 定义了 scope: Cluster，但代码里仍用 req.NamespacedName 去查，就会去 namespace 下找——路径错，必然 404。
- ClusterScoped CR 必须用
types.NamespacedName{Name: req.Name}（不含 Namespace） - Namespaced CR 才能用
req.NamespacedName - 检查 CRD YAML 中
spec.scope值，并同步调整 RBAC：ClusterScope 需ClusterRole+ClusterRoleBinding，否则权限无效 - 本地调试时，
envtest默认只加载 Namespaced cache，ClusterScoped 资源需额外配置cache.Options{Scheme: scheme}
最易被忽略的点：Status 更新失败不报错、OwnerReference 漏设导致资源残留、以及 Predicate 用错让事件根本进不了 Reconcile —— 这些都不是代码 bug，而是 Operator 的“契约”没守好。
