做过这类JavaWeb项目的朋友应该都有体会SSMSpring SpringMVC MyBatis不是新技术但直到今天它在教学项目、毕业设计和中小型企业内部系统中依然有极高的出场率。原因是这套组合能让人把框架怎么整合、请求怎么流转、数据怎么落地这件事彻底搞明白远比直接套一个Spring Boot脚手架更能建立底层直觉。我刚完成的知识库管理系统用的就是基于JavaWeb和MySQL的SSMMaven这套体系前端配BootstrapjQuery页面由JSP渲染。项目规模不算大但麻雀虽小五脏俱全涉及用户登录、权限控制、知识分类、文章管理、全文检索和操作日志等多个模块。这篇文章我会把从选型到部署的完整链路拆开讲重点聊一聊工程结构、数据库设计、SSM整合时容易踩的雷、前端交互的取舍以及最后打war包部署时遇到的那些让人抓狂的问题。1. 知识库管理系统到底在解决什么问题1.1 为什么需要一套知识库而不是一堆Word文档在落地这个项目前我身边很多团队的管理状态是Word文档散落在各处有人用云盘有人用群文件更有人直接存在本地硬盘。结果是写文档的人找不到合适的模板用文档的人搜不到想要的内容时间一长知识就变成了死知识。知识库管理系统本质上就是给这些文档一个统一的家有目录、有层级、有标签、有搜索甚至能控制谁能看谁不能看。我当时定的目标是公司内部的技术方案、操作手册、常见问题、会议纪要统一录入系统支持按分类浏览、按标题和正文检索、支持管理员对内容进行审核和下线。用户端要有良好的阅读体验最好能做到打开页面就能看到最新内容不用安装任何客户端。这个需求非常契合JavaWeb应用浏览器直接访问Bootstrap保证响应式布局jQuery处理交互JSP负责动态渲染。1.2 从什么都能做到做成什么样的边界控制做项目最忌讳一上来就堆功能。我在需求阶段就把边界划得很清楚第一版只做最核心的四件事用户登录与角色权限普通用户/管理员/超级管理员知识分类管理支持多级树形结构知识文章管理新增、编辑、草稿、发布、下线关键词全文搜索标题正文再加两个辅助模块操作日志和个人中心。日志用于记录谁在什么时间改了什么内容这个对后期追责和数据安全都很有用。个人中心只是为了让用户能维护自己的基本信息和修改密码避免写死一个admin。所有功能加起来刚好能用SSM这套架构清晰地划分为Controller、Service、DAO三层既不会太复杂到无法完成也能覆盖绝大多数企业知识管理的基本诉求。选型上有人会问为什么不用Spring Boot不是不能用而是我刻意选择了SSM因为这套项目对理解Spring容器如何管理Bean、SpringMVC如何分发请求、MyBatis如何把SQL映射成对象有极强的教育意义。SSMMaven的工程里每一行配置都看得见摸得着天然适合当作学习框架整合的实战案例。对于追求快速出活的生产环境-用Spring Boot当然省事但如果你想掌握底层整合思路SSM是绕不开的一课。2. Maven SSM JSP的工程结构设计与依赖管理2.1 Maven在这里扮演什么角色Maven最核心的功劳是解决了依赖地狱问题。SSM项目要运行需要spring-core、spring-webmvc、spring-jdbc、mybatis、mybatis-spring、mysql-connector-java、jackson-databind、jstl等几十个jar包。如果不用Maven你得跑到各个官网去下载还要手动处理版本兼容性用Maven的话只需要在pom.xml里声明依赖坐标它会自动拉取全部jar包包括依赖的依赖。我用的是阿里云镜像仓库因为中央仓库在国外下载速度实在感人。这块有个小坑JDK版本不一致时某些依赖的编译级别会出问题比如maven-compiler-plugin默认用1.5编译遇到Lombok或泛型代码就报警。我在pom里显式配了compiler插件source和target都设为1.8这样整个团队用不同JDK构建也能保证兼容。2.2 典型工程结构谁放什么别乱放SSM项目普遍采用Maven的war包结构不是Spring Boot那种内嵌容器结构。我的工程目录长这样knowledge-base-system ├── pom.xml └── src/main ├── java │ └── com/company/kb │ ├── controller │ │ ├── UserController.java │ │ ├── CategoryController.java │ │ ├── ArticleController.java │ │ └── SearchController.java │ ├── service │ │ ├── UserService.java │ │ ├── CategoryService.java │ │ ├── ArticleService.java │ │ └── impl │ │ ├── UserServiceImpl.java │ │ ├── CategoryServiceImpl.java │ │ └── ArticleServiceImpl.java │ ├── dao │ │ ├── UserMapper.java │ │ ├── CategoryMapper.java │ │ └── ArticleMapper.java │ ├── entity │ │ ├── User.java │ │ ├── Category.java │ │ └── Article.java │ ├── common │ │ ├── Result.java │ │ └── PageBean.java │ └── interceptor │ └── LoginInterceptor.java ├── resources │ ├── jdbc.properties │ ├── spring-mybatis.xml │ ├── spring-mvc.xml │ ├── mybatis-config.xml │ └── mapper │ ├── UserMapper.xml │ ├── CategoryMapper.xml │ └── ArticleMapper.xml └── webapp ├── WEB-INF │ ├── web.xml │ └── views │ ├── login.jsp │ ├── index.jsp │ ├── category/list.jsp │ ├── article/list.jsp │ ├── article/edit.jsp │ └── ... └── static ├── css ├── js └── images这里有个关键点service写接口impl写实现类controller只负责参数接收和视图转发。很多新手喜欢在controller里直接写业务逻辑一旦功能复杂代码就变成一坨。项目里的用户注册、文章发布、分类修改几乎每个动作都涉及多张表的联动比如发布一篇文章要插入文章表、更新分类的文章数量、记录日志。如果这些逻辑散在controller里事务就很难控制。所以我坚持把所有业务放入service层并且用Transactional注解声明事务。2.3 pom.xml里几个容易忽视的依赖细节第一是scope。servlet-api和jsp-api这类依赖在打包时不应该进入war包因为Tomcat自带了它们所以必须用provided作用域。如果漏写最常见的现象是Tomcat启动时ClassNotFound异常或者项目可以本地跑但部署到服务器就报一些奇怪的类重复问题。第二是jackson和fastjson的选择。我最终选了jackson-databind因为SpringMVC对它的支持最原生只要配置了 mvc:annotation-driven ResponseBody返回Java对象时自动转JSON。项目里我用Result 作为统一返回结构前端拿到之后判断code是不是200再决定是否弹窗提示还是刷新列表。dependency groupIdcom.fasterxml.jackson.core/groupId artifactIdjackson-databind/artifactId version2.9.8/version /dependency第三是JSTL依赖。很多人忘了加jstl导致JSP页面里的c:forEach标签失效页面直接显示标签源码。加jstl的同时最好顺手把standard加上虽然新版jstl已合并但这个坑比较隐蔽。3. 数据库设计分类表、文章表和用户权限表的关系建模3.1 表结构要从检索和权限两个角度反推知识库的数据库设计并不复杂但如果没想清楚后期会频繁改表。我设计时重点考虑了三个场景分类树怎么遍历、全文搜索怎么做、权限怎么控制。分类我采用了经典的parent_id自关联模型。这样支持无限层级比如根目录技术方案下可以有前端方案后端方案后端方案下面还能再挂微服务。查询某个分类的所有子分类时先用递归查出该分类及所有后代分类的ID集合再用IN条件去查文章。用户表我加了role字段用整数表示角色1超级管理员、2管理员、3普通用户。超级管理员能干所有事管理员可以管理某个分类下的文章普通用户只能阅读和下载如果后续接文件服务。为了不过度设计我没有单独建角色表而是用字段硬编码在枚举里维护。项目后期若需要细粒度权限再拆RBAC也完全来得及。文章表除了title和content还专门设计了status字段0草稿、1待审核、2已发布、3已下线。为什么要搞这么多状态因为知识库内容的准确性非常重要如果所有人写完就直接发布错别字和过时方案就会污染整个库。所以我在设计上保留了待审核状态管理员可以审稿审核通过后才会出现在前台检索结果里。这个功能在知识管理场景中非常实用很多生产环境的内容管理都要走这个流程。3.2 核心表结构参考下面给三张最核心的表实际项目里还有log表、tag表。用户表CREATE TABLE t_user ( id int(11) NOT NULL AUTO_INCREMENT, username varchar(50) NOT NULL, password varchar(64) NOT NULL, real_name varchar(50) DEFAULT NULL, email varchar(100) DEFAULT NULL, role tinyint(4) NOT NULL DEFAULT 3, status tinyint(4) NOT NULL DEFAULT 1, create_time datetime DEFAULT NULL, update_time datetime DEFAULT NULL, PRIMARY KEY (id), UNIQUE KEY uk_username (username) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;分类表CREATE TABLE t_category ( id int(11) NOT NULL AUTO_INCREMENT, name varchar(100) NOT NULL, parent_id int(11) NOT NULL DEFAULT 0, sort_order int(11) DEFAULT 0, create_time datetime DEFAULT NULL, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;文章表CREATE TABLE t_article ( id int(11) NOT NULL AUTO_INCREMENT, category_id int(11) NOT NULL, title varchar(200) NOT NULL, summary varchar(500) DEFAULT NULL, content longtext, author_id int(11) NOT NULL, status tinyint(4) NOT NULL DEFAULT 0, view_count int(11) NOT NULL DEFAULT 0, create_time datetime DEFAULT NULL, update_time datetime DEFAULT NULL, PRIMARY KEY (id), KEY idx_category_id (category_id), KEY idx_status (status) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;这里有一个非常重要的决定字符集用utf8mb4不要用utf8。MySQL的utf8其实只能存3字节的字符像emoji和生僻字会报incorrect string value而utf8mb4是真正的4字节编码兼容所有字符。我用Navicat建的表默认字符集选utf8mb4排序规则用utf8mb4_general_ci即可。3.3 全文搜索是SQL的LIKE还是数据库全文索引知识库最大的价值在于检索所以搜索模块我单独做了优化。一开始图省事用LIKE %关键词%去匹配title和summary数据量小的时候看不出问题等文章上千条后这种写法会导致全表扫描一旦并发上来MySQL的CPU就会飙升。后面我改成了两种方案结合核心字段title、summary、content先建MySQL全文索引用MATCH...AGAINST做全文检索。但注意MySQL的全文索引默认只支持英文分词对中文分词效果比较差。为了解决这个问题我引入了IK分词插件同时把全文索引建立在中文分词之后。这个改造在数据量几千条时效果明显查询响应从原来的500ms降到了80ms左右。如果你觉得引入分词插件太复杂还有一个折中方案在文章表单独建一个search_keywords字段存经过空格分隔的关键词快照录入文章时用程序自动提取搜索时再用LIKE去匹配这个字段。精度虽然不如分词器但比全字段LIKE快得多实现成本也低。3.4 事务和索引的冷知识MyBatis的mapper.xml里写SQL时表名和字段名一定要用反引号的尽量少用保留字需要注意。比如我的分类表字段parent_id就容易理解但如果是order在SQL里就要写成order。另外所有查询语句都尽量走索引尤其注意不要在索引列上做函数运算比如WHERE DATE(create_time)2024-01-01会让索引失效正确写法是范围查询。事务上Spring通过声明式事务管理需要在service实现类上加Transactional。默认只在RuntimeException时回滚像这里如果业务中出现CheckedException比如文件不存在事务不会自动回滚。我习惯在rollbackFor属性里指定Exception.class确保任何异常都回滚Transactional(rollbackFor Exception.class) public void publishArticle(Article article) { article.setStatus(2); articleMapper.insert(article); // 更新分类统计、写日志 categoryMapper.increaseCount(article.getCategoryId()); logMapper.insert(...); }4. SSM整合的核心链路与后端关键模块实现4.1 配置文件的整合思路以及一个典型的jdbc.propertiesSSM整合的本质是Spring容器管理Service和MapperSpringMVC容器管理Controller和视图解析器两者通过Spring父子容器关系关联在一起。最常见的方式是web.xml里配置ContextLoaderListener加载spring-mybatis.xmlDispatcherServlet加载spring-mvc.xmlspring-mybatis.xml里扫描service和mapperspring-mvc.xml里扫描controller这中间最容易搞混的是包扫描范围。如果spring-mvc.xml里也扫描了service包事务注解会失效因为SpringMVC容器会创建Service的另一个实例事务管理器根本管不到它。我见过太多项目出现本地跑得好好的部署到服务器后数据库自动回滚就失灵的情况八成就是包扫描冲突。jdbc.properties文件很普通但几个细节值得注意jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/knowledge_base?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/ShanghaiallowPublicKeyRetrievaltrue jdbc.usernameroot jdbc.passwordyour_password这里必须解释一下useSSLfalse。MySQL 8.0之后默认开SSL本地连接时如果证书不对会直接报错所以我果断关掉。serverTimezoneAsia/Shanghai是因为新版驱动默认用的是UTC时间不设这个参数插入日期会差8小时。allowPublicKeyRetrievaltrue是为了解决有时出现的Public Key Retrieval is not allowed异常。这几个参数每一项背后都对应一个崩溃过的深夜尤其新手遇到连接报错务必先查它们。4.2 MyBatis映射文件动态SQL和结果映射MyBatis最爽的就是动态SQL。比如文章列表页要支持关键词搜索、分类筛选、状态筛选用 和 组合可以把SQL写得非常干净select idsearchArticles parameterTypemap resultTypeArticle SELECT id, title, summary, author_id, status, view_count, create_time, update_time FROM t_article where if testkeyword ! null and keyword ! AND (title LIKE CONCAT(%, #{keyword}, %) OR summary LIKE CONCAT(%, #{keyword}, %) OR content LIKE CONCAT(%, #{keyword}, %)) /if if testcategoryId ! null AND category_id IN foreach collectioncategoryIds itemcid open( separator, close) #{cid} /foreach /if if teststatus ! null AND status #{status} /if /where ORDER BY create_time DESC LIMIT #{offset}, #{pageSize} /selectresultTypeArticle要求Article类的字段名和数据库列名能对应上。我用的是下划线转驼峰配置mybatis-config.xml里设了mapUnderscoreToCamelCasetrue这样数据库的create_time就能直接映射成createTime。如果没设置要么给每列加别名要么在resultMap里逐个指定非常啰嗦。4.3 分页插件与PageHelper的使用注意事项项目前端用的是Bootstrap的pagination组件但后端配套的分页我用的是PageHelper插件。集成PageHelper很简单引入依赖并在spring-mybatis.xml里配置一个拦截器插件即可。但这里有个很隐蔽的坑PageHelper的分页参数是绑定到线程的。如果service里开启了一个新线程去查数据或者在同一个方法里执行了第二条SQLPageHelper可能会作用在错误的SQL上导致数据错乱。我严格按照先设置PageHelper.startPage然后紧接着写第一条查询语句的规范来并且保证查询方法内有且只有一条会被分页的SQL。实际过程中我经常遇到列表页正常但不知道为什么count查询很慢。后来发现是因为我在查询前调用了其他Mapper的统计方法PageHelper把分页拦截到了别的SQL上。解决办法是保持service方法里查询语句的简洁或者把统计方法放在分页查询之后。4.4 用户登录与登录拦截器登录模块不能只是简单的查一下账号密码。密码我用的是MD5加盐存储。虽然MD5已不算安全但作为内部项目配合加盐后还是能防住不少低水平攻击。真正的重点是登录拦截器所有需要登录后才能访问的路径都要经过LoginInterceptor验证Session里是否有user对象。在spring-mvc.xml里配置拦截器的时候需要把登录页、静态资源、以及一些公开接口排除掉。否则会出现CSS和JS加载不了因为静态资源也被拦截了。这块我建议用 mvc:resources 显式放行static目录同时将拦截路径设为/user/**、/article/**等业务前缀而不是拦截全路径。5. JSP Bootstrap jQuery页面渲染与交互的取舍5.1 JSP没有死它依然适合这种场景标题里带了jsp很多人第一反应是都什么年代了还在用JSP。其实JSP对于这种服务端渲染为主的旧式项目非常合适尤其知识库这种对SEO没要求、但需要快速迭代后台管理界面的系统。它的好处是天然支持JSTL标签后端往request里塞一个List前端用c:forEach就能渲染出一整个表格。我来回切换前后端联调时这套机制比前后端分离 各种跨域处理省心得多。