Build failure with GCC 15: missing #include in llama-mmap.h leading to uint32_t errors

该报错发生在使用 GCC 15(及类似更严格的工具链)从源码编译 Ollama 时, llama-mmap.h 缺少 #include ,导致 uint32_t 类型未声明。Issue 中较新的 main(0.40.x)已不再包含该头文件、llama.cpp 已带有该 inclu

快速结论:该报错发生在使用 GCC 15(及类似更严格的工具链)从源码编译 Ollama 时,llama-mmap.h 缺少 #include <cstdint>,导致 uint32_t 类型未声明。Issue 中较新的 main(0.40.x)已不再包含该头文件、llama.cpp 已带有该 include,因此优先排查是否为旧版本(如 v0.5.7)源码。

适用环境:OS 为 WSL2,CPU 为 Intel;Ollama 版本 v0.5.7;GCC 15.x(Issue 提到 GCC 15.2.0 为例);构建目标为 linux/amd64。

最快修复方案:暂无确认的一步修复方案。后续讨论表明当前 main 已修复;若仍停在旧源码上,可优先尝试在 llama-mmap.h 中显式加入 #include <cstdint>(Issue 提出的修复方向,未在评论中复现验证)。

注意事项:评论者最终表示自己的编译问题并非该头文件缺失,而是某 patch 文件被拉取为 CRLF 行尾,通过在 .gitattributes 中添加 *.patch text eol=lf 解决。因此,若更新代码后仍失败,需把行尾问题一并纳入排查。

问题场景

在 Linux / WSL2 上使用 GCC 15.x 工具链,对 Ollama v0.5.7 从源码执行 make 或构建 amd64 版本时,编译 llama 相关包报错,报错位置位于 llama-mmap.cpp 引入的 llama-mmap.h,涉及 uint32_t read_u32() 与 write_u32(uint32_t val) 等声明。

报错原文

# github.com/ollama/ollama/llama
In file included from llama-mmap.cpp:27:
llama-mmap.h:52:5: error: ‘uint32_t’ does not name a type
   52 |     uint32_t read_u32() const;
      |     ^~~~~~~~
llama-mmap.h:31:1: note: ‘uint32_t’ is defined in header ‘<cstdint>’; this is probably fixable by adding ‘#include <cstdint>’
   30 | #include <vector>
  +++ |+#include <cstdint>
   31 | 
llama-mmap.h:55:20: error: ‘uint32_t’ has not been declared
   55 |     void write_u32(uint32_t val) const;

原因分析

从报错看,直接原因是 llama-mmap.h 使用了 uint32_t 却未包含 <cstdint>。GCC 15 对标准头文件的隐式包含更严格,不再像旧版本那样通过其他头文件间接带入 uint32_t,于是旧源码在此环境下编译失败。

按 Issue 评论核实,当前 main 中 llama-mmap.h 已不在 Ollama 仓库内,llama.cpp 通过 LLAMA_CPP_VERSION(评论时为 b12257)引入,该版本头文件顶部已有 #include <cstdint>,因此该问题在 head 上已修复,v0.5.7 属于较老版本。

另有可能原因:后续评论指出,问题实际出在某个 patch 文件被拉取为 CRLF 行尾,导致编译异常,与头文件缺失无关。

环境排查

  • 确认实际构建的 Ollama 源码版本:Issue 触发版本为 v0.5.7,当前 main 约为 0.40.x。
  • 确认 GCC 版本是否为 15.x,必要时用 gcc --version 核对(该命令为通用确认方式,非 Issue 原文)。
  • 确认引入的 llama.cpp 版本(LLAMA_CPP_VERSION),Issue 中验证的版本为 b12257。
  • 确认仓库内 .gitattributes 是否覆盖 *.patch 的 LF 行尾设置。
  • 确认工作区中是否存在因换行符被改写而产生差异的 patch 文件。

解决步骤

  1. 先更新到较新的 Ollama 代码(0.40.x 一线或当前 main),重新构建,确认 llama-mmap.h 缺失 include 的问题是否已随已修复版本消失。
  2. 如仍停留在旧源码构建,可优先尝试在 llama-mmap.h 中加入 #include <cstdint>。此步骤来自 Issue 的 Proposed Fix,评论中未在旧版本源码上实际复现验证。
  3. 若更新后仍出现编译失败,检查 .gitattributes,加入 *.patch text eol=lf,避免 patch 文件以 CRLF 拉取;这一做法被评论者确认可解决其重复出现的编译问题。
  4. 清理旧的构建产物后重新拉取/检出代码,再执行原构建命令,避免残留文件干扰。

验证方法

重新执行 make 或对应的源码构建流程,确认不再出现 ‘uint32_t’ does not name a type、‘uint32_t’ has not been declared 等错误,并确认构建产物能正常生成。若曾修改 .gitattributes,可检查 patch 文件行尾已统一为 LF,且重新检出后差异消失。

参考来源

ollama/ollama #19714

GamsGo AI

AI 工具推荐

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

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

了解 GamsGo AI

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

这个方案解决了吗?

celebrityanime
celebrityanime
文章: 36045

发表回复

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