#节点常见问题

#连接被以 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 释放权重,见高级配置。

#派单后断线会发生什么

在途任务收敛失败(5001),任务不计费;app-id 进入 pendingCleanup,恢复派单条件见断线与清理。

#节点如何升级

节点从不自升级:更新镜像/仓库后重启容器。见高级配置 → 升级。