1. 这个平台项目到底要解决什么问题需求边界是什么先说结论古诗词数字化平台这类题目的本质是把传统的纸质诗词典籍转换成一个可检索、可分类、可互动的内容管理系统。它看起来像是一个内容展示站但真正的考察点在于——你能不能把一套标准的CRUD增删改查逻辑映射到诗、词、作者、收藏、评论、用户管理这些实体上。作为毕设或课设它的难度梯度很舒服往上可以做诗词检索、按朝代/作者聚合、收藏排行往下可以砍需求不至于做不完。我拆解这类项目时第一步不是看代码而是先画一份功能脑图。一个完整的古诗词数字化平台通常包含下面的角色和功能域角色核心功能游客/普通用户注册、登录、按朝代浏览、按作者检索、查看诗词详情、收藏诗词、收藏列表管理管理员用户管理、诗词录入/编辑/删除、作者管理、分类管理、数据统计简版、公告维护系统后台支撑登录拦截、分页查询、统一异常处理、文件封面图上传这里建议在做需求文档时特别关注三个隐藏点检索逻辑的丰富度真正答辩时评委最常问你的检索是只匹配标题还是能匹配全文匹配作者名吗如果项目中诗词检索只是对标题做LIKE很容易被追问。建议至少做到标题 正文 作者名三字段组合检索。数据来源的版权提示数字化平台会录入大量诗词原文毕设源码里自带的示例数据往往来自公开的诗词数据库或网络爬虫。做项目报告时最好写明数据仅用于学习研究版权归原作者/整理者所有这一点不少学生忽略。数字化的实际含义诗词数字化不只是搬到网页上还包含古文今译/注释作者生平关联意象标签这些延伸字段。哪怕只是把注释和译文存放为字段也比单纯放一首原文要显得项目更饱满。2. 技术选型取舍为什么是SSMJSP以及前后端分离的说法该怎么理解项目标题同时出现了jsp和前后端分离第一次接触这套组合的同学很容易犯迷糊。这里我讲清楚它的真实结构。SSM Spring SpringMVC MyBatis是Java Web的经典老三样。Spring负责依赖注入和事务管理SpringMVC负责请求路由和参数绑定MyBatis负责数据库访问和SQL映射。它和现在主流的Spring Boot项目相比最大的区别是一大坨显式的XML配置——也正是这个原因它特别适合作为校内学习项目框架底层逻辑暴露得比Spring Boot多答辩时反而更容易讲出东西。关于JSP和前后端分离的关系必须澄清一下严格意义上的前后端分离是指前端静态资源HTML/JS/Vue/React应用与后端服务完全独立部署通过接口通信。而JSP是服务端渲染技术JSP页面本身由服务端解析后再返回给浏览器。这两者理念上是冲突的。所以标题里挂前后端分离的JSP项目通常只可能属于以下几种情况之一页面内使用AJAX异步请求后端接口但页面依然由JSP输出半分离后端提供了独立的JSON数据接口比如/api/poems前端通过jQuery等发起请求拿到JSON后动态渲染项目打包后把JSP静态化或者后期引入了极轻量的前端组件层。我在调试这类项目时实际见到的绝大多数是前面两种。也就是说前后端分离在这个语境下更准确的理解是页面与接口在逻辑上分层而不是真的做到了前端工程化和后端API独立部署。打开源码后第一件事就应该是确认这一点因为这会直接影响你调试时抓问题的方向——如果是服务端渲染页面不显示多半是EL表达式或数据模型的问题如果是异步接口页面不显示多半是接口返回JSON不对。技术栈选型的现实逻辑也很简单本校课程用SSM参考资料最多搜索报错方案最容易找到且不需要Docker、Nginx这些额外概念。对一个以展示学习和开发能力为目标的毕设项目来说稳定、可复现、能说清楚原理远比技术先进性重要。3. 数据库表结构设计的核心要点以及容易出现的问题拿到这类项目源码我习惯先打开SQL脚本因为表结构决定了整个项目的天花板。一个让人眼前一亮的古诗词平台数据库至少要有五张以上的核心表而且每张表之间的关系要清晰。3.1 推荐的表结构划分以下结构参考了我常见到的几个优秀毕设项目综合归纳而来用户表t_user主键、用户名、密码MD5或BCrypt加密、昵称、角色字段1普通用户0管理员、头像URL、创建时间。这里有个容易做错的地方——很多人喜欢把角色单独建表再用中间表关联对毕设来说这是过度设计直接用单个字段存角色值即可答辩时还能解释为简化权限模型符合项目规模。朝代/分类表t_dynasty主键、朝代名称、描述、排序号。比如唐代宋代元代等基本分类。诗人表t_poet主键、姓名、字号、生卒年、朝代ID外键关联朝代表、籍贯、简介、作品数量统计字段。诗词表t_poem主键、标题、体裁诗/词/曲、朝代ID、作者ID、正文全文、译文、注释、创作背景、点击量、是否推荐/置顶。这张表是查询最频繁的所以要建立组合索引至少覆盖(dynasty_id, poet_id, is_recommend)。收藏表t_favorite主键、用户ID、诗词ID、收藏时间。这表要有唯一约束用户ID 诗词ID不然反复点收藏会重复插入数据。评论表t_comment主键、用户ID、诗词ID、评论内容、评论时间、父评论ID支持楼中楼回复。轮播图/公告表主键、图片URL、跳转链接、备注。这七张表做出来功能的延展空间一下就打开了。3.2 表设计时的三大经验教训第一冗余字段不要害怕。比如诗词表里除了作者ID最好也存朝代名称和作者姓名字段。有学生担心这不违反第三范式吗——在查询压力大于写入压力的业务场景下适度冗余是为了避免每次列表展示都要JOIN两张表。我遇到的真实情况是有些二手源码里的查询语句为了拿作者名做了三层JOIN结果列表页响应时间直接破了秒级这完全是不必要的。第二统一主键生成策略。SSM项目里最常见的做法是数据库自增ID配合MyBatis的useGeneratedKeystrue回填主键。但有的源码会使用UUID字符串作为主键这会带来一个联动问题——收藏表和评论表的外键字段也要跟着改长度而且UUID做主键在InnoDB引擎下会因随机插入导致页分裂。统一用自增ID别折腾维护成本最低。第三时间字段的默认值一定要写在DDL里不要依赖Java代码去塞值。比如建表语句写上create_time DATETIME DEFAULT CURRENT_TIMESTAMP。之前我在帮某个课程设计排查时就发现新增收藏能成功但页面列表时间列全是null排查到最后是因为Mapper里的INSERT语句没写存储时间字段而数据库也没设置默认值——这是非常典型的低级错误。4. 核心功能模块的实现逻辑与关键代码拆解下面的代码片段主要是为了让新手看清SSM项目里常规功能的写法套路。以诗词列表和检索为例整个链路是JSP页面发起请求 → Controller接收参数 → Service层处理业务 → Mapper层执行SQL → 返回ModelAndView或JSON → JSP渲染展示。4.1 组合检索的Controller层写法Controller RequestMapping(/poem) public class PoemController { Autowired private PoemService poemService; RequestMapping(/list) public String list(RequestParam(defaultValue 1) Integer pageNum, RequestParam(defaultValue 10) Integer pageSize, RequestParam(required false) String keyword, RequestParam(required false) Integer dynastyId, RequestParam(required false) Integer poetId, Model model) { // 把检索条件封装成一个查询对象 PoemQuery query new PoemQuery(); query.setKeyword(keyword); query.setDynastyId(dynastyId); query.setPoetId(poetId); // 调用分页查询 PageInfoPoemVO page poemService.queryPage(pageNum, pageSize, query); // 回显查询条件避免翻页后表单已填写的搜索词丢失 model.addAttribute(page, page); model.addAttribute(keyword, keyword); model.addAttribute(dynastyId, dynastyId); model.addAttribute(poetId, poetId); return poem/list; } }这段代码里有两个容易被忽略的细节一是Model中把搜索条件原样回显到页面否则用户翻到第二页后搜索框的keyword就空了二是RequestParam(required false)处理可选参数否则请求没带某个参数时SpringMVC会直接报400错。4.2 分页查询的Service层与SQL写法Override public PageInfoPoemVO queryPage(Integer pageNum, Integer pageSize, PoemQuery query) { PageHelper.startPage(pageNum, pageSize); ListPoemVO list poemMapper.selectByCondition(query); return new PageInfo(list); }配合PageHelper插件MyBatis会自动在selectByCondition的SQL后面拼上LIMIT。对应的SQL文件里关键就是这个动态条件select idselectByCondition resultTypecom.example.vo.PoemVO SELECT p.id, p.title, p.content, p.author_name AS authorName, d.name AS dynastyName FROM t_poem p LEFT JOIN t_dynasty d ON p.dynasty_id d.id where if testkeyword ! null and keyword ! AND (p.title LIKE CONCAT(%, #{keyword}, %) OR p.content LIKE CONCAT(%, #{keyword}, %) OR p.author_name LIKE CONCAT(%, #{keyword}, %)) /if if testdynastyId ! null AND p.dynasty_id #{dynastyId} /if if testpoetId ! null AND p.author_id #{poetId} /if /where ORDER BY p.id DESC /select这里解释一下为什么用where标签而不是直接写WHERE 11MyBatis的where会自动移除掉第一个AND前缀SQL日志打印出来是干净的WHERE p.title LIKE而WHERE 11虽然能跑但一旦被安全扫描就会被列为SQL注入风险的假阳性答辩时没必要给自己添麻烦。另外ORDER BY p.id DESC看似简单其实暗示了列表按最新录入优先排序。如果产品上要突出经典名篇可以增加一个is_recommend字段作为优先排序条件。4.3 收藏功能的事务边界收藏操作的业务逻辑非常简单先查收藏表是否存在记录不存在则插入。但在多线程或重复点击的极端场景下两个请求同时通过不存在判断会导致两条重复记录。解决方式有两种在insert时依赖收藏表的唯一索引冲突时捕获DuplicateKeyException返回已收藏提示在Service方法上加Transactional借助MySQL的行锁和唯一索引兜底。我推荐两种配合着用少写很多防御代码。实际上课设系统并发量极低硬编码判断也出不了事但把唯一索引加上是个好习惯成本几乎为零。4.4 管理员后台的批量录入思路古诗词数据量很大手工一条条录入不现实。做得好的源码后台一般会提供一个仿百度富文本编辑或JSON导入功能。最简单的实现方式是管理员准备一个JSON数组文件后端读取后批量INSERT。public int batchImport(ListPoem poems) { SqlSession session sqlSessionFactory.openSession(ExecutorType.BATCH); try { PoemMapper mapper session.getMapper(PoemMapper.class); for (Poem poem : poems) { mapper.insert(poem); } session.commit(); } finally { session.close(); } }注意这套代码用了ExecutorType.BATCH意思是所有INSERT统一到事务提交时再执行速度比单条INSERT快不少。数据量大时再配合rewriteBatchedStatementstrue的JDBC URL参数可以进一步提速。5. 调试期最高频的四个坑附完整排查链路这节是今天分享的重点。我调试过的类似源码项目不下两位数以下每个坑都让不同的人卡了很久其中前两个几乎是必踩。5.1 坑一JSP页面CSS/JS全部失效页面呈现纯文本现象项目能启动首页能打开但没有任何样式控制台刷一堆404。根因SpringMVC的前端控制器把静态资源请求也拦截了。这通常发生在DispatcherServlet的url-pattern配置为/时。排查链路打开浏览器F12看Network发现/css/style.css请求返回404回去看web.xml发现DispatcherServlet映射的是/再翻springmvc.xml发现里面没有配置静态资源放行。解决在springmvc.xml加一行mvc:resources mapping/static/** location/static/ /同时把所有静态资源统一放进/static/css、/static/js、/static/images目录下页面上引用路径写成${pageContext.request.contextPath}/static/css/style.css。这是SSM项目最标准的做法也是为什么很多老毕设的JSP页面里贴着一大段EL表达式拼路径的原因。5.2 坑二页面数据全是${xxx}原样输出现象页面能打开显示的不是数据而是一串${poem.title}这样的文本。根因JSP被当成了普通文本返回没有触发JSP解析。常见原因是web.xml里的Servlet声明顺序不对或者项目没有被当作Web项目加载。排查链路检查web.xml的JSP Servlet是否存在通常由Tomcat容器自动提供此步可跳过看IDEA的Project Structure确认该模块的Packaging是war确认Artifacts里是否引入了Web facet并把依赖包打进了WEB-INF/lib。关键点如果IDEA中依赖没有以exploded war方式部署Tomcat运行时根本找不到JspServlet依赖的类库页面就会变成一堆纯文本和EL表达式。解决方法是Project Structure里Artifacts的Output Layout把build/lib下的所有jar包拖入WEB-INF/lib目录下。5.3 坑三数据库链接报错连接被拒或驱动找不到现象启动时提示Cannot create PoolableConnectionFactory或者ClassNotFoundException: com.mysql.jdbc.Driver。排查链路确认MySQL是否在本地运行、端口是否为3306用命令行mysql -uroot -p验证检查jdbc.properties里的driverClassName、url、username、password是否和本地一致确认mysql-connector-java的jar版本5.x的连接串是jdbc:mysql://localhost:3306/db?useUnicodetruecharacterEncodingutf88.x的驱动类名变成了com.mysql.cj.jdbc.Driver且必须加上serverTimezoneAsia/Shanghai否则会报时区错。教训我见过不少项目在别人机器上跑得好好的传到新环境就起不来十有八九是MySQL账号权限问题和时区配置。建议一开始就在连接串里把serverTimezone和characterEncoding写全这两个参数对中文环境和时区环境都更友好。5.4 坑四POST请求中文乱码现象后台录入的诗词正文在前台显示成锟斤拷。根因Tomcat默认的POST请求字符编码是ISO-8859-1和页面的UTF-8不匹配。解决在web.xml加一个编码过滤器并保证字符集统一为UTF-8filter filter-nameencodingFilter/filter-name filter-classorg.springframework.web.filter.CharacterEncodingFilter/filter-class init-param param-nameencoding/param-name param-valueUTF-8/param-value /init-param init-param param-nameforceEncoding/param-name param-valuetrue/param-value /init-param /filter filter-mapping filter-nameencodingFilter/filter-name url-pattern/*/url-pattern /filter-mapping同时还要保证三处编码一致JSP页面的pageEncoding、MySQL表的DEFAULT CHARSETutf8mb4、以及jdbc.properties连接串里的characterEncodingutf8。这三者有一个不一致中文就会出错。6. 从部署到跑通的完整清单以及环境版本怎么配不踩雷源码拿到手第一件事不是读业务代码而是先把环境凑齐、把项目跑起来。这里给出我实践过N遍的配置组合软件推荐版本版本搭配说明JDK1.8SSM项目基于JDK1.8开发的最多不要图新鲜装JDK17部分老框架组件会报模块访问错误Maven3.6.x和IDEA集成最稳的版本Tomcat8.5.x对应Servlet 3.1兼容SSM和JSPMySQL5.7 或 8.05.7的兼容性最省心8.0需要加时区参数IDEA2019 任一版本新版IDEA需要手动排除Maven的pom.xml编码警告不影响运行运行步骤按顺序来用IDEA打开项目根目录的pom.xml以Maven项目方式导入等待依赖下载完成确认ssm相关依赖、jstl、pagehelper、jackson等已进入External Libraries在本地MySQL中执行db.sql生成数据库和测试数据修改resources/jdbc.properties中的数据库账号密码配置Tomcat ServerDeployment里选择xxx:war explodedApplication context设为/启动Tomcat浏览器访问http://localhost:8080/若看到首页和诗词列表则项目跑通。启动时如果报java.lang.ClassNotFoundException: javax.servlet.jsp.jstl.core.Config这是缺少jstl依赖在pom.xml里补上javax.servlet:jstl:1.2即可。如果报java.lang.NoClassDefFoundError: com/fasterxml/jackson/core/JsonProcessingException需要把jackson-databind依赖显式加上这在新版Maven的传递依赖管理下偶尔会出现。7. 拿到源码后怎么二次开发让它交出更有含金量的版本很多同学手里拿到的源码功能大同小异如果你想在答辩或作品展示时有点差异化的东西我建议从下面三个方向中挑一个做扩展。方向一诗词朗读与音频关联。为每首诗词增加audio_url字段在前端嵌入一个简易音频播放器。数据源可以使用公开的语音合成API也可以使用开放的古诗词音频库。这个功能实现的代码量很小但演示效果好——点击播放能立刻抓住听众注意力。方向二以意象为维度的标签体系。常见意象如明月流水杨柳孤舟在数据表中增加poem_tags字段或标签中间表在详情页展示相关意象的诗词推荐。这个扩展意味着新的表、新的接口、新的前台展示工作量适中且能讲出一个有说服力的故事从唐诗中的高频意象切入做关联阅读。这在内容型平台是一个经典的信息架构设计。方向三用户的诗笺收藏集。允许用户把收藏的诗词再归类到自定义的诗笺合集中比如相思送别壮志。这实际上是把一对多的收藏关系升级成多对多需要增加t_album收藏集和t_album_poem收藏集与诗词关联两张新表前台多一个我的诗笺页面。关于这三个方向我的个人倾向是优先做方向二因为它能巧妙地把数字化拔高到知识关联的层次而且不依赖第三方服务。还有一条额外的小技巧如果项目里带了完整的开发文档和数据库设计说明你可以把这些文档里的ER图、用例图、时序图重新用自己的理解重绘一遍并补一段系统测试章节记录几个测试用例和结果。答辩时老师翻到这一页观感会明显好于没人看过的几十页截图堆砌。我从调试多个同类项目中得到的体会是这个项目最练人的地方不在于某个算法或者某项高深技术而在于你能否把一个模糊的需求古诗词数字化一步步拆解成数据库表、接口、页面和权限控制然后再把它们串成一个能演示、能讲明白的系统。如果你能在原始源码基础上加入一个让用户眼前一亮的小功能比如意象聚合、随机诗词卡片或方言朗读这个项目的意义就不只是一份作业了——它会更像一件拿得出手的作品。