本文介绍Kubernetes v1.30.3中kube-apiserver的watch cache机制，核心是Cacher组件：它通过watchCache环形缓冲存储事件，用Ready门控制启动同步，dispatch实现内存多路分发，bookmark维持资源版本推进。当缓存未命中或未就绪时回退到etcd，可能引发List风暴，需调整缓存容量和bookmark频率优化。

本文介绍kube-apiserver生产内核系列，聚焦控制面故障排障，以Storage/Watch/Admission/Auth/APF五轴为坐标系，规划16篇阅读路线。内容涵盖请求路径、watch cache、resourceVersion、Webhook、APF等机制，版本锚定Kubernetes v1.30.3，旨在帮助SRE归因504、410等错误，区分直连etcd与apiserver排障边界。