Reject missing explicitly named queries.

Explicitly configured named queries must either be present in the configured
NamedQueries or resolvable through the EntityManager. Previously, a missing
@query(name = …) declaration could fall back to query derivation and expose a
misleading parameter binding error.

Closes #1731

Signed-off-by: 014-code <2402143478@qq.com>

Author: 014-code

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

@@ -171,7 +171,15 @@ protected RepositoryQuery resolveQuery(JpaQueryMethod method, JpaQueryConfigurat
 
 			RepositoryQuery query = NamedQuery.lookupFrom(method, em, configuration);
 
-			return query != null ? query : NO_QUERY;
+			if (query != null) {
+				return query;
+			}
+
+			if (method.hasAnnotatedQueryName()) {
+				throw QueryCreationException.create(method, String.format("Did not find named query '%s'", name));
+			}
+
+			return NO_QUERY;
 		}
 
 		private @Nullable DeclaredQuery getCountQuery(JpaQueryMethod method, NamedQueries namedQueries, EntityManager em) {

spring-data-jpa/src/test/java/org/springframework/data/jpa/repository/query/JpaQueryLookupStrategyUnitTests.java

@@ -153,6 +153,21 @@ void prefersDeclaredQuery() throws Exception {
 		assertThat(repositoryQuery).isInstanceOf(AbstractStringBasedJpaQuery.class);
 	}
 
+	@Test // DATAJPA-1417
+	void rejectsMissingExplicitNamedQuery() throws Exception {
+
+		QueryLookupStrategy strategy = JpaQueryLookupStrategy.create(em, queryMethodFactory, Key.CREATE_IF_NOT_FOUND,
+				CONFIG);
+		Method method = UserRepository.class.getMethod("annotatedQueryNameOnly", String.class, String.class, String.class);
+		RepositoryMetadata metadata = new DefaultRepositoryMetadata(UserRepository.class);
+
+		when(em.createNamedQuery("missing-query")).thenThrow(new IllegalArgumentException());
+
+		assertThatExceptionOfType(QueryCreationException.class)
+				.isThrownBy(() -> strategy.resolveQuery(method, metadata, projectionFactory, namedQueries))
+				.withMessageContaining("Did not find named query 'missing-query'");
+	}
+
 	@Test // GH-2018
 	void namedQueryWithSortShouldThrowIllegalStateException() throws NoSuchMethodException {
 
@@ -228,6 +243,9 @@ interface UserRepository extends Repository<User, Integer> {
 		@Query(value = "select foo from Foo foo", name = "my-query-name")
 		User annotatedQueryWithQueryAndQueryName();
 
+		@Query(name = "missing-query")
+		List<User> annotatedQueryNameOnly(String firstname, String lastname, String emailAddress);
+
 		@Query("SELECT * FROM table WHERE (json_col->'jsonKey')::jsonb \\?\\? :param ")
 		List<User> customQueryWithQuestionMarksAndNamedParam(String param);