{"record":{"id":"da0deaccfedd2e83","repo":"flowable/flowable-engine","slug":"unable-to-suspend-transaction","errorCode":null,"errorMessage":"Unable to suspend transaction","messagePattern":"Unable to suspend transaction","errorType":"exception","errorClass":"TransactionException","httpStatus":null,"severity":"error","filePath":"modules/flowable-engine-common/src/main/java/org/flowable/common/engine/impl/interceptor/JtaTransactionInterceptor.java","lineNumber":103,"sourceCode":"            transactionManager.begin();\n        } catch (NotSupportedException | SystemException e) {\n            throw new TransactionException(\"Unable to begin transaction\", e);\n        }\n    }\n\n    private boolean isExisting() {\n        try {\n            return transactionManager.getStatus() != Status.STATUS_NO_TRANSACTION;\n        } catch (SystemException e) {\n            throw new TransactionException(\"Unable to retrieve transaction status\", e);\n        }\n    }\n\n    private Transaction doSuspend() {\n        try {\n            return transactionManager.suspend();\n        } catch (SystemException e) {\n            throw new TransactionException(\"Unable to suspend transaction\", e);\n        }\n    }\n\n    private void doResume(Transaction tx) {\n        if (tx != null) {\n            try {\n                transactionManager.resume(tx);\n            } catch (SystemException | InvalidTransactionException e) {\n                throw new TransactionException(\"Unable to resume transaction\", e);\n            }\n        }\n    }\n\n    private void doCommit() {\n        try {\n            transactionManager.commit();\n        } catch (HeuristicMixedException | SystemException | RollbackException | HeuristicRollbackException e) {\n            throw new TransactionException(\"Unable to commit transaction\", e);","sourceCodeStart":85,"sourceCodeEnd":121,"githubUrl":"https://github.com/flowable/flowable-engine/blob/d6d39ce1c69ff244f2d9dc6af756a9b95e865586/modules/flowable-engine-common/src/main/java/org/flowable/common/engine/impl/interceptor/JtaTransactionInterceptor.java#L85-L121","documentation":"Infrastructure failure in JtaTransactionInterceptor.doSuspend: transactionManager.suspend() threw a SystemException while the interceptor tried to suspend the current transaction around command execution. Wrapped as TransactionException; points at JTA-level trouble rather than application logic.","triggerScenarios":"Thrown at modules/flowable-engine-common/src/main/java/org/flowable/common/engine/impl/interceptor/JtaTransactionInterceptor.java:103 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Check transaction manager state and server logs for the underlying SystemException","Avoid requiresNew propagation when the transaction manager cannot suspend"],"exampleFix":null,"handlingStrategy":"try-catch","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"d6d39ce1c69ff244f2d9dc6af756a9b95e865586","analyzedAt":"2026-09-11T06:41:19.413Z","contentChangedAt":"2026-09-11T06:41:19.413Z","schemaVersion":2},"datasetVersion":"2026-09-18T11:17:12.947Z"}