Spring MVC中DispatcherServlet初始化失败：Bean定义冲突问题

你的问题核心是Spring容器初始化时检测到冲突的Bean定义：两个全类名不同但类名相同的FirstController（分别在com.dmitryshvalev.springMVC.controllers和com.dmitryshvalev.springMVC.config.controllers包下），默认生成了同名的firstController Bean，Spring无法识别哪个是有效Bean，最终导致DispatcherServlet初始化失败。主页面正常是因为它未触发DispatcherServlet，而其他标签页的请求依赖该Servlet，所以抛出HTTP 500错误。

具体解决方案： #

• 重命名冲突类：直接修改其中一个Controller的类名，比如将com.dmitryshvalev.springMVC.config.controllers.FirstController改为ConfigFirstController，Spring默认会以类名首字母小写作为Bean名称，自动避免冲突。
• 显式指定Bean名称：如果不想修改类名，在其中一个Controller的@Controller注解里指定唯一名称：

  @Controller("configFirstController")
  public class FirstController {
      // 业务代码
  }
  

• 调整组件扫描范围：检查applicationContextMVC.xml中的组件扫描配置，确保只扫描需要的Controller包。比如只扫描根controllers包：

  <context:component-scan base-package="com.dmitryshvalev.springMVC.controllers"/>
  

• 排除冲突类：如果必须扫描父包，通过过滤规则排除其中一个冲突类：

  <context:component-scan base-package="com.dmitryshvalev.springMVC">
      <context:exclude-filter type="assignable" expression="com.dmitryshvalev.springMVC.config.controllers.FirstController"/>
  </context:component-scan>
  

解决后重启服务器，DispatcherServlet即可正常初始化，所有标签页功能将恢复正常。

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