树莓派4.19.97-v7l+内核缺失build目录致RTL8812BU驱动安装失败

问题分析 #

执行驱动安装脚本时提示内核头文件未正确安装，核心原因是/lib/modules/4.19.97-v7l+目录缺失build软链接，该链接需指向对应版本的内核头文件目录。

解决步骤 #

1. 核对内核头文件版本与运行内核版本 #

执行以下命令查看已安装的内核头文件版本：

dpkg -l raspberrypi-kernel-headers

确认输出中的版本号与当前运行内核版本（4.19.97-v7l+）完全匹配。若版本不一致，需先重启树莓派（确保内核与头文件版本同步），或卸载错误版本的头文件重新安装对应版本。

2. 创建build软链接 #

第一步：查找/usr/src下的内核头文件目录

执行命令：

ls /usr/src

找到名称包含4.19.97-v7l+的目录（类似linux-headers-4.19.97-v7l+或raspberrypi-kernel-headers-4.19.97-v7l+）。

第二步：创建软链接

将找到的目录路径替换到下方命令中，执行：

sudo ln -s /usr/src/[找到的头文件目录名] /lib/modules/4.19.97-v7l+/build

3. 验证链接有效性 #

执行命令查看链接状态：

ls -l /lib/modules/4.19.97-v7l+/build

若输出显示链接指向/usr/src下的对应头文件目录，则创建成功。

4. 重新安装驱动 #

回到驱动脚本所在目录，执行：

sudo ./install-driver.sh

补充：若/usr/src无对应头文件 #

• 先卸载当前头文件：

sudo apt remove --purge raspberrypi-kernel-headers

• 查找匹配版本的头文件：

apt-cache show raspberrypi-kernel-headers | grep Version

• 安装对应版本（替换下方的[匹配的版本号]）：

sudo apt install raspberrypi-kernel-headers=[匹配的版本号]

完成后重复步骤2-4即可。

内容的提问来源于stack exchange，提问作者Xrou