错误码
出问题时，Microbe Studio 会在消息之外报出一个稳定的错误码—— DETECT_REGION_TIMEOUT、MAX_NODE_EXECUTIONS_EXCEEDED、FLOW_PACKAGE_SIGNATURE_INVALID。消息会翻译成你的语言；错误码永不改变，所以它才是你该搜索的东西，也是该写进缺陷报告的东西。
本页按你什么时候撞上它来组织，因为查的时候就是这样查的。
可重试与终结
当你在搭流程时
这些来自校验和编辑器。全部是终结的：没有任何东西会去重试一个编写期的错误。
图与连线
| 错误码 | 什么意思 | 该怎么办 |
|---|---|---|
FLOW_VALIDATION_ERROR | Validate 找到了阻塞问题 | 用 ◀ Previous error / Next error ▶ 逐个走过 |
TRANSITION_NOT_FOUND | 某节点返回了一个没接线的 route | 为它发出的 route 补上或修好连线——最常见是检测节点上未接的 Failure 端口 |
EDGE_PORT_INVALID | 一条连线起自该节点并不存在的端口 | 从一个有效的源端口重连 |
NODE_TYPE_UNSUPPORTED | 流程里带着这个版本不认识的节点类型 | 删掉它，或更新节点——见遗留节点 |
STALE_STATE | 你的编辑被拒绝，因为编辑期间流程变了 | 什么都没丢。重做一次 |
变量与表达式
| 错误码 | 什么意思 | 该怎么办 |
|---|---|---|
VARIABLE_NOT_DECLARED | 表达式用了一个没人声明的名字 | 在 Flow Inputs… 里声明，或用 Variable 节点创建。用一个名字不等于声明它 |
VARIABLE_TYPE_INVALID | 已声明变量的类型不是 schema 接受的那些 | 修正声明的类型 |
VARIABLE_SHADOWS_GLOBAL | 流程变量复用了保留的全局名 | 给流程变量改名 |
TYPE_MISMATCH | 默认值或初始值违反了声明的类型 | 通常是把 OCR 目标声明成 number 而不是 number?。把绑定 OCR 的变量声明为可空——读取失败写入空值，绝不编造 0 |
EXPRESSION_SYNTAX_ERROR | 表达式解析不了 | 修语法 |
EXPRESSION_NOT_BOOLEAN | 一个条件求值出来不是真/假 | 条件必须是布尔——要比较，不要只引用 |
EXPRESSION_EVALUATION_FAILED | 表达式解析通过但运行时炸了 | 检查缺失值和除以零 |
循环
| 错误码 | 什么意思 | 该怎么办 |
|---|---|---|
LOOP_START_MISSING / LOOP_END_MISSING | 一个循环区缺了其中一个标记 | 每个 Loop 都有编辑器管理的配对 Loop End——不要单独删掉一个 |
LOOP_BODY_NOT_CLOSED | 循环体从未到达它的 Loop End | 把循环体接通到 Loop End |
LOOP_PAIR_AMBIGUOUS | 判断不出哪个 Loop End 属于哪个 Loop | 简化嵌套 |
LOOP_REGION_INVALID | 区域形状不是一个有效的 循环 | 重建这个循环，而不是手工修补 |
LOOP_MODE_INVALID | 循环模式不在接受的取值里 | 选一个有效模式 |
LOOP_CONDITION_MISSING | 按条件驱动的循环没有条件 | 给一个条件，或者改成固定次数 |
LOOP_CONTROL_OUTSIDE_LOOP | Break 或 Continue 落在任何循环之外 | 把它移进它本该控制的那个循环区里 |
MAX_ITERATIONS_INVALID | 迭代上限不是一个可用的数字 | 设一个正整数 |
子流程
| 错误码 | 什么意思 | 该怎么办 |
|---|---|---|
SUBFLOW_NOT_FOUND | 一个 Sub Flow 节点指向已不存在的流程 | 重新指向，或导入缺失的流程。在依赖查看器里显示为 missing |
SUBFLOW_INVALID | 被引用的子流程不能当作子流程用 | 打开子流程并校验它 |
FLOW_CIRCULAR_DEPENDENCY / SUBFLOW_RECURSION_DETECTED | 一个流程调用了自己，直接或经由一条链 | 移除闭合这个环的那个引用——消息会点出这条链 |
SUBFLOW_DEPTH_EXCEEDED | 嵌套比允许的更深 | 拍扁它。两三层几乎覆盖一切——见 Sub Flow |
SUBFLOW_VARIABLE_CONFLICT | 子流程的一个输入与作用域里已有的名字冲突 | 给这个输入改名 |
监控范围
| 错误码 | 什么意思 | 该怎么办 |
|---|---|---|
OBSERVER_FORBIDDEN_NODE | 一种不能待在被守望区域内的节点类型待在里面了 | 把它移出去——见监控范围 |
OBSERVER_NESTED_MONITOR | 一个监控范围套在另一个监控范围里 | 监控不嵌套。用一个区域 |
OBSERVER_SPEC_INVALID | 该范围的配置无效 | 重建这个范围 |
SCOPE_PAIR_AMBIGUOUS / SCOPE_REGION_INVALID | 区域的几何解析不出来 | 删掉再重新覆盖选区 |
区域、点与模板
| 错误码 | 什么意思 | 该怎么办 |
|---|---|---|
RECT_TOO_SMALL | 画出的矩形低于可用的最小尺寸 | 画大一点 |
RECT_X_OVERFLOW / RECT_Y_OVERFLOW | 矩形跑到屏幕外面了 | 在画面内重画 |
POINT_INVALID / POINT_OUT_OF_BOUNDS | 某个坐标不可用或在屏幕外 | 在 Live Preview 上重新取点 |
TEMPLATE_NOT_FOUND | 某节点引用的模板素材不见了 | 重拍，或重新导入流程包 |
TEMPLATE_QUALITY_TOO_LOW | 拍下的裁剪太小或太平淡，匹配不可靠 | 重拍一个更大、更有辨识度的模板 |
TEMPLATE_CHECKSUM_MISMATCH | 存储的模板文件与其记录不符 | 重拍或修复该素材 |
TEMPLATE_CAPTURE_FAILED | 拍摄本身失败了 | 检查已附加的实例，然后重试 |
当流程在运行时
护栏——运行是故意停下的
这是运行时在保护你。全部终结。
| 错误码 | 什么意思 | 该怎么办 |
|---|---|---|
MAX_NODE_EXECUTIONS_EXCEEDED | 这次运行执行的节点数超过流程允许的量 | 循环会成倍放大：12 个节点跑 200 轮约 2400 次。抬高 Max node executions…，或者去找一个意料之外的环 |
MAX_RUNTIME_DURATION_EXCEEDED | 这次运行超过了它的时间上限 | 拆分工作，或抬高上限 |
MAX_CONSECUTIVE_FAILURES_EXCEEDED | 连续失败太多次，中间没有任何成功 | 检测的"未找到"不会导致这个。去找一个反复失败的动作节点 |
检测
| 错误码 | 可重试 | 什么意思 | 该怎么办 |
|---|---|---|---|
DETECT_IMAGE_NOT_FOUND | 是 | 模板没匹配上 | 调整模板、阈值、搜索区域或超时。动阈值之前先跑 Test Node 读真实置信度 |
DETECT_AMBIGUOUS | 是 | 好几个候选都匹配上了，没有胜出者 | 复查候选，或调阈值 |
DETECT_REGION_TIMEOUT | 是 | 一条 Check Region 规则在时限内始终没成立 | 提高 timeoutMs、调整规则，或核实区域里实际有什么 |
DETECTION_ENGINE_FAILED | — | 匹配器本身失败了 | 检查已附加实例和模板素材 |
OCR
| 错误码 | 可重试 | 什么意思 | 该怎么办 |
|---|---|---|---|
FEATURE_OCR_UNAVAILABLE | — | OCR 没装或没启用 | 运行 Read Text 节点之前先安装并启用 OCR（Tesseract）。也检查流程的 ocrEnabled 开关——这是"Read Text 什么都不做"最常见的原因 |
OCR_LANGUAGE_MISSING | — | 请求的语言包没装 | 装上那个 Tesseract 语言包，或选一个已有的语言 |
OCR_FAILED | — | OCR 调用失败 | 检查 Settings 里的 OCR 可执行文件路径 |
OCR_EXTRACT_NO_MATCH | 是 | OCR 读到了文字，但提取模式在里面什么都没匹配到 | 拿你的模式去和 Text read result 里的原始读取结果对。如果原始文本就是错的，那是区域或内容类型错了——不是模式 |
OCR_REGEX_INVALID | — | 自定义模式编译不了 | 修正正则 |
OCR_CONFIG_INVALID | — | OCR 设置不是一个可用的组合 | 复查语言和内容类型 |
动作与输入
| 错误码 | 可重试 | 什么意思 | 该怎么办 |
|---|---|---|---|
COORDINATE_SOURCE_UNAVAILABLE | 是 | 一个 Click 指向的 Find Image 节点在这条路径上还没产出匹配 | 先跑那个 Find Image，或在点击前确认它匹配到了。复制粘贴来的 Click 通常就撞这个 |
COORDINATE_PROFILE_INVALID | — | 坐标配置不可用 | 重新取目标 |
INPUT_FAILED | — | 模拟器拒绝了这次输入 | 检查实例可达且处于前台 |
INPUT_COMMAND_TIMEOUT | — | 输入命令没在时限内完成 | 检查模拟器负载 |
TEXT_EMPTY | — | Input Text 没有可输入的内容 | 给它文本，或一个非空的变量 |
TEXT_UNSUPPORTED_CHARACTER | — | 某个字符无法发送给模拟器 | 去掉或转写它 |
TEXT_NOT_FOUND / TEXT_MATCH_INVALID | — | 文本匹配目标或规则不可用 | 修正匹配配 置 |
TEXT_MODE_UNSUPPORTED / TEXT_CLEAR_UNSUPPORTED | — | 请求的输入或清除模式不可用 | 换一个受支持的模式 |
SWIPE_INVALID | — | Swipe 的几何不可用 | 重画起点和终点 |
KEY_UNSUPPORTED | — | 那个键发不出去 | 换一个键 |
WAIT_INVALID | — | 等待时长不可用 | 设一个正的时长 |
Captcha
| 错误码 | 可重试 | 什么意思 | 该怎么办 |
|---|---|---|---|
FEATURE_CAPTCHA_UNAVAILABLE | — | 这个版本里没有验证码求解器 | 检查流程的 captcha 功能开关 |
CAPTCHA_UNSOLVED | 是 | 在允许的尝试次数内没解开挑战 | 提高 Max attempts、检查挑战区域，或把 unsolved 输出接到"刷新再试"的路径上 |
模拟器与实例
| 错误码 | 什么意思 | 该怎么办 |
|---|---|---|
INSTANCE_NOT_ATTACHED | 该动作需要一个已附加的预览实例，但没有 | 在 Live Preview 里附加一个 |
INSTANCE_NOT_FOUND | 被引用的实例不见了 | 用 Add Instance 重新扫描 |
INSTANCE_OFFLINE | 实例不可达 | 启动模拟器 |
INSTANCE_IDENTITY_AMBIGUOUS | 两个实例分不清 | 检查 MuMu 的实例列表 |
INSTANCE_LAUNCH_FAILED / INSTANCE_SHUTDOWN_FAILED | 启动或关闭没生效 | 直接检查 MuMu，然后重试 |
INSTANCE_ATTACH_FAILED / INSTANCE_DETACH_FAILED | 附加预览失败 | 重新打开 Live Preview |
INSTANCE_REGISTRY_PARSE_FAILED / INSTANCE_PLAYER_STATE_UNKNOWN | 读不出 MuMu 自己的状态 | 重启 MuMu |
MUMU_CLI_UNAVAILABLE | 找不到 mumu-cli.exe | 在 Settings 里设置路径——见排查 MuMu CLI |
MUMU_CLI_INFO_FAILED / MUMU_CLI_ADB_FAILED / MUMU_CLI_CONTROL_FAILED | 一次 MuMu CLI 调用失败 | 检查 CLI 路径以及 MuMu 是否在运行 |
MUMU_DISCONNECTED | 运行中途与 MuMu 的连接断了 | 重新附加；看看模拟器是否重启过 |
SCREEN_CAPTURE_FAILED / FRAME_UNAVAILABLE | 采集不到画面 | 检查实例在运行，且没有以阻碍采集的方式被最小化 |
当你在运维时
| 错误码 | 什么意思 | 该怎么办 |
|---|---|---|
QUEUE_FLOW_NOT_FOUND | 一个队列项指向已不存在的流程 | 删掉该项或重新导入流程 |
QUEUE_RESOLUTION_MISMATCH | 流程/ 实例的分辨率对与你确认过的那一对不同 | 你之前那次 "Add anyway" 覆盖的是你真正见过的那一对。重新确认——见 Flow Queue |
SCHEDULE_NOT_FOUND | 计划任务不见了 | 重新创建 |
SCHEDULE_INVALID | 计划任务的时间设置不可用 | 检查重复方式、时间和时区 |
SCHEDULE_IMPORT_INVALID | 文件不是有效的 .muscheduler 导出 | 重新导出 |
SCHEDULE_IMPORT_FLOW_MISSING | 文件里的流程在这台机器上不存在 | 导入前为每一个选择替代 |
DEPLOYMENT_NOT_FOUND / DEPLOYMENT_START_FAILED / DEPLOYMENT_STOP_FAILED | 一次 deployment 操作没完成 | 检查目标实例 |
包、许可与账户
| 错误码 | 什么意思 | 该怎么办 |
|---|---|---|
FLOW_PACKAGE_INVALID | 包文件读不出是一个包 | 拿一份新的 |
FLOW_PACKAGE_SIGNATURE_INVALID | 签名校验失败——导出后被修改过，或不来自可信发布者 | 不要导入。从原发布者处取新的一份 |
FLOW_PACKAGE_CHECKSUM_MISMATCH | 内容与清单不符 | 文件损坏或被截断。重新下载 |
FLOW_PACKAGE_DEPENDENCY_MISSING | 包依赖的某个子流程缺失 | 导入完整的包，而不是从里面挑一个流程 |
FLOW_PACKAGE_KEY_REQUIRED / FLOW_PACKAGE_KEY_INVALID | 受保护的包需要你没有的密钥，或密钥不对 | 见流程知识产权 |
FLOW_PACKAGE_IMPORT_FAILED / FLOW_PACKAGE_EXPORT_FAILED | 传输因其他原因失败 | 检查磁盘空间和权限 |
FLOW_IMPORT_DUPLICATE_ID | 已经有一个同 id 的流程 | 有意识地覆盖，或改名 |
FLOW_OWNERSHIP_FORBIDDEN | 你的账户不能使用这个流程 | 看看这个流程属于谁 |
FLOW_LICENSE_EXPIRED | 一个有时限的 Flow License 到期了 | 续期——续期是往剩余时间上累加 |
FLOW_AUTHORIZE_OFFLINE | 受保护的流程需要一次在线校验，而服务器不可达 | 重新联网后再试 |
CAPABILITY_NOT_LICENSED | 你的许可不包含流程用到的某项能力 | 检查账户上的能力清单 |
AUTH_REQUIRED | 你没有登录 | 登录 |
AUTH_SERVER_UNAVAILABLE | 联系不上门户 | 检查网络连接 |
FLOW_IN_USE / FLOW_EDIT_LOCKED | 流程正在运行，或在别处被打开 | 停掉运行，或关掉另一个编辑器 |
ASSET_IN_USE | 该素材正被某个流程引用 | 先移除那些引用 |
Advanced Captcha（AI）
| 错误码 | 什么意思 | 该怎么办 |
|---|---|---|
AI_MODEL_NOT_INSTALLED | 还没导入任何模型包 | 通过 Settings → Advanced Captcha 下载并导入 |
AI_ARCHIVE_INVALID | 这个包读不出来 | 重新下载 |
AI_ARCHIVE_UNTRUSTED | 这个包不是可信来源签名的 | 不要导入 |
AI_ARCHIVE_INCOMPATIBLE | 这个包与当前版本不匹配 | 取对应你版本的包 |
AI_INSTALL_FAILED | 导入失败 | 检查磁盘空间 |
AI_RUNTIME_UNAVAILABLE | 本地 AI 运行时不可用 | 重新执行安装 |
AI_INFERENCE_FAILED | 模型跑了但在这个挑战上失败 | 没有 Advanced Captcha 时节点仍会走离线求解器——看看离线那条路能不能处理 |
已退役的节点族
PARALLEL_BRANCH_INVALID、PARALLEL_START_MISSING、PARALLEL_END_MISSING、PARALLEL_PAIR_AMBIGUOUS、PARALLEL_REGION_INVALID 属于已退役的 Parallel 节点。如果你看到其中之一，说明流程里还带着那个节点。它从来没让任何东西并发过——见遗留节点，用监控范围替换它。
内部错误码
这些来自你所编写的流程之下的层次——schema 迁移、编辑器自己的持久化，以及 UI 与运行时之间的进程边界。你很少会见到，见到时的修法通常是"重启应用"或"带上错误码报告它"。
SCHEMA_INVALID · SCHEMA_VERSION_UNSUPPORTED · SCHEMA_MIGRATION_MISSING · SCHEMA_MIGRATION_AMBIGUOUS · SCHEMA_MIGRATION_FAILED · SCHEMA_MIGRATION_INVALID_OUTPUT · IPC_PROTOCOL_UNSUPPORTED · IPC_COMMAND_UNKNOWN · IPC_PAYLOAD_INVALID · IPC_TIMEOUT · PERSISTENCE_FAILED · AUTOSAVE_FAILED · EVENT_LOG_CORRUPT · SNAPSHOT_INVALID · REPLAY_MISMATCH · STATE_INVALID · UI_STATE_INVALID · PROJECT_NOT_FOUND · PROJECT_INVALID · PARAM_INVALID · OUTPUT_MAPPING_INVALID · MEMORY_SCOPE_INVALID · MONITOR_SPEC_INVALID · ASSIGNMENTS_EMPTY · SHARE_FORBIDDEN · STOP_REQUESTED · SCALE_INVALID · USER_ABORTED · REGION_NOT_FOUND · DETECTION_ENGINE_FAILED
怎样引用一个错误
复制错误码，不要 复制翻译过的句子。属性面板里的 Copy Result 会把一个节点的完整测试结果放到剪贴板，那是你能附在报告里最有用的东西。