WSL2环境下Docker Desktop容器内DPDK编译失败问题咨询

../kernel/linux/meson.build:23:1: ERROR: Problem encountered: Cannot compile kernel modules as requested - are kernel headers installed?

问题根因 #

WSL2架构下Docker容器共享Windows宿主定制的WSL2内核，不会使用容器内CentOS7发行版自带的内核版本，你在容器内安装的默认kernel headers包和当前运行的WSL2内核版本不匹配，因此构建系统无法找到可用的内核头文件完成模块编译。

解决方案 #

方案1：禁用DPDK内核模块编译（最快可用） #

如果你的使用场景不需要DPDK内核模块（仅使用用户态驱动如VFIO、UIO_PCI_GENERIC，或仅运行DPDK用户态组件），直接在构建时关闭内核模块编译即可绕过报错：

• meson构建系统（DPDK 18.05及以上版本）：执行meson配置时添加参数
  meson build -Denable_kmods=false
• make构建系统（DPDK 18.05以下版本）：编译时指定禁用内核模块相关配置
  make install T=x86_64-native-linux-gcc CONFIG_RTE_EAL_IGB_UIO=n CONFIG_RTE_KNI_KMOD=n

方案2：挂载匹配WSL2版本的内核头文件（需要内核模块时使用） #

如果确实需要编译DPDK内核模块，按照以下步骤操作：

1. 先退出容器，在WSL2宿主终端执行以下命令查询当前运行的内核版本，确认内核头文件已安装
   uname -r
ls /usr/src/linux-headers-$(uname -r) /lib/modules/$(uname -r)
   如果提示路径不存在，可在WSL2宿主侧安装对应版本的WSL2内核头文件。
2. 启动容器时添加目录挂载参数，将WSL2宿主的内核头文件路径映射到容器内
   docker run -v /usr/src:/usr/src -v /lib/modules:/lib/modules [其余启动参数] [镜像名]
3. 进入容器后重新执行DPDK编译即可正常识别内核头文件

注意事项 #

CentOS7默认gcc版本为4.8.5，编译高版本WSL2内核头文件可能出现语法不兼容报错，可通过安装devtoolset升级gcc版本解决：

yum install centos-release-scl
yum install devtoolset-9-gcc devtoolset-9-gcc-c++
scl enable devtoolset-9 bash

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