故障速查（云端） 🚧 筹备中
13-云算力接入 · 2026-10-12 · 1.7 KB
🚧 筹备中：本专题尚在筹备（内容仍在校对与补充 ⇒ 请以应用实际界面与平台控制台为准 ⚠）
云端接入的问题九成集中在这张表里。按"现象"找，照"处置"做 ✓
本专题手工维护（2026-10-12 建）；⚠ 具体界面与文案以应用当前版本为准。
一、先按这个顺序查（30 秒定位）
① 地址对不对？ —— 整段照抄（含 token/前缀）· 不带尾斜杠 · 不重复拼端口
② 实例活着吗？ —— 平台上实例是否 Running、端口 8188 是否开放、域名有没有变
③ 应用里启用了吗？—— 「启用该目标参与调度」是否勾上、集群健康条是否 N/M 有它
三步都过还不行 ⇒ 再对下面的表 ✓
二、现象 → 原因 → 处置
| 现象 | 常见原因 | 处置 |
|---|---|---|
| 「测试连接」超时，但跑任务却正常 | 地址里重复拼了端口（地址自带端口，又拼了 :8188） | 删掉多余端口，baseUrl 用平台原样地址 ✓ |
| 所有请求 404（连根路径也 404），而且调度静默跳过这台、不报错 | 地址漏了 token / 路径前缀 | 把平台给的整段地址粘回去（一个字符都别删）✓ |
| 访问报 403 / 405 | baseUrl 结尾带了 / ⇒ 请求被拼成 //xxx | 去掉结尾的 / ✓ |
| 连上了但任务报「找不到模型 xxx」 | 权重没上云 / 放错子目录 / 软链失效 | 用镜像的权重校验看缺哪些 ⇒ 放到云盘对应分类目录下 ✓ |
| 健康条 N/M 掉了一个（少一台） | 云实例关机了，或换了域名 | 平台看实例状态；换域名就更新 baseUrl ✓ |
| 任务一直排队、不开始 | 并发上限（maxConcurrentJobs，默认 1）满了 | 等前一个跑完；或调大并发 / 加一台机器进池 ✓ |
| 刚开始能用，重开实例后全连不上 | 域名变了（云实例常见） | 回设置里更新地址 ✓ |
| 数据突然没了（权重/产物消失） | ① /cloud 其实没挂载（只是同名目录）② 云盘欠费被回收 | 建实例时勾选并挂载云存储；及时续费 ✓ |
| 第一次启动等了很久没反应 | 首启在加载/校验权重（正常） | 等 1~3 分钟，别重复开机重启 ✓ |
| 跑到一半失败 / 爆显存 | 规格不够（显存 < 24 GB）或并发开太大 | 换更大显存的卡，或降低并发/换轻量模型 ✓ |
| 某个模板在云上找不到 | 云算力用的是云端口径的模板库，与本地不完全相同 | 换用云端口径有的模板；别以为是"模板丢了" ✓ |
三、排错时的三条纪律
- 先怀疑地址，再怀疑机器：地址错（漏 token / 多端口 / 尾斜杠）占了绝大多数 ✓
- 一次只改一处：改完点「测试连接」验证，别一次改三个地方（否则不知道是哪处生效的）✓
- 先轻后重：确认接通永远用轻量模板（文生图），别用大视频模型试 ⇒ 省时间省钱 ✓
四、要报障时，把这四样一起给（能省一轮来回）
| # | 信息 | 从哪拿 |
|---|---|---|
| 1 | 完整服务地址（⚠ 私下给，别贴公开渠道） | 平台控制台 |
| 2 | 实例 ID | 平台实例列表 |
| 3 | 现象与时间（例：测试连接超时 / 任务报找不到模型） | 应用里的报错文案 |
| 4 | 健康条读数（N/M 节点可达） | 应用顶栏 |
来源：E:/workbuddyProj/unlimitCanvas/ai_manual/cloud_gpu/04-故障速查（云端）.md