apache/dolphinscheduler · error · ServiceException

120020

120020

Error message

create cluster error

What it means

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.

Source

Thrown at dolphinscheduler-api/src/main/java/org/apache/dolphinscheduler/api/service/impl/ClusterServiceImpl.java:103

        Cluster clusterExistByName = clusterDao.queryByClusterName(name);
        if (clusterExistByName != null) {
            throw new ServiceException(Status.CLUSTER_NAME_EXISTS, name);
        }

        Cluster cluster = new Cluster();
        cluster.setName(name);
        cluster.setConfig(config);
        cluster.setDescription(desc);
        cluster.setOperator(loginUser.getId());
        cluster.setCreateTime(new Date());
        cluster.setUpdateTime(new Date());
        cluster.setCode(CodeGenerateUtils.genCode());

        if (clusterDao.insert(cluster) > 0) {
            return cluster.getCode();
        }
        throw new ServiceException(Status.CREATE_CLUSTER_ERROR);
    }

    /**
     * query cluster paging
     *
     * @param loginUser login user
     * @param pageNo    page number
     * @param searchVal search value
     * @param pageSize  page size
     * @return cluster list page
     */
    @Override
    public PageInfo<ClusterDto> queryClusterListPaging(User loginUser, Integer pageNo, Integer pageSize,
                                                       String searchVal) {
        if (isNotAdmin(loginUser)) {
            throw new ServiceException(Status.USER_NO_OPERATION_PERM);
        }

View on GitHub (pinned to 02eac45a1b)

Solutions

1. Inspect server logs and database connectivity for the root cause.
2. Retry creation after resolving the database issue.
3. Verify the generated cluster code does not conflict with an existing row.

When it happens

Trigger: Thrown at dolphinscheduler-api/src/main/java/org/apache/dolphinscheduler/api/service/impl/ClusterServiceImpl.java:103 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of apache/dolphinscheduler@02eac45a1b (2026-09-06). Data as JSON: /api/errors/d7b37fdb00d7c352. Report an issue: GitHub.