首页 > 文章 > java教程

SpringMVC环境搭建教程详解

时间：2025-11-06 17:42:27 306浏览收藏

想快速搭建基于Java的Spring MVC环境？本文为你提供详细的教程，从创建Maven Web项目开始，一步步教你添加spring-webmvc依赖，配置DispatcherServlet及web.xml，编写spring-mvc-config.xml启用注解驱动和视图解析器。通过创建Controller类和JSP视图文件，最终将项目部署到Tomcat服务器。本教程适用于使用Maven构建的项目，助你轻松掌握Spring MVC环境搭建，为Java Web项目开发打下坚实基础。无论你是新手还是有一定经验的开发者，都能通过本文快速上手Spring MVC。

搭建Spring MVC开发环境需创建Maven Web项目，添加spring-webmvc依赖，配置DispatcherServlet和web.xml，编写spring-mvc-config.xml启用注解驱动与视图解析器，创建Controller类及JSP视图文件，最后部署至Tomcat运行访问根路径即可显示页面内容。

在Java中如何搭建Spring MVC开发环境_JavaWeb项目环境快速配置方法

搭建Spring MVC开发环境是JavaWeb项目开发的基础步骤。通过合理配置，可以快速启动一个支持MVC架构的Web应用。以下是详细的配置流程，适用于使用Maven构建的项目。

1. 创建Maven Web项目

使用IDE（如IntelliJ IDEA或Eclipse）创建一个Maven项目，选择maven-archetype-webapp模板，或手动创建目录结构：

src/main/java：存放Java源码
src/main/resources：存放配置文件
src/main/webapp/WEB-INF：存放web.xml和视图文件

2. 添加Spring MVC依赖

在pom.xml中添加Spring MVC及相关依赖：

<dependencies>
  <dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-webmvc</artifactId>
    <version>5.3.21</version>
  </dependency>
  <!-- Servlet API -->
  <dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>javax.servlet-api</artifactId>
    <version>4.0.1</version>
    <scope>provided</scope>
  </dependency>
  <!-- JSP支持 -->
  <dependency>
    <groupId>javax.servlet.jsp</groupId>
    <artifactId>jsp-api</artifactId>
    <version>2.2</version>
    <scope>provided</scope>
  </dependency>
</dependencies>

3. 配置web.xml

在WEB-INF/web.xml中注册Spring MVC的核心控制器DispatcherServlet：

<servlet>
  <servlet-name>dispatcher</servlet-name>
  <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
  <init-param>
    <param-name>contextConfigLocation</param-name>
    <param-value>/WEB-INF/spring-mvc-config.xml</param-value>
  </init-param>
  <load-on-startup>1</load-on-startup>
</servlet>
<p><servlet-mapping>
<servlet-name>dispatcher</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping></p>

4. 编写Spring MVC配置文件

在WEB-INF下创建spring-mvc-config.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:context="http://www.springframework.org/schema/context"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xsi:schemaLocation="
        http://www.springframework.org/schema/beans
        http://www.springframework.org/schema/beans/spring-beans.xsd
        http://www.springframework.org/schema/context
        http://www.springframework.org/schema/context/spring-context.xsd
        http://www.springframework.org/schema/mvc
        http://www.springframework.org/schema/mvc/spring-mvc.xsd">
<p><!-- 扫描Controller包 -->
<context:component-scan base-package="com.example.controller" /></p><p><!-- 启用注解驱动 -->
<mvc:annotation-driven /></p><p><!-- 视图解析器 -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/WEB-INF/views/" />
<property name="suffix" value=".jsp" />
</bean></p><p></beans></p>

5. 编写Controller和视图

创建一个简单的Controller类：

package com.example.controller;
<p>import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.servlet.ModelAndView;</p><p>@Controller
public class HomeController {
@GetMapping("/")
public ModelAndView home() {
ModelAndView mav = new ModelAndView("index");
mav.addObject("message", "Hello Spring MVC!");
return mav;
}
}</p>

在/WEB-INF/views/index.jsp中创建视图文件：

<html>
<body>
  <h1>${message}</h1>
</body>
</html>

6. 部署到Tomcat运行

将项目打包为WAR或直接部署到本地Tomcat服务器，启动后访问http://localhost:8080/your-app即可看到输出内容。

基本上就这些。只要依赖正确、配置无误，Spring MVC环境就能快速跑起来。关键是DispatcherServlet的配置和组件扫描路径要准确。不复杂但容易忽略细节。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《SpringMVC环境搭建教程详解》文章吧，也可关注golang学习网公众号了解相关技术文章。