IDEA+Maven构建SpringMVC Web项目：从零到部署的完整指南

1. 环境准备与项目创建

第一次用IDEA搭建SpringMVC项目时，我对着空白的界面发呆了半小时。现在回想起来，其实只要搞定几个关键步骤，整个过程就像搭积木一样简单。我们先从最基础的开发环境配置说起。

开发工具准备：

• IntelliJ IDEA（建议使用2023.3以上版本）
• JDK 1.8或更高版本（我用的是JDK 17）
• Maven 3.6.3+
• Tomcat 9.0+

安装完这些基础工具后，记得配置环境变量。特别是Maven的settings.xml文件，建议配置阿里云镜像加速依赖下载：

<mirror> <id>aliyunmaven</id> <mirrorOf>*</mirrorOf> <name>阿里云公共仓库</name> <url>https://maven.aliyun.com/repository/public</url> </mirror>

创建Maven项目：

1. 打开IDEA选择"New Project"
2. 左侧选择"Maven"，右侧勾选"Create from archetype"
3. 找到"maven-archetype-webapp"模板（找不到可以直接搜索）
4. 填写GroupId（如com.example）和ArtifactId（如demo-web）
5. 确认项目路径后点击Finish

这里有个新手容易踩的坑：如果网络不好可能导致archetype下载失败。遇到这种情况可以直接选择不使用archetype，创建完手动添加webapp目录。

2. 项目结构配置

刚创建好的项目结构可能不太完整，我们需要手动调整。标准的SpringMVC项目应该包含以下目录：

src ├── main │ ├── java # 源代码目录 │ ├── resources # 配置文件目录 │ └── webapp # web资源目录 │ ├── WEB-INF │ └── index.jsp └── test # 测试代码

修复目录结构：

1. 右键main文件夹 → New → Directory
2. 分别创建java、resources目录
3. 右键java目录 → Mark Directory as → Sources Root
4. 右键resources目录 → Mark Directory as → Resources Root

配置pom.xml： 这是项目的核心配置文件，我们需要添加SpringMVC相关依赖。以下是我的常用配置模板：

<packaging>war</packaging> <properties> <spring.version>5.3.23</spring.version> <thymeleaf.version>3.1.1.RELEASE</thymeleaf.version> </properties> <dependencies> <!-- Spring MVC --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-webmvc</artifactId> <version>${spring.version}</version> </dependency> <!-- Thymeleaf模板引擎 --> <dependency> <groupId>org.thymeleaf</groupId> <artifactId>thymeleaf-spring5</artifactId> <version>${thymeleaf.version}</version> </dependency> <!-- Servlet API --> <dependency> <groupId>javax.servlet</groupId> <artifactId>javax.servlet-api</artifactId> <version>4.0.1</version> <scope>provided</scope> </dependency> <!-- 其他常用工具包 --> <dependency> <groupId>com.fasterxml.jackson.core</groupId> <artifactId>jackson-databind</artifactId> <version>2.14.1</version> </dependency> </dependencies>

配置完成后记得点击右上角的"Maven Reload"按钮。如果依赖下载慢，可以尝试关闭IDEA的"Work offline"模式（File → Settings → Build → Maven）。

3. 核心配置文件编写

web.xml配置： 这是Java Web项目的入口文件，需要放在webapp/WEB-INF目录下。主要配置两个东西：

1. 字符编码过滤器（解决中文乱码问题）
2. Spring MVC的前端控制器DispatcherServlet

<?xml version="1.0" encoding="UTF-8"?> <web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd" version="4.0"> <!-- 字符编码过滤器 --> <filter> <filter-name>encodingFilter</filter-name> <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class> <init-param> <param-name>encoding</param-name> <param-value>UTF-8</param-value> </init-param> <init-param> <param-name>forceEncoding</param-name> <param-value>true</param-value> </init-param> </filter> <filter-mapping> <filter-name>encodingFilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping> <!-- DispatcherServlet配置 --> <servlet> <servlet-name>dispatcherServlet</servlet-name> <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> <init-param> <param-name>contextConfigLocation</param-name> <param-value>classpath:spring-mvc.xml</param-value> </init-param> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>dispatcherServlet</servlet-name> <url-pattern>/</url-pattern> </servlet-mapping> </web-app>

Spring MVC配置： 在resources目录下创建spring-mvc.xml文件，这是Spring的核心配置文件：

<?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 https://www.springframework.org/schema/context/spring-context.xsd http://www.springframework.org/schema/mvc https://www.springframework.org/schema/mvc/spring-mvc.xsd"> <!-- 组件扫描 --> <context:component-scan base-package="com.example.controller"/> <!-- 注解驱动 --> <mvc:annotation-driven/> <!-- 静态资源处理 --> <mvc:resources mapping="/static/**" location="/static/"/> <!-- Thymeleaf视图解析器 --> <bean id="templateResolver" class="org.thymeleaf.spring5.templateresolver.SpringResourceTemplateResolver"> <property name="prefix" value="/WEB-INF/views/"/> <property name="suffix" value=".html"/> <property name="templateMode" value="HTML"/> <property name="characterEncoding" value="UTF-8"/> </bean> <bean id="templateEngine" class="org.thymeleaf.spring5.SpringTemplateEngine"> <property name="templateResolver" ref="templateResolver"/> </bean> <bean class="org.thymeleaf.spring5.view.ThymeleafViewResolver"> <property name="templateEngine" ref="templateEngine"/> <property name="characterEncoding" value="UTF-8"/> </bean> </beans>

4. 编写业务代码

创建Controller： 在java目录下创建com.example.controller包，然后新建HomeController：

package com.example.controller; import org.springframework.stereotype.Controller; import org.springframework.ui.Model; import org.springframework.web.bind.annotation.GetMapping; @Controller public class HomeController { @GetMapping("/") public String home(Model model) { model.addAttribute("message", "欢迎来到Spring MVC世界！"); return "index"; } }

创建视图页面： 在webapp/WEB-INF下创建views目录，新建index.html：

<!DOCTYPE html> <html xmlns:th="http://www.thymeleaf.org"> <head> <meta charset="UTF-8"> <title>Spring MVC Demo</title> </head> <body> <h1 th:text="${message}">默认消息</h1> <p>当前时间：<span th:text="${#dates.format(#dates.createNow(), 'yyyy-MM-dd HH:mm:ss')}"></span></p> </body> </html>

静态资源处理： 在webapp下创建static目录，可以放CSS/JS/图片等资源。比如创建一个style.css：

body { font-family: Arial, sans-serif; margin: 40px; color: #333; } h1 { color: #0066cc; }

5. 服务器配置与项目部署

配置Tomcat：

1. 点击IDEA右上角的"Add Configuration"
2. 点击"+" → Tomcat Server → Local
3. 在"Deployment"标签页点击"+" → Artifact → 选择你的war包
4. 设置Application context为"/"（可以根据需要修改）
5. 在"Server"标签页设置HTTP端口（默认8080）

解决常见问题：

• 端口冲突：修改server.xml中的Connector端口
• 404错误：检查Application context路径是否正确
• 静态资源无法加载：确认spring-mvc.xml中配置了 mvc:resources

热部署技巧：

1. 在pom.xml中添加spring-boot-devtools依赖（即使不是Spring Boot项目）
2. IDEA设置：Build → Compiler → 勾选"Build project automatically"
3. 按Ctrl+Shift+A → 搜索"Registry" → 勾选"compiler.automake.allow.when.app.running"

6. 项目优化与扩展

日志配置： 在resources目录下添加logback.xml：

<?xml version="1.0" encoding="UTF-8"?> <configuration> <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender"> <encoder> <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern> </encoder> </appender> <logger name="org.springframework" level="INFO"/> <logger name="com.example" level="DEBUG"/> <root level="INFO"> <appender-ref ref="CONSOLE"/> </root> </configuration>

多环境配置：

1. 创建application-dev.properties和application-prod.properties
2. 在spring-mvc.xml中添加：

<context:property-placeholder location="classpath:application-${spring.profiles.active}.properties"/>

3. 在Tomcat配置的VM options中添加：

-Dspring.profiles.active=dev

RESTful API支持： 在Controller中添加API方法：

@RestController @RequestMapping("/api") public class ApiController { @GetMapping("/users") public List<User> getUsers() { // 实际项目中这里应该从数据库获取数据 return Arrays.asList( new User(1, "张三"), new User(2, "李四") ); } @PostMapping("/users") public ResponseEntity<String> createUser(@RequestBody User user) { // 处理用户创建逻辑 return ResponseEntity.ok("用户创建成功"); } }

7. 实际开发中的经验分享

目录结构规范： 我习惯按功能模块划分包结构，例如：

com.example ├── config # 配置类 ├── controller # 控制器 ├── service # 业务逻辑 ├── repository # 数据访问 ├── model # 数据模型 └── util # 工具类

性能优化建议：

1. 启用Gzip压缩：在Tomcat的server.xml中配置compression
2. 静态资源缓存：配置Cache-Control头
3. 使用连接池：配置DBCP或HikariCP
4. 启用Spring缓存：添加@EnableCaching注解

调试技巧：

1. 使用@ControllerAdvice统一处理异常
2. 配置拦截器记录请求日志
3. 使用Postman测试API接口
4. 开启Spring的debug日志查看请求处理流程

第一次启动项目时，我建议在DispatcherServlet的初始化方法上加个断点，观察整个Spring容器的加载过程。这能帮你更好地理解Spring MVC的工作原理。

8. 项目打包与部署

Maven打包：

1. 命令行执行：mvn clean package
2. 生成的war包在target目录下
3. 如果需要排除测试：mvn package -DskipTests

部署到外部Tomcat：

1. 将war包复制到Tomcat的webapps目录
2. 启动Tomcat（bin/startup.sh或startup.bat）
3. 访问http://localhost:8080/你的项目名/

Docker部署： 创建Dockerfile：

FROM tomcat:9.0 COPY target/demo-web.war /usr/local/tomcat/webapps/ EXPOSE 8080 CMD ["catalina.sh", "run"]

构建并运行：

docker build -t demo-web . docker run -p 8080:8080 demo-web

在实际项目中，我通常会配置CI/CD流水线自动完成这些部署步骤。Jenkins或GitHub Actions都是不错的选择。