企业官网建设流程全解析

ROCm 安装报错 "amdgpu dkms failed for running kernel"：完整修复指南

【免费下载链接】legacy-rocm-buildAMD ROCm™ Software - GitHub Home项目地址: https://gitcode.com/GitHub_Trending/ro/legacy-rocm-build

在 Ubuntu 24.04 上用 RX 7900 XTX，装好 ROCm 6.2.1 后执行sudo amdgpu-install dkms，看到 "amdgpu dkms failed for running kernel" 警告，驱动模块构建失败，量化工具也装不上。根源是 amdgpu-dkms 驱动包和 ROCm 运行时版本对不上。本文带你确认同一个坑、彻底清理、重装统一版 ROCm 6.2.2，并用 dkms status 验证修复结果。

现场：报错长什么样

先看你的环境：Ubuntu 24.04，内核已经比较新（本文这个案例是 6.8.0-45），显卡是 AMD Radeon RX 7900 XTX。你装好 ROCm 6.2.1，跑sudo amdgpu-install dkms，想一次性把驱动模块装好。输出最后一行出现了这句话：

WARNING: amdgpu dkms failed for running kernel

构建明确失败了。⚠️ 先别慌，用两条线索确认你踩的是不是同一个坑：

1. 你的内核偏新。像 6.8.0-45 这种较新的内核，正是这个问题的多发环境。
2. 驱动和运行时版本对不上。执行这条命令对比一下：

dpkg -l | grep -E "amdgpu-dkms|rocm-opencl-runtime"

素材里一边是 1:6.7.0.60102，另一边是 6.2.1.60201。如果你的输出里驱动包和运行时也是"各报各的号"，那就是同一个坑。

为什么会这样

DKMS（Dynamic Kernel Module Support）是一个机制，让内核模块在系统内核更新时自动重新编译，驱动不会因此和内核"失联"。amdgpu-dkms 就是用它构建的 AMD GPU 驱动模块，DKMS 会按当前内核重新编译驱动源码。

这里为什么构建不过：

• ROCm 运行时（rocm-opencl-runtime）已经是 6.2.1.60201，驱动包 amdgpu-dkms 却还停在 1:6.7.0.60102，两边没同步。
• 在 6.8.0-45 这个新内核上，源码基线太旧的驱动包很难保证一次编译通过，DKMS 就直接构建失败，只留下上面那句警告。
• 模块没构建出来，驱动加载不了，后面量化工具这类依赖驱动的安装步骤自然全卡住。

一句话：不是内核的错，是驱动和运行时"版本不同步"的错。

修复步骤（按顺序执行）

第 1 步：清理旧驱动和运行时残留

⚠️ 别直接重装。现在系统是半装状态，往上叠只会更乱。先把旧的卸干净：

sudo amdgpu-install --uninstall --rocmrelease=all sudo apt purge amdgpu-install sudo apt autoremove

第一条卸载所有已装的 ROCm release，第二条移除安装脚本本身，第三条清掉残留依赖。三步都跑完，才算"干净"。

第 2 步：重装统一版 ROCm 6.2.2

到官方渠道下载 Ubuntu 24.04 对应的 ROCm 6.2.2 安装包（runfile），运行安装程序，具体选项可以参考 runfile 安装器文档。

跟着界面流程装完整套，让驱动和运行时来自同一个版本。重点是别只挑个别包装：驱动和运行时版本一致，是这次修复的核心。

第 3 步：验证 dkms 状态

sudo dkms status

✅ 输出里应该能看到 amdgpu，且状态是构建成功。再确认这个目录存在：

ls /var/lib/dkms/amdgpu/

两项都正常时，再跑一次前面的sudo amdgpu-install dkms，确认不再出现警告，就算修好了。如果还是失败，回头检查现场那步的dpkg -l输出，确认驱动和运行时是不是都落在 6.2.2。

以后怎么避免

• 安装前先跑uname -r确认内核版本，选支持这个内核的 ROCm 版本
• 装完后对比 amdgpu-dkms 与 rocm-opencl-runtime 的版本号，两边必须同步
• 只使用官方推荐的版本组合，不要手动混搭单个包
• 系统内核升级后，重新跑一次驱动安装，确认 DKMS 自动重建没有新的构建失败
• 留意 ROCm 发布说明，环境不匹配时优先升级到最新稳定版，而不是回退内核

如果问题又冒出来，去官方发布说明里找和你系统匹配的版本，或者查兼容性矩阵 docs/compatibility/compatibility-matrix.rst 确认支持范围。驱动稳住之后，就可以装你需要的量化工具，继续 LLM 微调了。

【免费下载链接】legacy-rocm-buildAMD ROCm™ Software - GitHub Home项目地址: https://gitcode.com/GitHub_Trending/ro/legacy-rocm-build