{"record":{"id":"a48b739b96857ecc","repo":"hibernate/hibernate-orm","slug":"unknown-entity-type-entityname","errorCode":null,"errorMessage":"Unknown entity type '${entityName}'","messagePattern":"Unknown entity type '(.+?)'","errorType":"exception","errorClass":"UnknownEntityTypeException","httpStatus":null,"severity":"error","filePath":"hibernate-core/src/main/java/org/hibernate/boot/model/internal/NamedGraphCreatorParsed.java","lineNumber":74,"sourceCode":"\t\t\t\tGraphParserSettings.GRAPH_PARSER_MODE,\n\t\t\t\tGraphParserMode::interpret,\n\t\t\t\tGraphParserMode.LEGACY\n\t\t);\n\n\t\tif ( graphParserMode != null && graphParserMode.equals( GraphParserMode.MODERN ) ) {\n\t\t\treturn parseGraph( entityDomainClassResolver, entityDomainNameResolver );\n\t\t}\n\n\t\treturn parseGraphForLegacyParsingMode( entityDomainClassResolver, entityDomainNameResolver );\n\t}\n\n\tprivate static @Nonnull EntityDomainType<?> resolve(\n\t\t\tString entityName, GraphParserEntityNameResolver entityDomainNameResolver) {\n\t\tfinal var entityDomainType =\n\t\t\t\t(EntityDomainType<?>)\n\t\t\t\t\t\tentityDomainNameResolver.resolveEntityName( entityName );\n\t\tif ( entityDomainType == null ) {\n\t\t\tthrow new UnknownEntityTypeException( entityName );\n\t\t}\n\t\telse {\n\t\t\treturn entityDomainType;\n\t\t}\n\t}\n\n\tprivate <T> RootGraphImplementor<T> parseGraph(\n\t\t\tGraphParserEntityClassResolver entityDomainClassResolver,\n\t\t\tGraphParserEntityNameResolver entityDomainNameResolver) {\n\t\tfinal EntityDomainType<T> entityDomainType = resolveEntityDomainTypeFromAnnotation(\n\t\t\t\tentityDomainClassResolver\n\t\t);\n\n\t\tfinal var graphContext = parseText( annotation.graph() );\n\n\t\tfinal String graphName = this.name == null ? entityDomainType.getName() : this.name;\n\n\t\treturn GraphParsing.visit( graphName, entityDomainType, graphContext.graphElementList(),","sourceCodeStart":56,"sourceCodeEnd":92,"githubUrl":"https://github.com/hibernate/hibernate-orm/blob/fad1729dce015f908198d57a8d80274a30f905a5/hibernate-core/src/main/java/org/hibernate/boot/model/internal/NamedGraphCreatorParsed.java#L56-L92","documentation":"Error \"Unknown entity type '${entityName}'\" thrown in hibernate/hibernate-orm.","triggerScenarios":"An association or reference targets a type that Hibernate has not mapped as an entity.","commonSituations":"Missing @Entity on the target class, the class not being scanned into the persistence unit, or a typo in the entity name.","solutions":["Correct the entity type name to one registered in the persistence unit."],"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"}