{"record":{"id":"5075ed48f4a6c830","repo":"hibernate/hibernate-orm","slug":"not-an-embeddable-embeddablename","errorCode":null,"errorMessage":"Not an embeddable: ${embeddableName}","messagePattern":"Not an embeddable: (.+?)","errorType":"exception","errorClass":"IllegalArgumentException","httpStatus":null,"severity":"error","filePath":"hibernate-core/src/main/java/org/hibernate/metamodel/model/domain/internal/JpaMetamodelImpl.java","lineNumber":198,"sourceCode":"\t@Override\n\t@Nullable\n\tpublic EmbeddableDomainType<?> findEmbeddableType(@Nullable String embeddableName) {\n\t\tif ( embeddableName == null ) {\n\t\t\treturn null;\n\t\t}\n\t\tfinal var managedType = managedTypeByName.get( embeddableName );\n\t\tif ( !( managedType instanceof EmbeddableDomainType<?> embeddableDomainType ) ) {\n\t\t\treturn null;\n\t\t}\n\t\treturn embeddableDomainType;\n\t}\n\n\t@Override\n\t@Nonnull\n\tpublic EmbeddableDomainType<?> embeddable(@Nullable String embeddableName) {\n\t\tfinal var embeddableType = findEmbeddableType( embeddableName );\n\t\tif ( embeddableType == null ) {\n\t\t\tthrow new IllegalArgumentException( \"Not an embeddable: \" + embeddableName );\n\t\t}\n\t\treturn embeddableType;\n\t}\n\n\t@Override\n\t@Nullable\n\tpublic EntityDomainType<?> getHqlEntityReference(@Nonnull String entityName) {\n\t\tClass<?> loadedClass = null;\n\t\tfinal var importInfo = resolveImport( entityName );\n\t\tif ( importInfo != null ) {\n\t\t\tloadedClass = importInfo.loadedClass;\n\t\t\tentityName = importInfo.importedName;\n\t\t}\n\n\t\tfinal var entityDescriptor = findEntityType( entityName );\n\t\tif ( entityDescriptor != null ) {\n\t\t\treturn entityDescriptor;\n\t\t}","sourceCodeStart":180,"sourceCodeEnd":216,"githubUrl":"https://github.com/hibernate/hibernate-orm/blob/fad1729dce015f908198d57a8d80274a30f905a5/hibernate-core/src/main/java/org/hibernate/metamodel/model/domain/internal/JpaMetamodelImpl.java#L180-L216","documentation":"Error \"Not an embeddable: ${embeddableName}\" thrown in hibernate/hibernate-orm.","triggerScenarios":"Thrown when JpaMetamodel.embeddable() is called with a class name that is not a mapped embeddable.","commonSituations":"See trigger scenarios.","solutions":["Pass the class of a type annotated @Embeddable and used 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"}