{"record":{"id":"d7b37fdb00d7c352","repo":"apache/dolphinscheduler","slug":"120020","errorCode":"120020","errorMessage":"create cluster error","messagePattern":"create cluster error","errorType":"error_code","errorClass":"ServiceException","httpStatus":null,"severity":"error","filePath":"dolphinscheduler-api/src/main/java/org/apache/dolphinscheduler/api/service/impl/ClusterServiceImpl.java","lineNumber":103,"sourceCode":"\n        Cluster clusterExistByName = clusterDao.queryByClusterName(name);\n        if (clusterExistByName != null) {\n            throw new ServiceException(Status.CLUSTER_NAME_EXISTS, name);\n        }\n\n        Cluster cluster = new Cluster();\n        cluster.setName(name);\n        cluster.setConfig(config);\n        cluster.setDescription(desc);\n        cluster.setOperator(loginUser.getId());\n        cluster.setCreateTime(new Date());\n        cluster.setUpdateTime(new Date());\n        cluster.setCode(CodeGenerateUtils.genCode());\n\n        if (clusterDao.insert(cluster) > 0) {\n            return cluster.getCode();\n        }\n        throw new ServiceException(Status.CREATE_CLUSTER_ERROR);\n    }\n\n    /**\n     * query cluster paging\n     *\n     * @param loginUser login user\n     * @param pageNo    page number\n     * @param searchVal search value\n     * @param pageSize  page size\n     * @return cluster list page\n     */\n    @Override\n    public PageInfo<ClusterDto> queryClusterListPaging(User loginUser, Integer pageNo, Integer pageSize,\n                                                       String searchVal) {\n        if (isNotAdmin(loginUser)) {\n            throw new ServiceException(Status.USER_NO_OPERATION_PERM);\n        }\n","sourceCodeStart":85,"sourceCodeEnd":121,"githubUrl":"https://github.com/apache/dolphinscheduler/blob/02eac45a1b6676e639fcbfb4be2243de5771b05d/dolphinscheduler-api/src/main/java/org/apache/dolphinscheduler/api/service/impl/ClusterServiceImpl.java#L85-L121","documentation":"Thrown in createCluster when clusterDao.insert returns 0 rows or throws, so the cluster record was not persisted. Typical causes are database errors, constraint violations, or the generated cluster code colliding.","triggerScenarios":"Thrown at dolphinscheduler-api/src/main/java/org/apache/dolphinscheduler/api/service/impl/ClusterServiceImpl.java:103 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Inspect server logs and database connectivity for the root cause.","Retry creation after resolving the database issue.","Verify the generated cluster code does not conflict with an existing row."],"exampleFix":null,"handlingStrategy":"try-catch","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"02eac45a1b6676e639fcbfb4be2243de5771b05d","analyzedAt":"2026-09-06T17:43:00.555Z","contentChangedAt":"2026-09-06T17:43:00.555Z","schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}