{"record":{"id":"e8b2fb746dcc287b","repo":"hibernate/hibernate-orm","slug":"unknown-lockmode-in-hint-query-hibern","errorCode":null,"errorMessage":"Unknown LockMode in hint: \" + query + \":\" + HibernateHints.HINT_NATIVE_LOCK_MODE","messagePattern":"Unknown LockMode in hint: \" \\+ query \\+ \":\" \\+ HibernateHints\\.HINT_NATIVE_LOCK_MODE","errorType":"exception","errorClass":"AnnotationException","httpStatus":null,"severity":"error","filePath":"hibernate-core/src/main/java/org/hibernate/boot/model/internal/QueryHintDefinition.java","lineNumber":166,"sourceCode":"\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\n\t@Nonnull\n\tpublic LockOptions determineLockOptions(NamedQuery namedQueryAnnotation) {\n\t\treturn determineLockOptions( namedQueryAnnotation.lockMode(), specLockTimeout(), followOnStrategy() );\n\t}\n\n\t@Nullable\n\tprivate Integer specLockTimeout() {\n\t\tfinal Integer jakartaLockTimeout = getInteger( AvailableSettings.JAKARTA_LOCK_TIMEOUT );\n\t\tif ( jakartaLockTimeout != null ) {\n\t\t\treturn jakartaLockTimeout;\n\t\t}\n\n\t\treturn getInteger( AvailableSettings.JPA_LOCK_TIMEOUT );\n\t}","sourceCodeStart":148,"sourceCodeEnd":184,"githubUrl":"https://github.com/hibernate/hibernate-orm/blob/fad1729dce015f908198d57a8d80274a30f905a5/hibernate-core/src/main/java/org/hibernate/boot/model/internal/QueryHintDefinition.java#L148-L184","documentation":"Error \"Unknown LockMode in hint: \" + query + \":\" + HibernateHints.HINT_NATIVE_LOCK_MODE\" 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 LockMode value in the native lock mode 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"}