添加@EnableWebMvc注解后Spring Boot应用无法启动求助

作为Spring Boot新手碰到这种配置冲突的问题确实挺闹心的，我来帮你拆解下核心原因和解决办法：

核心问题：@EnableWebMvc和Spring Boot自动配置的冲突 #

Spring Boot之所以好用，很大程度是因为它的自动配置机制——已经帮你默认配置好了Spring MVC的核心组件（比如视图解析器、静态资源映射、消息转换器等），对应的自动配置类是WebMvcAutoConfiguration。

而@EnableWebMvc注解的作用是完全接管Spring MVC的配置：它会导入DelegatingWebMvcConfiguration，直接禁用Spring Boot的WebMvcAutoConfiguration。这就导致原来默认的配置全部失效，如果你没有手动补充必要的配置，应用自然启动失败或者运行异常。

针对你的场景的解决办法 #

场景1：只想自定义部分Spring MVC配置（新手最常用） #

这种情况完全不需要加@EnableWebMvc，直接让你的配置类实现WebMvcConfigurer接口，重写你需要的方法即可。这样既保留Spring Boot的自动配置，又能添加自定义逻辑。

比如你的AppConfig.java可以改成这样：

@Configuration
public class AppConfig implements WebMvcConfigurer {
    // 举个例子：自定义JSP视图解析器
    @Override
    public void configureViewResolvers(ViewResolverRegistry registry) {
        registry.jsp("/WEB-INF/views/", ".jsp");
    }

    // 如果你还需要其他自定义，比如静态资源映射、拦截器等，直接重写对应方法
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/static/**")
                .addResourceLocations("classpath:/static/");
    }
}

场景2：确实需要完全接管Spring MVC配置（不推荐新手使用） #

如果你明确要禁用所有Spring Boot的Web自动配置，那必须手动补充所有必要的组件配置，不然应用会因为缺少核心Bean而启动失败。

比如添加@EnableWebMvc后，你需要手动注册视图解析器、静态资源映射等：

@Configuration
@EnableWebMvc
public class AppConfig {
    // 手动注册JSP视图解析器
    @Bean
    public InternalResourceViewResolver viewResolver() {
        InternalResourceViewResolver resolver = new InternalResourceViewResolver();
        resolver.setPrefix("/WEB-INF/views/");
        resolver.setSuffix(".jsp");
        return resolver;
    }

    // 手动配置静态资源访问路径
    @Bean
    public WebMvcConfigurer resourceConfigurer() {
        return new WebMvcConfigurer() {
            @Override
            public void addResourceHandlers(ResourceHandlerRegistry registry) {
                registry.addResourceHandler("/static/**")
                        .addResourceLocations("classpath:/static/");
            }
        };
    }

    // 其他必要配置，比如消息转换器、拦截器等都需要手动添加
}

额外排查点 #

结合你提到的其他文件，还有几个需要注意的地方：

• WebAppInitializer.java：Spring Boot应用不需要手动编写这个类，因为Spring Boot已经通过SpringBootServletInitializer（打包成WAR时）或者内嵌容器（默认JAR包）自动处理了Servlet上下文的初始化，手动写这个可能会和自动配置冲突，建议移除。
• 启动类（ClientMain.java/JspClientMain.java）：确保你的启动类正确标注了@SpringBootApplication注解，这是Spring Boot启动的核心入口：

  @SpringBootApplication
  public class ClientMain {
      public static void main(String[] args) {
          SpringApplication.run(ClientMain.class, args);
      }
  }
  

• 日志文件：如果还是有问题，仔细看日志里的具体错误信息（比如"Missing bean xxx"、"Could not resolve view"），这些信息能帮你精准定位缺少了哪些配置。

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