必须用v1.Secret结构体构造，Data字段所有值需base64编码，且Namespace和Type不可省略；Namespace须设在ObjectMeta中，Type必须显式指定如v1.SecretTypeOpaque。
必须用 v1.Secret 结构体构造，Data 字段所有值都要 base64 编码，且不能漏掉 Namespace 和 Type —— 直接传明文字符串或空 Namespace 会静默失败或报 BadRequest。
client-go 创建 Secret 必须显式设置 Namespace 和 Type
很多初学者以为填完 Data 就够了，结果 Create() 返回 400 Bad Request 或 panic 报 nil pointer。这是因为 v1.Secret 是个强约束结构体：Namespace 是嵌套在 ObjectMeta 里的字段，不设就是空字符串；Type（如 v1.SecretTypeOpaque）更是必填，否则 API Server 拒绝接收。
-
Namespace必须写在metav1.ObjectMeta{Namespace: "default"}里，不能只靠 context 或 config 推导 -
Type推荐用常量：比如 TLS 证书用v1.SecretTypeTLS，通用凭据用v1.SecretTypeOpaque - 如果忘记设
Type，错误信息通常是field type is required，但不会明确告诉你缺哪个字段
Data 字段必须是 base64 编码后的 []byte
Data 是 map[string][]byte 类型，不是 map[string]string。哪怕你传的是普通密码字符串，也得先 base64.StdEncoding.EncodeToString()，再转成 []byte。Kubernetes 不做自动编码，客户端传啥它存啥——传明文进去，Secret 里存的就是明文（Base64 只是编码，不是加密）。
- 正确做法：
Data: map[string][]byte{"username": []byte(base64.StdEncoding.EncodeToString([]byte("admin")))} - 常见错误：直接写
"username": []byte("admin")→ 存进去的是乱码，Pod 挂载后读出来根本不是 "admin" - 证书类 Secret（如
tls.crt/tls.key）同样适用：读文件后必须 base64 编码，不能 raw bytes 直传
Update Secret 必须带最新 ResourceVersion
调用 Update() 时如果没带上刚 Get() 或 Create() 返回对象的 ResourceVersion，会返回 409 Conflict。这不是并发冲突警告，而是强制乐观锁校验 —— Kubernetes 要求你基于“已知最新版本”去改。
立即学习“go语言免费学习笔记（深入）”；
- 安全做法：先
Get()拿到当前对象，修改Data后直接复用它的ResourceVersion - 不要手写或硬编码
ResourceVersion，它由 API Server 生成，形如123456 - 如果只是想覆盖，用
Create()+Delete()组合更简单，但注意中间存在短暂不可用窗口
用 kubectl create secret 生成的 YAML 不能直接拿来反向构造 Go 对象
很多人把 kubectl create secret generic foo --from-literal=key=val -o yaml --dry-run=client 输出的 YAML 解析成 Go struct，结果 Data 字段解出来是 base64 字符串，直接塞进 v1.Secret.Data 就 panic。因为 Go struct 里要的是 []byte，不是字符串。
- YAML 中的
data:下内容是 base64 字符串（如key: dmFsdWU=），解析后需用base64.StdEncoding.DecodeString()得到原始字节，再赋值 - 更稳妥的方式：别解析 YAML，用 client-go 原生方式构造，避免编解码多层转换
- 注意
stringData字段（仅 YAML 支持）在 Go struct 中不存在，它只是 kubectl 的语法糖，API Server 接收前就自动转成Data
最容易被忽略的一点：Secret 的 Namespace 错了不会报错，而是创建到 default 命名空间，导致 Deployment 找不到它——因为 Deployment 引用 Secret 时指定了命名空间，而 Secret 实际在别处。务必 double-check ObjectMeta.Namespace 和引用位置是否一致。
