{"record":{"id":"8df8f2b87a03c3e3","repo":"hibernate/hibernate-orm","slug":"unrecognized-cache-inclusions-value","errorCode":null,"errorMessage":"Unrecognized cache-inclusions value : {}","messagePattern":"Unrecognized cache-inclusions value : (.+?)","errorType":"exception","errorClass":"IllegalArgumentException","httpStatus":null,"severity":"error","filePath":"hibernate-core/src/main/java/org/hibernate/boot/jaxb/hbm/transform/HbmXmlTransformer.java","lineNumber":1762,"sourceCode":"\t\tcaching.setAccess( hbmClass.getCache().getUsage() );\n\t\tcaching.setIncludeLazy( convert( hbmClass.getCache().getInclude() ) );\n\t\tentity.setCaching( caching );\n\t}\n\n\tprivate boolean convert(JaxbHbmCacheInclusionEnum hbmInclusion) {\n\t\tif ( hbmInclusion == null ) {\n\t\t\treturn true;\n\t\t}\n\n\t\tif ( hbmInclusion == JaxbHbmCacheInclusionEnum.NON_LAZY ) {\n\t\t\treturn false;\n\t\t}\n\n\t\tif ( hbmInclusion == JaxbHbmCacheInclusionEnum.ALL ) {\n\t\t\treturn true;\n\t\t}\n\n\t\tthrow new IllegalArgumentException( \"Unrecognized cache-inclusions value : \" + hbmInclusion );\n\t}\n\n\tprivate void transferResultSetMappings(String namePrefix, ResultSetMappingContainer container) {\n\t\tfinal var resultSetMappings = container.getResultset();\n\t\tresultSetMappings.forEach( (hbmMapping) -> {\n\t\t\t\t\tfinal var mapping = transformResultSetMapping( namePrefix, hbmMapping );\n\t\t\t\t\tmappingXmlBinding.getRoot().getSqlResultSetMappings().add( mapping );\n\t\t} );\n\t}\n\n\tprivate void transferToolingHints(ToolingHintContainer container) {\n\t\tif ( isNotEmpty( container.getToolingHints() ) ) {\n\t\t\thandleUnsupported(\n\t\t\t\t\t\"Transformation of <meta/> (tooling hint) is not supported - `%s`\",\n\t\t\t\t\thbmXmlBinding.getOrigin()\n\t\t\t);\n\t\t}\n\t}","sourceCodeStart":1744,"sourceCodeEnd":1780,"githubUrl":"https://github.com/hibernate/hibernate-orm/blob/fad1729dce015f908198d57a8d80274a30f905a5/hibernate-core/src/main/java/org/hibernate/boot/jaxb/hbm/transform/HbmXmlTransformer.java#L1744-L1780","documentation":"Error \"Unrecognized cache-inclusions value : {}\" thrown in hibernate/hibernate-orm.","triggerScenarios":"The cache include attribute holds an unrecognized value.","commonSituations":"A legacy hbm.xml <cache include=\"...\"> value other than all/non-lazy.","solutions":["Set the cache include attribute to a recognized value: all or non-lazy.","Fix typos in the cache-inclusions setting in the mapping document.","Remove the attribute to use the default inclusion behavior."],"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"}