设置Job历史限制后，Kubernetes仍无法自动删除CronJob生成的已完成Job

我之前也碰到过一模一样的坑！明明设置了successfulJobsHistoryLimit和failedJobsHistoryLimit为1，但集群里还是堆了一堆旧Job，甚至超过了默认的保留数量。结合我踩过的坑，给你几个排查方向：

1. 先确认参数设置的位置是否正确 #

这是最容易犯的错误——很多人会把这两个参数写到Job模板里，而不是CronJob的顶层spec下。这两个参数是CronJob本身的配置，不是它生成的Job的配置！

正确的YAML示例：

apiVersion: batch/v1
kind: CronJob
metadata:
  name: my-scheduled-job
spec:
  schedule: "0 */2 * * *"
  # 这两个参数必须放在CronJob的spec顶层！
  successfulJobsHistoryLimit: 1
  failedJobsHistoryLimit: 1
  jobTemplate:
    spec:
      template:
        spec:
          containers:
          - name: task-container
            image: my-task-image:latest
          restartPolicy: OnFailure

如果参数放在jobTemplate.spec里，CronJob控制器根本不会读取这个配置，自然不会触发自动清理。

2. 检查Kubernetes集群版本是否存在已知bug #

在一些较老的Kubernetes版本（比如1.18及更早的部分版本）中，CronJob的历史清理逻辑存在延迟或失效的问题。比如控制器可能没有定期触发清理，或者对Job状态的判断有误。

你可以先查看集群版本：

kubectl version --short

如果版本偏老，建议升级到稳定的新版本（比如1.22+），或者重启kube-controller-manager组件（注意：生产环境操作前要做好备份）。

3. 验证CronJob控制器是否正常工作 #

可以查看CronJob的事件日志，看看有没有清理失败的记录：

kubectl describe cronjob <your-cronjob-name>

在Events部分，如果看到类似Failed to clean up old jobs的日志，说明控制器在清理时遇到了问题，可能是权限不足或者API调用异常。

另外，也可以检查kube-controller-manager的日志，看看有没有相关报错：

# 假设控制器以Deployment运行在kube-system命名空间
kubectl logs -n kube-system deployment/kube-controller-manager -c kube-controller-manager | grep -i cronjob

4. 临时应急：手动清理旧Job #

如果自动清理暂时无法生效，可以用命令手动清理已完成的Job：

# 清理所有成功完成的Job（按CronJob的标签过滤）
kubectl delete jobs --field-selector status.successful=1 -l app=<your-cronjob-label>

# 清理失败的Job
kubectl delete jobs --field-selector status.failed=1 -l app=<your-cronjob-label>

也可以把这个命令做成一个定时任务，临时替代CronJob的自动清理功能。

内容的提问来源于stack exchange，提问作者J. Sebio