apache/dolphinscheduler · error · ServiceException

110004

110004

Error message

query plugin detail result is null

What it means

Thrown in UiPluginServiceImpl.queryUiPluginDetailById when pluginDefineMapper.queryDetailById(id) returns null: no row exists in t_ds_plugin_define for the requested plugin id, so the UI plugin detail lookup is a sentinel guard against a missing/expired plugin definition (e.g. plugin removed after registration or a stale id from the client).

Source

Thrown at dolphinscheduler-api/src/main/java/org/apache/dolphinscheduler/api/service/impl/UiPluginServiceImpl.java:78

        if (!pluginType.getHasUi()) {
            log.warn("Plugin does not have UI.");
            throw new ServiceException(Status.PLUGIN_NOT_A_UI_COMPONENT);
        }
        List<PluginDefine> pluginDefines = pluginDefineMapper.queryByPluginType(pluginType.getDesc());

        if (CollectionUtils.isEmpty(pluginDefines)) {
            log.warn("Query plugins result is null, check status of plugins.");
            throw new ServiceException(Status.QUERY_PLUGINS_RESULT_IS_NULL);
        }
        return pluginDefines;
    }

    @Override
    public PluginDefine queryUiPluginDetailById(int id) {
        PluginDefine pluginDefine = pluginDefineMapper.queryDetailById(id);
        if (null == pluginDefine) {
            log.warn("Query plugins result is empty, pluginId:{}.", id);
            throw new ServiceException(Status.QUERY_PLUGIN_DETAIL_RESULT_IS_NULL);
        }
        return pluginDefine;
    }

    @Override
    public ProductInfoDto queryProductInfo() {
        ProductInfoDto result = new ProductInfoDto();
        result.setVersion(dsVersion);
        return result;
    }

}

View on GitHub (pinned to 02eac45a1b)

Solutions

  1. Verify the plugin id passed to the API exists; refresh the UI plugin list and use a current id
  2. Check t_ds_plugin_define for rows of the expected plugin type; if empty, confirm the plugin jar is installed and the server restarted so it registers
  3. If plugins were upgraded, re-sync the plugin definitions in the database before retrying
Defensive patterns

Strategy: validation

When it happens

Trigger: Thrown at dolphinscheduler-api/src/main/java/org/apache/dolphinscheduler/api/service/impl/UiPluginServiceImpl.java:78 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/6c00bab071aeb9b6. Report an issue: GitHub.