> For AI agents: the complete documentation index is available at https://docs.reelway.ai/llms.txt, the full documentation bundle is available at https://docs.reelway.ai/llms-full.txt.

# 节点常见问题

### 连接被以 4021 关闭

`api-key` 头缺失、Key 无效或已吊销;`app-id` 头缺失同样拒绝。用 `POST /v1/client/key` 预检。

### 连接被以 4015 关闭

同一 `app-id` 已有在线连接,新连接将其接管。若为误接管,检查是否有多台节点复用了同一 UUID。

### 不派单(连接正常但无任务)

按序检查:`readyToAcceptJobs` 是否已发且 `ready: true`;是否处于 `awaitingCleanup` 且未携带 `postDisconnectCleanupComplete`;`workerModels[]` 是否为空(目录缺失时上报零模型,宁缺勿滥);`worker-type` 与目标网络(`fast|relaxed`)匹配。

### 跨工作流切换失败

任意跨工作流切换前先 `/free` 释放权重,见[高级配置](https://docs.reelway.ai/run-a-worker/comfy-worker/advanced-configuration.md)。

### 派单后断线会发生什么

在途任务收敛失败(`5001`),任务不计费;`app-id` 进入 `pendingCleanup`,恢复派单条件见[断线与清理](https://docs.reelway.ai/run-a-worker/worker-protocol.md#%E6%96%AD%E7%BA%BF%E4%B8%8E%E6%B8%85%E7%90%86)。

### 节点如何升级

节点从不自升级:更新镜像/仓库后重启容器。见[高级配置 → 升级](https://docs.reelway.ai/run-a-worker/comfy-worker/advanced-configuration.md#%E5%8D%87%E7%BA%A7)。