{"record":{"id":"3b61d2f745b85e0d","repo":"apache/dolphinscheduler","slug":"unsupported-executetype-0","errorCode":null,"errorMessage":"Unsupported executeType: {0}","messagePattern":"Unsupported executeType: (.+?)","errorType":"exception","errorClass":"ServiceException","httpStatus":null,"severity":"error","filePath":"dolphinscheduler-api/src/main/java/org/apache/dolphinscheduler/api/service/impl/ExecutorServiceImpl.java","lineNumber":264,"sourceCode":"                executorClient.recoverSuspendedWorkflowInstanceOperation()\n                        .onWorkflowInstance(workflowInstance)\n                        .byUser(loginUser)\n                        .execute();\n                return;\n            case PAUSE:\n                executorClient.pauseWorkflowInstance()\n                        .onWorkflowInstance(workflowInstance)\n                        .byUser(loginUser)\n                        .execute();\n                return;\n            case STOP:\n                executorClient.stopWorkflowInstance()\n                        .onWorkflowInstance(workflowInstance)\n                        .byUser(loginUser)\n                        .execute();\n                return;\n            default:\n                throw new ServiceException(\"Unsupported executeType: \" + executeType);\n        }\n    }\n\n    /**\n     * do action to execute task in workflow instance\n     *\n     * @param loginUser         login user\n     * @param projectCode       project code\n     * @param workflowInstanceId workflow instance id\n     * @param startNodeList     start node list\n     * @param taskDependType    task depend type\n     * @return execute result code\n     */\n    @Override\n    public WorkflowExecuteResponse executeTask(User loginUser,\n                                               long projectCode,\n                                               Integer workflowInstanceId,\n                                               String startNodeList,","sourceCodeStart":246,"sourceCodeEnd":282,"githubUrl":"https://github.com/apache/dolphinscheduler/blob/02eac45a1b6676e639fcbfb4be2243de5771b05d/dolphinscheduler-api/src/main/java/org/apache/dolphinscheduler/api/service/impl/ExecutorServiceImpl.java#L246-L282","documentation":"This plain ServiceException is thrown by controlWorkflowInstance when the executeType received in a control (repeat/pause/stop) request falls outside the known switch cases. It means the caller supplied an executeType value the current code cannot handle, typically from an unexpected or mismatched client value.","triggerScenarios":"Posting to the workflow instance control endpoint with an executeType not covered by the switch (anything other than the handled repeat-running / recover-suspended / pause / stop cases), e.g. a malformed or newer enum value.","commonSituations":"Older/newer client versions sending an executeType value added after this switch was written; manual API calls with a wrong or misspelled executeType string.","solutions":["Send a supported executeType value for the control endpoint (e.g. REPEAT_RUNNING, RECOVER_SUSPENDED_PROCESS, PAUSE, STOP).","Check client/server version alignment so enum values match.","Inspect the request body and correct the executeType field."],"exampleFix":"// before\nexecute(\"RESTART\", instanceId); // unsupported value\n// after\nexecute(\"REPEAT_RUNNING\", instanceId);","handlingStrategy":"validation","validationCode":"Set<String> supported = Set.of(\"REPEAT_RUNNING\",\"RECOVER_SUSPENDED_PROCESS\",\"PAUSE\",\"STOP\");\nif (!supported.contains(executeType)) throw new IllegalArgumentException(\"unsupported executeType: \" + executeType);","typeGuard":null,"tryCatchPattern":"try { controlWorkflowInstance(loginUser, instanceId, executeType); } catch (ServiceException e) { if (e.getMessage().startsWith(\"Unsupported executeType\")) { /* correct the executeType value and resend */ } else throw e; }","preventionTips":["Use the enum/constant defined by the server, not raw strings.","Keep client and server versions aligned.","Validate request payloads against the API schema before sending."],"tags":["execute-type","unsupported-operation","dolphinscheduler"],"backgroundTag":"invalid-enum-value","analyzedSha":"02eac45a1b6676e639fcbfb4be2243de5771b05d","analyzedAt":"2026-09-06T17:43:00.555Z","contentChangedAt":"2026-09-06T17:43:00.555Z","schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}