Support Hibernate @Any annotation in query derivation.

Added special handling for Hibernate's @Any annotation in QueryUtils to prevent IllegalArgumentException when deriving queries for properties annotated with @Any. Since @Any associations are not part of the JPA metamodel, they require special detection and handling using reflection.

The fix:
- Detects @Any annotated properties using reflection to avoid compile-time Hibernate dependency
- Returns the property path directly without metamodel validation for @Any properties
- Treats @Any associations as optional (requiring outer joins)
- Handles metamodel lookup failures gracefully when encountering @Any properties

This change allows Spring Data JPA repositories to use query derivation methods for entities containing @Any associations without throwing exceptions.

Fixes #2318

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: academey

spring-data-jpa/src/main/java/org/springframework/data/jpa/repository/query/QueryUtils.java

@@ -773,6 +773,13 @@ static <T> Expression<T> toExpressionRecursively(From<?, ?> from, PropertyPath p
 
 		boolean isLeafProperty = !property.hasNext();
 
+		// Check if this is a Hibernate @Any annotated property
+		if (isAnyAnnotatedProperty(from, property)) {
+			// For @Any associations, we need to handle them specially since they're not in the metamodel
+			// Simply return the path expression without further processing
+			return from.get(segment);
+		}
+
 		boolean requiresOuterJoin = requiresOuterJoin(from, property, isForSelection, hasRequiredOuterJoin);
 
 		// if it does not require an outer join and is a leaf, simply get the segment
@@ -816,6 +823,12 @@ static boolean requiresOuterJoin(From<?, ?> from, PropertyPath property, boolean
 			return false;
 		}
 
+		// Check if this is a @Any annotated property
+		if (isAnyAnnotatedProperty(from, property)) {
+			// @Any associations should be treated as optional associations
+			return true;
+		}
+
 		Bindable<?> model = from.getModel();
 		ManagedType<?> managedType = getManagedTypeForModel(model);
 		Bindable<?> propertyPathModel = getModelForPath(property, managedType, from);
@@ -827,6 +840,12 @@ static boolean requiresOuterJoin(From<?, ?> from, PropertyPath property, boolean
 			return true;
 		}
 
+		// If propertyPathModel is null, it might be a @Any association
+		if (propertyPathModel == null) {
+			// For @Any associations or other non-metamodel properties, default to outer join
+			return true;
+		}
+
 		if (!(propertyPathModel instanceof Attribute<?, ?> attribute)) {
 			return false;
 		}
@@ -969,10 +988,17 @@ static void checkSortExpression(Order order) {
 				return (Bindable<?>) managedType.getAttribute(segment);
 			} catch (IllegalArgumentException ex) {
 				// ManagedType may be erased for some vendor if the attribute is declared as generic
+				// or the attribute is not part of the metamodel (e.g., @Any annotation)
 			}
 		}
 
-		return fallback.get(segment).getModel();
+		try {
+			return fallback.get(segment).getModel();
+		} catch (IllegalArgumentException ex) {
+			// This can happen with @Any annotated properties as they're not in the metamodel
+			// Return null to indicate the property cannot be resolved through the metamodel
+			return null;
+		}
 	}
 
 	/**
@@ -996,4 +1022,48 @@ static void checkSortExpression(Order order) {
 
 		return singularAttribute.getType() instanceof ManagedType<?> managedType ? managedType : null;
 	}
+
+	/**
+	 * Checks if the given property path represents a property annotated with Hibernate's @Any annotation.
+	 * This is necessary because @Any associations are not present in the JPA metamodel.
+	 *
+	 * @param from the root from which to resolve the property
+	 * @param property the property path to check
+	 * @return true if the property is annotated with @Any, false otherwise
+	 * @since 4.0
+	 */
+	private static boolean isAnyAnnotatedProperty(From<?, ?> from, PropertyPath property) {
+		try {
+			// Get the Java type of the from clause
+			Class<?> javaType = from.getJavaType();
+			String propertyName = property.getSegment();
+			
+			// Try to find the field
+			Member member = null;
+			try {
+				member = javaType.getDeclaredField(propertyName);
+			} catch (NoSuchFieldException ex) {
+				// Try to find a getter method
+				String capitalizedProperty = propertyName.substring(0, 1).toUpperCase() + propertyName.substring(1);
+				try {
+					member = javaType.getDeclaredMethod("get" + capitalizedProperty);
+				} catch (NoSuchMethodException ex2) {
+					// Property not found
+					return false;
+				}
+			}
+			
+			if (member instanceof AnnotatedElement annotatedElement) {
+				// Check for Hibernate @Any annotation using reflection to avoid compile-time dependency
+				for (Annotation annotation : annotatedElement.getAnnotations()) {
+					if (annotation.annotationType().getName().equals("org.hibernate.annotations.Any")) {
+						return true;
+					}
+				}
+			}
+		} catch (Exception ex) {
+			// If anything goes wrong, assume it's not an @Any property
+		}
+		return false;
+	}
 }

spring-data-jpa/src/test/java/org/springframework/data/jpa/domain/sample/ConcreteMonitor1.java

@@ -0,0 +1,35 @@
+/*
+ * Copyright 2025 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.springframework.data.jpa.domain.sample;
+
+import jakarta.persistence.Entity;
+
+/**
+ * Concrete implementation of MonitorObject for @Any annotation testing.
+ */
+@Entity
+public class ConcreteMonitor1 extends MonitorObject {
+	
+	private String property1;
+	
+	public String getProperty1() {
+		return property1;
+	}
+	
+	public void setProperty1(String property1) {
+		this.property1 = property1;
+	}
+}

spring-data-jpa/src/test/java/org/springframework/data/jpa/domain/sample/ConcreteMonitor2.java

@@ -0,0 +1,35 @@
+/*
+ * Copyright 2025 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.springframework.data.jpa.domain.sample;
+
+import jakarta.persistence.Entity;
+
+/**
+ * Concrete implementation of MonitorObject for @Any annotation testing.
+ */
+@Entity
+public class ConcreteMonitor2 extends MonitorObject {
+	
+	private String property2;
+	
+	public String getProperty2() {
+		return property2;
+	}
+	
+	public void setProperty2(String property2) {
+		this.property2 = property2;
+	}
+}

spring-data-jpa/src/test/java/org/springframework/data/jpa/domain/sample/EntityWithAny.java

@@ -0,0 +1,75 @@
+/*
+ * Copyright 2025 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.springframework.data.jpa.domain.sample;
+
+import jakarta.persistence.Column;
+import jakarta.persistence.Entity;
+import jakarta.persistence.FetchType;
+import jakarta.persistence.GeneratedValue;
+import jakarta.persistence.GenerationType;
+import jakarta.persistence.Id;
+import jakarta.persistence.JoinColumn;
+
+import org.hibernate.annotations.Any;
+import org.hibernate.annotations.AnyDiscriminator;
+import org.hibernate.annotations.AnyDiscriminatorValue;
+import org.hibernate.annotations.AnyKeyJavaClass;
+
+/**
+ * Entity using @Any annotation for polymorphic association.
+ */
+@Entity
+public class EntityWithAny {
+
+	@Id
+	@GeneratedValue(strategy = GenerationType.IDENTITY)
+	private Long id;
+
+	@Any(fetch = FetchType.LAZY)
+	@AnyDiscriminator(org.hibernate.annotations.DiscriminatorType.INTEGER)
+	@AnyDiscriminatorValue(discriminator = "1", entity = ConcreteMonitor1.class)
+	@AnyDiscriminatorValue(discriminator = "2", entity = ConcreteMonitor2.class)
+	@AnyKeyJavaClass(String.class)
+	@Column(name = "monitor_type")
+	@JoinColumn(name = "monitor_name")
+	private MonitorObject monitorObject;
+
+	private String description;
+
+	public Long getId() {
+		return id;
+	}
+
+	public void setId(Long id) {
+		this.id = id;
+	}
+
+	public MonitorObject getMonitorObject() {
+		return monitorObject;
+	}
+
+	public void setMonitorObject(MonitorObject monitorObject) {
+		this.monitorObject = monitorObject;
+	}
+
+	public String getDescription() {
+		return description;
+	}
+
+	public void setDescription(String description) {
+		this.description = description;
+	}
+}

spring-data-jpa/src/test/java/org/springframework/data/jpa/domain/sample/MonitorObject.java

@@ -0,0 +1,37 @@
+/*
+ * Copyright 2025 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.springframework.data.jpa.domain.sample;
+
+import jakarta.persistence.Id;
+import jakarta.persistence.MappedSuperclass;
+
+/**
+ * Base class for monitor objects used in @Any annotation testing.
+ */
+@MappedSuperclass
+public abstract class MonitorObject {
+
+	@Id
+	protected String name;
+
+	public String getName() {
+		return name;
+	}
+
+	public void setName(String name) {
+		this.name = name;
+	}
+}