AI助手突然不理人?三层排查法一次讲透

今天早上，我们的 AI 助手（跑在云端的智能体）突然"罢工"——手机端发消息完全没反应，转圈 120 秒后超时。一通排查下来，发现根本不是它偷懒，而是三个隐藏问题叠在一起。

这套排查思路对任何人都适用——无论你的 AI 助手是跑在本地还是云端。

第一层：余额——AI 不理人最常见的原因

排查第一个动作：查 API 余额。

我们的助手用的是 DeepSeek 官方 API。日志里躺着这么一条：

rawError=402 Insufficient Balance"your API key has run out of credits"

翻译：API 余额用完了。充值前余额只剩 6.42 元——一次深度对话 + 工具调用可能就烧掉几块钱。

教训：AI 助手"突然不理人"，先查余额，别瞎重启。

第二层：网络——手机端为什么连不上

充值后助手本人活了（命令行直连秒回），但手机端还是连不上。这一步才是今天的重头戏。

现象：手机和电脑连同一个 WiFi，手机 APP 连 192.168.x.x:18789 超时；电脑本机访问却正常。

排查：查日志发现手机端请求根本没到助手——被挡在网络层。

根因：助手跑在 WSL（Windows 的 Linux 子系统）里，而 WSL 开了镜像网络模式（mirrored）。这个模式下有个隐藏坑：

WSL 里监听的服务，只有本机 localhost 能访问——局域网 IP 和 VPN 的 IP 全都不可达。手机自然连不上。

修复（三步）：

1. 1. WSL 改回 NAT 网络模式（改 .wslconfig + 重启）
2. 2. 拿 WSL 的新内网 IP
3. 3. Windows 加端口转发（portproxy）：把局域网端口转发到 WSL 的内网 IP

修完手机端秒连。

第三层：协议——APP 和网关版本不匹配

网络通了之后，日志里还看到一堆 unknown method: sessions.observer.visibility——手机 APP 发的指令，网关（服务端）不认识。

这通常是 APP 更新了、但服务端还是旧版本导致的协议不匹配。检查版本对齐，必要时升级服务端。

顺手解决外网访问：Tailscale

修网络时发现电脑上装了 Tailscale（组网工具）——顺手把外网访问也配了：

• • 在家：手机连局域网 IP
• • 在外：手机装 Tailscale → 连 100.x.x.x:18789——随时随地连助手

三层排查法总结

最后一步：修完后给助手发条消息实测——它回复"网络已通，状态正常 ✅"那一刻，才算真修好了。

本文由 Hermes Agent 实测生成 · 无姝制 · 不响

声明：本文为 AI 辅助创作，内容基于真实排障过程；不构成任何投资建议。