树莓派Debian 11系统Kernel Header版本不匹配问题求助

问题背景 #

运行Debian GNU/Linux 11（bullseye）的树莓派设备上，当前内核版本为5.13.19-v8+，但APT源中仅提供5.10.0-23版本的内核头文件，版本不匹配导致build_install.bash脚本执行时报错，提示找不到对应内核头文件。

操作及报错详情 #

arthi@raspberrypi:~/Desktop/RaspberryPiMouse/utils $ ./build_install.bash
build_install_header_from_apt_raspi2.bash
===================
ERROR: No kernel header files found.
If you need someone's support, you should share this information.
Linux raspberrypi 5.13.19-v8+ #1 SMP PREEMPT Sat Jul 1 12:27:00 BST 2023 aarch64 GNU/Linux
No LSB modules are available.
Distributor ID: Debian
Description:    Debian GNU/Linux 11 (bullseye)
Release:        11
Codename:       bullseye
/usr/src/linux-headers-5.10.0-23-arm64:
arch  include  Makefile  Module.symvers  scripts  tools

/usr/src/linux-headers-5.10.0-23-common:
arch  include  Makefile  scripts  tools

/usr/src/linux-headers-6.1.21-v8+:
arch   crypto         fs       io_uring  kernel    mm              rust     security  usr
block  Documentation  include  ipc       lib       Module.symvers  samples  sound     virt
certs  drivers        init     Kconfig   Makefile  net             scripts  tools

/usr/src/linux-kbuild-5.10:
scripts  tools
===================
arthi@raspberrypi:~/Desktop/RaspberryPiMouse/utils $ uname -r
5.13.19-v8+
arthi@raspberrypi:~/Desktop/RaspberryPiMouse/utils $ apt-cache search linux-headers
raspberrypi-kernel-headers - Header files for the Raspberry Pi Linux kernel
linux-headers-5.10.0-23-arm64 - Header files for Linux 5.10.0-23-arm64
linux-headers-5.10.0-23-common - Common header files for Linux 5.10.0-23
linux-headers-arm64 - Header files for Linux arm64 configuration (meta-package)
arthi@raspberrypi:~/Desktop/RaspberryPiMouse/utils $

解决方案 #

方法1：添加树莓派官方仓库安装对应版本头文件 #

1. 编辑APT源配置文件，添加树莓派官方仓库：

   sudo nano /etc/apt/sources.list.d/raspi.list
   

   写入以下内容：

   deb http://archive.raspberrypi.org/debian/ bullseye main
   

2. 导入树莓派仓库GPG密钥：

   wget -O - https://archive.raspberrypi.org/debian/raspberrypi.gpg.key | sudo apt-key add -
   

3. 更新APT缓存：

   sudo apt update
   

4. 安装对应版本的内核头文件：
   先查询可用的raspberrypi-kernel-headers版本：

   apt-cache policy raspberrypi-kernel-headers
   

   找到与5.13.19-v8+匹配的版本后执行安装：

   sudo apt install raspberrypi-kernel-headers=5.13.19-v8+
   

   若找不到对应版本，需先安装同版本内核再装头文件：

   sudo apt install raspberrypi-kernel=5.13.19-v8+
   sudo apt install raspberrypi-kernel-headers=5.13.19-v8+
   

方法2：手动编译对应版本内核头文件 #

1. 安装编译依赖：

   sudo apt install git bc bison flex libssl-dev make libc6-dev libncurses5-dev
   

2. 克隆对应版本的树莓派内核源码：

   git clone --depth=1 --branch=5.13.19-v8 https://github.com/raspberrypi/linux.git
   

3. 加载当前内核配置：

   cd linux
   zcat /proc/config.gz > .config
   make oldconfig
   

4. 编译并安装内核头文件：

   sudo make headers_install INSTALL_HDR_PATH=/usr
   

方法3：切换到Debian官方匹配内核 #

若无需保留5.13.19-v8+内核，可直接安装Debian官方的5.10内核及对应头文件：

sudo apt install linux-image-arm64 linux-headers-arm64
sudo reboot

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