flowable/flowable-engine · error · FlowableObjectNotFoundException

Cannot find app definition with id

Error message

Cannot find app definition with id 

What it means

Lookup failure in NeedsAppDefinitionCmd.execute: an appDefinitionId was supplied but the repository service finds no app definition with that id (deleted, wrong engine, or typo), so the subclass command cannot proceed.

Solutions

1. List app definitions to confirm the id exists in this engine
2. Re-deploy the app if the definition was removed

When it happens

Trigger: Thrown at modules/flowable-app-engine/src/main/java/org/flowable/app/engine/impl/cmd/NeedsAppDefinitionCmd.java:49 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of flowable/flowable-engine@d6d39ce1c6 (2026-09-11). Data as JSON: /api/errors/4fcfcf72b4da9209. Report an issue: GitHub.

Appendix: source

Thrown at modules/flowable-app-engine/src/main/java/org/flowable/app/engine/impl/cmd/NeedsAppDefinitionCmd.java:49

    private static final long serialVersionUID = 1L;

    protected String appDefinitionId;

    public NeedsAppDefinitionCmd(String appDefinitionId) {
        this.appDefinitionId = appDefinitionId;
    }

    @Override
    public T execute(CommandContext commandContext) {

        if (appDefinitionId == null) {
            throw new FlowableIllegalArgumentException("appDefinitionId is null");
        }

        AppDefinition appDefinition = CommandContextUtil.getAppRepositoryService().getAppDefinition(appDefinitionId);

        if (appDefinition == null) {
            throw new FlowableObjectNotFoundException("Cannot find app definition with id " + appDefinitionId, AppDefinition.class);
        }

        return execute(commandContext, appDefinition);
    }

    /**
     * Subclasses must implement in this method their normal command logic.
     */
    protected abstract T execute(CommandContext commandContext, AppDefinition appDefinition);

}

View on GitHub (pinned to d6d39ce1c6)