{"record":{"id":"d91dda40d6d9f0b3","repo":"hibernate/hibernate-orm","slug":"undefined-filter-parameter","errorCode":null,"errorMessage":"Undefined filter parameter '{}'","messagePattern":"Undefined filter parameter '(.+?)'","errorType":"exception","errorClass":"IllegalArgumentException","httpStatus":null,"severity":"error","filePath":"hibernate-core/src/main/java/org/hibernate/internal/FilterImpl.java","lineNumber":112,"sourceCode":"\t\treturn parameters == null ? emptyMap() : unmodifiableMap( parameters );\n\t}\n\n\t/**\n\t * Set the named parameter's value for this filter.\n\t *\n\t * @param name The parameter's name.\n\t * @param value The value to be applied.\n\t * @return This FilterImpl instance (for method chaining).\n\t * @throws IllegalArgumentException Indicates that either the parameter was undefined or that the type\n\t * of the passed value did not match the configured type.\n\t */\n\tpublic Filter setParameter(String name, Object value) throws IllegalArgumentException {\n\t\tfinal Object argument = definition.processArgument( value );\n\n\t\t// Make sure this is a defined parameter and check the incoming value type\n\t\tfinal var type = definition.getParameterJdbcMapping( name );\n\t\tif ( type == null ) {\n\t\t\tthrow new IllegalArgumentException( \"Undefined filter parameter '\" + name + \"'\" );\n\t\t}\n\t\tif ( argument != null && !type.getJavaTypeDescriptor().isInstance( argument ) ) {\n\t\t\tthrow new IllegalArgumentException( \"Argument assigned to filter parameter '\" + name\n\t\t\t\t\t+ \"' is not of type '\" + type.getJavaTypeDescriptor().getTypeName() + \"'\" );\n\t\t}\n\t\tif ( parameters == null ) {\n\t\t\tparameters = new TreeMap<>();\n\t\t}\n\t\tparameters.put( name, argument );\n\t\tvalidated = false;\n\t\treturn this;\n\t}\n\n\t/**\n\t * Set the named parameter's value list for this filter.  Used\n\t * in conjunction with IN-style filter criteria.\n\t *\n\t * @param name   The parameter's name.","sourceCodeStart":94,"sourceCodeEnd":130,"githubUrl":"https://github.com/hibernate/hibernate-orm/blob/fad1729dce015f908198d57a8d80274a30f905a5/hibernate-core/src/main/java/org/hibernate/internal/FilterImpl.java#L94-L130","documentation":"Error \"Undefined filter parameter '{}'\" thrown in hibernate/hibernate-orm.","triggerScenarios":"Thrown when a filter is given a parameter that is not declared, of the wrong type, or lacking a value.","commonSituations":"Typical situations: typos in filter parameter names; setting a parameter of an incompatible Java type; forgetting to bind a parameter before running the query.","solutions":["Declare the parameter in the @FilterDef/@Filter definition, or fix the parameter name passed to setParameter."],"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"}