Reconcile函数是持续状态对齐的幂等循环,每次调用必须从任意当前状态收敛至期望状态;需分类处理NotFound等错误、安全类型断言、独立更新status并确保幂等性。

Reconcile 函数不是事件处理器,别按“收到创建事件就执行初始化”来写。 它是持续对齐状态的循环,每次调用都必须能从任意当前状态收敛到期望状态,无论触发原因是 CR 创建、更新、关联资源被删,还是 Informer 缓存刷新。
Reconcile 里怎么处理“资源不存在”这类错误
常见错误现象:r.Get(ctx, req.NamespacedName, &myapp) 返回 NotFound 错误,但 Reconcile 直接 return error,导致 controller-runtime 不断重试,日志刷屏。
- 正确做法:显式检查错误类型,
if apierrors.IsNotFound(err)时直接 return nil(表示“资源已删除,无需再调谐”) - 不要忽略
DeletionTimestamp != nil的情况——这是资源正在被删除的信号,应进入清理逻辑(如删除 finalizer、清理子资源) - 所有 client.Get / List 调用都要做错误分类处理,不能一概 return err;403 权限错误、429 限流、500 服务端错误的应对策略完全不同
为什么不能在 Reconcile 里用 obj.(*corev1.Pod) 强制断言
当你用 Informer 或 client.List 获取 Pod 列表后,直接写 pod := obj.(*corev1.Pod),一旦上游返回的是 *unstructured.Unstructured(比如跨版本或使用了某些动态客户端),程序 panic,整个 Reconciler 停摆。
- 必须用 type switch:
switch obj := item.(type) { case *corev1.Pod: ... case *unstructured.Unstructured: if obj.GetKind() == "Pod" { ... } } - 尤其注意 watch.Event.Object 字段:它可能是
*corev1.Pod、*corev1.Event(注意是 k8s.io/api/core/v1.Event,不是 watch.Event)、*unstructured.Unstructured,永远不假设类型 - controller-runtime 的
client.List默认返回 runtime.Object,不是具体类型;想安全转成*corev1.Pod,得先err := scheme.Convert(&unstructuredObj, &typedObj, nil)
status.conditions 更新为什么总不生效或被覆盖
典型表现:kubectl describe 看不到 condition 变化,或者刚设成 True,下一次 Reconcile 又变回 Unknown。
立即学习“go语言免费学习笔记(深入)”;
- 根本原因:status 更新必须走
r.Status().Update(ctx, &myapp)单独请求,不能和 spec 合并在一个r.Update()里,否则 API Server 拒绝并报Invalid: status - 并发风险:多个 Reconcile 协程同时更新 status,彼此覆盖。解决办法是先
r.Get(ctx, key, &existing)拿当前 status,只 patch 差异字段(比如只改conditions[0].lastTransitionTime),而不是全量替换 - 别在 Reconcile 结尾才更新 status——关键步骤后立刻调用封装好的
updateStatusCondition(r, &myapp, "ApplyingConfig", corev1.ConditionTrue, ""),确保故障发生时 status 能真实反映卡点
最常被忽略的一点:Reconcile 函数的幂等性不是“尽量做到”,而是硬性前提。哪怕你加了 time.Sleep(10 * time.Second) 或发了一次 webhook,只要没做去重/标记,下一次调谐就会重复执行——而 Kubernetes 会因为超时、网络抖动、缓存延迟等原因反复触发它。


















