# 错误：Chart 需要 kubeVersion: >=1.25.0-0，这与 Kubernetes v1.24.10 不兼容

- **ID:** `kubernetes/helm-incompatible-capabilities`
- **领域:** kubernetes
- **类别:** install_error
- **验证级别:** ai_generated
- **修复率:** 82%

## 根因

Helm Chart 定义了最低 Kubernetes 版本要求 (kubeVersion)，当前集群版本不满足此要求，导致无法安装或升级。

## 版本兼容性

| 版本 | 状态 | 引入 | 弃用 |
|------|------|------|------|
| Helm 3.11 | active | — | — |
| Helm 3.12 | active | — | — |
| Helm 3.13 | active | — | — |
| Kubernetes 1.24 | active | — | — |
| Kubernetes 1.25 | active | — | — |

## 解决方案

1. ```
   Upgrade the cluster: use kubeadm or cloud provider to upgrade nodes to a compatible version, e.g., kubectl get nodes and then upgrade to v1.25+
   ```
2. ```
   Find an older chart version that supports your Kubernetes version: helm search repo <chart-name> --versions and install with --version <older-version>
   ```

## 无效尝试

- **Downgrading the chart to an older version manually by editing Chart.yaml** — Chart.yaml 中的 kubeVersion 是声明式的，降级版本可能不满足其他依赖 (70% 失败率)
- **Ignoring the error with --force flag** — Helm 的 --force 不绕过 kubeVersion 检查，只用于资源替换 (95% 失败率)
- **Manually deleting the kubeVersion field from Chart.yaml** — 删除字段后安装可能成功，但 Chart 可能依赖集群特性导致运行时错误 (50% 失败率)