容器、Agent 与工作流故障排查

核心认识

故障排查按基础设施、配置、应用和业务输入分层进行。先复现并收集容器状态与日志，再验证模型、插件和工作流，不要用反复重启替代根因分析。

• 端口错误先定位占用进程和 Docker 映射。
• Agent 内部错误先验证模型配置和服务日志。
• 文件类模型调用确认模型能力和文件类型。
• 代码节点第三方库通过受控镜像或沙箱依赖管理。

操作方法

1. 记录时间、输入、页面和错误信息。
2. 检查容器状态、健康检查和资源。
3. 读取对应服务日志并缩小故障层。
4. 修复后补充自动检查和故障记录。

docker compose -f ./docker/docker-compose.yml ps
docker compose -f ./docker/docker-compose.yml logs --tail=200

验收与边界

• 能说明本功能的输入、输出和权限边界。
• 能用一个最小示例验证配置生效。
• 真实生产数据和凭据未写入页面、仓库或日志。