Compile bug: rocm-6.3.4, no matching function for call to group_mask_warp_inplace

这个报错通常发生在 Linux 上用 HIP 后端编译 llama.cpp 时,编译器没有把 ggml-cuda 中与 warp 掩码相关的实现和调用编到同一个条件分支里。优先排查 ROCm 安装是否混用了多个版本(系统 ROCm 与本地 ROCm 的 hip.h 冲突),再检查构建使用的 ROCm

快速结论:这个报错通常发生在 Linux 上用 HIP 后端编译 llama.cpp 时,编译器没有把 ggml-cuda 中与 warp 掩码相关的实现和调用编到同一个条件分支里。优先排查 ROCm 安装是否混用了多个版本(系统 ROCm 与本地 ROCm 的 hip.h 冲突),再检查构建使用的 ROCm 版本与 HIP 头文件路径是否一致。

适用环境:Issue 已确认的环境包括:Linux;llama.cpp 的 HIP 后端(GGML_HIP=ON);GPU 目标 gfx1102、gfx906;ROCm 6.3.3、6.3.4,另有用户报告 ROCm 7.2.4 在同一提交上出现另一组头文件错误。Issue 未提供 Python、PyTorch 或 CUDA 版本信息。

最快修复方案:暂无确认的一步修复方案。可优先尝试确认环境中没有同时暴露多个 ROCm 版本,特别检查 PATH、HIP_PATH、HIPCXX 等变量是否指向同一套 ROCm 安装,并把版本统一到同一套 ROCm 后重新编译;Issue 中提到该问题在 #31617 合并后得到解决。

注意事项:Issue 中的环境混乱已被确认:有用户把 ROCm 6.3.4 的 bin 目录误加进 PATH,导致与 ROCm 7.2.4 混用。单纯替换 ROCm 版本是否能解决,Issue 没有给出完整验证记录;修改 PATH 或 HIP_PATH 后应清理构建目录再编译,避免残留缓存继续引用旧头文件。

问题场景

用户在 Linux 上以 HIP 后端构建 llama.cpp,CMake 配置为 -DGGML_HIP=ON -DGPU_TARGETS=gfx1102,gfx906 -DCMAKE_BUILD_TYPE=Release,并通过 HIPCXX、HIP_PATH 指向 hipconfig 输出的 clang 与 ROCm 路径。编译到 ggml/src/ggml-cuda/topk-moe.cu 时报找不到 group_mask_warp_inplace。

报错原文

llama.cpp/ggml/src/ggml-cuda/topk-moe.cu:229:13: error: no matching function for call to 'group_mask_warp_inplace'

有用户在同一首次坏提交上使用 ROCm 7.2.4 时,还遇到另一组 HIF 头文件错误:

/opt/rocm/include/hip/amd_detail/amd_warp_functions.h:115:12: error: use of undeclared identifier '__builtin_amdgcn_wavefrontsize'
/opt/rocm/include/hip/amd_detail/amd_device_functions.h:695:59: error: too many arguments to function call, expected 2, have 3

原因分析

维护者在讨论中指出,group_mask_warp_inplace 的定义与调用都受同一条件保护:#if !defined(GGML_USE_HIP) || HIP_VERSION >= 60300000,理论上不应出现只编入调用、没有编入定义的情况。因此“找不到函数”更可能来自构建环境异常:例如系统 ROCm 与本地 ROCm 同时存在,编译器实际包含的 hip.h 与构建时使用的 ROCm 版本不一致,使 HIP_VERSION 判断与实际可用接口不匹配。

后续有用户确认自己的 ROCm 7.2.4 环境脚本错误地把 ROCm 6.3.4 的 bin 目录加进 PATH,修正路径后同一提交可成功编译。参与讨论者据此判断该用户环境存在冲突的系统与本地 ROCm 安装。

环境排查

  • 确认系统是否安装了多个 ROCm 版本(例如 /opt/rocm 与 /opt/rocm-6.3.4 同时存在)。
  • 检查 PATH 中各 ROCm bin 目录的顺序,确认没有把不同版本的 bin 混在一起。
  • 检查 HIP_PATH、HIPCXX 是否与当前期望的 ROCm 安装路径一致;HIPCXX 来自 hipconfig -l,应与同一版本 ROCm 对应。
  • 确认编译器实际引用的 hip.h 路径,是否来自期望的 ROCm 版本,而不是系统残留的另一份安装。
  • 确认 llama.cpp 提交是否晚于 Issue 中提到的首次坏提交 f2f667b,以及是否包含 #31617 的修复。
  • 清理旧构建目录后再配置,避免 CMake 缓存继续使用错误的 ROCm 路径。

解决步骤

  1. 停止使用混用多个版本的 shell 环境。逐一核对 PATH、HIP_PATH、HIPCXX 中出现的 ROCm 路径,确保它们指向同一套 ROCm 安装。Issue 中用户的问题就是 PATH 中混入了另一版本的 bin 目录。
  2. 删除原有 build 目录,按原配置重新运行 CMake 配置与编译,避免缓存继续引用旧的头文件路径。Issue 的构建命令可参考:cmake -S .. -B . -DGGML_HIP=ON -DGPU_TARGETS=gfx1102,gfx906 -DCMAKE_BUILD_TYPE=Release。
  3. 如果统一环境后仍报同样的 no matching function for call to 'group_mask_warp_inplace',更新到包含 #31617 的 llama.cpp 版本后再编译。Issue 作者表示该问题在 #31617 合并后已解决。
  4. 如果只是要绕过当前构建失败,可优先尝试更换到已验证可编译的 ROCm 版本组合,但 Issue 没有给出通用的版本兼容矩阵,此步骤属于可优先尝试,不能视为确认方案。

验证方法

重新配置并编译后,确认 topk-moe.cu 不再报 group_mask_warp_inplace 相关错误,且构建过程能完整通过。进一步检查生成的二进制是否确实使用期望的 HIP 后端与目标 GPU 架构;如果仍出现 hip/amd_detail 头文件相关错误,说明环境中仍可能存在多版本 ROCm 路径冲突。

参考来源

ggml-org/llama.cpp #30755

GamsGo AI

AI 工具推荐

想把多个 AI 模型放在一个入口?

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。

这个方案解决了吗?

celebrityanime
celebrityanime
文章: 36195

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注