Reconcile函数写完控制器仍不能运行，必须严格按序完成四步：注册scheme（含client-go和apiextensionsv1）、自动生成CRD YAML、status更新用Status().Update、Watch范围与cache命名空间匹配。
Reconcile 函数写完就以为控制器能跑？不行。controller-runtime 的启动、资源注册、CRD 识别、状态更新这四步里，任意一步漏掉或顺序错，都会在 mgr.Start() 阶段 panic 或 reconcile 时静默失败。
controller-runtime 启动前必须完成 scheme 注册
没注册 scheme 就调 mgr.GetClient()，后续所有 Get/List 都会报 no kind "MyApp" is registered for version "example.com/v1"——不是 CRD 没 apply，是 Go 程序根本“不认识”这个类型。
必须按顺序做三件事：
- 用
runtime.NewSchemeBuilder收集你的 CR struct（如&MyApp{}、&MyAppList{}） - 显式调
clientgoscheme.AddToScheme(scheme)和apiextensionsv1.AddToScheme(scheme)，否则连 CRD 自身都解析不了 - 确保
MyAppstruct 嵌入了metav1.TypeMeta和metav1.ObjectMeta，并实现runtime.Object接口
CRD YAML 必须由 controller-gen 自动生成
手写 CRD 容易拼错 spec.group、spec.versions[0].name 或 spec.names.kind，导致 client-go 创建实例时 API Server 返回 404 Not Found 或 400 Bad Request。
正确做法是：
立即学习“go语言免费学习笔记（深入）”；
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 在 CR struct 上加
// +kubebuilder:object:root=true和// +kubebuilder:subresource:status注释 - 运行
make manifests（依赖controller-gen），它会校验 group/version/kind 对齐关系 - 生成的 YAML 中
metadata.name格式必须是<plural>.<group></group></plural>，比如myapps.example.com
Reconcile 里更新 status 必须用 Status().Update
直接改 struct 的 Status 字段再调 Update()，API Server 会拒绝并返回 Invalid: status.subresources.status 错误——因为 spec 和 status 是两个独立子资源。
安全写法只有这一种：
- 先
r.Client.Get(ctx, req.NamespacedName, instance)拿到最新对象 - 修改
instance.Status.Ready = true等字段 - 调
r.Client.Status().Update(ctx, instance)单独提交 status - 如果同时要更新 spec，必须分两步：先
Update()spec，再Status().Update()，顺序不能反
监听范围不匹配会导致事件收不到
你以为 Watch 了 &MyApp{} 就能收到所有命名空间的变更？默认 cache 是集群级的，但如果你在 manager.Options{Cache: cache.Options{Namespace: "my-ns"}} 里限制了命名空间，而 ctrl.Watch(source.Kind(...)) 没加 predicates.NamespacePredicate，就会出现“CR 创建了但 reconcile 根本不触发”的现象。
检查点有三个：
-
manager.New(..., manager.Options{Cache: cache.Options{Namespace: "my-ns"}})设了命名空间，则所有 Watch 默认只生效于该 ns - 若需跨 ns，删掉
Cache.Namespace，或显式传cache.Options{Namespace: ""} - Watch 时用
ctrl.Watch(source.Kind(mgr.GetCache(), &MyApp{}), predicates.GenerationChangedPredicate{})，避免低频变更被跳过
scheme 加载时机、Status().Update 的强制分离、以及命名空间过滤和 Watch 范围之间那层看不见的耦合。这些地方一错，日志里既没 panic 也没 error，只有 reconcile 彻底失联。 
