IntelliJ IDEA 中配置 Spring MVC 环境的详细步骤及问题解决

更新时间：2025年04月27日 14:29:24 作者：yuren_xia

这篇文章主要介绍了IntelliJ IDEA 中配置 Spring MVC 环境的详细步骤及问题解决,本文分步骤结合实例给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧

步骤 1：创建 Maven Web 项目

新建项目

File -> New -> Project → 选择 Maven → 勾选 Create from archetype → 选择 maven-archetype-webapp。
输入 GroupId（如 com.example）、ArtifactId（如 spring-mvc-demo） → 点击 Next → 完成项目创建。

项目结构
确保项目包含以下目录：

src/main/
  ├── java/         # Java 代码
  ├── resources/    # 配置文件
  		└── applicationContext.xml
  └── webapp/       # Web 资源
      ├── WEB-INF/
      │   └── web.xml
      └── index.jsp

步骤 2：添加 Spring MVC 依赖

在 pom.xml 中添加以下依赖（Spring 5.x + Servlet 4.x）：

<dependencies>
    <!-- Spring MVC -->
   <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-webmvc</artifactId>
      <version>5.3.30</version>
    </dependency>  
</dependencies>

1、保存后执行

– 在 Maven 工具窗口中，展开项目 -> Lifecycle。
– 双击 clean → 等待清理完成。
– 双击 install → 等待依赖下载和构建完成。

2、将新的依赖加入到发布目录中

– 点击Edite Configurations–>选中当前Server–>右侧选择Deployment–>选中当前发布项目，点击编辑按钮，将新加入的依赖添加到左侧（选中依赖，右键“Put into WEB-INF/lib”）
– 如下图

步骤 3：配置 DispatcherServlet

方式 1：通过 web.xml 配置

配置web.xml 文件

<web-app xmlns="https://jakarta.ee/xml/ns/jakartaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="https://jakarta.ee/xml/ns/jakartaee 
         https://jakarta.ee/xml/ns/jakartaee/web-app_6_0.xsd"
         version="6.0">
  <servlet>
     <servlet-name>springmvc</servlet-name>
     <!--配置DispatcherServlet    -->
     <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
     <init-param>
         <param-name>contextConfigLocation</param-name>
         <param-value>classpath:applicationContext.xml</param-value>
     </init-param>
     <!--设置web应用启动时自动创建spring ioc容器并初始化DispatcherServlet-->
     <load-on-startup>0</load-on-startup>
 </servlet>
 <servlet-mapping>
     <servlet-name>springmvc</servlet-name>
     <!--拦截所有对象-->
     <url-pattern>/</url-pattern>
 </servlet-mapping>
</web-app>

配置applicationContext.xml
在 src/main/resource/ 下新建 applicationContext.xml：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xmlns:mvc="http://www.springframework.org/schema/mvc"
     xmlns:context="http://www.springframework.org/schema/context"
     xsi:schemaLocation="
     http://www.springframework.org/schema/beans
     http://www.springframework.org/schema/beans/spring-beans.xsd
     http://www.springframework.org/schema/mvc
     http://www.springframework.org/schema/mvc/spring-mvc.xsd
     http://www.springframework.org/schema/context
     http://www.springframework.org/schema/context/spring-context.xsd
">
  <!--在spring ioc初始化过程中，自动创建并管理com.hirain及其子包中拥有如下注解的对象：
  @Repository
  @Service
  @Controller
  @Component
  -->
  <context:component-scan base-package="com.hirain"/>
  <!--启用mvc注解开发模式-->
  <mvc:annotation-driven/>
  <!--将图片、css、js等静态资源排除在外，可提高执行效率-->
  <mvc:default-servlet-handler/>
</beans>

方式 2：纯 Java 配置（推荐）

创建配置类 src/main/java/com/example/config/WebConfig.java：

package com.example.config;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.EnableWebMvc;
import org.springframework.web.servlet.config.annotation.ViewResolverRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
@Configuration
@EnableWebMvc
@ComponentScan(basePackages = "com.example.controller")
public class WebConfig implements WebMvcConfigurer {
    @Override
    public void configureViewResolvers(ViewResolverRegistry registry) {
        registry.jsp("/WEB-INF/views/", ".jsp");
    }
}

修改 web.xml 使用 AnnotationConfigServletWebServerApplicationContext：

<context-param>
    <param-name>contextClass</param-name>
    <param-value>org.springframework.web.context.support.AnnotationConfigWebApplicationContext</param-value>
</context-param>
<context-param>
    <param-name>contextConfigLocation</param-name>
    <param-value>com.example.config.WebConfig</param-value>
</context-param>

步骤 4：创建 Controller 和视图

Controller 类
在 src/main/java/com/example/controller 下新建 HelloController.java：

package com.example.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
@Controller
public class HelloController {
    @GetMapping("/hello")
    public String hello() {
        return "hello"; // 对应 /WEB-INF/views/hello.jsp
    }
}

JSP 视图
在 src/main/webapp/WEB-INF/views 下新建 hello.jsp：

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Hello Spring MVC</title>
</head>
<body>
    <h1>Hello, Spring MVC!</h1>
</body>
</html>

步骤 5：配置 Tomcat 并运行

添加 Tomcat 服务器

点击右上角 Add Configuration → + → Tomcat Server -> Local。
指定 Tomcat 安装路径（若未配置，需先下载 Tomcat）。

部署项目

在 Deployment 标签页 → 点击 + → 选择 Artifact → 选择 spring-mvc-demo:war exploded。
设置上下文路径（如 /demo）。

启动服务器

点击绿色三角按钮 → 访问 http://localhost:8080/demo/hello，看到页面显示 “Hello, Spring MVC!” 即成功。

常见问题解决

404 错误

检查 @Controller 和 @GetMapping 注解是否生效。
确保 web.xml 中的 DispatcherServlet 映射正确（如 / 或 *.do）。

JSP 无法解析

确认视图解析器的 prefix 和 suffix 配置正确。
确保 JSP 文件位于 WEB-INF/views/ 目录下。

依赖冲突

执行 mvn dependency:tree 检查依赖版本是否兼容。

扩展配置

静态资源处理

在 spring-mvc-servlet.xml 中添加：

<mvc:resources mapping="/static/**" location="/static/"/>

静态文件存放在 src/main/webapp/static/ 目录下。

启用注解驱动

确保 <mvc:annotation-driven/> 或 @EnableWebMvc 已配置。

完成以上步骤后，Spring MVC 环境即可正常运行。如果遇到问题，优先检查控制台日志和依赖树。

到此这篇关于IntelliJ IDEA 中配置 Spring MVC 环境的详细步骤的文章就介绍到这了,更多相关idea配置spring mvc环境内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Java代码编译和反编译的那些事儿
这篇文章主要给大家介绍了关于Java代码编译和反编译的相关资料，文中通过示例代码介绍的非常详细，对大家学习或者使用Java具有一定的参考学习价值，需要的朋友们下面来一起学习学习吧
2019-05-05
简单了解Mybatis如何实现SQL防注入
这篇文章主要介绍了简单了解Mybatis如何实现SQL防注入,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2020-01-01
java 重定义数组的实现方法(与VB的ReDim相像)
java 重定义数组的实现方法(与VB的ReDim相像)，需要的朋友可以参考一下
2013-04-04
Java详解使用线程池处理任务方法
java中经常需要用到多线程来处理，我们非常不建议单纯使用继承Thread或者实现Runnable接口的方式来创建线程，那样势必有创建及销毁线程耗费资源、线程上下文切换问题。同时创建过多的线程也可能引发资源耗尽的风险，这个时候引入线程池比较合理，方便线程任务的管理
2022-05-05
Java中比较抽象类与接口的异同
大家好，本篇文章主要讲的是Java中比较抽象类与接口的异同，感兴趣的同学赶快来看一看吧，对你有帮助的话记得收藏一下，方便下次浏览
2021-12-12
SpringBoot如何使用feign实现远程接口调用和错误熔断
这篇文章主要介绍了SpringBoot如何使用feign实现远程接口调用和错误熔断,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2019-12-12
都9102年了，你还用for循环操作集合吗
这篇文章主要给大家介绍了关于java中for循环操作集合使用的相关资料，文中通过示例代码介绍的非常详细，对大家的学习或者使用java具有一定的参考学习价值，需要的朋友们下面来一起学习学习吧
2019-03-03
使用Java代码进行因数分解和求最小公倍数的示例
这篇文章主要介绍了使用Java代码进行因数分解和求最小公倍数的示例,都是基于最基础的算法原理实现,需要的朋友可以参考下
2015-11-11
Jdk中没有jre文件夹怎么办?如何解决?
这篇文章主要介绍了Jdk中没有jre文件夹怎么办?如何解决的问题，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2023-02-02
详解Java快速上手用户后台管理系统
只有在实战中练习才能真正获得能力的提升，本篇文章手把手带你用Java快速上手实现一个用户后台管理系统,大家可以在过程中查缺补漏，提升水平
2022-01-01