Spring Boot启动报错FatalBeanException：EmbeddedServletContainerFactory无法实例化

根本原因 #

你遇到的这个错误核心和独立管理端口+匿名内部类的组合有关：

当你配置了management.port和server.port不同的独立端口时，Spring Boot的EndpointWebMvcAutoConfiguration会创建一个子管理上下文来单独处理监控端点请求。这个过程需要实例化EmbeddedServletContainerFactory的实现类，但你用的是匿名内部类（ConnectorConfig$1）——匿名内部类默认是非静态的，会持有外部类ConnectorConfig的实例引用。

子上下文在初始化Bean时无法处理这种依赖外部类实例的非静态内部类，因为子上下文的Bean创建逻辑不支持这种嵌套的实例依赖关系，所以抛出了“无法实例化”的错误。

而你发现直接new TomcatEmbeddedServletContainerFactory()能正常启动，是因为这是Spring提供的顶级类，没有任何外部类依赖，子上下文可以毫无障碍地实例化它。

修复方案 #

有两种简洁的修复方式，核心都是让TomcatEmbeddedServletContainerFactory的实现类摆脱对外部类实例的依赖：

方案1：改用静态内部类

把原来的匿名内部类改成静态内部类，静态内部类不会持有外部类的实例引用，子上下文可以正常实例化它：

@Configuration
public class ConnectorConfig {
    @Value("${server.port}")
    private Integer port;

    @Bean
    public TomcatEmbeddedServletContainerFactory servletContainer() {
        CustomTomcatContainerFactory tomcat = new CustomTomcatContainerFactory();
        // 保留原有配置逻辑
        tomcat.addAdditionalTomcatConnectors(getHttpConnector());
        tomcat.addConnectorCustomizers((TomcatConnectorCustomizer) connector -> {
            if ((connector.getProtocolHandler() instanceof AbstractHttp11Protocol<?>)) {
                ((AbstractHttp11Protocol<?>) connector.getProtocolHandler()).setMaxSwallowSize(-1);
            }
        });
        return tomcat;
    }

    // 你的getHttpConnector实现保持不变
    private Connector getHttpConnector() {
        Connector connector = new Connector("org.apache.coyote.http11.Http11NioProtocol");
        connector.setScheme("http");
        connector.setPort(port);
        connector.setSecure(false);
        connector.setRedirectPort(8443); // 根据你的实际HTTPS端口调整
        return connector;
    }

    // 静态内部类实现自定义逻辑
    private static class CustomTomcatContainerFactory extends TomcatEmbeddedServletContainerFactory {
        @Override
        protected void postProcessContext(Context context) {
            SecurityConstraint securityConstraint = new SecurityConstraint();
            securityConstraint.setUserConstraint("CONFIDENTIAL");
            SecurityCollection collection = new SecurityCollection();
            collection.addPattern("/*");
            securityConstraint.addCollection(collection);
            context.addConstraint(securityConstraint);
        }
    }
}

方案2：提取为独立顶级类

把自定义的容器工厂逻辑抽成一个单独的顶级类，彻底消除内部类的依赖问题：

首先创建独立类：

public class CustomTomcatContainerFactory extends TomcatEmbeddedServletContainerFactory {
    @Override
    protected void postProcessContext(Context context) {
        SecurityConstraint securityConstraint = new SecurityConstraint();
        securityConstraint.setUserConstraint("CONFIDENTIAL");
        SecurityCollection collection = new SecurityCollection();
        collection.addPattern("/*");
        securityConstraint.addCollection(collection);
        context.addConstraint(securityConstraint);
    }
}

然后在ConnectorConfig中使用：

@Configuration
public class ConnectorConfig {
    @Value("${server.port}")
    private Integer port;

    @Bean
    public TomcatEmbeddedServletContainerFactory servletContainer() {
        CustomTomcatContainerFactory tomcat = new CustomTomcatContainerFactory();
        tomcat.addAdditionalTomcatConnectors(getHttpConnector());
        tomcat.addConnectorCustomizers((TomcatConnectorCustomizer) connector -> {
            if ((connector.getProtocolHandler() instanceof AbstractHttp11Protocol<?>)) {
                ((AbstractHttp11Protocol<?>) connector.getProtocolHandler()).setMaxSwallowSize(-1);
            }
        });
        return tomcat;
    }

    private Connector getHttpConnector() {
        Connector connector = new Connector("org.apache.coyote.http11.Http11NioProtocol");
        connector.setScheme("http");
        connector.setPort(port);
        connector.setSecure(false);
        connector.setRedirectPort(8443);
        return connector;
    }
}

两种方案都能解决问题，你可以根据代码结构偏好选择其中一种。

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