{"record":{"id":"69b2de8bfc567063","repo":"hibernate/hibernate-orm","slug":"could-not-resolve-class-classname-named-for-i","errorCode":null,"errorMessage":"Could not resolve class '${className}' named for instantiation","messagePattern":"Could not resolve class '(.+?)' named for instantiation","errorType":"exception","errorClass":"SemanticException","httpStatus":null,"severity":"error","filePath":"hibernate-core/src/main/java/org/hibernate/query/hql/internal/SemanticQueryBuilder.java","lineNumber":1549,"sourceCode":"\t@Override\n\tpublic SqmDynamicInstantiation<?> visitInstantiationTarget(HqlParser.InstantiationTargetContext ctx) {\n\t\tif ( ctx.MAP() != null ) {\n\t\t\treturn forMapInstantiation( mapJavaType, nodeBuilder() );\n\t\t}\n\t\telse if ( ctx.LIST() != null ) {\n\t\t\treturn forListInstantiation( listJavaType, nodeBuilder() );\n\t\t}\n\t\telse {\n\t\t\tfinal var simplePath = ctx.simplePath();\n\t\t\tif ( simplePath == null ) {\n\t\t\t\tthrow new SyntaxException( \"Missing instantiation target type\" );\n\t\t\t}\n\t\t\tfinal String className = instantiationClassName( simplePath );\n\t\t\ttry {\n\t\t\t\treturn forClassInstantiation( resolveInstantiationTargetType( className ), nodeBuilder() );\n\t\t\t}\n\t\t\tcatch (ClassLoadingException e) {\n\t\t\t\tthrow new SemanticException( \"Could not resolve class '\" + className + \"' named for instantiation\", query );\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate String instantiationClassName(HqlParser.SimplePathContext ctx) {\n\t\tfinal String name = ctx.getText();\n\t\treturn expectedResultTypeName != null && expectedResultTypeShortName.equals( name )\n\t\t\t\t? expectedResultTypeName\n\t\t\t\t: name;\n\t}\n\n\tprivate JavaType<?> resolveInstantiationTargetType(String className) {\n\t\tfinal String qualifiedName = creationContext.getJpaMetamodel().qualifyImportableName( className );\n\t\tfinal var targetJavaType = creationContext.classForName( qualifiedName );\n\t\treturn creationContext.getTypeConfiguration().getJavaTypeRegistry().resolveDescriptor( targetJavaType );\n\t}\n\n\t@Override","sourceCodeStart":1531,"sourceCodeEnd":1567,"githubUrl":"https://github.com/hibernate/hibernate-orm/blob/fad1729dce015f908198d57a8d80274a30f905a5/hibernate-core/src/main/java/org/hibernate/query/hql/internal/SemanticQueryBuilder.java#L1531-L1567","documentation":"Error \"Could not resolve class '${className}' named for instantiation\" thrown in hibernate/hibernate-orm.","triggerScenarios":"A name referenced in a mapping, query, or configuration cannot be resolved at runtime.","commonSituations":"Typos in entity/attribute/mapping names, missing mappings, or refactoring without updating references.","solutions":["Use a fully-qualified class name that exists on the classpath in the instantiation.","Check for typos in the class name."],"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"}