---
title: 排查常见问题
description: 按启动、模型、任务和调度逐层缩小范围。
lastVerified: 2026-09-23
---

# 5.3 排查常见问题

先记下出错时间、页面动作和脱敏错误，再查相应层。不要首先清空数据库或重新安装全部环境。

## 安装与启动

| 现象 | 检查和处理 |
| --- | --- |
| docker 命令不存在 | 安装 Docker CLI 与可运行的本机引擎，执行 `docker info` 验证 |
| Docker 无法连接 | 启动引擎，检查当前 context 或环境变量；不要默认切向远程环境 |
| 同名容器不属于当前项目 | 源码开发模式下返回原源码目录操作；该错误终止初始化，不会主动停止原容器 |
| 端口被占用 | 查明占用进程的用途；不要使用模糊进程名批量结束服务 |
| 插件构建错误 | Compose 安装查看镜像构建输出；源码模式检查 Node、pnpm 版本和依赖，再运行 `pnpm check:dsh` |
| 页面 401 或认证失效 | 使用本次启动输出的完整认证链接，避免复制旧令牌 |

## 模型与同事

先在普通对话验证模型。对话也失败时查模型连接；只有某位同事失败时查其在岗状态、运行配置、业务范围和资料授权。

群里没有回应时先看是否选中或提及正确同事，以及收到、配置错误等可见反馈。没有反馈也不要推断任务已开始，检查具体任务与执行记录。

## 自动化与 Auto Dream

确认本机服务在线、计划启用、同事状态和时间时区。再看该日期是否已有运行记录。重新上线不会保证补齐每个离线时段；补跑前核对重复风险。

## 提交问题时提供什么

提供版本、操作步骤、预期结果、实际结果和已脱敏的错误信息。不要提交模型密钥、Cookie、认证 URL、数据库连接串或整份运行目录。模型没有产生结果与界面显示结果失败应分别描述。