必须显式设置 apiVersion: batch/v1 和 kind: CronJob，否则 API Server 返回 400 错误；还需配置 RBAC 权限、使用合法 5 字段 cron 表达式、指定 RestartPolicy 为 OnFailure 或 Never。
用 client-go 创建 CronJob 对象时，必须显式设置 apiVersion 和 kind
Go 代码里构造 CronJob 结构体时，如果漏掉 apiVersion: batch/v1 和 kind: CronJob，Kubernetes API Server 会直接返回 400 Bad Request，错误信息类似：the object has no api version set 或 no kind "CronJob" is registered for version "batch/v1"。
这是因为 client-go 不会自动补全这些字段，必须手动写死：
job := &batchv1.CronJob{
TypeMeta: metav1.TypeMeta{
Kind: "CronJob",
APIVersion: "batch/v1", // 注意：不是 v1beta1（已弃用）
},
ObjectMeta: metav1.ObjectMeta{
Name: "my-cron-job",
Namespace: "default",
},
Spec: batchv1.CronJobSpec{
Schedule: "*/5 * * * *",
JobTemplate: batchv1.JobTemplateSpec{
Spec: batchv1.JobSpec{
Template: corev1.PodTemplateSpec{
Spec: corev1.PodSpec{
RestartPolicy: corev1.RestartPolicyOnFailure,
Containers: []corev1.Container{{
Name: "hello",
Image: "busybox:1.35",
Args: []string{"echo", "hello from cron"},
}},
},
},
},
},
},
}调用 Create() 前要确保 client-go 已正确配置 RBAC 权限
即使 Go 代码语法完全正确，clientset.BatchV1().CronJobs(namespace).Create(ctx, job, metav1.CreateOptions{}) 仍可能返回 403 Forbidden，典型错误：cronjobs.batch is forbidden: User "system:serviceaccount:default:my-sa" cannot create resource "cronjobs" in API group "batch" in the namespace "default"。
你需要为服务账号（ServiceAccount）绑定对应 ClusterRole 或 Role：
立即学习“go语言免费学习笔记（深入）”；
- 如果是集群级操作，用
ClusterRole+ClusterRoleBinding，权限包含verbs: ["create"]，resources: ["cronjobs"]，apiGroups: ["batch"] - 如果是命名空间内操作，用
Role+RoleBinding，且namespace字段必须与Create()调用时传入的 namespace 一致 - 注意：Kubernetes v1.25+ 默认不启用
batch/v1beta1，只认batch/v1，RBAC 规则里apiGroups必须写["batch"]，不能写["batch/v1"]
Schedule 字符串格式不支持秒字段，且需符合 POSIX cron 语义
CronJob.Spec.Schedule 是字符串字段，但它的语法不是 Linux crond 的 5 字段（分、时、日、月、周），而是标准的 5 字段 POSIX cron（不支持第 6 位“秒”）。写成 "0 */5 * * *" 会报错：Invalid value: "0 */5 * * *": Expected exactly 5 fields, found 6。
常见合法值示例：
-
"*/5 * * * *"— 每 5 分钟执行一次 -
"0 2 * * *"— 每天凌晨 2 点 -
"0 0 * * 0"— 每周日凌晨 0 点（注意：周日是 0，不是 7）
另外，Kubernetes 的 cron 解析器不支持 @hourly、@daily 这类符号别名，必须展开为标准字段。
JobTemplate 中的 PodSpec 必须设置 RestartPolicy: OnFailure 或 Never
如果不显式指定 RestartPolicy，client-go 会使用 struct 零值（即空字符串），导致 API Server 拒绝创建，报错：spec.jobTemplate.spec.template.spec.restartPolicy: Unsupported value: "": supported values: "OnFailure", "Never"。
这是硬性校验，和普通 Pod 不同（普通 Pod 默认是 Always），CronJob 的底层 Job 要求 Pod 只能失败重试或不重启：
-
OnFailure：容器失败时重启，适合单次任务失败后重试 -
Never：失败也不重启，适合调试或幂等性强的任务 - 绝对不要设成
Always，否则创建失败
这个字段容易被忽略，因为 IDE 自动补全可能不会提示它为必填项，但实际是 server 端强制校验。
CronJob 的 startingDeadlineSeconds 和 concurrencyPolicy 这类字段虽非必需，但在生产环境几乎必配；不设的话，错过调度时间可能永久丢失，或并发任务堆积导致资源失控。
