IntelliJ IDEA 中配置 Spring MVC 環(huán)境的詳細步驟及問題解決
更新時間：2025年04月27日 14:29:24 作者：yuren_xia
這篇文章主要介紹了IntelliJ IDEA 中配置 Spring MVC 環(huán)境的詳細步驟及問題解決,本文分步驟結(jié)合實例給大家介紹的非常詳細,對大家的學(xué)習(xí)或工作具有一定的參考借鑒價值,需要的朋友參考下吧
以下是在 IntelliJ IDEA 中配置 Spring MVC 環(huán)境的詳細步驟：
步驟 1：創(chuàng)建 Maven Web 項目
新建項目
File -> New -> Project→ 選擇 Maven → 勾選 Create from archetype → 選擇maven-archetype-webapp。- 輸入
GroupId（如com.example）、ArtifactId（如spring-mvc-demo） → 點擊Next→ 完成項目創(chuàng)建。
項目結(jié)構(gòu)
確保項目包含以下目錄：
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、保存后執(zhí)行
– 在 Maven 工具窗口中，展開項目 -> Lifecycle。
– 雙擊 ?clean → 等待清理完成。
– 雙擊 ?install → 等待依賴下載和構(gòu)建完成。
2、將新的依賴加入到發(fā)布目錄中
– 點擊Edite Configurations–>選中當(dāng)前Server–>右側(cè)選擇Deployment–>選中當(dāng)前發(fā)布項目，點擊編輯按鈕，將新加入的依賴添加到左側(cè)（選中依賴，右鍵“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>
<!--設(shè)置web應(yīng)用啟動時自動創(chuàng)建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初始化過程中，自動創(chuàng)建并管理com.hirain及其子包中擁有如下注解的對象：
@Repository
@Service
@Controller
@Component
-->
<context:component-scan base-package="com.hirain"/>
<!--啟用mvc注解開發(fā)模式-->
<mvc:annotation-driven/>
<!--將圖片、css、js等靜態(tài)資源排除在外，可提高執(zhí)行效率-->
<mvc:default-servlet-handler/>
</beans>方式 2：純 Java 配置（推薦）
創(chuàng)建配置類 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：創(chuàng)建 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"; // 對應(yīng) /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 服務(wù)器
- 點擊右上角
Add Configuration→+→Tomcat Server -> Local。 - 指定 Tomcat 安裝路徑（若未配置，需先下載 Tomcat）。
部署項目
- 在
Deployment標簽頁 → 點擊+→ 選擇Artifact→ 選擇spring-mvc-demo:war exploded。 - 設(shè)置上下文路徑（如
/demo）。
啟動服務(wù)器
- 點擊綠色三角按鈕 → 訪問
http://localhost:8080/demo/hello，看到頁面顯示 “Hello, Spring MVC!” 即成功。
常見問題解決
404 錯誤
- 檢查
@Controller和@GetMapping注解是否生效。 - 確保
web.xml中的DispatcherServlet映射正確（如/或*.do）。
JSP 無法解析
- 確認視圖解析器的
prefix和suffix配置正確。 - 確保 JSP 文件位于
WEB-INF/views/目錄下。
依賴沖突
- 執(zhí)行
mvn dependency:tree檢查依賴版本是否兼容。
擴展配置
靜態(tài)資源處理
- 在
spring-mvc-servlet.xml中添加：
<mvc:resources mapping="/static/**" location="/static/"/>
- 靜態(tài)文件存放在
src/main/webapp/static/目錄下。
啟用注解驅(qū)動
- 確保
<mvc:annotation-driven/>或@EnableWebMvc已配置。
完成以上步驟后，Spring MVC 環(huán)境即可正常運行。如果遇到問題，優(yōu)先檢查控制臺日志和依賴樹。
到此這篇關(guān)于IntelliJ IDEA 中配置 Spring MVC 環(huán)境的詳細步驟的文章就介紹到這了,更多相關(guān)idea配置spring mvc環(huán)境內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
相關(guān)文章
Digester是apache開源項目Commons中的一個子項目,用于解析XML文檔的工具,本文為大家整理了Digester解析XML文件的三種方式,希望對大家有所幫助2024-01-01
springboot將mybatis升級為mybatis-plus的實現(xiàn)
之前項目工程用的是mybatis,現(xiàn)在需要將其替換為mybatis-plus,本文主要介紹了springboot將mybatis升級為mybatis-plus的實現(xiàn),具有一定的參考價值,感興趣的可以了解一下2023-09-09
最近準備搭建一個SSM框架,由于很久沒有搭建了,一來就遇到各種問題,折騰了一天終于搞定了,特此記錄一下遇到的問題,下面這篇文章主要給大家介紹了關(guān)于idea搭建SSM框架遇踩的坑,文中還附完整過程,需要的朋友可以參考下2023-04-04
解讀@ConfigurationProperties的基本用法
這篇文章主要介紹了@ConfigurationProperties的基本用法,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2025-03-03
這篇文章主要介紹了idea報錯之找不到符號:類的問題及解決方案,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2023-12-12
這篇文章主要介紹了深入了解JVM字節(jié)碼增強技術(shù),文中通過示例代碼介紹的非常詳細，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友可以參考下2019-11-11
這篇文章主要介紹了JDBC 使用說明,需要的朋友可以參考下2015-08-08
這篇文章主要介紹了Java計算字符串公式的方式解讀，具有很好的參考價值，希望對大家有所幫助。如有錯誤或未考慮完全的地方，望不吝賜教2022-12-12
Spring與Mybatis整合方式(mybatis-spring整合jar包功能)
這篇文章主要介紹了Spring與Mybatis整合方式(mybatis-spring整合jar包功能),具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2025-05-05
SpringBoot集成JWT實現(xiàn)Token登錄驗證的示例代碼
隨著技術(shù)的發(fā)展,分布式web應(yīng)用的普及,通過session管理用戶登錄狀態(tài)成本越來越高,因此慢慢發(fā)展成為token的方式做登錄身份校驗,本文就來介紹一下SpringBoot集成JWT實現(xiàn)Token登錄驗證的示例代碼,感興趣的可以了解一下2023-12-12