Reconcile函数是Kubernetes控制循环的执行单元，必须幂等、非阻塞；每次调用需假设前次已成功，同一请求执行多次效果须与一次相同，严禁副作用操作、阻塞调用及错误资源更新方式。
Reconcile 函数不是“写一次就完事”的回调，而是 Kubernetes 控制循环的执行单元；写错逻辑会导致资源卡在 Pending、反复重试、状态不更新，甚至引发级联删除失败。
Reconcile 必须是幂等且非阻塞的
每次调用都应假设前一次可能已成功执行过——同一请求来 10 次，效果必须和来 1 次一样。任何带副作用的“一次性操作”（比如发一次 webhook、写本地文件、初始化全局变量）都会破坏终态收敛。
- 不要在
Reconcile里调用time.Sleep或select {}阻塞，超时默认 15 秒，卡住会堆积 reconcile queue，导致后续事件延迟处理 - 避免用
client.Create覆盖已有对象；该用client.Patch或client.Update，否则会丢掉metadata.generation、ownerReferences等关键字段 - 检查对象是否存在，优先用
err := client.Get(ctx, key, obj)+errors.IsNotFound(err)判断，而不是靠 panic 或静默忽略
CRD 类型未注册或权限缺失是 Reconcile 失败最常见原因
Operator 启动后 Reconcile 根本不触发，或者一调用就 panic，大概率不是业务逻辑问题，而是基础配置没对齐。
- CRD YAML 必须先用
kubectl apply -f crd.yaml部署成功；否则mgr.GetClient().Get会报no matches for kind "MyApp" in version "app.example.com/v1" - Go 类型必须显式注册进 Scheme：在
main.go中mgr, err := ctrl.NewManager(...)之前，调用myappv1.AddToScheme(mgr.GetScheme())，漏掉这行会直接 panic - RABC 权限要覆盖 CRD 所有子资源：除了
resources: ["myapps"]，还得加resources: ["myapps/status"]和resources: ["myapps/finalizers"]，否则Status().Update()会 403
更新 status 和主资源必须分离调用
Reconcile 中经常要同时更新 CR 的 spec（主资源）和 status（子资源），但这两者不能混用同一个 client 方法——Kubernetes 对 status 子资源有独立的 API endpoint 和 RBAC 要求。
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
立即学习“go语言免费学习笔记（深入）”；
- 更新 spec 字段（如
spec.replicas）用client.Update(ctx, cr) - 更新 status 字段（如
status.readyReplicas）必须用client.Status().Update(ctx, cr)，否则 API Server 会拒绝 - 如果 status 更新失败，不要直接 return error；建议记录日志并继续执行主流程，否则可能因 status 写失败而阻塞整个 reconcile 循环
调试 Reconcile 失败要盯住 Events 和日志锚点
Reconcile 返回 error 不等于功能坏掉，而是触发重试；真正的问题藏在资源 Events 和日志中那行带 name=xxx 的输出里。
- 查错误事件：
kubectl describe myapp/myinstance，Events 区域会显示类似Reconcile error: failed to get deployment: not found - 查对应日志：用
kubectl logs -l control-plane=controller-manager | grep "name=myinstance"定位到具体哪次调用出错 - 常见 error 类型：
context deadline exceeded（网络或 client 超时）、invalid value（struct tag 与 CRD 字段不一致）、Operation cannot be fulfilled（resourceVersion 冲突，需重试）
最容易被忽略的是：Reconcile 的输入对象（req ctrl.Request）只含 name/namespace，所有资源获取都得靠 client 显式 Get；没人替你缓存或预加载依赖对象，每一步都要自己 check error、自己 handle not-found，少一个判断就可能让整个控制器陷入静默失败。
