1. 项目概述与核心需求拆解1.1 这是一个什么样的项目先聊这个项目的定位。基于SpringBoot的个人博客网站本质上是三个能力打包在一起一是记录生活偏向个人随笔、日记、心情记录二是分享知识需要有文章发布、分类、检索这些内容管理能力三是展示作品也就是作品集功能适合放设计稿、摄影图、代码仓库链接之类的东西。说白了这个项目对照的不是传统意义上只写技术文章的博客而是把个人站点这个概念做完整——访客进来既能读到你的思考也能看到你做过什么还能感受到你是一个什么样的人。这就是为什么很多毕业设计选题会选它因为覆盖面够宽技术栈够主流又能做出一个看得见摸得着的完整系统。从技术选型上说SpringBoot MySQL Thymeleaf或者前后端分离配Vue加上MyBatis Plus做数据访问这套组合在毕业设计里是非常稳妥的。SpringBoot解决了配置地狱的问题起步快、生态成熟、资料多遇到问题几乎都能搜到答案。而对于导师来说这个选题的技术难度适中又有充分的扩展空间——想加分就加Redis缓存、加Elasticsearch全文搜索、加文件上传OSS不想太复杂也能在基础功能上做得非常完整。这个项目的目标人群也很清晰计算机相关专业的毕业生、想要搭建个人站点的开发者、以及需要一套可复用的博客系统代码做二次开发的人。如果你是零基础起步这个项目能让你把SpringBoot、MyBatis、前端模板引擎这套东西完整跑通一遍如果你有一定基础可以直接跳到核心模块看实现思路再针对性地扩展功能。1.2 需求层面的深度分析把标题拆开看三个关键词对应三组不同的功能需求记录生活对应的是文章管理模块。这里的文章类型应该支持区分生活随笔和技术博客可以考虑加一个文章分类字段来承载。展示形式上时间轴式的归档页面比单纯的文章列表更有生活感。分享知识对应的是内容检索与阅读体验。文章列表分页、分类筛选、关键词搜索、标签聚合、阅读量统计这些是基础。更进一步的还有上一篇下一篇导航、相关文章推荐、评论互动。知识分享的阅读体验关键在于排版和导航代码高亮、目录锚点这些细节反而比花哨的页面效果更实用。展示作品对应的是独立的作品模块。每个作品要有封面图、标题、描述、链接地址、技术标签。作品列表最好支持栅格布局展示点击进去有详情页。这个模块和文章模块虽然是都在一个系统里但数据结构和展示形式完全不同设计的时候要单独建表、单独写页面。再往后看博客网站还涉及用户维度管理员要能登录后台、发布文章、管理评论普通访客可能注册成为作者甚至投稿。毕业设计如果要控制规模单管理员模式就够了也就是只有你一个人能发文章、管理内容访客只能浏览和评论。如果想增加复杂度就做成多用户模式有注册登录、有角色权限但这意味着工作量会显著增加。我要说的核心建议是先明确你的目标是功能完整、能顺利答辩还是技术亮点突出、冲优秀论文。如果是前者单用户版足够如果是后者在单用户版的基础上加Redis缓存热文章、加定时统计、加评论敏感词过滤这些亮点比单纯做一个多用户注册登录更有技术含量。2. 技术架构与整体方案选型解析2.1 为什么选SpringBoot而不是其他框架现在做个博客系统方案多得是PHP的WordPress、Python的Django、Node的Hexo甚至纯静态的Hugo。但毕设场景下SpringBoot依然是最稳妥的选择原因很实在第一SpringBoot是目前企业级Java开发的事实标准。学了这一套SSMSpring SpringMVC MyBatis的老架构能看懂微服务的Spring Cloud Alibaba也能平滑过渡。对求职来说Java后端岗位大多要问SpringBoot做了这个项目等于把面试八股里的核心部分落了地。第二开发效率足够高。SpringBoot的自动配置机制把大量样板代码省掉了一个注解就能开启一个功能模块。配合Lombok省略Getter/Setter配合MyBatis Plus省略大部分SQL一个人完成整个系统是完全现实的。第三资料丰富到泛滥的程度。遇到任何报错把关键信息往搜索引擎一贴几乎必有现成答案。这对毕设时间紧的情况非常友好。我见过不少选型翻车的案例。有人选Python的FastAPI很轻量但国内企业用得少答辩时如果导师问为什么不用SSM答不好容易扣分。有人选Node的Express写起来快但Java方向的导师不一定认可。如果你的导师没有明确要求技术栈那就老实选SpringBoot这是兼容性最高的答案。2.2 总体架构单体应用还是前后端分离这是做技术选型时第一个要拍板的问题。两种方案我都做过说一下实际感受单体应用方案SpringBoot Thymeleaf模板引擎Java直接渲染HTML页面。优点是架构简单、开发量少、部署方便一个jar包搞定本地跑起来改完代码刷新就能看到效果。缺点是前后端耦合页面逻辑写在服务端模板里以后想拆成小程序或者App后端接口要重新设计。前后端分离方案SpringBoot只做API接口前端用Vue通常是Vue 2 Element UI或者Vue 3 Element Plus单独跑一个工程。优点是职责清晰接口可以复用前端页面更丝滑。缺点是工作量至少多三分之一要处理跨域、Token鉴权、构建部署等一系列额外问题。如果你对前端不熟或者时间紧选单体应用如果你前端功底不错、想把这个项目作为找工作的敲门砖选前后端分离。就毕业设计而言单体应用做出来的完整度往往更高因为精力都集中在了功能实现上而不是前后端联调。我这里后面的讲解以单体应用为主因为它的性价比最合适。2.3 核心依赖清单与版本选型直接给一份经过验证的依赖清单照抄就能跑通以单体应用方案为例依赖组件版本选择说明JDK1.8 或 17毕设环境建议1.8兼容性最好SpringBoot2.7.x不用3.x3.x要求JDK17且部分资料不可直接用MyBatis Plus3.5.x框架内置分页插件、代码生成器MySQL5.7 或 8.0建议8.0字符集utf8mb4ThymeleafSpringBoot 2.7自带服务端模板渲染Lombok最新稳定版简化实体类代码Druid1.2.x数据库连接池自带监控面板Hutool5.8.x工具类库处理日期、随机数等为什么特意强调SpringBoot用2.7.x而不是最新的3.x因为毕业设计阶段你搜索到的绝大多数博客、教程、视频都是基于2.x写的遇到问题能直接对号入座。3.x刚出的时候一堆依赖不兼容踩坑成本太高。技术选型的核心逻辑不是为了用最新而是为了在有限时间内把项目做完、做稳。3. 数据库设计与核心功能模块详解3.1 数据表结构规划数据库是博客系统的基础设计得合理不合理直接影响后面开发的顺畅程度。我吃过亏一开始图省事把文章和作品放一张表用类型字段区分结果后面扩展字段时痛苦得不行。后来老老实实拆开世界就清净了。按我的实践核心表可以这样规划表名用途关键字段user管理员和用户表id, username, password(MD5/BCrypt), nickname, avatar, rolearticle文章表id, title, summary, content, cover_image, category_id, tags, views, status, create_time, update_timecategory文章分类表id, name, description, sort_ordertag标签表id, name文章和标签可以建立中间表 article_tagcomment评论表id, article_id, nickname, email, content, parent_id, create_time, statuswork作品表id, title, description, cover_image, link_url, tech_tags, sort_order, create_timefriend_link友情链接表id, site_name, site_url, sort_ordersite_config站点配置表id, config_key, config_value用于存站点名称、公告、轮播图等这里有几个设计细节值得注意第一文章内容和作品描述都用TEXT类型TinyText不够用文章稍微写长一点就存不下了。第二status字段建议用int0表示草稿、1表示已发布、2表示回收站比直接用布尔值扩展性好。第三comment表的parent_id用来做楼中楼回复如果嫌麻烦可以先砍掉只保留一层的评论列表。第四所有表都加上create_time和update_time这是基本功后面做时间线展示和统计都用得到。3.2 文章发布与富文本编辑文章模块是整个系统里最核心的部分从用户角度看最重要的体验是写起来顺手和读起来舒服。这背后对应两个关键技术选型富文本编辑器和代码高亮。富文本编辑器我在实际项目中换过好几个。早期用UEditor功能全但界面老旧而且官方维护已经停了。后来换过wangEditor轻量、界面现代、中文文档友好在毕设和中小型项目中够用。如果你想要实时预览的Markdown编辑体验可以用editor.md专门为Markdown设计的编辑器非常适合技术博客场景。我的建议是如果你分享的知识偏技术写代码、写教程选Markdown编辑器存储时存原文展示时转HTML如果你偏生活记录写随笔、发图集选富文本编辑器所见即所得插入图片方便。也可以后台同时支持两种编辑器文章上加一个editor_type字段区分。代码高亮用的组件是highlight.js或prism.js。两者都很成熟我一般选highlight.js因为默认样式好看、支持的语言多、接入简单。后端返回文章内容后前端在页面加载完成时调用hljs.highlightAll()即可。注意Markdown编辑器提交的内容是纯文本Markdown展示时不能直接输出到页面上需要先做Markdown转HTML的渲染。Java后端可以用commonmark-java库或者在前端用marked.js处理。如果用marked.js处理时机要放在页面输出前避免XSS注入问题——服务端必须对内容做HTML标签过滤。3.3 作品展示模块的设计思路作品模块是这个项目区别于普通博客的亮点。很多人觉得作品不就是文章的变体吗其实不是。文章强调的是读作品强调的看两者的信息结构和交互形式差别很大。作品的核心字段是封面图、标题、一句话简介、详细描述、演示链接、相关技术标签。展示形式上要有两种视角列表视角用栅格布局展示每张卡片是一张封面图鼠标悬停时显示作品标题和简介点击进入详情。封面图比例建议统一裁剪成固定比例比如4:3或16:10在数据层面可以存一个list_cover和一个detail_cover避免页面样式错乱。详情视角大图居中、标题、技术标签、详细描述如果有演示链接就放一个醒目的在线预览按钮。技术标签可以点击点击后跳转到同标签的作品列表。作品模块的图片处理要注意一件事用户上传的封面图尺寸不可控一定要在后端做压缩和裁剪。大概率你不想引第三方服务可以在后端集成thumbnailator类库几行代码完成等比缩放和裁剪。3.4 前台展示与后台管理的功能划分一个完整的博客网站系统应该有两个端前台门户和后台管理。前台门户面向普通访客核心页面包括首页展示最新文章、热门文章、站点公告、轮播图文章列表页支持按分类筛选、按标签聚合、关键词搜索、分页文章详情页正文、目录、上一篇/下一篇、相关推荐、评论区时光轴页按月份倒序展示所有文章很有记录生活的感觉作品展示页栅格作品墙点击查看详情关于我页面个人简介、联系方式、站点头像友情链接页展示交换链接的站点后台管理面向管理员核心页面包括仪表盘文章数、评论数、浏览量统计概览文章管理文章列表支持搜索、筛选、批量删除、写文章、编辑文章分类管理增删改查分类调整排序评论管理审核、删除、回复评论作品管理上传作品、编辑作品、调整展示顺序站点设置站点名称、Logo、公告、页脚信息、社交链接前后台的路由会采用不同的访问路径前台/后台/admin。在SpringBoot中后台的页面放在templates/admin目录下前台页面放在templates目录下根据实际模板存放规则组织各自独立好维护也好打包。3.5 功能优先级规划哪些先做哪些后做把功能按优先级排序这个特别重要。我见过太多人上来就搞注册登录、搞评论结果核心的文章发布功能反而临近提交才仓促完成细节全是漏洞。合理顺序是这样第一优先级必做文章管理含富文本编辑、分类、标签、搜索、作品管理、首页和详情页、管理员登录。这些是系统的骨架没有这些就谈不上博客。第二优先级建议做评论功能、时光轴页面、友情链接、站点设置。这些能明显提升系统完整度答辩时有东西可讲。第三优先级加分项阅读量统计、相关文章推荐、代码高亮、图片懒加载、站点公告、访问统计。这些是锦上添花的功能每做出来一个都是答辩的加分点。我的经验是先把第一优先级的功能做到没有明显bug的程度再去碰后面那些。很多人的误区是在注册登录上花了太多精力——管理员登录本质就是一个登录表单加一个拦截器真的不用搭出一套完整的用户体系。4. 核心功能开发实操与关键代码实现4.1 项目初始化与基础配置SpringBoot项目初始化有两种常见方式一是用IDEA自带的Spring Initializr二是去Spring官网的脚手架页面生成。IDEA社区的版本就能做直接在New Project里选Spring Initializr填好Group和Artifact勾选Web、MySQL、Thymeleaf依赖生成后手工把MyBatis Plus等依赖加进pom.xml。pom.xml中核心依赖配置参考dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-thymeleaf/artifactId /dependency dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.3.1/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.33/version /dependency dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependencyapplication.yml配置文件中的几个关键配置项server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/personal_blog?useUnicodetruecharacterEncodingutf8mb4useSSLfalseserverTimezoneAsia/Shanghai username: root password: 123456 type: com.alibaba.druid.pool.DruidDataSource thymeleaf: cache: false encoding: UTF-8 mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl map-underscore-to-camel-case: true global-config: db-config: logic-delete-field: deleted logic-delete-value: 1 logic-not-delete-value: 0这里提几个实操中的坑数据源URL中要记得加characterEncodingutf8mb4否则中文会乱码。serverTimezone要指定Asia/Shanghai否则MySQL 8.0会报时区错误。thymeleaf的cache必须设置为false否则你改完模板刷新页面看不到变化还以为是代码没生效。4.2 文章发布与数据持久化链路文章发布这个功能的完整链路是后台表单提交 - 控制器接收参数 - 服务层校验并处理 - 数据持久化 - 前台页面展示。后端接收文章数据时建议直接用实体类Article接收而不是一个个散装参数。要注意的是富文本编辑器提交的内容是HTML片段服务端一定要做XSS过滤。可以用Hutool的HtmlUtil来转义危险标签或者直接用jsoup这个库做白名单过滤。这个点做没做答辩时专业程度一眼就能看出来。如果使用MyBatis Plus基础的增删改查完全不需要写SQL。在Mapper接口里继承BaseMapper就能获得常用的单表操作方法。多表关联查询比如文章关联分类名可以自己用注解SQL实现