SpringMVC实例化ThymeleafView失败及后续404问题求助

看起来你遇到的是两个关联的配置问题，我来一步步帮你拆解解决：

一、解决Controller返回Thymeleaf视图时的500错误（无法实例化ThymeleafView） #

这个问题大概率是Thymeleaf依赖不全或者SpringMVC视图解析器配置错误导致的，按以下步骤排查：

• 检查Thymeleaf依赖是否完整且版本匹配
  确保你的Maven pom.xml 里引入了Thymeleaf与Spring整合的核心依赖，注意版本要和你的SpringMVC版本对应（比如Spring 5.x对应thymeleaf-spring5，Spring 6.x对应thymeleaf-spring6）：

  <dependency>
      <groupId>org.thymeleaf</groupId>
      <artifactId>thymeleaf-spring5</artifactId>
      <version>3.1.2.RELEASE</version> <!-- 替换成对应你的Spring版本的合适版本 -->
  </dependency>
  <dependency>
      <groupId>org.thymeleaf</groupId>
      <artifactId>thymeleaf</artifactId>
      <version>3.1.2.RELEASE</version>
  </dependency>
  

  不要只引入单一的thymeleaf依赖，必须引入Spring整合包，否则Spring无法识别Thymeleaf视图。

• 修正springMVC.xml中的视图解析器配置
  你可能错误配置了普通的JSP视图解析器，必须替换为Thymeleaf专属的解析器链：

  <!-- 1. 模板解析器：指定HTML文件位置和格式 -->
  <bean id="templateResolver" class="org.thymeleaf.spring5.templateresolver.SpringResourceTemplateResolver">
      <property name="prefix" value="/WEB-INF/templates/"/> <!-- 你的HTML文件存放路径，确保这个目录存在 -->
      <property name="suffix" value=".html"/>
      <property name="templateMode" value="HTML"/>
      <property name="characterEncoding" value="UTF-8"/>
  </bean>
  
  <!-- 2. 模板引擎：关联解析器 -->
  <bean id="templateEngine" class="org.thymeleaf.spring5.SpringTemplateEngine">
      <property name="templateResolver" ref="templateResolver"/>
  </bean>
  
  <!-- 3. 视图解析器：让SpringMVC识别Thymeleaf视图 -->
  <bean class="org.thymeleaf.spring5.view.ThymeleafViewResolver">
      <property name="templateEngine" ref="templateEngine"/>
      <property name="characterEncoding" value="UTF-8"/>
  </bean>
  

  同时要确保你的HTML文件确实放在/WEB-INF/templates/目录下，Controller返回的视图名称要和文件名一致（比如返回"index"对应index.html，不要加.html后缀）。

• 清理Maven缓存并重新构建
  执行mvn clean install命令，清除旧的依赖缓存，确保新的依赖生效。

二、解决添加javax.servlet-api后DispatcherServlet的404部署错误 #

这个问题是因为你没有给servlet-api依赖设置正确的作用域，导致和Tomcat自带的Servlet API冲突：

• 修改javax.servlet-api的依赖scope为provided
  Tomcat本身已经提供了Servlet API的实现，我们只需要在编译时依赖它，不需要打包到项目中。修改pom.xml中的依赖：

  <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>javax.servlet-api</artifactId>
      <version>4.0.1</version> <!-- 对应你的Tomcat版本，比如Tomcat9用4.0.x，Tomcat10用5.0.x -->
      <scope>provided</scope>
  </dependency>
  

• 检查web.xml中的DispatcherServlet配置
  确保你的DispatcherServlet配置正确，能加载到springMVC.xml：

  <servlet>
      <servlet-name>springmvc</servlet-name>
      <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
      <init-param>
          <param-name>contextConfigLocation</param-name>
          <param-value>classpath:springMVC.xml</param-value> <!-- 确保路径正确，比如如果springMVC.xml在resources下就用这个路径 -->
      </init-param>
      <load-on-startup>1</load-on-startup> <!-- 让DispatcherServlet随Tomcat启动加载，避免延迟初始化 -->
  </servlet>
  <servlet-mapping>
      <servlet-name>springmvc</servlet-name>
      <url-pattern>/</url-pattern>
  </servlet-mapping>
  

• 重启Tomcat并重新部署
  清理Tomcat的work目录，然后重启Tomcat重新部署项目，应该就能解决404问题了。

按这个顺序排查，先解决500错误，再处理404问题，应该就能让你的项目正常运行了。

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