{"record":{"id":"04a83062cf905ff6","repo":"hibernate/hibernate-orm","slug":"could-not-resolve-entity-name-entityname","errorCode":null,"errorMessage":"Could not resolve entity name '${entityName}'","messagePattern":"Could not resolve entity name '(.+?)'","errorType":"exception","errorClass":"EntityTypeException","httpStatus":null,"severity":"error","filePath":"hibernate-core/src/main/java/org/hibernate/metamodel/model/domain/internal/JpaMetamodelImpl.java","lineNumber":234,"sourceCode":"\t\t}\n\n\t\tif ( loadedClass == null ) {\n\t\t\tloadedClass = resolveRequestedClass( entityName );\n\t\t\t// populate the class cache for boot metamodel imports\n\t\t\tif ( importInfo != null && loadedClass != null ) {\n\t\t\t\timportInfo.loadedClass = loadedClass;\n\t\t\t}\n\t\t}\n\n\t\treturn loadedClass == null ? null : resolveEntityReference( loadedClass );\n\t}\n\n\t@Override\n\t@Nonnull\n\tpublic EntityDomainType<?> resolveHqlEntityReference(@Nonnull String entityName) {\n\t\tfinal var hqlEntityReference = getHqlEntityReference( entityName );\n\t\tif ( hqlEntityReference == null ) {\n\t\t\tthrow new EntityTypeException( \"Could not resolve entity name '\" + entityName + \"'\", entityName );\n\t\t}\n\t\treturn hqlEntityReference;\n\t}\n\n\tprivate static <X> ManagedDomainType<X> checkDomainType(Class<X> cls, @Nullable ManagedDomainType<?> domainType) {\n\t\tif ( domainType != null && !Objects.equals( domainType.getJavaType(), cls ) ) {\n\t\t\tthrow new IllegalStateException( \"Managed type \" + domainType\n\t\t\t\t\t\t+ \" has a different Java type than requested\" );\n\t\t}\n\t\telse {\n\t\t\t@SuppressWarnings(\"unchecked\") // Safe, we checked it\n\t\t\tfinal var type = (ManagedDomainType<X>) domainType;\n\t\t\treturn type;\n\t\t}\n\t}\n\n\t@Override\n\t@Nullable","sourceCodeStart":216,"sourceCodeEnd":252,"githubUrl":"https://github.com/hibernate/hibernate-orm/blob/fad1729dce015f908198d57a8d80274a30f905a5/hibernate-core/src/main/java/org/hibernate/metamodel/model/domain/internal/JpaMetamodelImpl.java#L216-L252","documentation":"Error \"Could not resolve entity name '${entityName}'\" thrown in hibernate/hibernate-orm.","triggerScenarios":"Thrown when an entity name (e.g. from an HQL query or EntityGraph) cannot be resolved to a mapped entity.","commonSituations":"See trigger scenarios.","solutions":["Check the entity name (default: unqualified class name, or the name given in @Entity) and correct the lookup string."],"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"}