Ubuntu安装显卡驱动与CUDA常见问题有哪些？

Question

在Ubuntu系统中安装NVIDIA显卡驱动与CUDA工具包时，常见的技术问题包括：系统与驱动版本不兼容导致的黑屏或登录循环；使用apt安装的驱动版本过旧，无法支持最新的CUDA版本；禁用nouveau驱动失败，导致安装过程中冲突；以及CUDA Toolkit与cuDNN版本不匹配，引发深度学习框架运行错误。此外，多内核环境下切换内核后可能出现驱动失效，需重新编译安装；Secure Boot启用状态下也可能阻止第三方驱动加载。这些问题通常涉及系统配置、源码编译、依赖管理等多个层面，是部署AI开发环境时的高频障碍。

Answer 1

Ubuntu系统中安装NVIDIA显卡驱动与CUDA工具包的常见问题与解决方案

一、系统与NVIDIA驱动版本不兼容导致黑屏或登录循环

在Ubuntu系统上安装NVIDIA驱动时，如果驱动版本与当前内核或GPU型号不匹配，可能导致图形界面无法启动，表现为黑屏或陷入登录循环。

• 原因分析： 驱动未适配当前Linux内核版本；Secure Boot启用；Xorg配置错误。
• 解决方法：

1. 进入TTY终端（Ctrl+Alt+F3）并卸载现有驱动：sudo apt purge nvidia-*
2. 禁用nouveau驱动：echo blacklist nouveau | sudo tee /etc/modprobe.d/blacklist-nvidia-nouveau.conf
3. 更新initramfs：sudo update-initramfs -u
4. 使用官方.run文件手动安装最新驱动

二、apt安装的NVIDIA驱动版本过旧

通过Ubuntu官方仓库使用apt install nvidia-driver-xxx安装的驱动可能落后于官方最新稳定版，无法支持最新的CUDA Toolkit。

方式	优点	缺点
APT安装	简单快捷，依赖自动处理	版本老旧，功能缺失
.run文件安装	可获取最新驱动	需手动禁用nouveau和Secure Boot

建议从NVIDIA官网下载对应GPU型号的.run驱动文件进行安装。

三、禁用nouveau失败引发冲突

nouveau是开源的NVIDIA显卡驱动，在安装闭源驱动前必须禁用，否则会导致冲突。

# 创建黑名单文件
echo "blacklist nouveau" | sudo tee /etc/modprobe.d/blacklist-nvidia-nouveau.conf
echo "options nouveau modeset=0" | sudo tee -a /etc/modprobe.d/blacklist-nvidia-nouveau.conf

# 更新initramfs
sudo update-initramfs -u
    

重启后可通过以下命令验证是否成功禁用：

lsmod | grep nouveau

四、CUDA Toolkit与cuDNN版本不匹配

CUDA Toolkit和cuDNN版本需严格匹配，否则可能导致TensorFlow、PyTorch等深度学习框架运行异常。

• 典型错误信息： Could not load dynamic library 'libcudnn.so.X' 或 CUDNN_STATUS_NOT_SUPPORTED
• 解决方案：

1. 访问cuDNN官方文档查看对应CUDA版本
2. 使用conda管理环境，确保版本一致性：

   conda create -n pytorch_env python=3.9

   conda install pytorch torchvision torchaudio cudatoolkit=11.8 -c pytorch

五、多内核环境下切换内核导致驱动失效

当系统存在多个Linux内核（如5.15.0-76-generic 和 5.15.0-80-generic），切换内核后可能需要重新编译安装NVIDIA驱动模块。

sudo dkms status

若输出中没有对应的nvidia条目，则说明驱动未为当前内核构建。应重新执行.run文件安装或使用dkms重新构建。

六、Secure Boot启用状态下阻止第三方驱动加载

NVIDIA闭源驱动属于第三方模块，若Secure Boot处于开启状态，将阻止其加载。

sudo mokutil --sb-state

若输出显示Secure Boot enabled，需进入BIOS设置将其关闭，并重新启动系统。

七、整体流程图示例

graph TD
            A[开始] --> B[更新系统]
            B --> C[禁用nouveau]
            C --> D[更新initramfs]
            D --> E[关闭Secure Boot]
            E --> F[下载.run驱动]
            F --> G[安装驱动]
            G --> H[安装CUDA Toolkit]
            H --> I[安装cuDNN]
            I --> J[测试环境]