# InternalError：CUDA 驱动程序版本不足以支持 CUDA 运行时版本

- **ID:** `tensorflow/cuda-driver-version-mismatch`
- **领域:** tensorflow
- **类别:** install_error
- **错误码:** `CUD`
- **验证级别:** ai_generated
- **修复率:** 92%

## 根因

安装的 NVIDIA 驱动程序版本低于 TensorFlow 编译所依赖的 CUDA 工具包所需版本。

## 版本兼容性

| 版本 | 状态 | 引入 | 弃用 |
|------|------|------|------|
| tensorflow 2.15 | active | — | — |
| tensorflow 2.16 | active | — | — |
| tensorflow 2.17 | active | — | — |

## 解决方案

1. ```
   Update the NVIDIA driver to the required version. Check current driver with `nvidia-smi` and download the latest driver from https://www.nvidia.com/Download/index.aspx. For Ubuntu: `sudo apt update && sudo apt install nvidia-driver-545`.
   ```
2. ```
   Downgrade TensorFlow to a version compatible with the current driver. For example, use `pip install tensorflow==2.12.0` if the driver is older.
   ```

## 无效尝试

- **** — Reinstalling TensorFlow alone does not update the NVIDIA driver; the driver is a system-level component. (95% 失败率)
- **** — Installing a newer CUDA toolkit via conda often fails because it does not update the kernel-mode driver. (80% 失败率)