Ubuntu 22.04 安装NVIDIA驱动报错‘Building kernel modules’？别慌，这份保姆级排错指南帮你搞定

Ubuntu 22.04安装NVIDIA驱动报错"Building kernel modules"全流程解决方案

最近在实验室新配的深度学习工作站上安装Ubuntu 22.04时，遇到了经典的NVIDIA驱动安装问题。当运行sudo apt install nvidia-driver-535后，终端突然弹出红色错误提示："ERROR: An error occurred while performing the step: 'Building kernel modules'"。作为一名长期使用Linux系统的开发者，我深知这个问题的棘手程度——它可能让新手卡住数天，甚至放弃Linux转投Windows。本文将分享我经过多次实战总结出的完整解决方案，涵盖从日志分析到最终验证的全套流程。

1. 理解错误本质与初步诊断

遇到"Building kernel modules"错误时，最重要的是保持冷静。这个报错本质上是NVIDIA内核模块(nvidia.ko)编译失败的表现，通常发生在驱动安装程序尝试将驱动与当前运行的内核版本匹配时。在Ubuntu 22.04这种较新的LTS版本上，问题往往源自以下几个关键因素：

1. 内核头文件缺失或不匹配：编译内核模块需要对应版本的linux-headers
2. Secure Boot启用状态：UEFI安全启动会阻止未签名模块加载
3. GCC工具链不完整：缺少build-essential等基础编译工具
4. 残留驱动冲突：之前安装失败的驱动或开源驱动nouveau造成干扰

首要诊断步骤是检查安装日志，这个文件包含了故障的详细信息：

sudo cat /var/log/nvidia-installer.log | grep -i error -A5 -B5

典型错误可能包括：

• Unable to find the kernel source tree
• Failed to compile kernel module
• Secure Boot prevents loading unsigned modules

2. 系统环境准备与依赖检查

2.1 验证内核版本与头文件

Ubuntu 22.04默认使用5.15系列内核，但通过uname -r查看的实际运行版本可能与已安装的头文件存在差异：

uname -r # 显示当前运行内核版本 apt list --installed | grep linux-headers # 查看已安装头文件

若发现版本不匹配，需安装对应头文件：

sudo apt install linux-headers-$(uname -r)

2.2 安装完整编译工具链

确保系统具备完整的编译环境：

sudo apt update sudo apt install build-essential dkms libglvnd-dev

注意：dkms(Dynamic Kernel Module Support)能在内核更新后自动重新编译NVIDIA模块，是长期维护的关键组件。

2.3 处理Secure Boot问题

在UEFI系统中，Secure Boot可能导致模块加载失败。检查状态：

mokutil --sb-state

若显示"SecureBoot enabled"，有两种解决方案：

1. 进入BIOS临时禁用Secure Boot
2. 为NVIDIA模块创建签名（推荐长期方案）：

sudo apt install mokutil sudo mokutil --import /var/lib/shim-signed/mok/NVIDIA.der

3. 彻底清理旧驱动残留

残留驱动是许多安装失败的元凶。执行深度清理：

sudo apt purge *nvidia* sudo apt autoremove sudo rm -rf /usr/lib/nvidia /usr/lib/x86_64-linux-gnu/nvidia

然后屏蔽开源驱动nouveau：

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 sudo update-initramfs -u

重启后验证nouveau是否已禁用：

lsmod | grep -i nouveau

4. 驱动安装方案选择与实践

4.1 官方推荐安装方式

Ubuntu 22.04提供了三种主流安装方法：

推荐工作流：

sudo add-apt-repository ppa:graphics-drivers/ppa sudo apt update sudo apt install nvidia-driver-535 nvidia-dkms-535

4.2 处理安装后配置

安装完成后需要配置Xorg（如使用图形界面）：

sudo nvidia-xconfig --preserve-busid --enable-all-gpus

验证驱动加载状态：

nvidia-smi # 应显示GPU信息 glxinfo | grep "OpenGL renderer" # 确认3D加速

5. 高级排错与性能优化

5.1 内核模块编译失败深度解决

如果仍然遇到编译错误，可能需要手动指定内核路径：

sudo ./NVIDIA-Linux-x86_64-535.86.05.run --kernel-source-path=/usr/src/linux-headers-$(uname -r)

5.2 多GPU环境特殊配置

对于多显卡工作站，需在Xorg配置中指定主GPU：

Section "ServerLayout" Identifier "Layout0" Screen 0 "Screen0" 0 0 Option "MultiGPU" "Off" EndSection

5.3 持久化模式设置

提高GPU在计算任务中的稳定性：

sudo nvidia-smi -pm 1 sudo nvidia-smi -ac 5001,1590

6. 自动化维护脚本

以下是我日常使用的驱动维护脚本，包含安装、验证和清理功能：

#!/bin/bash # nvidia-manager.sh - NVIDIA驱动管理工具 KERNEL=$(uname -r) DRIVER_VERSION="535" function install_deps() { echo "[+] 安装依赖项..." sudo apt update && sudo apt install -y \ build-essential dkms linux-headers-$KERNEL \ libglvnd-dev mokutil } function clean_old() { echo "[+] 清理旧驱动..." sudo apt purge -y *nvidia* && sudo apt autoremove -y sudo rm -rf /usr/lib/nvidia /usr/lib/x86_64-linux-gnu/nvidia } function install_driver() { echo "[+] 安装驱动版本: $DRIVER_VERSION" sudo apt install -y \ nvidia-driver-$DRIVER_VERSION \ nvidia-dkms-$DRIVER_VERSION \ nvidia-utils-$DRIVER_VERSION } function verify_install() { echo "[+] 验证安装..." if nvidia-smi &>/dev/null; then echo "[√] NVIDIA驱动工作正常" nvidia-smi --query-gpu=driver_version --format=csv else echo "[×] 驱动加载失败，检查日志: /var/log/nvidia-installer.log" fi } case "$1" in install) install_deps clean_old install_driver verify_install ;; check) verify_install ;; *) echo "用法: $0 {install|check}" exit 1 esac

将此脚本保存为nvidia-manager.sh后，可通过以下命令使用：

chmod +x nvidia-manager.sh sudo ./nvidia-manager.sh install

7. 常见问题速查表

以下是NVIDIA驱动安装过程中典型问题及解决方案速查：

对于深度学习用户，还需特别注意：

sudo apt install nvidia-cuda-toolkit libcudnn8 libcudnn8-dev export LD_LIBRARY_PATH=/usr/local/cuda/lib64:$LD_LIBRARY_PATH