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
- Verify the plugin id passed to the API exists; refresh the UI plugin list and use a current id
- 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
- 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.