Khi có gì sai, Microbe Studio báo một mã ổn định kèm thông điệp — DETECT_REGION_TIMEOUT, MAX_NODE_EXECUTIONS_EXCEEDED, FLOW_PACKAGE_SIGNATURE_INVALID. Thông điệp được dịch sang ngôn ngữ của bạn; mã thì không bao giờ đổi, nên nó là thứ đáng tìm kiếm và đáng trích trong một báo cáo lỗi.
Trang này xếp theo lúc bạn gặp nó , vì đó là cách người ta tra.
Retry được so với dứt điểm
Một số lỗi dưới đây được đánh dấu retry được . Nghĩa là chính runtime có thể thử lại thao tác — ví dụ một phép phát hiện poll lại đến hết timeout. Lỗi dứt điểm dừng ở đó và cần bạn đổi một thứ gì.
Chuyện này khác với retry policy của từng node, và khác nữa với status so với route — một phép phát hiện không thấy gì thì tự nó chưa hẳn là lỗi. Hãy đọc Mô hình thực thi trước nếu một "thất bại" làm bạn bất ngờ.
Khi bạn đang dựng flow
Những mã này đến từ validate và từ trình soạn. Tất cả đều dứt điểm: không gì retry một sai sót lúc soạn.
Đồ thị và dây nối
Mã Nghĩa là gì Cần làm gì FLOW_VALIDATION_ERRORValidate tìm thấy vấn đề chặn Đi qua chúng bằng ◀ Previous error / Next error ▶ TRANSITION_NOT_FOUNDMột node trả về route không có edge nào nối Thêm hoặc sửa edge cho route nó phát ra — thường nhất là một port Failure chưa nối EDGE_PORT_INVALIDMột edge bắt đầu từ port mà node đó không có Nối lại từ một port nguồn hợp lệ NODE_TYPE_UNSUPPORTEDFlow mang một loại node bản build này không biết Gỡ nó, hoặc cập nhật node — xem Node cũ STALE_STATELần sửa của bạn bị từ chối vì flow đã đổi trong lúc bạn sửa Không mất gì. Làm lại lần sửa
Biến và biểu thức
Mã Nghĩa là gì Cần làm gì VARIABLE_NOT_DECLAREDMột biểu thức dùng cái tên không gì khai báo Khai trong Flow Inputs… hoặc tạo bằng node Variable . Dùng một tên không phải là khai báo nó VARIABLE_TYPE_INVALIDKiểu của biến đã khai không thuộc các kiểu schema nhận Sửa kiểu đã khai VARIABLE_SHADOWS_GLOBALMột biến flow dùng lại tên global đã đặt riêng Đổi tên biến flow TYPE_MISMATCHGiá trị mặc định hoặc khởi tạo vi phạm kiểu đã khai Thường là một đích OCR khai number thay vì number?. Hãy khai các biến gắn OCR là nullable — một lần đọc thất bại ghi rỗng, không bao giờ bịa 0 EXPRESSION_SYNTAX_ERRORBiểu thức không parse được Sửa cú pháp EXPRESSION_NOT_BOOLEANMột điều kiện cho ra thứ không phải đúng/sai Điều kiện phải là boolean — hãy so sánh, đừng chỉ tham chiếu EXPRESSION_EVALUATION_FAILEDBiểu thức parse được nhưng nổ lúc chạy Kiểm giá trị thiếu và chia cho 0
Vòng lặp
Mã Nghĩa là gì Cần làm gì LOOP_START_MISSING / LOOP_END_MISSINGMột vùng lặp thiếu một trong hai marker Mọi Loop có một Loop End cặp đôi do trình soạn quản — đừng xóa một cái lẻ LOOP_BODY_NOT_CLOSEDThân vòng lặp không bao giờ tới Loop End Nối thân đi tới Loop End LOOP_PAIR_AMBIGUOUSKhông quyết được Loop End nào thuộc Loop nào Đơn giản hóa việc lồng nhau LOOP_REGION_INVALIDHình dạng vùng không phải một vòng lặp hợp lệ Tạo lại vòng lặp thay vì sửa tay LOOP_MODE_INVALIDLoop mode không thuộc các giá trị được nhận Chọn một mode hợp lệ LOOP_CONDITION_MISSINGMột vòng lặp theo điều kiện mà không có điều kiện Cấp một điều kiện, hoặc chuyển sang số lần cố định LOOP_CONTROL_OUTSIDE_LOOPBreak hoặc Continue nằm ngoài mọi vòng lặpĐưa nó vào trong vùng lặp nó định điều khiển MAX_ITERATIONS_INVALIDTrần số lần lặp không phải một số dùng được Đặt một số nguyên dương
Sub flow
Mã Nghĩa là gì Cần làm gì SUBFLOW_NOT_FOUNDMột node Sub Flow trỏ tới flow không còn tồn tại Trỏ lại, hoặc import flow thiếu. Hiện là missing trong trình xem phụ thuộc SUBFLOW_INVALIDFlow con được tham chiếu không dùng được như một sub flow Mở flow con và validate nó FLOW_CIRCULAR_DEPENDENCY / SUBFLOW_RECURSION_DETECTEDMột flow gọi chính nó, trực tiếp hay qua chuỗi Gỡ tham chiếu khép vòng — thông điệp gọi tên chuỗi đó SUBFLOW_DEPTH_EXCEEDEDLồng sâu hơn mức cho phép Làm phẳng đi. Hai hay ba tầng phủ gần hết — xem Sub Flow SUBFLOW_VARIABLE_CONFLICTMột input của flow con trùng tên đã có trong scope Đổi tên input
Monitor scope
Mã Nghĩa là gì Cần làm gì OBSERVER_FORBIDDEN_NODEMột loại node không được ở trong khu vực canh lại đang ở trong đó Đưa nó ra ngoài — xem Monitor Scope OBSERVER_NESTED_MONITORMột monitor scope nằm trong một monitor scope khác Monitor không lồng nhau. Dùng một khu vực OBSERVER_SPEC_INVALIDCấu hình của scope không hợp lệ Tạo lại scope SCOPE_PAIR_AMBIGUOUS / SCOPE_REGION_INVALIDHình học của khu vực không phân giải được Xóa rồi bọc lại vùng chọn
Region, điểm và template
Mã Nghĩa là gì Cần làm gì RECT_TOO_SMALLHình chữ nhật đã vẽ nhỏ dưới mức dùng được Vẽ region lớn hơn RECT_X_OVERFLOW / RECT_Y_OVERFLOWHình chữ nhật chạy ra ngoài màn hình Vẽ lại trong khung POINT_INVALID / POINT_OUT_OF_BOUNDSMột tọa độ không dùng được hoặc ngoài màn hình Chọn lại trên Live Preview TEMPLATE_NOT_FOUNDMột node tham chiếu asset template đã mất Chụp lại, hoặc import lại gói flow TEMPLATE_QUALITY_TOO_LOWMẩu cắt quá nhỏ hoặc quá trơn để khớp đáng tin Chụp lại một template lớn hơn, đặc trưng hơn TEMPLATE_CHECKSUM_MISMATCHFile template đã lưu không khớp bản ghi của nó Chụp lại hoặc sửa asset TEMPLATE_CAPTURE_FAILEDChính việc chụp thất bại Kiểm instance đang gắn rồi thử lại
Khi flow đang chạy
Rào chắn — lần chạy dừng có chủ đích
Đây là runtime đang bảo vệ bạn. Tất cả đều dứt điểm.
Mã Nghĩa là gì Cần làm gì MAX_NODE_EXECUTIONS_EXCEEDEDLần chạy thực thi nhiều node hơn flow cho phép Vòng lặp nhân lên: 200 lần qua 12 node là ~2400 lần. Nâng Max node executions… , hoặc tìm một chu trình ngoài ý muốn MAX_RUNTIME_DURATION_EXCEEDEDLần chạy dài hơn trần thời gian của nó Chia nhỏ khối việc, hoặc nâng trần MAX_CONSECUTIVE_FAILURES_EXCEEDEDQuá nhiều thất bại liên tiếp mà không gì thành công ở giữa "Không thấy" của phép phát hiện không gây ra điều này. Tìm một node hành động hỏng liên tục
Phát hiện
Mã Retry được Nghĩa là gì Cần làm gì DETECT_IMAGE_NOT_FOUNDcó Template không khớp được Điều chỉnh template, ngưỡng, search region hay timeout. Chạy Test Node đọc độ tin cậy thật trước khi chạm vào ngưỡng DETECT_AMBIGUOUScó Nhiều ứng viên khớp và không cái nào thắng Xem lại các ứng viên hoặc tinh chỉnh ngưỡng DETECT_REGION_TIMEOUTcó Một luật Check Region không bao giờ thành đúng kịp Nâng timeoutMs, sửa luật, hoặc kiểm xem trong region thực sự có gì DETECTION_ENGINE_FAILED— Chính bộ khớp thất bại Kiểm instance đang gắn và asset template
OCR
Mã Retry được Nghĩa là gì Cần làm gì FEATURE_OCR_UNAVAILABLE— OCR chưa cài hoặc chưa bật Cài và bật OCR (Tesseract) trước khi chạy node Read Text . Cũng kiểm feature gate ocrEnabled của flow — đây là nguyên nhân phổ biến nhất của "Read Text không làm gì" OCR_LANGUAGE_MISSING— Gói ngôn ngữ được yêu cầu chưa cài Cài gói ngôn ngữ Tesseract đó, hoặc chọn một ngôn ngữ có sẵn OCR_FAILED— Lệnh gọi OCR thất bại Kiểm đường dẫn OCR trong Settings OCR_EXTRACT_NO_MATCHcó OCR đọc được chữ, nhưng pattern trích không khớp gì trong đó So pattern của bạn với bản đọc thô trong Text read result . Nếu văn bản thô đã sai thì region hoặc kiểu nội dung sai — không phải pattern OCR_REGEX_INVALID— Pattern tùy biến không compile được Sửa regex OCR_CONFIG_INVALID— Thiết lập OCR không phải một tổ hợp dùng được Kiểm lại ngôn ngữ và kiểu nội dung
Mã Retry được Nghĩa là gì Cần làm gì COORDINATE_SOURCE_UNAVAILABLEcó Một Click trỏ vào node Find Image chưa tạo ra cú khớp trên đường này Chạy Find Image trước, hoặc xác minh nó đã khớp trước cú click. Đây là thứ một Click copy-paste thường gặp COORDINATE_PROFILE_INVALID— Profile tọa độ không dùng được Chọn lại đích INPUT_FAILED— Giả lập từ chối input Kiểm instance có với tới được và đang focus INPUT_COMMAND_TIMEOUT— Lệnh input không hoàn tất kịp Kiểm tải của giả lập TEXT_EMPTY— Input Text không có gì để gõCấp văn bản, hoặc một biến không rỗng TEXT_UNSUPPORTED_CHARACTER— Một ký tự không gửi được tới giả lập Bỏ hoặc chuyển tự nó TEXT_NOT_FOUND / TEXT_MATCH_INVALID— Đích hoặc luật khớp văn bản không dùng được Sửa cấu hình khớp TEXT_MODE_UNSUPPORTED / TEXT_CLEAR_UNSUPPORTED— Chế độ gõ hoặc xóa được yêu cầu không có Chọn một chế độ được hỗ trợ SWIPE_INVALID— Hình học Swipe không dùng được Vẽ lại điểm đầu và cuối KEY_UNSUPPORTED— Phím đó không gửi được Chọn phím khác WAIT_INVALID— Thời lượng chờ không dùng được Đặt một thời lượng dương
Captcha
Mã Retry được Nghĩa là gì Cần làm gì FEATURE_CAPTCHA_UNAVAILABLE— Bộ giải captcha không có trong bản build này Kiểm feature gate captcha của flow CAPTCHA_UNSOLVEDcó Thử thách không được giải trong số lần cho phép Nâng Max attempts , kiểm region thử thách, hoặc nối output unsolved sang đường làm-mới-rồi-thử-lại
Giả lập và instance
Mã Nghĩa là gì Cần làm gì INSTANCE_NOT_ATTACHEDThao tác cần một instance preview đang gắn mà không có Gắn một cái trong Live Preview INSTANCE_NOT_FOUNDInstance được tham chiếu đã mất Quét lại bằng Add Instance INSTANCE_OFFLINEInstance không với tới được Bật giả lập INSTANCE_IDENTITY_AMBIGUOUSHai instance không phân biệt được Kiểm danh sách instance của MuMu INSTANCE_LAUNCH_FAILED / INSTANCE_SHUTDOWN_FAILEDBật hoặc tắt không có tác dụng Kiểm MuMu trực tiếp rồi thử lại INSTANCE_ATTACH_FAILED / INSTANCE_DETACH_FAILEDGắn preview thất bại Mở lại Live Preview INSTANCE_REGISTRY_PARSE_FAILED / INSTANCE_PLAYER_STATE_UNKNOWNKhông đọc được trạng thái của chính MuMu Khởi động lại MuMu MUMU_CLI_UNAVAILABLEKhông tìm thấy mumu-cli.exe Đặt đường dẫn trong Settings — xem Khắc phục MuMu CLI MUMU_CLI_INFO_FAILED / MUMU_CLI_ADB_FAILED / MUMU_CLI_CONTROL_FAILEDMột lệnh MuMu CLI thất bại Kiểm đường dẫn CLI và việc MuMu có đang chạy MUMU_DISCONNECTEDKết nối tới MuMu rớt giữa lần chạy Gắn lại; kiểm xem giả lập có khởi động lại SCREEN_CAPTURE_FAILED / FRAME_UNAVAILABLEKhông chụp được khung hình Kiểm instance đang chạy và không bị minimize theo cách chặn việc chụp
Khi bạn đang vận hành
Mã Nghĩa là gì Cần làm gì QUEUE_FLOW_NOT_FOUNDMột mục queue trỏ tới flow đã mất Gỡ mục đó hoặc import lại flow QUEUE_RESOLUTION_MISMATCHCặp độ phân giải flow/instance khác cặp bạn đã xác nhận Cái "Add anyway" trước đó phủ đúng cặp bạn thực sự đã thấy. Hãy xác nhận lại — xem Flow Queue SCHEDULE_NOT_FOUNDLịch đã mất Tạo lại SCHEDULE_INVALIDThời gian của lịch không dùng được Kiểm kiểu lặp, giờ và múi giờ SCHEDULE_IMPORT_INVALIDFile không phải bản export .muscheduler hợp lệ Export lại SCHEDULE_IMPORT_FLOW_MISSINGCác flow trong file không tồn tại trên máy này Chọn thứ thay cho từng cái trước khi import DEPLOYMENT_NOT_FOUND / DEPLOYMENT_START_FAILED / DEPLOYMENT_STOP_FAILEDMột thao tác deployment không hoàn tất Kiểm instance đích
Gói, giấy phép và tài khoản
Mã Nghĩa là gì Cần làm gì FLOW_PACKAGE_INVALIDFile gói không đọc được như một gói Lấy bản mới FLOW_PACKAGE_SIGNATURE_INVALIDKiểm chữ ký thất bại — bị sửa sau khi export, hoặc không từ nhà publish tin cậy Đừng import. Lấy bản mới từ nhà publish gốc FLOW_PACKAGE_CHECKSUM_MISMATCHNội dung không khớp manifest File hỏng hoặc bị cắt. Tải lại FLOW_PACKAGE_DEPENDENCY_MISSINGMột sub flow mà gói phụ thuộc bị thiếu Import gói đầy đủ, không phải một flow lẻ trong đó FLOW_PACKAGE_KEY_REQUIRED / FLOW_PACKAGE_KEY_INVALIDMột gói được bảo vệ cần khóa bạn không có, hoặc khóa sai Xem Sở hữu trí tuệ Flow FLOW_PACKAGE_IMPORT_FAILED / FLOW_PACKAGE_EXPORT_FAILEDViệc chuyển thất bại vì lý do khác Kiểm dung lượng đĩa và quyền FLOW_IMPORT_DUPLICATE_IDĐã có flow với id đó Overwrite có chủ đích, hoặc đổi tên FLOW_OWNERSHIP_FORBIDDENTài khoản của bạn không được dùng flow này Kiểm flow thuộc về ai FLOW_LICENSE_EXPIREDMột Flow License có thời hạn đã hết Gia hạn — việc gia hạn cộng dồn vào thời gian còn lại FLOW_AUTHORIZE_OFFLINEMột flow được bảo vệ cần kiểm online mà server không với tới được Kết nối lại rồi thử lại CAPABILITY_NOT_LICENSEDGiấy phép của bạn không gồm một capability flow đang dùng Kiểm danh sách capability trên tài khoản AUTH_REQUIREDBạn chưa đăng nhập Đăng nhập AUTH_SERVER_UNAVAILABLEKhông với tới được portal Kiểm kết nối FLOW_IN_USE / FLOW_EDIT_LOCKEDFlow đang chạy hoặc đang mở ở nơi khác Dừng lần chạy, hoặc đóng trình soạn kia ASSET_IN_USEAsset đang được một flow tham chiếu Gỡ các tham chiếu trước
Advanced Captcha (AI)
Mã Nghĩa là gì Cần làm gì AI_MODEL_NOT_INSTALLEDChưa import gói model nào Tải và import qua Settings → Advanced Captcha AI_ARCHIVE_INVALIDGói không đọc được Tải lại AI_ARCHIVE_UNTRUSTEDGói không được ký bởi nguồn tin cậy Đừng import AI_ARCHIVE_INCOMPATIBLEGói không khớp bản build này Lấy gói cho phiên bản của bạn AI_INSTALL_FAILEDViệc import thất bại Kiểm dung lượng đĩa AI_RUNTIME_UNAVAILABLERuntime AI cục bộ không có Chạy lại việc cài AI_INFERENCE_FAILEDModel chạy nhưng thất bại trên thử thách này Không có Advanced Captcha thì node vẫn chạy trên bộ giải offline — kiểm xem đường offline có xử lý được không
Nhóm node đã nghỉ
PARALLEL_BRANCH_INVALID, PARALLEL_START_MISSING, PARALLEL_END_MISSING, PARALLEL_PAIR_AMBIGUOUS, PARALLEL_REGION_INVALID thuộc node Parallel đã nghỉ . Nếu bạn thấy một mã trong số đó, flow vẫn còn mang node đó. Nó chưa bao giờ làm gì đồng thời — xem Node cũ và thay bằng Monitor Scope .
Mã nội bộ
Những mã này đến từ các tầng dưới flow bạn soạn — migration schema, lớp lưu trữ của chính trình soạn, và biên giữa UI với runtime. Bạn ít khi thấy, và khi thấy thì cách sửa thường là "khởi động lại app" hoặc "báo lỗi kèm mã".
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 mã , đừng copy câu đã dịch. Copy Result trong panel Properties đưa toàn bộ kết quả test của một node vào clipboard — đó là thứ hữu ích nhất bạn có thể gửi kèm báo cáo.
Trang liên quan