问题排查
38-连线画布 · 2026-10-12 · 1.9 KB
连线画布的问题九成在"线"和"跑"两处。按现象找，照处置做 ✓
本专题手工维护（2026-10-12 建）；⚠ 报错文案以应用当前版本为准（应用给的提示往往已经写明原因 ✓）
一、先按这个顺序查（30 秒定位）
① 线本身 —— 端口类型对不对？目标端口够不够收？方向对不对（上游输出 → 下游输入）？
② 运行判据 —— 上游是否**全部成功**？是不是放了**两个「总执行入口」**？
③ 环境/参数 —— 参数齐不齐？引擎/算力起没起？权重在不在？
二、现象 → 原因 → 处置
| 现象 | 常见原因 | 处置 |
|---|---|---|
| 线拖过去没建立 | ① 目标该类型端口数量已达上限 ② 类型不匹配（如 图 → 视频）③ 反向拖了（从输入端拖出） | 看应用给的原因；换成能收的端口、或先删掉旧的一条 ✓ |
| 连接被拒（提示类似"连线未建立（从「X」的输出端拖出）"） | 同上的两种：数量上限 / 类型不匹配 | 同上 ✓（同一个输出可以接多个下游，别再怀疑这点 ✓） |
| 想连上传节点却连不上 | 上传节点没有输入端 ⇒ 它只作源 | 把线连到下游的输入端 ✓ |
| 参考顺序不对（生成的图/视频不对味） | 复合端口按连接顺序编号 ⇒ 顺序即语义 | 断开重连，关键参考先连 ✓ |
| 报「每张画布仅允许一个「总执行入口」节点」 | 画布上有两个总执行入口 | 删掉多余的那个（一张画布一个 ✓） |
| 参数被拦（提示类似"X 不在允许值里；合法值：…"） | 参数填了模板不认的值 | 按提示列出的合法值改 ✓ |
| 点了运行不动 / 排队中 | ① 同一时间只跑一个任务（全局串行）② 远端队列满了要顺延再试 ③ 计划任务正在执行（也会串行） | 等它跑完；别重复点 ✓ |
| 下游不跑 | 级联要求"全部上游都有成功任务" ⇒ 有上游失败/没跑 | 先把失败的上游修好再跑 ✓ |
| 环状连接跑到某处停住 | 有防环机制（级联层数上限） | 拆掉环，改成单向链 ✓ |
| 节点提示「暂无资源，请先给该节点填入资产」 | 该节点的输入没喂素材 | 连上/上传素材，或先跑上游 ✓ |
| 任务失败提示本地算力未就绪 | 本地引擎没启动 / 缺模型 | 起 ComfyUI；或换云端算力 ⇒ 见《云算力接入》卷 ✓ |
| 文本节点提示「该文本内容暂未加载，无法直接预览」 | 文本资源还在懒加载 | 点开/滚动到它触发加载，或重新打开画布 ✓ |
| 找不到产物 | 产物在本地任务目录（jobs/<任务 id>/…） | 按节点上的任务去看，或在资产库里找 ✓ |
| 复制出来的节点不对劲 | ⚠ 视频剪辑节点不可复制（它的时间线数据与文件绑定） | 别复制那个节点，改为重新放一个并重配 ✓ |
| 组里放不进另一个组 | 组容器不能嵌套 | 用命名 + 布局表达层级 ✓ |
| 画布越来越卡 | 节点与连线太多 | 分组折叠、把成段流程抽成预设模块、拆分多张画布 ✓ |
| 改了「全局设定」但某些节点没反应 | 有的引擎不吃该项全局（按自身设定走） | 去该节点参数里直接设 ✓ |
三、排错三条纪律
- 先读应用的提示 —— 它通常已写明"数量上限 / 类型不匹配 / 允许值"，照改即可 ✓
- 一次只改一处 ⇒ 改完立刻单节点跑验证（别整张跑）✓
- 先小后大：先用最小链路（一个节点）确认环境通，再上复杂图 ✓
四、要报障时，把这四样一起给（省一轮来回）
| # | 信息 | 从哪拿 |
|---|---|---|
| 1 | 画布名 + 出问题的节点名 | 画布上直接看 ✓ |
| 2 | 应用的报错原文（照抄，别转述） | 节点状态 / 提示气泡 ✓ |
| 3 | 任务 id（产物目录用它定位） | 节点上的任务信息 ✓ |
| 4 | 你的操作序列（点了什么、连了什么） | 回想一遍即可 ✓ |
来源：E:/workbuddyProj/unlimitCanvas/ai_manual/flow_canvas/03-问题排查.md