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