Spring Cloud调用/restart端点报无匹配RestartEndpoint Bean错误

算力阿峰

2026-8-26

问题根因

RestartEndpoint Bean 无法注入的核心原因是仅开启了Actuator层的端点开关，未开启Spring Cloud上下文层面的重启能力开关，该开关默认值为false，不会自动注册重启端点对应的Bean，和Eureka优先还是Config优先的启动顺序没有关系。

修复步骤

补全缺失的核心配置，在application.properties（或bootstrap.yml）中追加如下配置，原有已添加的配置不要删除，建议同时把用到的env、refresh端点也加入暴露列表：

management.endpoints.web.exposure.include=env,refresh,restart
management.endpoint.restart.enabled=true
# 缺失的核心开关：开启Spring Cloud上下文重启能力
spring.cloud.context.restart.enabled=true

编程注入时添加@Lazy注解延迟加载，避免Bean初始化顺序问题导致注入失败：

import org.springframework.cloud.context.restart.RestartEndpoint;
import org.springframework.context.annotation.Lazy;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;

@Component
public class AppRestartOperator {
    @Lazy
    @Autowired
    private RestartEndpoint restartEndpoint;

    public void triggerRestart() {
        restartEndpoint.restart();
    }
}

如果项目引入了Spring Security依赖，需要给Actuator端点添加放行规则（生产环境请替换为符合安全要求的权限校验逻辑），避免未授权访问导致端点调用失败、应用上下文销毁后无法正常重启：

import org.springframework.security.config.annotation.web.builders.HttpSecurity;
import org.springframework.security.config.annotation.web.configuration.EnableWebSecurity;
import org.springframework.security.config.annotation.web.configuration.WebSecurityConfigurerAdapter;

@EnableWebSecurity
public class ActuatorSecurityConfig extends WebSecurityConfigurerAdapter {
    @Override
    protected void configure(HttpSecurity http) throws Exception {
        http.authorizeRequests()
                .antMatchers("/actuator/**").permitAll()
                .anyRequest().authenticated()
                .and().csrf().ignoringAntMatchers("/actuator/**");
    }
}

调用HTTP端点时注意：/actuator/restart仅支持POST请求，使用GET请求会被拦截抛出异常。

验证流程

配置修改后重启应用，按如下顺序操作即可达到预期效果：

调用POST /actuator/env修改spring.application.name配置
调用POST /actuator/refresh，确认返回值中包含更新后的配置项
调用POST /actuator/restart，应用会自动刷新Spring上下文、加载Config Server的最新配置后完成重启，不会再抛出Bean找不到的错误。

内容的提问来源于stack exchange，提问作者user15499060