{"record":{"id":"5377f7b86e5d19b0","repo":"hibernate/hibernate-orm","slug":"unable-to-interpret-flushmode-in-named-query-hint","errorCode":null,"errorMessage":"Unable to interpret FlushMode in named query hint: \" + queryName","messagePattern":"Unable to interpret FlushMode in named query hint: \" \\+ queryName","errorType":"exception","errorClass":"AnnotationException","httpStatus":null,"severity":"error","filePath":"hibernate-core/src/main/java/org/hibernate/boot/model/internal/QueryHintDefinition.java","lineNumber":152,"sourceCode":"\t\t\treturn value == null\n\t\t\t\t\t? null\n\t\t\t\t\t: CacheMode.interpretExternalSetting( value );\n\t\t}\n\t\tcatch (Exception e) {\n\t\t\tthrow new AnnotationException( \"Unable to interpret CacheMode in named query hint: \" + queryName, e );\n\t\t}\n\t}\n\n\t@Nullable\n\tpublic QueryFlushMode getFlushMode() {\n\t\tfinal String value = getString( HibernateHints.HINT_FLUSH_MODE );\n\t\ttry {\n\t\t\treturn value == null\n\t\t\t\t\t? null\n\t\t\t\t\t: FlushModeTypeHelper.queryFlushModeFromHint( value );\n\t\t}\n\t\tcatch (MappingException e) {\n\t\t\tthrow new AnnotationException( \"Unable to interpret FlushMode in named query hint: \" + queryName, e );\n\t\t}\n\t}\n\n\t@Nullable\n\tpublic LockMode getLockMode(String query) {\n\t\tfinal var value = (String) hintsMap.get( HibernateHints.HINT_NATIVE_LOCK_MODE );\n\t\tif ( value == null ) {\n\t\t\treturn null;\n\t\t}\n\t\ttry {\n\t\t\treturn LockMode.fromExternalForm( value );\n\t\t}\n\t\tcatch ( MappingException e ) {\n\t\t\tthrow new AnnotationException( \"Unknown LockMode in hint: \" + query\n\t\t\t\t\t\t\t\t\t\t\t+ \":\" + HibernateHints.HINT_NATIVE_LOCK_MODE, e );\n\t\t}\n\t}\n","sourceCodeStart":134,"sourceCodeEnd":170,"githubUrl":"https://github.com/hibernate/hibernate-orm/blob/fad1729dce015f908198d57a8d80274a30f905a5/hibernate-core/src/main/java/org/hibernate/boot/model/internal/QueryHintDefinition.java#L134-L170","documentation":"Error \"Unable to interpret FlushMode in named query hint: \" + queryName\" thrown in hibernate/hibernate-orm.","triggerScenarios":"A named query (or its hints) is declared with missing or invalid values.","commonSituations":"@NamedQuery/@NamedNativeQuery without a name, both resultSetMapping and an inline mapping, or a hint value of the wrong type (boolean/int/CacheMode/FlushMode/LockMode).","solutions":["Use a valid FlushMode value (e.g. AUTO, COMMIT, ALWAYS, MANUAL) in the named query hint."],"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"}