以下是在 IntelliJ IDEA 中配置 Spring MVC 環境的詳細步驟：

---

步驟 1：創建 Maven Web 項目

1. 新建項目

   • File -> New -> Project → 選擇 Maven → 勾選 Create from archetype → 選擇 maven-archetype-webapp。
   • 輸入 GroupId（如 com.example）、ArtifactId（如 spring-mvc-demo） → 點擊 Next → 完成項目創建。

2. 項目結構
   確保項目包含以下目錄：

   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 配置

1. 配置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>
   

2. 配置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/beanshttp://www.springframework.org/schema/beans/spring-beans.xsdhttp://www.springframework.org/schema/mvchttp://www.springframework.org/schema/mvc/spring-mvc.xsdhttp://www.springframework.org/schema/contexthttp://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 配置（推薦）

1. 創建配置類 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 {@Overridepublic void configureViewResolvers(ViewResolverRegistry registry) {registry.jsp("/WEB-INF/views/", ".jsp");}
   }
   

2. 修改 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 和視圖

1. 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}
   }
   

2. 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 并運行

1. 添加 Tomcat 服務器

   • 點擊右上角 Add Configuration → + → Tomcat Server -> Local。
   • 指定 Tomcat 安裝路徑（若未配置，需先下載 Tomcat）。

2. 部署項目

   • 在 Deployment 標簽頁 → 點擊 + → 選擇 Artifact → 選擇 spring-mvc-demo:war exploded。
   • 設置上下文路徑（如 /demo）。

3. 啟動服務器

   • 點擊綠色三角按鈕 → 訪問 http://localhost:8080/demo/hello，看到頁面顯示 “Hello, Spring MVC!” 即成功。

---

常見問題解決

1. 404 錯誤

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

2. JSP 無法解析

   • 確認視圖解析器的 prefix 和 suffix 配置正確。
   • 確保 JSP 文件位于 WEB-INF/views/ 目錄下。

3. 依賴沖突

   • 執行 mvn dependency:tree 檢查依賴版本是否兼容。

---

擴展配置

1. 靜態資源處理
   在 spring-mvc-servlet.xml 中添加：

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

   • 靜態文件存放在 src/main/webapp/static/ 目錄下。

2. 啟用注解驅動
   確保 <mvc:annotation-driven/> 或 @EnableWebMvc 已配置。

---

完成以上步驟后，Spring MVC 環境即可正常運行。如果遇到問題，優先檢查控制臺日志和依賴樹。