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

2025-04-28 05:50

本文主要是介绍IntelliJ IDEA 中配置 Spring MVC 环境的详细步骤及问题解决,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

《IntelliJIDEA中配置SpringMVC环境的详细步骤及问题解决》:本文主要介绍IntelliJIDEA中配置SpringMVC环境的详细步骤及问题解决,本文分步骤结合实例给大...

以下是在 IntelliJ IDEA 中配置 Spring MVC 环境的详细步骤:

步骤 1:创建 Maven Web 项目

新建项目

  • File -> New -> Pr编程oject → 选择 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”)
– 如下图

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

步骤 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>javascript;

配置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.springframew编程ork.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 配置(推荐)

创建配KlgfDdwG置类 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 无法解析

  • 确认视图解析器的 prefixsuffix 配置正确。
  • 确保 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环境内容请搜索China编程(www.chinasem.cn)以前的文章或继续浏览下面的相关文章希望大家以后多多支持编程China编程(www.chinasem.cn)!

这篇关于IntelliJ IDEA 中配置 Spring MVC 环境的详细步骤及问题解决的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1154405

相关文章

Java对异常的认识与异常的处理小结

《Java对异常的认识与异常的处理小结》Java程序在运行时可能出现的错误或非正常情况称为异常,下面给大家介绍Java对异常的认识与异常的处理,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参... 目录一、认识异常与异常类型。二、异常的处理三、总结 一、认识异常与异常类型。(1)简单定义-什么是

Redis Cluster模式配置

《RedisCluster模式配置》:本文主要介绍RedisCluster模式配置,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧... 目录分片 一、分片的本质与核心价值二、分片实现方案对比 ‌三、分片算法详解1. ‌范围分片(顺序分片)‌2. ‌哈希分片3. ‌虚

Python pip下载包及所有依赖到指定文件夹的步骤说明

《Pythonpip下载包及所有依赖到指定文件夹的步骤说明》为了方便开发和部署,我们常常需要将Python项目所依赖的第三方包导出到本地文件夹中,:本文主要介绍Pythonpip下载包及所有依... 目录步骤说明命令格式示例参数说明离线安装方法注意事项总结要使用pip下载包及其所有依赖到指定文件夹,请按照以

SpringBoot项目配置logback-spring.xml屏蔽特定路径的日志

《SpringBoot项目配置logback-spring.xml屏蔽特定路径的日志》在SpringBoot项目中,使用logback-spring.xml配置屏蔽特定路径的日志有两种常用方式,文中的... 目录方案一:基础配置(直接关闭目标路径日志)方案二:结合 Spring Profile 按环境屏蔽关

Python包管理工具核心指令uvx举例详细解析

《Python包管理工具核心指令uvx举例详细解析》:本文主要介绍Python包管理工具核心指令uvx的相关资料,uvx是uv工具链中用于临时运行Python命令行工具的高效执行器,依托Rust实... 目录一、uvx 的定位与核心功能二、uvx 的典型应用场景三、uvx 与传统工具对比四、uvx 的技术实

Java使用HttpClient实现图片下载与本地保存功能

《Java使用HttpClient实现图片下载与本地保存功能》在当今数字化时代,网络资源的获取与处理已成为软件开发中的常见需求,其中,图片作为网络上最常见的资源之一,其下载与保存功能在许多应用场景中都... 目录引言一、Apache HttpClient简介二、技术栈与环境准备三、实现图片下载与保存功能1.

Python中使用uv创建环境及原理举例详解

《Python中使用uv创建环境及原理举例详解》uv是Astral团队开发的高性能Python工具,整合包管理、虚拟环境、Python版本控制等功能,:本文主要介绍Python中使用uv创建环境及... 目录一、uv工具简介核心特点:二、安装uv1. 通过pip安装2. 通过脚本安装验证安装:配置镜像源(可

canal实现mysql数据同步的详细过程

《canal实现mysql数据同步的详细过程》:本文主要介绍canal实现mysql数据同步的详细过程,本文通过实例图文相结合给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的... 目录1、canal下载2、mysql同步用户创建和授权3、canal admin安装和启动4、canal

Maven 配置中的 <mirror>绕过 HTTP 阻断机制的方法

《Maven配置中的<mirror>绕过HTTP阻断机制的方法》:本文主要介绍Maven配置中的<mirror>绕过HTTP阻断机制的方法,本文给大家分享问题原因及解决方案,感兴趣的朋友一... 目录一、问题场景:升级 Maven 后构建失败二、解决方案:通过 <mirror> 配置覆盖默认行为1. 配置示

SpringBoot排查和解决JSON解析错误(400 Bad Request)的方法

《SpringBoot排查和解决JSON解析错误(400BadRequest)的方法》在开发SpringBootRESTfulAPI时,客户端与服务端的数据交互通常使用JSON格式,然而,JSON... 目录问题背景1. 问题描述2. 错误分析解决方案1. 手动重新输入jsON2. 使用工具清理JSON3.