WSL2 内核升级后 /dev/dri 设备节点缺失问题解析

在 Windows Subsystem for Linux 2 (WSL2) 环境中，当用户升级到最新内核版本 6.6.75.1 后，可能会遇到一个常见问题：系统缺少关键的图形渲染设备节点，包括 /dev/dri/card0、/dev/dri/card1 和 /dev/dri/renderD128。这些设备节点对于图形加速和硬件渲染至关重要。

问题现象

用户在升级内核后，虽然能够运行不依赖渲染节点的基本图形应用（如 glxinfo 和 glxgears），但任何需要访问 /dev/dri 下设备节点的应用程序都会失败。手动加载 dxgkrnl 或其他相关驱动模块也无法解决问题。

根本原因分析

经过深入调查，发现问题的根源在于两个关键因素：

1. vgem 模块未加载：vgem 模块是创建虚拟图形执行管理器设备的关键组件，负责在 /dev/dri 下创建设备节点。

2. 模块路径配置不当：当用户将 modules.vhdx 挂载到 /mnt/wsl/kernel-modules 并创建符号链接到 /lib/modules/$(uname -r) 时，模块的实际路径变成了嵌套结构（/lib/modules/6.6.75.1-microsoft-standard-WSL2/lib/modules），导致内核无法正确找到模块文件。

解决方案

针对这个问题，微软已经更新了内核仓库中的脚本和说明文档。用户可以通过以下步骤解决问题：

1. 手动加载 vgem 模块：

   sudo modprobe vgem
   

2. 正确配置模块路径：

   • 确保模块文件直接位于 /lib/modules/$(uname -r) 目录下
   • 避免出现嵌套的 lib/modules 路径结构

3. 环境变量配置： 用户还需要确保正确设置了以下环境变量，以启用正确的图形驱动：

   export __GLX_VENDOR_LIBRARY_NAME=mesa
   export __EGL_VENDOR_LIBRARY_FILENAMES=/usr/share/glvnd/egl_vendor.d/50_mesa.json
   export GALLIUM_DRIVER=d3d12
   export MESA_LOADER_DRIVER_OVERRIDE=d3d12
   export VK_ICD_FILENAMES=/usr/share/vulkan/icd.d/dzn_icd.x86_64.json
   

技术背景

在 WSL2 的图形支持架构中，DXGKRNL（DirectX Graphics Kernel）是内置在 Linux 内核中的关键组件（CONFIG_DXGKRNL=y），它提供了与 Windows 主机图形系统的接口。而 vgem 模块则负责在 Linux 用户空间创建必要的设备节点，使应用程序能够通过这些标准接口访问图形功能。

当这些组件正确配置后，WSL2 能够提供完整的图形加速支持，包括 Vulkan 和 OpenGL 的硬件加速功能，大大提升了图形应用程序在 WSL2 环境中的性能表现。