用 client-go 读取 ConfigMap 必须三步：先初始化 *rest.Config，再构造 clientset.Clientset，最后调用 CoreV1().ConfigMaps(namespace).Get()；namespace 非空，Get() 第二参数须为 metav1.GetOptions{}。
用 client-go 读取 ConfigMap 需要哪些核心步骤
必须先初始化 *rest.Config，再构造 clientset.Clientset，最后调用 CoreV1().ConfigMaps(namespace).Get()。跳过任一环节都会 panic 或返回 nil。
-
rest.InClusterConfig()仅适用于 Pod 内运行；本地调试请用rest.InClusterConfig()替换为clientcmd.BuildConfigFromFlags("", kubeconfigPath) - 命名空间（
namespace）不能传空字符串，否则会报错namespaces "" not found -
Get()第二个参数必须是metav1.GetOptions{}，不能传nil（v0.28+ 版本已强制要求）
cfg, err := rest.InClusterConfig()
if err != nil {
log.Fatal(err)
}
clientset, err := kubernetes.NewForConfig(cfg)
if err != nil {
log.Fatal(err)
}
cm, err := clientset.CoreV1().ConfigMaps("default").Get(context.TODO(), "my-config", metav1.GetOptions{})
if err != nil {
log.Fatal(err)
}
fmt.Printf("Data keys: %v\n", maps.Keys(cm.Data))
更新 ConfigMap 时为什么总是被拒绝
常见原因是没传 ResourceVersion，或传了过期的值。Kubernetes 使用乐观并发控制，Update() 要求请求体中 ObjectMeta.ResourceVersion 与服务端当前一致。
- 直接修改
cm.Data后调用Update()前，必须保留原始cm.ResourceVersion - 若不确定版本号，应先
Get()一次再改再Update()，不能靠缓存旧对象 - 使用
Apply()（需 v1.22+ + server-side apply）可绕过 ResourceVersion 校验，但需启用serverSideApply特性门
如何安全地批量注入 ConfigMap 到结构体
不要手动遍历 cm.Data 映射赋值，容易漏字段、类型错配。推荐用 mapstructure.Decode() 或 envconfig.Process() 这类库做结构绑定。
-
mapstructure.Decode()支持嵌套结构、类型转换、默认值（default:"xxx"tag） - 字段名必须导出（首字母大写），且建议加
mapstructure:"key-name"tag 显式指定 key 名 - 若 ConfigMap 中某个 key 缺失，对应字段会是零值 —— 需配合
required:"true"tag 或手动校验
type Config struct {
TimeoutSeconds int `mapstructure:"timeout-seconds"`
LogLevel string `mapstructure:"log-level" default:"info"`
}
var cfg Config
if err := mapstructure.Decode(cm.Data, &cfg); err != nil {
log.Fatal(err)
}
Watch ConfigMap 变化时常见的连接中断问题
原生 Watch() 返回的 watch.Interface 不自动重连。一旦网络抖动或 apiserver 重启，watch 就静默终止，后续变更完全收不到。
立即学习“go语言免费学习笔记（深入）”；
- 必须自己封装重连逻辑：捕获
err != nil后 sleep + retry，同时记录上次收到的resourceVersion - 推荐用
cache.NewInformer()或cache.NewSharedIndexInformer()，它们内置重试、reflector 和本地缓存 - 注意 informer 的
ResyncPeriod不是轮询间隔，而是强制触发全量同步的周期，不影响事件实时性
