{"record":{"id":"fa12aae284cb05e8","repo":"mybatis/mybatis-3","slug":"environment-declaration-requires-a-transactionfact","errorCode":null,"errorMessage":"Environment declaration requires a TransactionFactory.","messagePattern":"Environment declaration requires a TransactionFactory\\.","errorType":"validation","errorClass":"BuilderException","httpStatus":null,"severity":"error","filePath":"src/main/java/org/apache/ibatis/builder/xml/XMLConfigBuilder.java","lineNumber":346,"sourceCode":"    DatabaseIdProvider databaseIdProvider = (DatabaseIdProvider) resolveClass(type).getDeclaredConstructor()\n        .newInstance();\n    databaseIdProvider.setProperties(properties);\n    Environment environment = configuration.getEnvironment();\n    if (environment != null) {\n      String databaseId = databaseIdProvider.getDatabaseId(environment.getDataSource());\n      configuration.setDatabaseId(databaseId);\n    }\n  }\n\n  private TransactionFactory transactionManagerElement(XNode context) throws Exception {\n    if (context != null) {\n      String type = context.getStringAttribute(\"type\");\n      Properties props = context.getChildrenAsProperties();\n      TransactionFactory factory = (TransactionFactory) resolveClass(type).getDeclaredConstructor().newInstance();\n      factory.setProperties(props);\n      return factory;\n    }\n    throw new BuilderException(\"Environment declaration requires a TransactionFactory.\");\n  }\n\n  private DataSourceFactory dataSourceElement(XNode context) throws Exception {\n    if (context != null) {\n      String type = context.getStringAttribute(\"type\");\n      Properties props = context.getChildrenAsProperties();\n      DataSourceFactory factory = (DataSourceFactory) resolveClass(type).getDeclaredConstructor().newInstance();\n      factory.setProperties(props);\n      return factory;\n    }\n    throw new BuilderException(\"Environment declaration requires a DataSourceFactory.\");\n  }\n\n  private void typeHandlersElement(XNode context) {\n    if (context == null) {\n      return;\n    }\n    for (XNode child : context.getChildren()) {","sourceCodeStart":328,"sourceCodeEnd":364,"githubUrl":"https://github.com/mybatis/mybatis-3/blob/008069adb1b089579b5dcba87ee591908b263274/src/main/java/org/apache/ibatis/builder/xml/XMLConfigBuilder.java#L328-L364","documentation":"Error \"Environment declaration requires a TransactionFactory.\" thrown in mybatis/mybatis-3.","triggerScenarios":"Thrown at src/main/java/org/apache/ibatis/builder/xml/XMLConfigBuilder.java:346 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Add a <transactionManager> element with a type such as JDBC or MANAGED inside the <environment> declaration.","Example: <transactionManager type=\"JDBC\"/>."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"008069adb1b089579b5dcba87ee591908b263274","analyzedAt":"2026-08-14T13:07:10.264Z","schemaVersion":2},"datasetVersion":"2026-08-15T17:31:12.345Z"}