Support configuring bean names as well as bean types for extra-refreshable and never-refreshable (#1457)

Thanks to https://github.com/spring-projects/spring-boot/issues/22403, applications could define a bean in addition to an auto-configured bean of the same type, then we should support configuring bean names for fine-grained control.

Signed-off-by: Yanming Zhou <zhouyanming@gmail.com>

docs/modules/ROOT/partials/_configprops.adoc

@@ -76,8 +76,8 @@
 |spring.cloud.loadbalancer.zone |  | Spring Cloud LoadBalancer zone.
 |spring.cloud.refresh.additional-property-sources-to-retain |  | Additional property sources to retain during a refresh. Typically only system property sources are retained. This property allows property sources, such as property sources created by EnvironmentPostProcessors to be retained as well.
 |spring.cloud.refresh.enabled | `+++true+++` | Enables autoconfiguration for the refresh scope and associated features.
-|spring.cloud.refresh.extra-refreshable | `+++true+++` | Additional class names for beans to post process into refresh scope.
-|spring.cloud.refresh.never-refreshable | `+++true+++` | Comma separated list of class names for beans to never be refreshed or rebound.
+|spring.cloud.refresh.extra-refreshable | `+++true+++` | Additional bean names or class names for beans to post process into refresh scope.
+|spring.cloud.refresh.never-refreshable | `+++true+++` | Comma separated list of bean names or class names for beans to never be refreshed or rebound.
 |spring.cloud.refresh.on-restart.enabled | `+++true+++` | Enable refreshing context on start.
 |spring.cloud.service-registry.auto-registration.enabled | `+++true+++` | Whether service auto-registration is enabled. Defaults to true.
 |spring.cloud.service-registry.auto-registration.fail-fast | `+++false+++` | Whether startup fails if there is no AutoServiceRegistration. Defaults to false.

spring-cloud-context/src/main/java/org/springframework/cloud/autoconfigure/RefreshAutoConfiguration.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2012-2020 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.
@@ -63,6 +63,7 @@ import org.springframework.util.StringUtils;
  * @author Dave Syer
  * @author Venil Noronha
  * @author Olga Maciaszek-Sharma
+ * @author Yanming Zhou
  */
 @Configuration(proxyBeanMethods = false)
 @ConditionalOnClass(RefreshScope.class)
@@ -209,6 +210,9 @@ public class RefreshAutoConfiguration {
 				// Already refresh scoped
 				return false;
 			}
+			if (this.refreshables.contains(name)) {
+				return true;
+			}
 			String type = definition.getBeanClassName();
 			if (!StringUtils.hasText(type) && registry instanceof BeanFactory) {
 				Class<?> cls = ((BeanFactory) registry).getType(name);

spring-cloud-context/src/main/java/org/springframework/cloud/context/properties/ConfigurationPropertiesRebinder.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2012-2020 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.
@@ -47,6 +47,7 @@ import org.springframework.util.StringUtils;
  * the <code>@ConfigurationProperties</code> bean.
  *
  * @author Dave Syer
+ * @author Yanming Zhou
  * @see RefreshScope for a deeper and optionally more focused refresh of bean components.
  *
  */
@@ -131,7 +132,7 @@ public class ConfigurationPropertiesRebinder
 				// TODO: determine a more general approach to fix this.
 				// see
 				// https://github.com/spring-cloud/spring-cloud-commons/issues/571
-				if (getNeverRefreshable().contains(bean.getClass().getName())) {
+				if (getNeverRefreshable().contains(bean.getClass().getName()) || getNeverRefreshable().contains(name)) {
 					return false; // ignore
 				}
 				appContext.getAutowireCapableBeanFactory().destroyBean(bean);

spring-cloud-context/src/main/resources/META-INF/additional-spring-configuration-metadata.json

@@ -39,13 +39,13 @@
 		{
 			"name": "spring.cloud.refresh.extra-refreshable",
 			"type": "java.util.Set<java.lang.String>",
-			"description": "Additional class names for beans to post process into refresh scope.",
+			"description": "Additional bean names or class names for beans to post process into refresh scope.",
 			"defaultValue": true
 		},
 		{
 			"name": "spring.cloud.refresh.never-refreshable",
 			"type": "java.lang.String",
-			"description": "Comma separated list of class names for beans to never be refreshed or rebound.",
+			"description": "Comma separated list of bean names or class names for beans to never be refreshed or rebound.",
 			"defaultValue": true
 		},
 		{

spring-cloud-context/src/test/java/org/springframework/cloud/autoconfigure/RefreshAutoConfigurationTests.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2012-2020 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.
@@ -41,6 +41,7 @@ import static org.assertj.core.api.BDDAssertions.then;
 /**
  * @author Dave Syer
  * @author Olga Maciaszek-Sharma
+ * @author Yanming Zhou
  */
 @ExtendWith(OutputCaptureExtension.class)
 class RefreshAutoConfigurationTests {
@@ -79,7 +80,7 @@ class RefreshAutoConfigurationTests {
 	}
 
 	@Test
-	public void extraRefreshables() {
+	public void extraRefreshableWithClassName() {
 		try (ConfigurableApplicationContext context = getApplicationContext(WebApplicationType.NONE, Config.class,
 				"sealedconfig.foo=bar",
 				"spring.cloud.refresh.extra-refreshable:" + SealedConfigProps.class.getName())) {
@@ -89,7 +90,17 @@ class RefreshAutoConfigurationTests {
 	}
 
 	@Test
-	void neverRefreshable() {
+	public void extraRefreshableWithBeanName() {
+		String beanName = "sealedconfig-" + SealedConfigProps.class.getName();
+		try (ConfigurableApplicationContext context = getApplicationContext(WebApplicationType.NONE, Config.class,
+				"sealedconfig.foo=bar", "spring.cloud.refresh.extra-refreshable:" + beanName)) {
+			context.getBean(SealedConfigProps.class);
+			context.getBean(ContextRefresher.class).refresh();
+		}
+	}
+
+	@Test
+	void neverRefreshableWithClassName() {
 		try (ConfigurableApplicationContext context = getApplicationContext(WebApplicationType.NONE, Config.class,
 				"countingconfig.foo=bar",
 				"spring.cloud.refresh.never-refreshable:" + CountingConfigProps.class.getName())) {
@@ -99,6 +110,17 @@ class RefreshAutoConfigurationTests {
 		}
 	}
 
+	@Test
+	void neverRefreshableWithBeanName() {
+		String beanName = "countingconfig-" + CountingConfigProps.class.getName();
+		try (ConfigurableApplicationContext context = getApplicationContext(WebApplicationType.NONE, Config.class,
+				"countingconfig.foo=bar", "spring.cloud.refresh.never-refreshable:" + beanName)) {
+			CountingConfigProps configProps = context.getBean(CountingConfigProps.class);
+			context.getBean(ContextRefresher.class).refresh();
+			assertThat(configProps.count).as("config props was rebound when it should not have been").hasValue(1);
+		}
+	}
+
 	@Test
 	void refreshScopeLifecylePresentByDefault() {
 		new ApplicationContextRunner().withConfiguration(AutoConfigurations.of(RefreshAutoConfiguration.class))