Spring Boot传统文化传播网站项目：从需求拆分到部署上线全流程

做Spring Boot课程设计或者毕设，最容易卡住的有三件事：功能模块不知道从哪里拆，数据库表怎么设计才合理，代码写好之后又部署不起来。我手头刚好完整跑通了一个Spring Boot传统文化传播网站项目，程序、源码、数据库脚本、调试部署环境都齐全，还附带一篇1万字以上的论文文档。这篇文章就把整个项目从需求拆分到部署上线的全过程写透，重点讲那些踩过的问题和翻车的细节，你照着做不仅能把这套东西跑起来，也能快速改成自己想要的毕业设计题目。项目的系统界面截图放在文章最后面，方便你直观对照。

1. "传统文化传播"这个题目，需求到底怎么拆

1.1 为什么这个业务方向很适合做JavaWeb项目

传统文化传播网站，剥开表面看，本质上是一个内容信息发布平台。用户想看诗词歌赋、传统节日、非遗项目、历史故事，管理员要在后台维护这些内容。这个业务场景和新闻网站、企业官网、博客系统非常相似，但它天然自带分类体系，内容划分比普通博客更清晰，论文里也容易写出"传播优秀传统文化"的立意。数据库设计、页面展示、权限管理都可以围绕"内容"这条主线展开，不需要堆砌特别复杂的业务规则，做出来又像个完整产品，这就是它适合当课程设计和毕设的原因。

从技术角度看，这个题目把JavaWeb的核心知识点全串起来了：Spring Boot的自动配置和依赖管理、MyBatis Plus的增删改查、MySQL的表关系设计、Thymeleaf的页面渲染、Session会话控制、拦截器权限校验。做完一个项目，这些知识点不再是零散的，而是变成了一个能运行的整体。这也是评审老师比较看重的点。

1.2 角色划分：前台用户和管理员两条线

我把系统拆成两条主链路，一条给用户，一条给管理员。

前台用户侧，游客可以浏览网站首页、查看文章列表、查看文章详情，按分类筛选内容，还可以搜索文章标题。注册并登录后，可以在文章下方发表评论，可以把喜欢的文章加入收藏，方便下次继续阅读。整个浏览阅读流程符合一个内容网站的基本习惯，没有多余的复杂操作，上手成本很低。

后台管理侧，管理员登录成功后进入管理后台，主要做七件事：管理注册用户账号、管理文章分类、发布和编辑文章、删除违规评论、查看收藏情况、维护首页轮播图、发布网站公告。

两条线的功能边界非常清楚。用户侧重点在展示和互动，管理侧重点在内容维护。边界清楚的好处是什么？开发的时候可以分模块推进，写代码不打架，写论文也好分章节。我在做系统设计的时候，就是按这个"双端+七模块"的思路来画用例图的。

1.3 一个完整的使用场景是什么样的

拿用户浏览的一条完整路径来说。用户打开网站，在首页看到轮播图和最新文章推荐，点进"传统节日"分类，看到这一类文章的列表，再点标题进入详情页，阅读完整正文。读到一半觉得文章写得好，点收藏按钮收入个人书架，读完在评论区写下自己的感受，提交评论。

管理员这边的场景是：登录后台后，在评论管理里看到用户新增的评论，选中某条可以删除；在文章模块里点击新增文章，填写标题、选择分类、上传封面图、填写正文，点击发布，文章立刻在网站前台显示出来；在轮播图管理里上传一张新的节日海报，设置跳转链接，首页的轮播图马上更新。

这种场景描述放进论文的"需求分析"部分，评审老师一眼就能看懂系统是干什么的，画用例图也有现成素材。所以做项目第一步不是急着写代码，而是先把这个场景捋顺，越具体越好。

2. 技术选型和开发环境：为什么最终定格在这些工具上

2.1 开发环境清单

项目标题里写明了包含开发环境，意思是拿到手上后，环境照着配就能在本地完整跑起来。我自己的环境组合如下，供参考。

这套组合不挑机器，学校机房、自己的笔记本都能装。版本不用刻意追求最新，够用、稳定、出问题能搜到答案才是关键。我见过不少同学上来就装最新版JDK，结果Spring Boot老项目启动不了，来回折腾半天，最后发现是版本兼容问题，真的很浪费时间。

2.2 Spring Boot版本选择：2.7.x比3.x更适合课程设计

现在Spring Boot已经出到3.x了，但我在这个项目里还是用2.7.x。原因很现实：3.x要求JDK17起步，很多同学的本地环境还是JDK8，学校的教材、课程设计模板也大多基于JDK8。如果项目用Spring Boot 2.7.18，既能稳定跑在JDK8上，又不会像早期2.1、2.2版本那样出现各种兼容麻烦。

另外，Spring Boot 2.7.x的自动配置、Starter机制和3.x核心思路差距不大，学到的原理后面迁移到新版本也成立。网上关于2.7.x的教程和报错解决方案特别多，遇到问题一搜就有答案，这对项目进度来说是实打实的保障。

2.3 ORM选型：MyBatis Plus让单表操作省出一半时间

数据库操作我用的是MyBatis Plus，不是原生MyBatis。拿文章表来说，基础的增删改查方法在BaseMapper接口里已经自带：selectById、insert、updateById、deleteById，Service层通过IService接口也能直接拿到getById、save、updateById、removeById这些方法。相比手写MyBatis的XML映射文件，工作量至少省三分之一。

那么多表关联怎么处理？比如文章列表要显示分类名称，评论列表要显示用户昵称，这种场景我在Mapper的XML里写JOIN查询，MyBatis Plus并不限制自定义SQL。用它的核心策略是：单表操作用内置方法，多表操作用自定义SQL，两手抓，既不累又能应对复杂需求。

2.4 前端方案：Thymeleaf服务端渲染，不搞前后端分离

前端我用Thymeleaf模板引擎搭配Bootstrap，没有把项目拆成前后端分离架构。对课程设计和毕设来说，这个选择非常明智。如果搞Vue加Spring Boot前后端分离，意味着要单独管理前端项目、处理跨域、多学一套Node环境，周期拉长不少。

Thymeleaf的好处是所有页面服务端渲染，项目启动后直接在浏览器访问localhost:8080就能看到完整系统，部署也简单，打一个jar包全部搞定。配合Bootstrap的栅格系统和组件库，页面的视觉设计一样可以做到位。做传统文化主题页面时，主要把配色换成暗红、米黄、墨色这些偏古风的色调，标题用带书法感的字体，界面放进论文里辨识度很高。

3. 数据库设计：8张表怎么撑起整个传统文化网站

3.1 从需求到数据表：核心表结构拆解

数据库层面的设计我是围绕内容来做的，最终建了8张核心表。

第一张是管理员表，字段主要是id、账号、密码、创建时间。第二张是注册用户表，记录用户名、密码、昵称、头像、注册时间。第三张是文章分类表，存分类名称、排序、状态。第四张是文章表，整个系统的核心，包含标题、摘要、正文、分类ID、封面图、浏览量、发布状态、创建时间。第五张是评论表，关联文章和用户。第六张是收藏表，同样关联文章和用户。第七张是轮播图表，存图片路径、跳转链接、排序。第八张是公告表，存公告内容、发布时间、状态。

文章表的字段设计要单独说一句。正文用TEXT类型，可以存较长的内容；摘要用VARCHAR(500)；发布状态用TINYINT，0表示草稿，1表示已发布。这些字段设置直接决定后台编辑功能和前台展示逻辑怎么实现。分类表里的排序字段也很关键，决定前台分类导航里分类出现的先后顺序。

3.2 表之间的关系是怎么画的

把这8张表的关系理清楚：文章和分类是多对一关系，一篇文章属于一个分类，一个分类下可以有多篇文章；文章和评论是一对多关系，一篇文章可以有多条评论；用户和评论是一对多关系，一个用户可以评论多篇文章；用户和文章通过收藏表形成多对多关系，一个用户能收藏多篇文章，一篇文章也能被多个用户收藏。

我特意没有在数据库层加物理外键，只在逻辑上维护关联。原因很简单：删除文章时如果有物理外键约束，必须先删评论、删收藏、再删文章，顺序错了直接报错。用逻辑外键，代码里控制删除顺序就行，省掉一个大坑。这个设计经验在论文的数据库设计章节里也可以写进去，算是一个设计亮点的说明。

3.3 建表SQL的关键片段

下面是文章表的建表SQL，可以直接拿去做参考。

CREATE TABLE `content_article` ( `id` bigint(20) NOT NULL AUTO_INCREMENT, `title` varchar(200) NOT NULL COMMENT '文章标题', `summary` varchar(500) DEFAULT NULL COMMENT '摘要', `content` text COMMENT '正文内容', `category_id` bigint(20) DEFAULT NULL COMMENT '分类ID', `cover_image` varchar(255) DEFAULT NULL COMMENT '封面图', `view_count` int(11) DEFAULT '0' COMMENT '浏览量', `status` tinyint(4) DEFAULT '1' COMMENT '0草稿 1发布', `create_time` datetime DEFAULT CURRENT_TIMESTAMP, `update_time` datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='传统文化文章表';

字符集一定用utf8mb4，这样才能完整存储生僻字和特殊符号。传统文化内容里经常碰到生僻古文、注音符号、各种异体字，如果用了utf8或者latin1，入库就乱码，前台页面显示出来也是问号。这个细节很多人容易忽略，真遇到了能折腾大半天。

4. 项目初始化与Spring Boot代码结构

4.1 从Spring Initializr开始生成工程

打开IDEA，在New Project里选择Spring Initializr，然后填写项目坐标。Group填com.example，Artifact填culture，包名会自动生成com.example.culture。Language选Java，Type选Maven，Packaging选Jar，Java Version选8。这里注意Java Version要选8，对应本地的JDK版本，不要默认选最新的。

Dependencies这一步，我勾选了Spring Web、Thymeleaf、MySQL Driver、Lombok。MyBatis Plus不在Spring Initializr的可选列表里，需要在pom.xml里手动添加依赖。Lombok是省代码利器，在实体类上加一个@Data注解，自动生成getter和setter，少写几百行重复代码，项目看起来也清爽很多。

4.2 pom.xml里的关键依赖配置

MyBatis Plus的依赖写法如下，注意版本要和Spring Boot 2.7.x匹配。

<dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-boot-starter</artifactId> <version>3.5.3.2</version> </dependency>

这个版本兼容性好，网上教程多，遇到版本相关的问题容易查解决方案。如果换成更高版本，比如3.5.5以上，在某些Spring Boot 2.7.x组合下可能出现分页插件配置不生效的情况，排查起来比较麻烦。

4.3 分层架构和包结构设计

包结构我按标准三层架构来分。

com.example.culture ├── controller # 控制层，接收请求 ├── service # 业务层接口 │ └── impl # 业务层实现 ├── mapper # 数据访问层 ├── entity # 实体类 ├── config # 配置类，拦截器、密码加密等 └── common # 通用返回结果、异常处理、工具类

项目骨架搭好之后，后面的业务代码基本都是往这些包里填内容。论文里画系统架构图的时候，直接把这个包结构向上抽象一层，就是最标准的"表现层-业务层-数据访问层"三层架构，架构评审那一块基本不需要额外费脑子。

5. 核心功能实现：登录、文章、评论、收藏，代码怎么组织

5.1 管理员登录与登录拦截器

登录是后台所有功能的前置条件。管理员在登录页填写账号密码，表单提交到/admin/login接口，Controller里用QueryWrapper查管理员表，然后比密码。密码我用了MD5加盐存储，数据库里不存明文，安全性在论文里也说得过去。登录成功后把管理员id和账号放进Session，标记登录状态。

紧接着要处理一个关键问题：不加拦截的话，用户手工输入后台URL就能跳过登录，这是很多项目容易忽略的漏洞。解决思路是写一个WebConfig类实现WebMvcConfigurer接口，注册HandlerInterceptor拦截器。拦截器里对/admin/**路径做判断，如果Session里没有管理员信息就重定向到登录页。这个拦截器的代码量很小，但价值很大，论文的安全性设计章节也有的写。

5.2 文章列表分页与详情逻辑

前台文章列表分成两类。一类是按分类进入的列表页，另一类是首页推荐的混合列表，都走同一个Service方法。根据QueryWrapper构造条件，调用MyBatis Plus的分页查询，传给分页参数current和size，返回结果封装成统一Page对象，包含当前页数据、总条数、总页数。前端用Thymeleaf的each属性循环渲染，底部分页导航用Bootstrap的翻页组件。

文章详情页的逻辑不多，但有个细节值得留意：每访问一次详情页，浏览量加1。这个更新直接在Controller里处理后调用update方法，给viewCount字段加1，不需要额外写定时任务，也不用Redis做计数器，简单直接有效。测试的时候你刷新一次页面，数字变一次，效果立竿见影。

5.3 评论和收藏：用户互动的两个入口

评论的逻辑是用户登录状态下提交评论，后端拿到文章ID、用户ID、评论内容，插入评论表。列表查询评论时用JOIN关联用户表，把评论人的昵称显示出来。管理员后台多了删除评论的权限。这里要注意的是，插入评论前判断一下用户是否登录，前端按钮控制加后端Session校验，双保险。

收藏逻辑也类似。用户点收藏按钮，前端发请求到/favorite/add接口，后端判断这个文章和用户的组合是否已存在，存在就提示"已收藏"，不存在就插入收藏表。个人中心里再做"我的收藏"列表，分页展示，支持取消收藏。这几个交互逻辑都不复杂，但能把系统的功能完整度拉高一个档次，非常值得写上。

5.4 接口设计的一个小规范

所有的接口返回值我统一封装成一个Result对象，包含code、message、data三个字段。code等于200表示成功，code等于500表示服务端异常，400可以表示参数错误。前端拿到这个统一结构后，根据code做判断，该提示就提示，该跳转就跳转，不会出现页面卡死或者白屏。

这个Result类放在common包里，是全局通用组件。写论文的时候，在"系统设计"章节提一句"统一响应格式设计"，再贴一下类的代码，这部分的篇幅和质量就都有了。

6. 调试部署全流程：从本地跑起来到服务器上线

6.1 第一步：导入数据库

打开Navicat，新建数据库culture_db，字符集选utf8mb4，排序规则选utf8mb4_general_ci。然后右键运行SQL文件，把项目里的culture_db.sql导入。导入完成后刷新数据库，能看到8张表以及部分测试数据。SQL文件里如果已经带测试数据，网站一启动就有内容可看，不需要手工逐条录入，这对验收演示特别重要。

6.2 第二步：修改配置并启动

用IDEA打开项目，等待Maven下载依赖。修改application.yml里的数据库账号密码，改成自己本地的MySQL账号密码。admin账号密码可以在SQL文件里提前查好，也可以先改数据库。然后直接运行启动类里的main方法。控制台能看到Spring Boot的彩色Logo，看到Tomcat started on port(s): 8080这行日志，说明本地启动成功，浏览器访问localhost:8080就能看到网站前台。

6.3 几个最容易翻车的启动报错

跑这种项目时我见过不少同学踩坑，这里直接列出最常见的四个报错和解决办法。

第一个是端口被占用。IDEA控制台报"Port 8080 was already in use"，打开任务管理器找到占用8080端口的进程结束掉，或者把application.yml里的server.port改成其他端口，比如8081。

第二个是数据库连不上。报"Access denied for user 'root'@'localhost'"，基本可以确定是账号或密码配置错了，去application.yml核对。

第三个是时区报错。报"The server time zone value"相关错误，解决方式是在JDBC连接URL后面加上serverTimezone=Asia/Shanghai，完整写法是jdbc:mysql://localhost:3306/culture_db?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai。

第四个是找不到模板页面。报"Error resolving template"，多半是Thymeleaf页面路径写错。检查Controller里return的页面名和templates目录下的文件路径是否一致，这个排查思路可以用浏览器地址栏的路径反推。

6.4 打jar包并部署到服务器

本地跑通后要部署到服务器，先执行Maven的package命令，打成jar包。在IDEA右侧Maven面板双击package，target目录下会生成culture-0.0.1-SNAPSHOT.jar。服务器上安装JDK8和MySQL，把jar包用FTP工具传上去，执行：

java -jar culture-0.0.1-SNAPSHOT.jar

如果希望关闭窗口后项目不退出，用nohup方式启动：

nohup java -jar culture-0.0.1-SNAPSHOT.jar > app.log 2>&1 &

这里有一个非常关键的坑：服务器上的MySQL端口、账号、密码通常和本地不一样，所以一定要在jar包同目录放一个外部的application.yml，覆盖包内的默认配置。Spring Boot读取配置时，外部配置文件优先级高于jar包内部的，这个机制用对了能省很多事。

6.5 部署完后如何自测

部署完成后不要急着交差，按这个顺序自测一遍：浏览器打开服务器IP加端口，先看网站首页能否正常加载，图片能不能显示；点进一篇文章详情，看浏览量是否加1；尝试注册一个新用户，再登录发表评论；用管理员账号进后台，新增一篇测试文章，回前台看是否出现。都走通了，项目才算真正交付。

7. 关于论文文档和系统界面的几点说明

7.1 万字论文的内容结构

项目附带的论文文档字数在1万字以上，论文结构按标准毕设模板来写。一上来是摘要和关键词，然后第一章绪论写背景和意义，第二章相关技术介绍，写Spring Boot、MyBatis Plus、MySQL、Thymeleaf，第三章系统分析，第四章系统设计，第五章系统实现和功能展示，最后是测试和总结。这个结构是学校普遍认可的框架，照着填充内容就行，不用自己另起炉灶。

其中"测试"章节不用写得太复杂，围绕登录、文章发布、评论、收藏这几个核心功能，写几个典型测试用例，列出输入、操作步骤、预期结果、实际结果，一个表格列出来就是不少篇幅，看起来还特别规范。系统架构图、功能模块图、数据库E-R图这三张图是论文的硬通货，务必放上去。

7.2 系统界面的截图放在最后

项目提供的系统界面截图放在文档的最后面，包括网站首页、文章列表页、文章详情页、登录页面、后台管理界面等。把截图按顺序插入论文的"系统实现"那一章，配合文字说明，整个项目的完整度一下子就体现出来了。

提个建议：拿到这类项目之后，不要只满足于把项目跑起来。先把数据库表关系用纸画一遍，再跟着Controller到Service再到Mapper的调用链走一遍，理清一套流程后，这个项目才真正属于你。改页面样式、增加字段、换图片素材都是小工程，核心代码逻辑吃透了，任何传统文化网站的需求你都能往里套。

最后再说一句，我实际跑这个项目时唯一的教训就是数据库字符集，一开始图省事用了默认的utf8，导入带生僻古文的测试数据直接乱码，后来把所有表改成utf8mb4才解决。你如果照着这个项目做，建库时一定注意这一点，能省下后面查乱码的大量时间。