作者:互联网 时间: 2026-06-30 09:28:52
Ollama 是大多数人第一个接触的本地大模型工具。但它的问题也是最多的——不是因为它质量差,而是因为它被用在太多奇奇怪怪的硬件组合上了。
| Ollama | vLLM / SGLang | |
|---|---|---|
| 定位 | 个人开发者本地跑模型 | 生产级推理服务 |
| 硬件 | RTX 3060 ~ 4090 消费卡 | H100/A100 数据中心卡 |
| 模型格式 | GGUF(量化) | HuggingFace Safetensors |
| 并发 | 单用户 | 高并发 API |
| 显存策略 | 动态卸载到 CPU 内存 | 纯 GPU |
Ollama 的坑集中在一件事:在不够的硬件上跑太大的模型,然后崩溃方式千奇百怪。
报错特征
ollama run deepseek-r1:8b Error: llama runner process has terminated: exit status 2
环境:AMD RX 6750 XT、ROCm、手动替换 GPU 适配文件
根因:Ollama 的 llama runner 是底层推理进程。exit status 2 通常意味着:
修复方案:
强制指定 CPU 推理(临时绕过 GPU 问题):
OLLAMA_LLM_LIBRARY=cpu_avx2 ollama run deepseek-r1:8b
清理损坏的模型文件重新下载:
ollama rm deepseek-r1:8b rm -rf ~/.ollama/models/blobs/sha256-* ollama pull deepseek-r1:8b
AMD GPU 用户检查 ROCm 驱动:
rocminfo | grep "Name" # 确认 GPU 在列表中 sudo dmesg | grep -i amdgpu # 检查是否有驱动加载错误
NVIDIA 用户检查 CUDA 库: Ollama 内置多种 CUDA 库(cu11/cu12),强制用特定版本:
OLLAMA_LLM_LIBRARY=cuda_v12 ollama run deepseek-r1:8b
报错特征
time=... level=ERROR msg="Failed to acquire semaphore" error="context canceled" time=... msg="embedding generation failed: no slots available after 10 retries"
然后所有请求立即返回:
{"error": "failed to generate embedding"}
环境:双 RTX 4090、Ollama 0.1.38、连续 embedding 任务
发生了什么:前 10-15 分钟一切正常。然后 Ollama 先挂起请求到超时 → 之后所有新请求都立即返回错误。不重启就无法恢复。
根因:Ollama 的并发槽位(slots)管理 bug。embedding 任务长期占用 GPU 后,Ollama 无法正确释放槽位。新请求进来时 no slots available——即使 GPU 实际上空闲。
修复方案:
降低并发数:
OLLAMA_NUM_PARALLEL=4 ollama serve
默认并发数较高,降到 4 或 8 可避免槽位耗尽。
限制 OLLAMA_MAX_LOADED_MODELS:
OLLAMA_MAX_LOADED_MODELS=1 ollama serve
只允许一个模型常驻显存,减少槽位争用。
定期清理 + 健康检查(生产环境):
# cron job: 每 30 分钟强制卸载模型再重新加载
curl http://localhost:11434/api/generate -d '{"model":"qwen3:8b","keep_alive":0}'
keep_alive:0 强制请求完成后立即卸载模型。
升级 Ollama 版本:
curl -fsSL https://ollama.com/install.sh | sh
0.1.45+ 版本对槽位管理有显著改进。
报错特征
GGML_ASSERT(ggml_nbytes(src0) <= INT_MAX) failed llama runner process has terminated
环境:ollama run gpt-oss:20b(MXFP4 量化,20.9B 参数)
根因:Ollama 底层使用 GGML 张量库,其中单个张量的字节数用 int 存储。当模型参数超过 2^31-1 字节(约 2.1 GB)时,某个中间张量超过了 INT_MAX 限制,触发断言崩溃。
这本质上是 GGML 的限制——单个张量不能超过 2.1 GB。大模型 + 大上下文会在 KV cache 中产生超限的张量。
修复方案:
用更激进的量化降低模型体积:
# 从 MXFP4 换到 Q2_K 或 IQ1_M ollama pull qwen3:30b-iq1_m
限制上下文长度:
ollama run qwen3:30b /set parameter num_ctx 4096
上下文越短,KV cache 的张量越小,越不容易超 INT_MAX。
换到 GGUF 的 Q8_0 或更小量化格式: Ollama 的 Modelfile 中指定量化版本:
FROM ./qwen3-30b.Q4_K_M.gguf
报错特征:
Error: ollama server not responding - timed out waiting for server to start
根因:这是 Ollama 最常见的启动失败。背后可能有三类原因:
~/.ollama/models/ 下的 blob 文件不完整(下载中断、磁盘错误)。修复方案:
检查日志:
# Linux journalctl -u ollama -f # 或 cat ~/.ollama/logs/server.log
手动启动并观察:
ollama serve # 在另一个终端 ollama run qwen3:8b
完全重置 Ollama:
systemctl stop ollama rm -rf ~/.ollama/models/ systemctl start ollama ollama pull qwen3:8b
用 CPU 模式启动排除 GPU 问题:
OLLAMA_LLM_LIBRARY=cpu ollama serve
如果 CPU 模式能启动 → 问题在 GPU → 重装驱动。
特征:ollama run model-a 跑完,切换到 ollama run model-b,显存不够。nvidia-smi 显示 model-a 仍占着显存。
根因:Ollama 默认 keep_alive=5m——模型在最后一次请求后继续占用显存 5 分钟。这在开发调试时频繁切换模型极其难受。
修复方案:
立即卸载模型:
curl http://localhost:11434/api/generate -d '{"model":"model-a","keep_alive":0,"prompt":"hi"}'
keep_alive:0 强制请求完成后立即卸载。
全局缩短 keep_alive:
OLLAMA_KEEP_ALIVE=30s ollama serve
30 秒无请求后自动卸载。
生产环境设 OLLAMA_KEEP_ALIVE=-1:
OLLAMA_KEEP_ALIVE=-1 ollama serve
模型永远不卸载(适合固定模型高并发场景),但开发时别用这个。
| 变量 | 值 | 作用 |
|---|---|---|
OLLAMA_LLM_LIBRARY | cuda_v12/cpu_avx2/cpu | 强制指定推理后端 |
OLLAMA_NUM_PARALLEL | 4 | 并发请求数(默认较高) |
OLLAMA_MAX_LOADED_MODELS | 1 | 同时加载模型数 |
OLLAMA_KEEP_ALIVE | 30s/-1/0 | 模型保活时间 |
OLLAMA_HOST | 0.0.0.0 | 绑定地址(API 暴露用) |
OLLAMA_DEBUG | 1 | 详细日志 |
Ollama 的坑跟 vLLM/SGLang 有本质区别:vLLM 坑在调度器和 CUDA Graph,SGLang 坑在环境配置和通信,Ollama 坑在硬件兼容性 + 量化格式 + 消费级 GPU 的极限压榨。
核心原则:
搭配我们推理引擎系列前三篇(vLLM V1 / SGLang / Dify),你现在有了完整的本地推理工具排障体系。