Parrot OS升级时realtek-rtl8188eus-dkms配置失败，求排查方案

问题概述 #

升级Parrot OS 5.1 Electro Ara后，执行dpkg --configure -a时出现realtek-rtl8188eus-dkms包配置失败，核心错误为驱动模块无法针对6.0.0-2parrot1-amd64内核编译。

报错信息 #

dpkg --configure -a
Setting up realtek-rtl8188eus-dkms (5.3.9~git20220829.4ba8e08-0parrot1) ...
Removing old realtek-rtl8188eus-5.3.9~git20220829.4ba8e08 DKMS files...
Deprecated feature: REMAKE_INITRD (/var/lib/dkms/realtek-rtl8188eus/5.3.9~git20220829.4ba8e08/source/dkms.conf)
Deprecated feature: REMAKE_INITRD (/var/lib/dkms/realtek-rtl8188eus/5.3.9~git20220829.4ba8e08/source/dkms.conf)
Module realtek-rtl8188eus-5.3.9~git20220829.4ba8e08 for kernel 5.18.0-14parrot1-amd64 (x86_64).
Before uninstall, this module version was ACTIVE on this kernel.

8188eu.ko:
- Uninstallation
  - Deleting from: /lib/modules/5.18.0-14parrot1-amd64/updates/dkms/
- Original module
  - No original module was found for this module on this kernel.
  - Use the dkms install command to reinstall any previous module version.
depmod....
Deleting module realtek-rtl8188eus-5.3.9~git20220829.4ba8e08 completely from the DKMS tree.
Loading new realtek-rtl8188eus-5.3.9~git20220829.4ba8e08 DKMS files...
Deprecated feature: REMAKE_INITRD (/usr/src/realtek-rtl8188eus-5.3.9~git20220829.4ba8e08/dkms.conf)
Building for 6.0.0-2parrot1-amd64
Building initial module for 6.0.0-2parrot1-amd64
Deprecated feature: REMAKE_INITRD (/var/lib/dkms/realtek-rtl8188eus/5.3.9~git20220829.4ba8e08/source/dkms.conf)
Error! Bad return status for module build on kernel: 6.0.0-2parrot1-amd64 (x86_64)
Consult /var/lib/dkms/realtek-rtl8188eus/5.3.9~git20220829.4ba8e08/build/make.log for more information.
dpkg: error processing package realtek-rtl8188eus-dkms (--configure):
installed realtek-rtl8188eus-dkms package post-installation script subprocess returned error exit status 10
Errors were encountered while processing:
realtek-rtl8188eus-dkms

系统信息 #

• Parrot OS版本：5.1 Electro Ara
• 内核版本：6.0.0-2parrot1-amd64

排查解决步骤 #

1. 查看编译错误详情 #

首先查看驱动编译时的具体报错，定位问题根源：

cat /var/lib/dkms/realtek-rtl8188eus/5.3.9~git20220829.4ba8e08/build/make.log

重点关注编译过程中的语法错误、未定义符号、依赖缺失等信息，这些是解决问题的关键。

2. 确保编译依赖与内核头文件完整 #

驱动编译需要对应版本的内核头文件和基础编译工具：

• 安装当前内核的头文件：

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

• 安装完整编译工具链：

  sudo apt install build-essential dkms
  

安装完成后重新执行dpkg --configure -a尝试修复。

3. 卸载并重装故障DKMS包 #

如果依赖没问题但仍编译失败，尝试彻底清理现有驱动包后重装：

• 卸载驱动包：

  sudo dpkg --purge realtek-rtl8188eus-dkms
  

• 清理DKMS残留文件：

  sudo rm -rf /var/lib/dkms/realtek-rtl8188eus/
  

• 重新安装驱动包：

  sudo apt install realtek-rtl8188eus-dkms
  

4. 替换为第三方维护的更新驱动 #

官方包版本可能未适配新内核，可以尝试使用第三方维护的更新版驱动：

• 先卸载现有驱动包（同步骤3）
• 克隆社区维护的驱动源码，进入源码目录后安装DKMS：

  git clone https://github.com/aircrack-ng/rtl8188eus.git
  cd rtl8188eus
  sudo dkms add .
  sudo dkms install rtl8188eus/5.3.9
  

（注：版本号需根据源码实际版本调整）

5. 临时回退到兼容内核 #

如果新内核暂时无法适配驱动，可回退到旧内核（5.18.0-14parrot1-amd64）：

• 重启系统，在GRUB菜单中选择旧内核启动
• 标记新内核为保留，避免自动更新：

  sudo apt-mark hold linux-image-6.0.0-2parrot1-amd64 linux-headers-6.0.0-2parrot1-amd64
  

• 后续驱动适配新内核后，解除保留：

  sudo apt-mark unhold linux-image-6.0.0-2parrot1-amd64 linux-headers-6.0.0-2parrot1-amd64
  

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