SSM框架整合JSP集成easyui：保姆级完整项目开发示例详解

这篇文章专为解决这些痛点而写：我们用“保姆级”步骤带你从0到1完成可运行项目——从环境搭建（JDK、Tomcat、Maven）、SSM框架整合配置（Spring容器、SpringMVC分发器、MyBatis映射），到JSP中easyui的集成（布局、数据表格、表单的嵌入与适配），再到前后端联调（Controller与easyui的数据交互），每一步都有具体代码和注意事项，帮你避开“配置路径错”“JSON格式不对”“样式失效”等坑。

不管是刚学SSM的新手，还是想快速整合前端UI的开发者，跟着走就能掌握完整流程，顺利跑通属于自己的实战项目。

你有没有过这种经历？跟着视频学SSM整合，代码抄得一模一样，结果项目启动报“ No qualifying bean of type”；好不容易启动了，JSP里的easyui表格变成一堆乱码，按钮没样式；或者点查询按钮，后端没收到参数，页面一直转圈。去年我带的实习生小周就踩了这一串坑，足足花了三天才把项目跑通——不是因为他笨，是很多教程要么跳步骤，要么没讲清楚“为什么要这么做”。今天这篇文章，我把自己踩过的坑全揉进去，从0到1帮你搭一个能跑的SSM+JSP+easyui项目，每一步都讲得比别人细，连配置文件里的注释含义都给你标清楚。

为什么选SSM+JSP+easyui？先把底层逻辑讲清楚

我之前帮一个做五金批发的朋友做后台，他想快速上线，不要太复杂的前端框架，我第一反应就是选SSM+JSP+easyui——不是因为它多新潮，是它“稳”且“省时间”。先讲SSM：Spring是“容器大脑”，管所有对象的依赖和生命周期；SpringMVC是“ web 门童”，接收浏览器请求，转给对应的Controller处理；MyBatis是“数据库翻译官”，把SQL结果转换成Java实体类，不用自己写JDBC代码。这三层分工明确，新手只要理清边界，就不会把Spring的配置写到SpringMVC里（小周刚开始就犯过这错，导致Bean加载重复）。

再讲JSP和easyui：JSP是Java Web的传统视图层，能直接嵌Java代码，适合展示动态数据；easyui是前端“快捷模板库”，自带表格、表单、树等几十种组件，不用自己写CSS和JS——我帮朋友做用户列表时，用easyui的datagrid组件，10分钟就搭好了带分页、排序的表格，要是自己写，至少得花半天调样式。

阿里云开发者社区2023年的Java开发框架调查显示，SSM是Java Web开发中占比最高的框架组合（超过60%），就是因为它轻量、易扩展，还能帮新手建立“分层编程”的思维（引用链接：阿里云开发者社区）。而easyui虽然不算最新潮，但在企业内部系统中使用率很高——毕竟老板要的是“能快速用”，不是“看起来高级”。

从0到1搭项目：每一步都踩过坑，所以讲得比别人细

接下来我把整个流程拆成4步，每一步都附“避坑提示”——这些都是我或身边人踩过的，比纯讲理论有用10倍。

第一步：环境搭建——别嫌麻烦，版本不对全白搭

先列个“必对版”环境清单，直接照这个下，避免版本冲突：

避坑提示：Tomcat版本要和JDK对应！比如Tomcat 9必须配JDK 1.8及以上，我之前用Tomcat 10配JDK 1.8，启动直接报“ Unsupported major.minor version”，查了Tomcat官网文档才知道——Tomcat 10要JDK 11以上，别贪新下高版本。

第二步：SSM整合——搞懂“谁管什么”，才不会配错

SSM的核心是“分层解耦”，我把关键配置文件的作用和坑点整理成表格，你直接对着填：

经验分享：小周刚开始把Service层的注解写成@Controller，结果SpringMVC扫到了，Spring没扫到，导致“ No bean named ‘userService’ available”——记住：@Controller是给SpringMVC用的，@Service是给Spring用的，别搞混！

第三步：easyui集成——顺序错了，样式全乱

easyui的坑主要在“引入顺序”和“数据格式”，我直接给你能跑的代码模板：

<!-
先引jQuery，easyui依赖它 >
<!-
引easyui的样式 >
<!-
引easyui的JS >

避坑提示：我之前帮朋友调页面，他把easyui的JS放在jQuery前面，结果Console报“ $ is not defined”，datagrid变成普通表格——记住：jQuery是“爸爸”，必须先到！

 <!-
easyui表格，url指向Controller的接口 >


 

 

 
ID
 
用户名
 
邮箱
 
创建时间
 
 
 

第四步：联调测试——用这3个工具，快速定位问题

项目搭好后，别直接点启动，用工具先测：

{
 "total": 2,
 "rows": [
 {"id":1,"username":"admin","email":"admin@test.com","createTime":"2024-01-01"},
 {"id":2,"username":"user","email":"user@test.com","createTime":"2024-01-02"}
 ]
}

经验分享：我之前没封装这个格式，直接返回List，结果页面一片空白——查了easyui官网文档才知道，datagrid要求返回“总条数+数据列表”，不然不认。

我把这个项目的完整代码放在了Gitee上（点击下载），你可以下载下来对比着看。如果按步骤做还是有问题，或者遇到了新坑，欢迎在评论区留言——毕竟这些坑我都踩过，比你更懂怎么爬出来。

最后想说：SSM+JSP+easyui不是最潮的组合，但绝对是新手“打基础”的最好选择——等你把这些逻辑摸透，再学Spring Boot或Vue，会比别人快一倍。赶紧动手试试吧，第一次跑通项目的成就感，比看10个视频都爽！

项目启动报“ No qualifying bean of type”是怎么回事？

这大概率是组件扫描范围错了或者注解用混了。比如去年我带的实习生小周，把Service层的注解写成@Controller，结果SpringMVC扫到了这个类，但Spring核心容器没扫到，就会提示找不到bean。还有种情况是applicationContext.xml（Spring核心配置）扫了Controller层，和dispatcher-servlet.xml（SpringMVC配置）的扫描范围重复，导致Bean冲突。解决方法很简单：@Service注解只用在Service层，@Controller只用在Controller层；applicationContext.xml只扫Service和Dao层（比如com.example.service），dispatcher-servlet.xml只扫Controller层（com.example.controller），别跨界。

JSP里的easyui组件没样式，按钮变成普通文字怎么办？

90%是引入文件的顺序或者路径错了。easyui依赖jQuery，必须先引jQuery，再引easyui的CSS和JS——我之前帮朋友调页面时，他把easyui的JS放在jQuery前面，结果Console报“$ is not defined”，样式直接崩了。另外要检查路径：如果static文件夹放在webapp下，引的时候要写“static/easyui/themes/default/easyui.css”，别加“/”开头，不然Tomcat会从根路径找，找不到就报404。还有种情况是easyui的CSS文件没下全，比如漏了themes文件夹里的图片，导致图标显示不出来，最好直接从官网下载完整的easyui包。

点easyui的查询按钮，后端没收到参数，页面一直转圈怎么解决？

先检查两个点：一是参数名对不对，easyui的datagrid默认会发page（当前页）和rows（每页条数）这两个参数，如果你Controller里写的是“pageNum”“pageSize”，肯定收不到，得改成和easyui一致的参数名，或者用@RequestParam指定别名（比如@RequestParam(“page”) int pageNum）。二是后端返回的JSON格式对不对，easyui要求返回的JSON必须包含total（总条数）和rows（数据列表）两个字段——我之前没封装这个格式，直接返回List，结果页面一直转圈，查了文档才知道得按这个格式来。另外可以用Postman测一下接口，看返回的JSON是不是符合要求。

引easyui的CSS/JS时报404，怎么快速检查路径？

首先看static文件夹的位置：必须放在webapp目录下（和WEB-INF同级），如果放错位置，比如放在src/main/resources下，Tomcat根本找不到。然后检查路径写法：比如引jQuery时，写“static/jquery/jquery-1.12.4.min.js”就行，别加“/”开头——加了“/”会变成从Tomcat的根路径（比如http://localhost:8080/）找，而不是你的项目路径（http://localhost:8080/项目名/）。最后用浏览器的开发者工具查：打开“Network”面板，刷新页面，看引的CSS/JS文件状态是不是200 OK，如果是404，把鼠标放在请求URL上，就能看到实际请求的路径，对比一下自己写的路径是不是错了。

Tomcat和JDK版本不对应会有什么问题？怎么选合适的版本？

版本不对应会直接导致项目启动失败，比如用Tomcat10配JDK1.8，会报“Unsupported major.minor version”错误——因为Tomcat10要求JDK11及以上，而JDK1.8的版本号不够。推荐的版本组合是：JDK1.8配Tomcat9.0.x（比如9.0.60），Maven3.8.x（比如3.8.5），这些版本组合是我踩过无数坑后 的“稳版”，基本不会有冲突。如果不确定自己的版本对不对，可以查Tomcat官网的文档，每个Tomcat版本下面都会写对应的JDK版本要求（比如Tomcat9的文档里明确写了“Requires JDK 1.8 or later”）。

YUANLEISVIP

收藏 链接