Linux内核快速编译调试及BTF校验失败报错解决方法

你遇到的BTF校验报错和新内核无法引导问题，本质是增量编译流程不完整导致的内核与模块BTF（BPF Type Format）元数据不匹配，和vmlinuz识别无关。
5.19版本内核的BTF元数据是全局统一生成的，内核主镜像和所有配套模块共用一套类型ID、符号偏移映射表。你修改内核代码后仅重编了bzImage主镜像，没有同步重编、安装内核模块：新主镜像的BTF映射表已经发生变化（哪怕只是加printk，编译时生成的类型ID、符号偏移也可能变动），但/lib/modules下安装的还是旧版本模块，模块内嵌的BTF信息和新内核的全局BTF表无法对齐，就会触发-22（EINVAL）校验错误，严重时会导致启动流程卡住。

不需要每次修改代码都执行make clean全量重编，按以下方式操作可以把单次编译耗时压缩到全量编译的1/10甚至更短：

正确的增量编译流程 #

修改内核代码后，执行以下命令即可生成匹配的内核与模块，不会出现BTF校验错误：

make -j16 bzImage modules
make modules_install install

内核构建系统会自动识别改动的代码文件，仅重编译改动关联的目标文件，不会触发全量构建。只有当你修改了全局编译选项、切换编译器、调整内存模型/BTF全局配置这类影响全局构建规则的选项时，才需要清理构建产物。

编译提速配置 #

• 启用ccache编译缓存：如果内核版本未内置CONFIG_CCACHE选项，编译时指定C编译器为ccache包装版本即可，二次编译时命中缓存的文件不需要重复编译，整体速度可提升3~5倍：

  make -j16 CC="ccache gcc" bzImage modules
  

• 裁剪内核配置：调试阶段关闭所有和当前调试硬件无关的驱动、文件系统、内核功能选项，仅保留SPI总线、目标放大器驱动、基础系统运行必须的组件，不要把无关功能编进内核或编译为模块，整体需要编译的代码量可缩减到默认配置的1/3以下。
• 非必要不执行make clean：该命令会删除所有中间构建产物，强制触发全量编译。如果遇到依赖异常导致的编译报错，优先执行make prepare更新全局依赖表，90%以上的场景不需要全量清理。

SPI驱动调试提效技巧 #

• 将调试的SPI放大器驱动、SPI总线驱动配置为模块（=m），调试阶段不需要重编整个内核镜像，仅单独编译对应驱动的ko文件即可：

  # 以drivers/spi/spi.c为例，单独编译对应模块
  make -j16 drivers/spi/spi.ko
  

  编译完成后直接将ko文件传输到目标设备，通过rmmod/insmod替换运行中的驱动即可，不需要重启系统，单次验证流程可缩短到10秒以内。
• 开启CONFIG_DYNAMIC_DEBUG动态调试功能，不需要手动修改代码添加printk，系统运行时可通过debugfs动态开启/关闭指定驱动、指定函数、指定行号的调试日志，省掉重复编译的步骤。

不要认为“没有修改模块相关代码就不需要重编模块”：只要重编了内核主镜像vmlinux，全局BTF映射表就会重新生成，哪怕代码改动完全不涉及模块逻辑，旧模块的BTF信息也可能和新内核不匹配，必须同步重编安装模块才能正常启动。

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