NewHot /TROUBLESHOOTING
故障排查
AI 工具报错排查:安装失败、启动异常、连接与鉴权失败、调用报错、版本回退,每条写明现象、影响版本、触发条件与处理方式,方便按关键字找到同类问题和解决办法。
19 篇文章 · 更新至 11月18日
最新动态
故障排查频道跟踪厂商官方发布的动态,覆盖安装与部署异常、使用与调用异常,共 19 篇,按发布时间倒序排列;点开任意一条查看完整内容与原始来源。
- 使用与调用异常 Codex @OpenAI
Codex CLI 0.170.0 修复 MCP OAuth 凭据竞争与 Windows 沙箱权限问题
Codex CLI 0.170.0 集中修复 MCP OAuth 在取消、登录与登出时的凭据竞争、超大 WebSocket 回落、Cloud 会话重连、Windows 文件替换与沙箱权限保留等问题,并改进重复文件搜索与线程搜索片段。遇到这些异常的开发者可以升级。
- 使用与调用异常 n8n
n8n 2.48.5 修复 AI Agent 工具调用历史串项与流式换行、Qdrant 子路径等异常
n8n 2.48.5 修复 AI Agent 节点按输入条目共享工具调用历史、流式文本块之间多出换行、Qdrant Vector Store 在反向代理子路径下连错地址以及 Microsoft Teams Trigger 漏发批量通知等问题,并调整了表达式、权限与实例 ID 行为。
- 使用与调用异常 OpenCode
OpenCode 2.3.1 修复超时命令被终止与僵尸进程,长时间构建任务自动转入后台运行该怎么调整
OpenCode 2.3.1 让超时的 shell 命令转入后台继续运行,而不是直接被杀掉;同时修复 opencode-pty 的僵尸进程、切换模型后被拒绝请求、子代理状态误报与多会话流式内存占用。后台压缩默认开启,长任务与多会话工作流的默认体验都有变化。
- 安装与部署异常 Dify
Dify 1.20.0 升级:OpenTelemetry 追踪、文件扫描与 Langfuse 端点迁移
Dify 1.20.0 发布,新增 OpenTelemetry 追踪导出、知识库上传文件恶意软件扫描与 Chatflow 工具调用展示,并适配 Langfuse v4 与新的云 ingestion 端点。自托管团队升级前需要处理数据库迁移与配置变更。
- 安装与部署异常 llama.cpp
llama.cpp b12503 修复 OpenVINO 后端显存占用与 -fa off 启动报错问题
llama.cpp b12503 集中修复 OpenVINO 后端的显存占用、SWA 识别与 -fa off 启动问题:GPU 无状态模式改用 4-D KV cache,减少每步解码的整块复制;-fa off 在状态模式下会回退到无状态执行并给出警告,同时还加入了新的环境变量开关。
- 使用与调用异常 Claude Code @Anthropic
Claude Code 2.1.327 修复 /export 覆盖文件与 MCP 配置被清空的异常问题
Claude Code 2.1.327 修复 /export 无提示覆盖文件、project scope 下 MCP 增删误删 .mcp.json 其他顶层键、远程 MCP 长时间断线不重连、claude -p 启动挂起与屏幕冻结等异常,并在 /status 增加配置自检清单,方便定位损坏的插件与权限设置。
- 使用与调用异常 Devin Desktop(Windsurf)
Devin Desktop 3.14 修复 Windows 更新残留与流式回复卡在运行工具状态的问题
Devin Desktop 3.14 修复 Windows 更新后残留旧 Devin.exe、多会话流式输出时内存占用过高、Devin Local 在 Running tools 状态停留约 4 分钟与后台标签提前启动 VS Code 等问题,并让 Anthropic 模型的长会话跨轮保留 prompt cache。
- 使用与调用异常 Open WebUI
Open WebUI 0.13.4 调整 Tether 沙箱与本地 MCP 连接,常见异常怎么排查绕行
Open WebUI 0.13.4 用 Tether 取代 Direct Connections,并调整沙箱终端、本地 MCP 工具与编码代理的接入方式。版本不匹配、工具服务器开关未开、模型 ID 冲突或沙箱无法强制执行时,功能会表现为连接失败或入口消失,本文整理排查顺序。
- 使用与调用异常 Qwen @Alibaba
Qwen Code 0.28.0 修复 SDK 超时、认证弹窗与终端输出丢失这类异常问题的绕行处理方式
Qwen Code 0.28.0 修复 SDK 读取响应体时丢失 capabilities 截止时间、WebSocket 探测计时器未释放、认证对话框退出确认窗口消失、进程退出后缓冲 shell 输出丢失与 Grep 不接受原生正则等问题,官方标注无已知破坏性变更。
- 安装与部署异常 Ollama
Ollama 0.40.17 版本修复 Vulkan 集显内存映射与 ChatGPT CLI 重启异常
Ollama 0.40.17 修复 Vulkan 集成显卡内存映射、ChatGPT CLI 恢复与优雅重启,并让 OpenCode 设置读取 thinking 元数据;MLX 后端新增并发生成,llama.cpp 与 MLX 依赖同步升级。使用集显或经常重启命令行的用户可以优先升级。
- 安装与部署异常 vLLM
vLLM 0.34.0 升级报错:block size 默认 64 与 ROCm 镜像移除后怎么解决
vLLM 0.34.0 带来 Extensible KV cache 默认开启、Model Runner V1 移除、默认 block size 改为 64、ROCm 7.2 镜像下线与 huggingface_hub 2.0.0 依赖要求。升级前不逐项核对就可能在启动阶段报错,本文整理受影响的部署场景与排查顺序。
- 使用与调用异常 ComfyUI
ComfyUI 0.44.0 修复 MTPHead 崩溃与 fp8、VAE dtype 异常,升级怎么绕行
ComfyUI 0.44.0 修复预取队列清理时的 MTPHead 解包崩溃、动态显存下 fp8 e4m3fn 回退 bf16 计算与 LTX 2.5 diffusion VAE 解码器的 dtype 崩溃。版本还加入设置 VAE 计算 dtype 的节点,并更新前端与工作流模板。
- 使用与调用异常 Gemini CLI @Google
Gemini CLI 0.67.0 版本修复取消后仍执行工具、重复加载代理与终端字符宽度异常显示问题
Gemini CLI 0.67.0 修复非交互模式下取消请求后仍继续执行工具、工作区为主目录时代理被重复加载、设置迁移丢失 ${VAR} 占位符、原子写入破坏只读文件与硬链接等问题,并新增 models 命令与 --list-models 参数用于模型发现。
已加载全部 19 篇
故障排查频道的写作标准是什么?
故障排查频道只写有现象、有触发条件、有处理方式的报错,结论来自官方文档与可复现的排查过程。
- 只写 AI 工具在使用中真实出现的报错与异常:安装与启动失败、依赖与驱动问题、鉴权与连接失败、调用报错与版本回退。
- 判断标准是问题能复现、报错信息可核对,处理方式来自官方文档、官方 Issue 回复或实际验证,而不是猜测。
- 每条写清现象、影响版本、触发条件与临时绕行办法,涉及环境差异的标明系统与版本。
- 不写无法复现的个例、未经验证的偏方与厂商未确认的故障。
故障排查的内容从哪里来?
以官方文档、官方 Issue 回复与状态页为准,并注明验证时的系统与版本环境。