JavaWeb Spring MVC 搭建：从零到能跑通，何搭其实没那么玄乎

Spring MVC 搭建的何搭核心就一句话：把请求路由到方法，把方法返回值渲染成视图。何搭别被那些铺天盖地的何搭架构图唬住，实际动起手来，何搭比你想的何搭简单。

先准备好工具：JDK 8+，何搭Maven 3.x，何搭IDEA（或者 Eclipse，何搭但 IDEA 真香）。何搭我假设你已经建好了一个空的何搭 Maven webapp 项目——如果连这一步都卡住，那先补 Maven 基础，何搭别硬撑。何搭

第一步：塞依赖，何搭配 web.xml

打开 pom.xml，何搭加 Spring MVC 的核心依赖。别贪多，先加 spring-webmvc 和 javax.servlet-api（scope 选 provided）。版本选 5.x 稳定版，别追新，5.3.x 就够用。

<dependency> <groupId>org.springframework</groupId> <artifactId>spring-webmvc</artifactId> <version>5.3.30</version> </dependency>

然后配置 web.xml。这一步是历史遗留的坑，但绕不开。Spring MVC 的核心是 DispatcherServlet，所有请求都先经过它。配置如下：

<servlet> <servlet-name>springmvc</servlet-name> <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> <init-param> <param-name>contextConfigLocation</param-name> <param-value>classpath:springmvc.xml</param-value> </init-param> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>springmvc</servlet-name> <url-pattern>/</url-pattern> </servlet-mapping>

注意 url-pattern 写成 / 而不是 *.do，这样 RESTful 风格的路由才能正常工作。你要是还抱着 .do 后缀的习惯，那等于把自己锁死在十年前。

第二步：写 springmvc.xml，开启注解驱动

在 resources 目录下新建 springmvc.xml。核心就三件事：开启组件扫描、开启注解驱动、配置视图解析器。

<context:component-scan base-package="com.example.controller"/> <mvc:annotation-driven/> <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"> <property name="prefix" value="/WEB-INF/views/"/> <property name="suffix" value=".jsp"/> </bean>

组件扫描让 Spring 找到你写的 @Controller 类。注解驱动是必须的，否则 @RequestMapping 根本不会生效。视图解析器决定了 Controller 返回的字符串对应哪个 JSP 文件——比如返回 "home"，就找 /WEB-INF/views/home.jsp。

这里有个小坑：/WEB-INF/ 目录下的 JSP 不能直接通过浏览器访问，只能由 Spring 内部转发。这是好事，防止用户绕过 Controller 直接看页面，但新手容易以为自己写错了。

第三步：写个 Controller 验证一下

创建一个 HomeController，放在你扫描的包路径下。别想复杂，先跑通再说。

@Controller public class HomeController {  @RequestMapping("/home") public String home() {  return "home"; } }

在 /WEB-INF/views/ 下建一个 home.jsp，随便写点内容。然后启动 Tomcat，访问 http://localhost:8080/你的项目名/home。看到页面了？恭喜，Spring MVC 已经跑起来了。

要是 404，多半是 web.xml 的 url-pattern 写错了，或者 springmvc.xml 没被加载。检查 Tomcat 启动日志，看有没有报错信息，比瞎猜管用。

第四步：加个参数接收，感受一下灵活性

光能跳转页面没什么意思，Spring MVC 的强项在于参数绑定。比如接收一个 GET 请求的 name 参数：

@RequestMapping("/greet") public String greet(@RequestParam("name") String name, Model model) {  model.addAttribute("name", name); return "greet"; }

在 greet.jsp 里用 EL 表达式 ${ name} 就能显示出来。这里有几个细节值得注意：@RequestParam 可以设 required=false 加默认值，避免参数缺失时报 400。Model 对象往页面传数据，比用 HttpServletRequest.setAttribute() 干净多了。

我见过太多人上来就折腾 RESTful 风格、JSON 交互、拦截器，结果连最基础的请求转发都没搞明白。先把这套跑通，再谈进阶。Spring MVC 的入门曲线其实平缓得很，卡住你的往往不是框架本身，而是对 HTTP 协议和 Servlet 规范的理解不够。

搭建过程中最容易翻车的几个点：spring-webmvc 版本和 servlet-api 版本不兼容（Tomcat 9 用 javax，Tomcat 10 用 jakarta，别混）；Maven 依赖没刷新导致类找不到；web.xml 头声明版本太低不支持注解。这些坑我都踩过，每次解决都靠看日志——别怕报错，把堆栈信息读完，答案就在里面。

最后说句实在话：Spring MVC 说白了就是一套封装好的 Servlet 工具集。你只要理解了一个 HTTP 请求从浏览器出发，经过 DispatcherServlet 分发到 Controller 方法，再返回视图的完整链路，剩下的都是细节。跑通这个最小示例，后面加数据库、加拦截器、加 REST API，都是在这个骨架上添砖加瓦罢了。

(责任编辑：时尚)