本页汇集 10 个部署与环境问题清单，覆盖 611 篇已发布文档。遇到问题时，先按发生环节分流，再进入对应清单查看具体条目。
先分流：三步定位所属环节
| 步骤 | 需要确认的事实 | 指向的环节 |
|---|---|---|
| 第 1 步 | 服务进程是否已经启动，容器与编排组件的状态是否正常 | 进程未起来 → 容器与编排、镜像与架构适配；进程已起但访问不到 → 启动与可访问性 |
| 第 2 步 | 后端日志中是否有依赖组件的连接错误（数据库、对象存储、推理服务） | 数据库或存储报错 → 数据库与对象存储；模型调用报错 → 模型接入与推理服务 |
| 第 3 步 | 问题是否出现在一次版本变更或配置变更之后 | 变更后出现 → 版本升级、环境变量与初始化；与变更无关 → 按第 1、2 步的结论进入对应环节 |
各环节的判别特征与条目数量
| 环节 | 判别特征 | 已发布文档 | 清单 |
|---|---|---|---|
| 镜像与架构适配 | 容器镜像获取与处理器架构适配的问题 | 60 | 进入清单 |
| 容器与编排 | 容器运行、编排与平台化部署环节的问题 | 146 | 进入清单 |
| 数据库与对象存储 | 数据库连接与对象存储配置环节的问题 | 73 | 进入清单 |
| 版本升级 | 版本升级过程与升级后出现的问题 | 100 | 进入清单 |
| 环境变量与初始化 | 环境变量、初始化配置与首次启动前置项的问题 | 48 | 进入清单 |
| 启动与可访问性 | 服务已启动但页面或接口访问不到的问题 | 47 | 进入清单 |
| 模型接入与推理服务 | 自建推理服务与模型接入环节的问题 | 68 | 进入清单 |
| Agent 与 MCP | Agent 运行时与 MCP 工具接入环节的问题 | 22 | 进入清单 |
| 接口与鉴权 | 接口调用与鉴权配置环节的问题 | 21 | 进入清单 |
| 本地开发与构建 | 本地开发环境搭建与前后端构建环节的问题 | 26 | 进入清单 |
10 个环节的清单共覆盖 611 篇文档。其他问题可通过技术中心搜索按具体报错信息查找。
分流时的三个常见顺序问题
- 先改配置再看日志。 部署环节的多数问题在后端日志中有明确的组件名与错误码，在未确认日志内容前调整环境变量或编排文件，会让后续排查失去基准。
- 跳过依赖组件直接查主服务。 数据库、对象存储与推理服务任一不可达时，主服务的表现都是功能异常，从主服务侧入手会反复无果。
- 不区分变更前后。 一次版本升级或配置变更之后出现的问题，与稳定运行期出现的问题排查路径不同，先确认时间关系可以缩小一半范围。
上线与变更前的核对项
- 确认目标版本的升级说明中列出的环境变量增减项已全部处理
- 确认各配套组件的镜像版本与主服务版本对应
- 确认数据库与对象存储的连接信息在目标环境中可用
- 确认处理器架构与所选镜像一致
- 确认推理服务在部署网络内可达，并完成一次调用验证
这张分流表的适用范围
归类依据是文档标题中出现的技术对象，同一篇文档可能同时涉及多个环节，本页按首个匹配到的环节归入一处。以下情形不在本页覆盖范围内：
- 商业版特有的部署形态与配置项
- 与具体云厂商产品耦合的网络与权限配置
- 需要结合实例运行数据才能判断的性能与容量问题
继续阅读
参考资料
问题仍未定位时
上述条目覆盖的是可依据公开信息复现与排查的情形。若问题涉及具体部署环境的配置细节、或需要结合运行日志逐项确认，可通过商务咨询获取部署阶段的技术支持；云服务形态可直接开始使用，不需要处理部署环节的环境依赖。