{"record":{"id":"3161c2e5920196e2","repo":"flowable/flowable-engine","slug":"unable-to-begin-transaction","errorCode":null,"errorMessage":"Unable to begin transaction","messagePattern":"Unable to begin 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":87,"sourceCode":"                throw ex;\n            } catch (Exception ex) {\n                doRollback(isNew, ex);\n                throw new UndeclaredThrowableException(ex, \"TransactionCallback threw undeclared checked exception\");\n            }\n            if (isNew) {\n                doCommit();\n            }\n            return result;\n        } finally {\n            doResume(oldTx);\n        }\n    }\n\n    private void doBegin() {\n        try {\n            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    }","sourceCodeStart":69,"sourceCodeEnd":105,"githubUrl":"https://github.com/flowable/flowable-engine/blob/d6d39ce1c69ff244f2d9dc6af756a9b95e865586/modules/flowable-engine-common/src/main/java/org/flowable/common/engine/impl/interceptor/JtaTransactionInterceptor.java#L69-L105","documentation":"Wrapper thrown by JtaTransactionInterceptor.doBegin: transactionManager.begin() failed with NotSupportedException or SystemException (transaction manager unavailable or nesting not supported), so the JTA transaction for the command could not be started.","triggerScenarios":"Thrown at modules/flowable-engine-common/src/main/java/org/flowable/common/engine/impl/interceptor/JtaTransactionInterceptor.java:87 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Check JTA transaction manager configuration and availability","Avoid unsupported nested transaction usage; use requiresNew appropriately"],"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"}