{"record":{"id":"7cd0fca7dadb7eef","repo":"hibernate/hibernate-orm","slug":"could-not-instantiate-persister-s-s","errorCode":null,"errorMessage":"Could not instantiate persister %s (%s)","messagePattern":"Could not instantiate persister (.+?) \\((.+?)\\)","errorType":"exception","errorClass":"MappingException","httpStatus":null,"severity":"error","filePath":"hibernate-core/src/main/java/org/hibernate/persister/internal/PersisterFactoryImpl.java","lineNumber":82,"sourceCode":"\t\t\tPersistentClass entityBinding,\n\t\t\tEntityDataAccess entityCacheAccessStrategy,\n\t\t\tNaturalIdDataAccess naturalIdCacheAccessStrategy,\n\t\t\tRuntimeModelCreationContext creationContext) {\n\t\tfinal var persisterClass = persisterClassResolver.getEntityPersisterClass( entityBinding );\n\t\tfinal var constructor = resolveEntityPersisterConstructor( persisterClass );\n\t\ttry {\n\t\t\treturn constructor.newInstance( entityBinding, entityCacheAccessStrategy, naturalIdCacheAccessStrategy, creationContext );\n\t\t}\n\t\tcatch (MappingException e) {\n\t\t\tthrow e;\n\t\t}\n\t\tcatch (InvocationTargetException e) {\n\t\t\tfinal var target = e.getTargetException();\n\t\t\tif ( target instanceof HibernateException hibernateException ) {\n\t\t\t\tthrow hibernateException;\n\t\t\t}\n\t\t\telse {\n\t\t\t\tthrow new MappingException(\n\t\t\t\t\t\tString.format(\n\t\t\t\t\t\t\t\tLocale.ROOT,\n\t\t\t\t\t\t\t\t\"Could not instantiate persister %s (%s)\",\n\t\t\t\t\t\t\t\tpersisterClass.getName(),\n\t\t\t\t\t\t\t\tentityBinding.getEntityName()\n\t\t\t\t\t\t),\n\t\t\t\t\t\ttarget\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\t\tcatch (Exception e) {\n\t\t\tthrow new MappingException(\n\t\t\t\t\tString.format(\n\t\t\t\t\t\t\tLocale.ROOT,\n\t\t\t\t\t\t\t\"Could not instantiate persister %s (%s)\",\n\t\t\t\t\t\t\tpersisterClass.getName(),\n\t\t\t\t\t\t\tentityBinding.getEntityName()\n\t\t\t\t\t),","sourceCodeStart":64,"sourceCodeEnd":100,"githubUrl":"https://github.com/hibernate/hibernate-orm/blob/fad1729dce015f908198d57a8d80274a30f905a5/hibernate-core/src/main/java/org/hibernate/persister/internal/PersisterFactoryImpl.java#L64-L100","documentation":"Error \"Could not instantiate persister %s (%s)\" thrown in hibernate/hibernate-orm.","triggerScenarios":"Hibernate bootstrap fails to create a configured custom implementation class.","commonSituations":"A custom persister/factory/resolver class is missing, non-public, or lacks the required constructor.","solutions":["Verify the custom persister class has a constructor matching (EntityBinding, EntityMetamodel, PersistenceContext) and is public.","Check the nested cause for the underlying instantiation failure.","Ensure the persister class is on the classpath and loadable."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"fad1729dce015f908198d57a8d80274a30f905a5","analyzedAt":"2026-08-22T04:13:57.527Z","schemaVersion":2},"datasetVersion":"2026-08-22T09:17:25.309Z"}