Enforce using @ConfigurationProperties("xxx") instead of @ConfigurationProperties(prefix = "xxx")

buildSrc/src/main/java/org/springframework/boot/build/architecture/ArchitectureCheck.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2012-2024 the original author or authors.
+ * Copyright 2012-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.
@@ -39,6 +39,7 @@
 import com.tngtech.archunit.core.domain.JavaParameter;
 import com.tngtech.archunit.core.domain.JavaType;
 import com.tngtech.archunit.core.domain.properties.CanBeAnnotated;
+import com.tngtech.archunit.core.domain.properties.HasAnnotations;
 import com.tngtech.archunit.core.domain.properties.HasName;
 import com.tngtech.archunit.core.domain.properties.HasOwner.Predicates.With;
 import com.tngtech.archunit.core.domain.properties.HasParameterTypes;
@@ -95,7 +96,9 @@ public ArchitectureCheck() {
 				noClassesShouldLoadResourcesUsingResourceUtils(), noClassesShouldCallStringToUpperCaseWithoutLocale(),
 				noClassesShouldCallStringToLowerCaseWithoutLocale(),
 				conditionalOnMissingBeanShouldNotSpecifyOnlyATypeThatIsTheSameAsMethodReturnType(),
-				enumSourceShouldNotSpecifyOnlyATypeThatIsTheSameAsMethodParameterType());
+				enumSourceShouldNotSpecifyOnlyATypeThatIsTheSameAsMethodParameterType(),
+				classLevelConfigurationPropertiesShouldNotSpecifyOnlyPrefixAttribute(),
+				methodLevelConfigurationPropertiesShouldNotSpecifyOnlyPrefixAttribute());
 		getRules().addAll(getProhibitObjectsRequireNonNull()
 			.map((prohibit) -> prohibit ? noClassesShouldCallObjectsRequireNonNull() : Collections.emptyList()));
 		getRuleDescriptions().set(getRules().map((rules) -> rules.stream().map(ArchRule::getDescription).toList()));
@@ -329,6 +332,39 @@ public void check(JavaMethod item, ConditionEvents events) {
 		};
 	}
 
+	private ArchRule classLevelConfigurationPropertiesShouldNotSpecifyOnlyPrefixAttribute() {
+		return ArchRuleDefinition.classes()
+			.that()
+			.areAnnotatedWith("org.springframework.boot.context.properties.ConfigurationProperties")
+			.should(notSpecifyOnlyPrefixAttributeOfConfigurationProperties())
+			.allowEmptyShould(true);
+	}
+
+	private ArchRule methodLevelConfigurationPropertiesShouldNotSpecifyOnlyPrefixAttribute() {
+		return ArchRuleDefinition.methods()
+			.that()
+			.areAnnotatedWith("org.springframework.boot.context.properties.ConfigurationProperties")
+			.should(notSpecifyOnlyPrefixAttributeOfConfigurationProperties())
+			.allowEmptyShould(true);
+	}
+
+	private ArchCondition<? super HasAnnotations<?>> notSpecifyOnlyPrefixAttributeOfConfigurationProperties() {
+		return new ArchCondition<>("not specify only prefix attribute of @ConfigurationProperties") {
+
+			@Override
+			public void check(HasAnnotations<?> item, ConditionEvents events) {
+				JavaAnnotation<?> configurationProperties = item
+					.getAnnotationOfType("org.springframework.boot.context.properties.ConfigurationProperties");
+				Map<String, Object> properties = configurationProperties.getProperties();
+				if (properties.size() == 1 && properties.containsKey("prefix")) {
+					events.add(SimpleConditionEvent.violated(item, configurationProperties.getDescription()
+							+ " should specify implicit 'value' attribute other than explicit 'prefix' attribute"));
+				}
+			}
+
+		};
+	}
+
 	public void setClasses(FileCollection classes) {
 		this.classes = classes;
 	}

spring-boot-project/spring-boot-actuator-autoconfigure/src/main/java/org/springframework/boot/actuate/autoconfigure/endpoint/web/CorsEndpointProperties.java

@@ -33,7 +33,7 @@
  * @author Andy Wilkinson
  * @since 2.0.0
  */
-@ConfigurationProperties(prefix = "management.endpoints.web.cors")
+@ConfigurationProperties("management.endpoints.web.cors")
 public class CorsEndpointProperties {
 
 	/**

spring-boot-project/spring-boot-actuator-autoconfigure/src/main/java/org/springframework/boot/actuate/autoconfigure/endpoint/web/WebEndpointProperties.java

@@ -32,7 +32,7 @@
  * @author Phillip Webb
  * @since 2.0.0
  */
-@ConfigurationProperties(prefix = "management.endpoints.web")
+@ConfigurationProperties("management.endpoints.web")
 public class WebEndpointProperties {
 
 	private final Exposure exposure = new Exposure();

spring-boot-project/spring-boot-actuator-autoconfigure/src/main/java/org/springframework/boot/actuate/autoconfigure/jdbc/DataSourceHealthIndicatorProperties.java

@@ -25,7 +25,7 @@
  * @author Julio Gomez
  * @since 2.4.0
  */
-@ConfigurationProperties(prefix = "management.health.db")
+@ConfigurationProperties("management.health.db")
 public class DataSourceHealthIndicatorProperties {
 
 	/**

spring-boot-project/spring-boot-actuator-autoconfigure/src/main/java/org/springframework/boot/actuate/autoconfigure/logging/LogFileWebEndpointProperties.java

@@ -27,7 +27,7 @@
  * @author Stephane Nicoll
  * @since 2.0.0
  */
-@ConfigurationProperties(prefix = "management.endpoint.logfile")
+@ConfigurationProperties("management.endpoint.logfile")
 public class LogFileWebEndpointProperties {
 
 	/**

spring-boot-project/spring-boot-actuator-autoconfigure/src/main/java/org/springframework/boot/actuate/autoconfigure/metrics/export/appoptics/AppOpticsProperties.java

@@ -28,7 +28,7 @@
  * @author Stephane Nicoll
  * @since 2.1.0
  */
-@ConfigurationProperties(prefix = "management.appoptics.metrics.export")
+@ConfigurationProperties("management.appoptics.metrics.export")
 public class AppOpticsProperties extends StepRegistryProperties {
 
 	/**

spring-boot-project/spring-boot-actuator-autoconfigure/src/main/java/org/springframework/boot/actuate/autoconfigure/metrics/export/atlas/AtlasProperties.java

@@ -28,7 +28,7 @@
  * @author Stephane Nicoll
  * @since 2.0.0
  */
-@ConfigurationProperties(prefix = "management.atlas.metrics.export")
+@ConfigurationProperties("management.atlas.metrics.export")
 public class AtlasProperties {
 
 	/**

spring-boot-project/spring-boot-actuator-autoconfigure/src/main/java/org/springframework/boot/actuate/autoconfigure/metrics/export/datadog/DatadogProperties.java

@@ -27,7 +27,7 @@
  * @author Stephane Nicoll
  * @since 2.0.0
  */
-@ConfigurationProperties(prefix = "management.datadog.metrics.export")
+@ConfigurationProperties("management.datadog.metrics.export")
 public class DatadogProperties extends StepRegistryProperties {
 
 	/**

spring-boot-project/spring-boot-actuator-autoconfigure/src/main/java/org/springframework/boot/actuate/autoconfigure/metrics/export/dynatrace/DynatraceProperties.java

@@ -29,7 +29,7 @@
  * @author Georg Pirklbauer
  * @since 2.1.0
  */
-@ConfigurationProperties(prefix = "management.dynatrace.metrics.export")
+@ConfigurationProperties("management.dynatrace.metrics.export")
 public class DynatraceProperties extends StepRegistryProperties {
 
 	private final V1 v1 = new V1();

spring-boot-project/spring-boot-actuator-autoconfigure/src/main/java/org/springframework/boot/actuate/autoconfigure/metrics/export/elastic/ElasticProperties.java

@@ -26,7 +26,7 @@
  * @author Andy Wilkinson
  * @since 2.1.0
  */
-@ConfigurationProperties(prefix = "management.elastic.metrics.export")
+@ConfigurationProperties("management.elastic.metrics.export")
 public class ElasticProperties extends StepRegistryProperties {
 
 	/**

spring-boot-project/spring-boot-actuator-autoconfigure/src/main/java/org/springframework/boot/actuate/autoconfigure/metrics/export/ganglia/GangliaProperties.java

@@ -31,7 +31,7 @@
  * @author Stephane Nicoll
  * @since 2.0.0
  */
-@ConfigurationProperties(prefix = "management.ganglia.metrics.export")
+@ConfigurationProperties("management.ganglia.metrics.export")
 public class GangliaProperties {
 
 	/**

spring-boot-project/spring-boot-actuator-autoconfigure/src/main/java/org/springframework/boot/actuate/autoconfigure/metrics/export/graphite/GraphiteProperties.java

@@ -32,7 +32,7 @@
  * @author Stephane Nicoll
  * @since 2.0.0
  */
-@ConfigurationProperties(prefix = "management.graphite.metrics.export")
+@ConfigurationProperties("management.graphite.metrics.export")
 public class GraphiteProperties {
 
 	/**

spring-boot-project/spring-boot-actuator-autoconfigure/src/main/java/org/springframework/boot/actuate/autoconfigure/metrics/export/humio/HumioProperties.java

@@ -30,7 +30,7 @@
  * @author Andy Wilkinson
  * @since 2.1.0
  */
-@ConfigurationProperties(prefix = "management.humio.metrics.export")
+@ConfigurationProperties("management.humio.metrics.export")
 public class HumioProperties extends StepRegistryProperties {
 
 	/**

spring-boot-project/spring-boot-actuator-autoconfigure/src/main/java/org/springframework/boot/actuate/autoconfigure/metrics/export/influx/InfluxProperties.java

@@ -30,7 +30,7 @@
  * @author Stephane Nicoll
  * @since 2.0.0
  */
-@ConfigurationProperties(prefix = "management.influx.metrics.export")
+@ConfigurationProperties("management.influx.metrics.export")
 public class InfluxProperties extends StepRegistryProperties {
 
 	/**

spring-boot-project/spring-boot-actuator-autoconfigure/src/main/java/org/springframework/boot/actuate/autoconfigure/metrics/export/jmx/JmxProperties.java

@@ -28,7 +28,7 @@
  * @author Stephane Nicoll
  * @since 2.0.0
  */
-@ConfigurationProperties(prefix = "management.jmx.metrics.export")
+@ConfigurationProperties("management.jmx.metrics.export")
 public class JmxProperties {
 
 	/**

spring-boot-project/spring-boot-actuator-autoconfigure/src/main/java/org/springframework/boot/actuate/autoconfigure/metrics/export/kairos/KairosProperties.java

@@ -26,7 +26,7 @@
  * @author Stephane Nicoll
  * @since 2.1.0
  */
-@ConfigurationProperties(prefix = "management.kairos.metrics.export")
+@ConfigurationProperties("management.kairos.metrics.export")
 public class KairosProperties extends StepRegistryProperties {
 
 	/**

spring-boot-project/spring-boot-actuator-autoconfigure/src/main/java/org/springframework/boot/actuate/autoconfigure/metrics/export/newrelic/NewRelicProperties.java

@@ -31,7 +31,7 @@
  * @author Neil Powell
  * @since 2.0.0
  */
-@ConfigurationProperties(prefix = "management.newrelic.metrics.export")
+@ConfigurationProperties("management.newrelic.metrics.export")
 public class NewRelicProperties extends StepRegistryProperties {
 
 	/**

spring-boot-project/spring-boot-actuator-autoconfigure/src/main/java/org/springframework/boot/actuate/autoconfigure/metrics/export/otlp/OtlpMetricsProperties.java

@@ -34,7 +34,7 @@
  * @author Jonatan Ivanov
  * @since 3.4.0
  */
-@ConfigurationProperties(prefix = "management.otlp.metrics.export")
+@ConfigurationProperties("management.otlp.metrics.export")
 public class OtlpMetricsProperties extends StepRegistryProperties {
 
 	/**

spring-boot-project/spring-boot-actuator-autoconfigure/src/main/java/org/springframework/boot/actuate/autoconfigure/metrics/export/prometheus/PrometheusProperties.java

@@ -31,7 +31,7 @@
  * @author Stephane Nicoll
  * @since 2.0.0
  */
-@ConfigurationProperties(prefix = "management.prometheus.metrics.export")
+@ConfigurationProperties("management.prometheus.metrics.export")
 public class PrometheusProperties {
 
 	/**

spring-boot-project/spring-boot-actuator-autoconfigure/src/main/java/org/springframework/boot/actuate/autoconfigure/metrics/export/signalfx/SignalFxProperties.java

@@ -30,7 +30,7 @@
  * @author Stephane Nicoll
  * @since 2.0.0
  */
-@ConfigurationProperties(prefix = "management.signalfx.metrics.export")
+@ConfigurationProperties("management.signalfx.metrics.export")
 public class SignalFxProperties extends StepRegistryProperties {
 
 	/**

spring-boot-project/spring-boot-actuator-autoconfigure/src/main/java/org/springframework/boot/actuate/autoconfigure/metrics/export/simple/SimpleProperties.java

@@ -31,7 +31,7 @@
  * @author Stephane Nicoll
  * @since 2.0.0
  */
-@ConfigurationProperties(prefix = "management.simple.metrics.export")
+@ConfigurationProperties("management.simple.metrics.export")
 public class SimpleProperties {
 
 	/**

spring-boot-project/spring-boot-actuator-autoconfigure/src/main/java/org/springframework/boot/actuate/autoconfigure/metrics/export/stackdriver/StackdriverProperties.java

@@ -29,7 +29,7 @@
  * @author Stephane Nicoll
  * @since 2.3.0
  */
-@ConfigurationProperties(prefix = "management.stackdriver.metrics.export")
+@ConfigurationProperties("management.stackdriver.metrics.export")
 public class StackdriverProperties extends StepRegistryProperties {
 
 	/**

spring-boot-project/spring-boot-actuator-autoconfigure/src/main/java/org/springframework/boot/actuate/autoconfigure/metrics/export/statsd/StatsdProperties.java

@@ -31,7 +31,7 @@
  * @author Stephane Nicoll
  * @since 2.0.0
  */
-@ConfigurationProperties(prefix = "management.statsd.metrics.export")
+@ConfigurationProperties("management.statsd.metrics.export")
 public class StatsdProperties {
 
 	/**

spring-boot-project/spring-boot-actuator-autoconfigure/src/main/java/org/springframework/boot/actuate/autoconfigure/opentelemetry/OpenTelemetryProperties.java

@@ -27,7 +27,7 @@
  * @author Moritz Halbritter
  * @since 3.2.0
  */
-@ConfigurationProperties(prefix = "management.opentelemetry")
+@ConfigurationProperties("management.opentelemetry")
 public class OpenTelemetryProperties {
 
 	/**

spring-boot-project/spring-boot-actuator-autoconfigure/src/main/java/org/springframework/boot/actuate/autoconfigure/ssl/SslHealthIndicatorProperties.java

@@ -27,7 +27,7 @@
  * @author Jonatan Ivanov
  * @since 3.4.0
  */
-@ConfigurationProperties(prefix = "management.health.ssl")
+@ConfigurationProperties("management.health.ssl")
 public class SslHealthIndicatorProperties {
 
 	/**

spring-boot-project/spring-boot-actuator-autoconfigure/src/main/java/org/springframework/boot/actuate/autoconfigure/system/DiskSpaceHealthIndicatorProperties.java

@@ -30,7 +30,7 @@
  * @author Stephane Nicoll
  * @since 1.2.0
  */
-@ConfigurationProperties(prefix = "management.health.diskspace")
+@ConfigurationProperties("management.health.diskspace")
 public class DiskSpaceHealthIndicatorProperties {
 
 	/**

spring-boot-project/spring-boot-actuator-autoconfigure/src/main/java/org/springframework/boot/actuate/autoconfigure/wavefront/WavefrontProperties.java

@@ -39,7 +39,7 @@
  * @author Glenn Oppegard
  * @since 3.0.0
  */
-@ConfigurationProperties(prefix = "management.wavefront")
+@ConfigurationProperties("management.wavefront")
 public class WavefrontProperties {
 
 	/**

spring-boot-project/spring-boot-actuator-autoconfigure/src/main/java/org/springframework/boot/actuate/autoconfigure/web/exchanges/HttpExchangesProperties.java

@@ -32,7 +32,7 @@
  * @author Stephane Nicoll
  * @since 2.0.0
  */
-@ConfigurationProperties(prefix = "management.httpexchanges")
+@ConfigurationProperties("management.httpexchanges")
 public class HttpExchangesProperties {
 
 	private final Recording recording = new Recording();

spring-boot-project/spring-boot-actuator-autoconfigure/src/test/java/org/springframework/boot/actuate/autoconfigure/jdbc/DataSourceHealthContributorAutoConfigurationTests.java

@@ -216,7 +216,7 @@ void runWhenDataSourceHasNullRoutingKeyShouldProduceUnnamedComposedIndicator() {
 	static class DataSourceConfig {
 
 		@Bean
-		@ConfigurationProperties(prefix = "spring.datasource.test")
+		@ConfigurationProperties("spring.datasource.test")
 		DataSource testDataSource() {
 			return DataSourceBuilder.create()
 				.type(org.apache.tomcat.jdbc.pool.DataSource.class)

spring-boot-project/spring-boot-actuator/src/main/java/org/springframework/boot/actuate/sbom/SbomProperties.java

@@ -28,7 +28,7 @@
  * @author Moritz Halbritter
  * @since 3.3.0
  */
-@ConfigurationProperties(prefix = "management.endpoint.sbom")
+@ConfigurationProperties("management.endpoint.sbom")
 public class SbomProperties {
 
 	/**

spring-boot-project/spring-boot-actuator/src/test/java/org/springframework/boot/actuate/context/properties/ConfigurationPropertiesReportEndpointFilteringTests.java

@@ -163,13 +163,13 @@ ConfigurationPropertiesReportEndpoint endpoint() {
 	static class BaseConfiguration {
 
 		@Bean
-		@ConfigurationProperties(prefix = "foo.primary")
+		@ConfigurationProperties("foo.primary")
 		Foo primaryFoo() {
 			return new Foo();
 		}
 
 		@Bean
-		@ConfigurationProperties(prefix = "foo.secondary")
+		@ConfigurationProperties("foo.secondary")
 		Foo secondaryFoo() {
 			return new Foo();
 		}
@@ -190,7 +190,7 @@ public void setName(String name) {
 
 	}
 
-	@ConfigurationProperties(prefix = "only.bar")
+	@ConfigurationProperties("only.bar")
 	public static class Bar {
 
 		private String name = "123456";

spring-boot-project/spring-boot-actuator/src/test/java/org/springframework/boot/actuate/context/properties/ConfigurationPropertiesReportEndpointMethodAnnotationsTests.java

@@ -89,13 +89,13 @@ ConfigurationPropertiesReportEndpoint endpoint() {
 		}
 
 		@Bean
-		@ConfigurationProperties(prefix = "first")
+		@ConfigurationProperties("first")
 		Foo foo() {
 			return new Foo();
 		}
 
 		@Bean
-		@ConfigurationProperties(prefix = "other")
+		@ConfigurationProperties("other")
 		Foo other() {
 			return new Foo();
 		}
@@ -112,7 +112,7 @@ ConfigurationPropertiesReportEndpoint endpoint() {
 		}
 
 		@Bean
-		@ConfigurationProperties(prefix = "other")
+		@ConfigurationProperties("other")
 		Bar bar() {
 			return new Bar();
 		}
@@ -133,7 +133,7 @@ public void setName(String name) {
 
 	}
 
-	@ConfigurationProperties(prefix = "test")
+	@ConfigurationProperties("test")
 	public static class Bar {
 
 		private String name = "654321";