Manus智能体后台崩溃需5分钟内定位根因：先用ps aux | grep manus确认进程存续，再查netstat -tuln | grep :8000验证端口监听，结合Nginx 504日志、直连health接口及debugpy耗时分析，逐层排查DNS解析失败、模型服务排队或KV缓存击穿。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Manus智能体后台崩溃时，服务突然中断、API持续超时、健康检查失败、日志中反复出现异常堆栈，必须在5分钟内定位到是DNS解析失败、模型服务排队阻塞、还是KV缓存击穿引发的级联雪崩。
确认是否真崩溃，还是假死卡住
先验证进程是否还在运行：执行ps aux | grep manus，若无任何输出或只显示grep自身，说明主进程已退出；若存在但CPU/内存占用长期为0%，大概率处于IO卡死或死锁状态。
这一步操作起来很简单，直接把文件拖进去就行。
接着查端口监听状态：netstat -tuln | grep :8000（假设Manus监听8000端口）。如果没结果，别急着重启服务——【进程虽在但未绑定端口，说明启动脚本中途失败或配置加载异常】。此时立刻去logs/app.log末尾找ERROR前10行，重点关注import error、config parse failed、redis connection refused等关键词。
逐层排查请求链路超时点
Manus请求链路典型路径为：客户端 → Nginx/API网关 → Manus AI进程 → 模型服务（如Qwen、DeepSeek）→ 缓存/DB。超时可能出现在任意环节，不能只盯着Manus日志。
方法一：查看Nginx access log时间戳
找到/usr/local/nginx/logs/access.log，筛选一条504响应记录，例如：
10.20.30.40 - - [06/Aug/2026:13:05:22 +0800] "POST /v1/chat/completions HTTP/1.1" 504 166 "-" "curl/8.7.1"
注意状态码是504而非500——这说明Nginx已等待上游（Manus）响应超时，但Manus进程本身可能仍在处理或已崩溃。
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
方法二：直连Manus端口绕过网关
执行curl -v http://127.0.0.1:8000/health。若返回Connection refused，证明Manus进程未正常监听；若返回超时但连接成功，问题就在Manus内部调度逻辑或下游模型调用环节。
方法三：抓取Manus进程内部耗时
进入Manus部署目录，执行python -m debugpy --wait-for-client --listen 0.0.0.0:5678 app.py（需提前安装debugpy），再用另一终端发请求。若调试器卡在await model_client.invoke()处不动，说明超时发生在调用下游模型服务阶段；若卡在await asyncio.wait_for()前，问题就在Manus自身的调度逻辑或资源争抢。
高频报错及对应修复动作
① 报错关键词：`ConnectionRefusedError: [Errno 111] Connection refused`
原因：Manus尝试连接Redis、PostgreSQL或模型服务时，目标地址不可达。
执行nslookup redis.internal 或 telnet model-api.deepseek.com 443确认连通性。若失败，检查/etc/resolv.conf DNS配置或安全组出向规则。
② 报错关键词：`KeyError: 'tools'` 或 `AttributeError: 'NoneType' object has no attribute 'invoke'`
原因：系统提示词加载失败或工具注册表为空，常见于config.yaml中llm.tools路径写错、或tools目录权限被误删。
【不要手动touch空文件补位，必须用tools/init.py重新生成注册表】
③ 报错关键词：`RuntimeError: Event loop is closed`
原因：异步任务未正确await就返回，或信号处理中强行关闭了event loop。
检查所有使用asyncio.create_task()的地方，确保task被await或加入asyncio.gather()；SIGTERM信号捕获后必须调用loop.shutdown_asyncgens()再close。
④ 报错关键词：`OSError: [Errno 24] Too many open files`
原因：Linux系统文件描述符耗尽，常由未关闭的HTTP连接、日志句柄、数据库游标累积导致。
临时提升限制：ulimit -n 65536；永久生效需修改/etc/security/limits.conf并重启会话。
