apache/dolphinscheduler · error · ServiceException

1200027

1200027

Error message

not found cluster [{0}] 

What it means

Thrown in queryClusterByName when clusterDao.queryByClusterName returns null: no cluster exists with the requested name. It is an existence guard ensuring callers never receive a null cluster object; the faulting input is the name path parameter.

Source

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

                .map(cluster -> {
                    ClusterDto dto = new ClusterDto();
                    // todo: Don't use copy
                    BeanUtils.copyProperties(cluster, dto);
                    return dto;
                }).collect(Collectors.toList());
    }

    /**
     * query cluster
     *
     * @param name cluster name
     */
    @Override
    public ClusterDto queryClusterByName(String name) {

        Cluster cluster = clusterDao.queryByClusterName(name);
        if (cluster == null) {
            throw new ServiceException(Status.QUERY_CLUSTER_BY_NAME_ERROR, name);
        }
        ClusterDto dto = new ClusterDto();
        BeanUtils.copyProperties(cluster, dto);
        return dto;
    }

    /**
     * delete cluster
     *
     * @param loginUser login user
     * @param code      cluster code
     */
    @Override
    public void deleteClusterByCode(User loginUser, Long code) {
        if (isNotAdmin(loginUser)) {
            throw new ServiceException(Status.USER_NO_OPERATION_PERM);
        }

View on GitHub (pinned to 02eac45a1b)

Solutions

1. Check the cluster name for typos; names are case-sensitive.
2. List all clusters to find the correct name.
3. Create the cluster if it does not exist yet.

When it happens

Trigger: Thrown at dolphinscheduler-api/src/main/java/org/apache/dolphinscheduler/api/service/impl/ClusterServiceImpl.java:177 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/0adc1140ab729cbb. Report an issue: GitHub.