做过Java Web开发的同学应该都有体会Spring Boot项目遍地都是但真正能让人从零到一跑通、看懂、能改、能讲的项目其实不多。个人博客系统正好卡在这个位置上——它足够小不至于让你淹没在业务逻辑里它又足够完整前后台、登录权限、增删改查、文件上传、分页搜索全都有。我接触过不少基于Spring Boot的博客系统源码也带过一些同学用这类项目做毕设或者练手今天这篇就把这套“源码文档运行视频讲解视频”的博客系统彻底拆开聊一聊从技术选型到数据库设计从本地跑起来到源码怎么读、面试怎么讲一次说透。1. 项目概述与技术选型思路1.1 为什么个人博客是Spring Boot练手的“黄金项目”很多人学Spring Boot有个误区上来就去啃官方文档或者跟着教程写一个连数据库都不连的Hello World。学完之后真正面对“让我独立做个系统”的需求时依然一脸懵。个人博客系统恰恰是把理论和实战串起来的那根线。从功能上看一个标准的个人博客系统至少涵盖这样几条线文章发布与编辑、分类与标签管理、评论互动、站内搜索、用户登录与权限控制、后台管理界面。这些功能几乎是所有业务系统的缩影。你把这些吃透了以后去做商城、后台管理系统、企业官网会发现底层逻辑都是相通的无非是换几个实体类、多几张业务表的事。从技术上看Spring Boot在这类项目中能发挥它最大的优势自动配置、Starter机制、内嵌Tomcat。你不需要再像SSH时代那样写一堆XML配置一个带main方法的启动类就能把整个Web应用跑起来。配合Spring MVC做接口、MyBatis做持久层、Thymeleaf做服务端页面渲染整个技术链路清晰、工程结构简洁特别适合拿来作为理解“Java后端是怎么工作”的样本。1.2 技术栈选型分析这套博客系统的技术栈属于非常典型且稳妥的组合Spring Boot MyBatis/MyBatis-Plus MySQL Thymeleaf Bootstrap/Layui。我逐一解释一下为什么这样选。Spring Boot是整个项目的地基。它的核心价值不在于某个单独的功能而在于把Spring生态里那堆复杂的配置过程高度自动化。你用spring-boot-starter-web引入Web能力用spring-boot-starter-thymeleaf引入模板引擎用spring-boot-starter-validation引入参数校验依赖一加、配置文件一写该有的能力就都有了。这是早期SSH时代无法想象的开发体验也是面试时经常被问到的“自动配置原理”的实践基础。持久层这块个人博客的实体关系并不复杂但增删改查的频次很高。MyBatis-Plus是在MyBatis之上做的增强内置了通用的Mapper方法单表CRUD基本不用写SQL条件构造器QueryWrapper可以非常方便地拼查询条件。比如按分类查文章、按关键词模糊搜索写起来就是几行代码的事。底层SQL还是你自己熟悉的MyBatis那一套只是省掉了大量重复的XML映射文件。数据库用MySQL不用多说开源、稳定、资料多本地开发用5.7或者8.0都行。这里给个建议如果你用的MySQL 8.0驱动依赖务必用mysql-connector-j新版坐标而不是老旧的com.mysql.jdbc.Driver否则连接数据库的时候会踩坑。模板引擎Thymeleaf是Spring Boot官网推荐的服务端渲染方案它的特点是HTML文件里直接写th:text这类属性前后端不分离的场景下非常顺手。配合Bootstrap或者Layui这类前端框架不写一行JS也能把界面做到像模像样。当然这里要说明一下现在企业里前后端分离是大趋势Vue/React Spring Boot的组合更常见但作为学习项目服务端渲染能让你更直观地看到数据是怎么从数据库一路走到浏览器页面的这个“全链路可视”的价值非常宝贵。2. 核心功能模块与数据库设计2.1 功能模块拆解一个完整的个人博客系统从使用角色上可以分成两个视角游客视角和管理员视角。这两个视角决定了系统的功能边界和权限设计。游客侧的功能就是任何一个普通访客在博客上能做的事。首页展示文章列表支持按分类、标签筛选点进文章详情页可以查看正文和评论填写昵称和邮箱就能发表评论。大多数博客系统还会提供按时间归档的功能把文章按“某年某月”分组展示形成一条时间轴。这些功能看起来简单但背后涉及列表分页、多表关联查询、评论归属等一系列基础操作。管理员侧的功能则是这套系统的“后台管理面”。管理员登录之后可以进入一个完全不同的界面进行文章的发布与编辑、分类和标签的维护、评论的审核与删除以及个人信息的设置。这里有一个常见的设计选择后台界面是做成独立的模块还是跟前台混在一起我的建议是既然是学习项目干脆把前后台完全分离——一个/admin前缀下的后台控制器一套独立的后台页面模板这样既能体现模块化设计思想也方便后续做权限控制。权限控制这块最基础的方案就是登录拦截器 Session。用户输入用户名密码登录成功后把用户信息写入Session拦截器对/admin/**路径做校验Session里没有用户就重定向到登录页。更进阶一点可以引入Spring Security或者Sa-Token但对这个项目来说拦截器已经足够了而且更容易被初学者理解。2.2 数据库表设计与关联关系数据库设计是整个项目的地基地基打不好写代码的时候到处别扭。这套博客系统的核心表我整理了一下大致是这些文章表t_article主键id、标题title、正文内容content、摘要summary、封面图cover_image、分类id、是否置顶、是否发布、浏览量、创建时间、更新时间。其中分类id是外键关联分类表。分类表t_category主键id、分类名称name、分类别名alias做URL时用、排序sort。分类和文章是一对多关系一篇文章只能属于一个分类但一个分类下可以有多篇文章。标签表t_tag主键id、标签名称name。标签和文章是多对多关系所以需要一张中间表t_article_tag字段就两个article_id和tag_id。评论表t_comment主键id、文章id、昵称nickname、邮箱email、内容content、父评论id用于做楼中楼回复、创建时间。评论只挂在文章下面和文章是多对一关系。用户表t_user主键id、用户名username、密码password、昵称nickname、头像avatar、角色role。个人博客的管理员通常只有一个但为了结构完整还是保留角色字段方便以后扩展多用户。这套表结构覆盖了常见的一对多、多对多、多对一关系几乎是一个微缩版的“数据建模教材”。建表的时候我有几个经验一是时间字段用datetime而不是varchar排序、查询都方便二是内容字段用longtext或者mediumtext博客文章不会只有几百字三是所有表都加上create_time和update_time字段哪怕MyBatis-Plus可以自动填充有这个字段在排查数据问题时你是能省很多力气的。2.3 核心接口设计思路接口设计上这个项目走的是经典REST风格但也保留了传统表单提交的便利性。拿文章管理的接口来说GET /—— 首页带分页参数pageNum、pageSize返回文章列表GET /article/{id}—— 文章详情按id查询同时浏览量加一GET /category/{id}—— 按分类查看文章列表GET /tag/{id}—— 按标签查看文章列表POST /comment—— 提交评论参数包含文章id、昵称、邮箱、内容GET /admin/article/list—— 后台文章管理列表GET /admin/article/edit/{id}—— 后台编辑文章页面POST /admin/article/save—— 保存文章新增和更新共用这一个接口POST /admin/article/delete/{id}—— 删除文章GET /admin/login、POST /admin/login—— 后台登录页和登录提交这里有个设计细节值得琢磨新增和更新为什么共用一个save接口因为编辑文章时如果新增走一套、更新走一套前端表单要处理两种提交地址后端也要写两个近乎重复的方法。共用接口的逻辑其实很简单——传入的id有值就执行更新id为空就执行插入前端只需要把id隐藏域带上就行。这样代码量减少了逻辑也更集中。3. 从零到一本地运行与项目导航3.1 环境准备与版本选择拿到源码之后先别急着打开代码看先把运行环境装好。这套博客系统本地的运行环境非常标准JDK 8或11、Maven 3.6、MySQL 5.7/8.0、IDEA。如果你的机器上已经装了这些直接跳过这一步如果还没装我按顺序说一下注意事项。JDK版本这块Spring Boot 2.x对JDK 8和11都支持得很好我一般建议用JDK 8不是因为新版本不好而是因为JDK 8跟大多数教学视频、网上的资料经验最匹配遇到问题时你能搜到最多解决方案。如果你用的是JDK 17那Spring Boot版本建议选2.7.x以上否则会有兼容性问题。这里额外提醒一句Spring Boot 3.x强制要求JDK 17如果你的项目是基于Spring Boot 2.x写的就别用JDK 17跑否则启动阶段直接报错而且报错信息很可能让你一头雾水。Maven装好之后建议在settings.xml里把镜像源换成阿里云的否则第一次拉依赖能把人急死。IDEA里有自带Maven但默认用的是国外的中央仓库下载速度非常不稳定。更换镜像的做法很简单在mirrors节点里加一个mirror idaliyunmaven/id mirrorOfcentral/mirrorOf name阿里云公共仓库/name urlhttps://maven.aliyun.com/repository/public/url /mirrorMySQL装好之后要记得把数据库的编码设置为utf8mb4。utf8mb4和utf8的区别在于前者能存emoji表情和生僻字而评论区这类场景偏偏最容易出现这些内容。字符集不匹配的典型症状就是评论里存了个emoji程序报Incorrect string value错误这是很多新手会踩的经典坑。3.2 配置修改与启动流程环境装好之后整个启动流程并不复杂但有几个配置必须改成你自己的。项目里的核心配置文件是src/main/resources/application.yml也可能是application.properties看项目习惯需要改动的主要是这几项spring: datasource: url: jdbc:mysql://localhost:3306/blog?useUnicodetruecharacterEncodingutf8mb4serverTimezoneAsia/Shanghai username: root password: 你自己的数据库密码 driver-class-name: com.mysql.cj.jdbc.Driver server: port: 8080数据库的连接信息是必须改的。serverTimezoneAsia/Shanghai这个参数建议保留否则使用MySQL 8.0时时区设置不正确会导致日期时间字段在存取时出现8小时的偏差。characterEncodingutf8mb4对应前面说的字符集配置。useUnicodetrue是一个兼容性参数老项目里基本上都有写上无妨。数据库本身怎么准备项目里一般会附带一个blog.sql或者db.sql文件。用Navicat或者命令行执行这个SQL文件数据库和表结构就自动建好了。执行时注意SQL文件本身的编码要和数据库的编码一致如果打开SQL文件发现中文全是乱码那执行完之后表里的注释和数据也是乱的。这个用记事本打开看几眼就能判断出来。配置改完之后启动就非常简单了——IDEA里找到主启动类BlogApplication.java右键运行。看到类似这样的日志就说明启动成功了Tomcat started on port(s): 8080 (http) with context path Started BlogApplication in 10.123 seconds然后在浏览器里访问http://localhost:8080前台页面就出来了访问http://localhost:8080/admin/login就是后台管理登录页。3.3 项目结构导航第一次打开一个Spring Boot项目最大的困惑往往是“这么多文件和目录我该从哪里看起”。这套博客系统的目录结构大致是标准的三层架构加模板分层我按顺序梳理一遍。Java代码部分以主启动类的包路径为根往下依次是controller—— 控制器层接收HTTP请求、调用服务、返回页面或JSON数据。这是请求进入后端的第一站。service—— 业务逻辑层接口加实现类的方式处理实际的业务规则。mapper—— 数据访问层MyBatis的Mapper接口对应数据库的增删改查操作。entity—— 实体类层对应数据库表的Java对象属性基本和表字段一一对应。config—— 配置类比如拦截器注册、跨域配置等。common或util—— 公共类和工具类比如统一返回结果、MD5加密工具等。resources部分static—— 静态资源目录存放CSS、JS、图片等。templates—— 模板页面目录Thymeleaf的HTML文件都在这通常会按admin和index等子目录区分前后台页面。application.yml—— 全局配置文件。mapper或mybatis—— 如果项目用了MyBatis的XML映射文件一般会放这里。读代码的时候我的建议是不要从Controller开始而是先看entity和表结构搞清楚这个系统里有哪几类数据、它们之间什么关系然后再看Controller有哪些接口最后再深入到Service和Mapper。这个顺序和开发时的思路是一致的先有数据和数据结构才有基于数据的操作。4. 源码导读从请求到响应的完整链路4.1 三次“经典跳转”看懂三层架构很多新手看Spring Boot源码容易陷入一个误区——试图从头到尾一行一行读结果没读几十行就晕了。正确的姿势是跟着一个具体请求走一遍完整链路把主干摸清了枝节自然就通了。这里我选三个最经典的请求来做演示。第一个是文章详情页请求GET /article/{id}。请求先到Controller一个标注了GetMapping(/article/{id})的方法接收路径里的id然后调用ArticleService.getArticleById(id)。Service层做了两件事先把文章的浏览数加一再从数据库查询文章详情。查询结果通过ArticleMapper走到数据库返回一条文章记录最后Controller把这个记录塞进Model返回一个名为article的视图Thymeleaf渲染出完整的HTML。整个过程是一条干净的直线Controller → Service → Mapper → MySQL → Mapper → Service → Controller → 页面。第二个是文章列表页请求GET /?pageNum1pageSize10。区别在于Service里用了MyBatis-Plus的Page分页插件先构造一个分页条件然后传入Mapper执行分页查询。结果是一个带records、total、current、pages等属性的分页对象前端拿到这个对象就能同时渲染出文章列表和页码条。分页是几乎所有Web系统的标配能力这个逻辑吃透了以后做任何列表页都是同一个套路。第三个是后台登录请求POST /admin/login。这个流程稍微复杂一点。Controller收到表单提交的用户名和密码后先在Service里通过用户名查询用户然后用MD5工具类把明文密码加密和数据库里存的值比对。比对成功就设置Session属性然后重定向到/admin/index失败则带着错误提示返回到登录页。这里的密码加密是个值得关注的点——数据库里存的绝不能是明文密码MD5虽然不算强加密但至少完成了“不可逆存储”的初步要求。日常练手可以继续用做正经项目就要换成BCrypt这类更靠谱的算法了。4.2 拦截器、全局异常与统一返回源码里还有几个容易被忽视但很重要的设计面试时拿出来讲会让别人觉得你真的“吃透”了这个项目。登录拦截器是权限控制的核心实现。在WebMvcConfigurer里注册一个HandlerInterceptor重写preHandle方法从Session里取用户取不到就重定向到登录页。关键点是addPathPatterns和excludePathPatterns——拦截的是/admin/**放行的是登录页本身和静态资源。这样设计的好处是权限逻辑和业务代码完全解耦Controller里的方法不需要关心“我需不需要登录”拦截器已经统一处理了。全局异常处理通过ControllerAdvice注解实现。这个类可以捕获整个Controller层抛出的异常并返回一个统一格式的错误页。比如ArticleService里查不到文章、或者是参数类型转换错误如果没有全局异常处理用户看到的是Spring默认的白叶错误页有了它异常信息被吞掉转而显示一个友好的“页面不存在”页面。这种处理方式的价值在于把异常处理逻辑从每个方法里抽出来集中管理。统一返回结果是前后端数据交互中的约定。项目里一般会有一个Result类包含code、message、data三个字段。成功时code为200失败时为500。这个设计在前后端分离的项目里几乎是标配在服务端渲染的项目里主要用于AJAX请求——比如前台提交评论后端返回一段JSON前端根据code判断提交是否成功再决定要不要刷新页面。4.3 MyBatis-Plus条件构造器的实战用法这套项目里非常高频地用到了MyBatis-Plus的LambdaQueryWrapper这是写起来最舒服、也最容易出错的点。我举一个实际应用的例子——在后台文章管理页根据标题关键字搜索文章LambdaQueryWrapperArticle wrapper new LambdaQueryWrapper(); wrapper.like(StringUtils.hasText(keyword), Article::getTitle, keyword); wrapper.orderByDesc(Article::getCreateTime); PageArticle page new Page(pageNum, pageSize); PageArticle result articleMapper.selectPage(page, wrapper);仔细看这段代码的精妙之处like方法的第一个参数是一个布尔值当keyword为空字符串时连查询条件都不会拼接进去从根源上避免了“查询条件为空却还想过滤”的尴尬。这种写法在实际开发中极其常见强烈建议亲手敲一遍理解它的语义。orderByDesc排序selectPage自动分页整个查询从拼SQL到执行几乎不需要你写一行数据库语句。还有一个很容易忽略但又特别方便的方法——selectById和selectBatchIds。前者按主键查单条记录后者按主键集合批量查。在查评论列表时一个文章id对应多条评论如果你的数据模型设计得当一条查询就能把这些评论一次性取出来而不是循环里逐条查数据库——那种N1查询性能非常差是SQL优化中最典型的反面教材。5. 常见问题排查与面试延伸5.1 本地运行期的经典“翻车”现场我见过很多同学在本地运行这类Spring Boot项目时翻车翻在前几个步骤上。作为带过不少新手的人我把出镜率最高的问题整理成了一张速查表现象原因解决思路启动时报Access denied for user rootlocalhost数据库账号密码不对检查application.yml里的username/password启动时报Unknown database blog数据库没建执行SQL文件先建库或手动创建同名数据库访问页面中文乱码数据库/连接串/页面编码不一致统一使用utf8mb4检查链接里的characterEncoding参数端口被占用启动失败8080被别的程序占了换端口比如server.port8081依赖拉不下来Maven仓库源太慢换阿里云镜像强制更新mvn clean installLombok的日志/Getter报错IDEA没安装Lombok插件装插件并开启Annotation Processing前端页面样式全丢了静态资源路径不对检查模板里引用的css/js路径是否以/开头时间差8小时数据库时区不对连接串加serverTimezoneAsia/Shanghai这里我想单独展开说一下Lombok。很多基于Spring Boot的源码都用到了Data、Slf4j这些注解。如果你的IDEA里没有安装Lombok插件或者没有开启Annotation Processing那么编译阶段就会报找不到getter/setter方法的错误。第一次遇到这个报错的同学总会怀疑是代码有问题实际上就是环境配置少了一步。在IDEA的设置里搜annotation勾上Enable annotation processing重启一下项目基本就解决了。另一个高频问题是数据库SQL脚本执行时报Unknown column或者表已存在。前者通常是SQL脚本和实体类不对应后者是重复执行脚本导致的。遇到这种情况最干净的办法是把所有表DROP掉重新执行一遍SQL脚本保证初始数据是最新最完整的。如果你用的是Navicat直接右键数据库选择“运行SQL文件”注意选对目标数据库——很多人把SQL执行到系统库里然后发现项目一直找不到表那就是另一段故事了。5.2 从项目出发的Spring Boot面试考点做完这个博客系统之后如果你正处在找工作阶段那这些知识点值得认真准备一下——因为它们大概率会被追问。我把面试官围绕这个项目常问的问题和回答思路整理一下。问题一Spring Boot自动配置的原理是什么这是最基础也最常考的一题。你可以结合项目里的依赖来说当引入spring-boot-starter-web时spring-boot-autoconfigure包里的ServletWebServerFactoryAutoConfiguration等配置类会生效。这些配置类通过ConditionalOnClass、ConditionalOnMissingBean等条件注解判断“当前有没有这个类”“用户有没有自定义同类Bean”满足条件时才自动创建Bean并注册到容器中。最后通过spring.factories或AutoConfiguration.imports文件把所有自动配置类加载进来。你在项目里几乎没配什么XML但Tomcat能启动、Spring MVC能工作靠的全是这一套机制。问题二Spring Boot的核心注解有哪些可以从项目里实际用到的注解说起SpringBootApplication是启动类的核心它组合了SpringBootConfiguration、EnableAutoConfiguration、ComponentScan三个注解。Controller层用的是RestController和RequestMappingService层是ServiceMapper层是Mapper。这些注解背后的本质是“组件扫描 依赖注入”理解了这一点你对Spring IoC的理解就能落地了。问题三拦截器和过滤器的区别是什么这个项目里用了拦截器做登录校验面试官很可能顺着问过滤器。回答的核心是过滤器是Servlet规范里的基于函数回调在请求进入Servlet之前执行可以过滤所有请求拦截器是Spring MVC里的基于Java反射机制在Controller方法执行前执行但只拦截经过DispatcherServlet的请求。拦截器还能拿到HandlerMethod从而获取方法上的注解、类信息这些更细粒度的数据。实际项目中过滤器常用于字符编码、跨域处理拦截器常用于登录校验、权限控制。问题四项目的数据库设计怎么考虑性能可以结合博客系统来回答文章表有一个分类外键允许多条文章共用同一个分类这样设计是合理的。但要注意“不要过度设计”——如果业务量很大比如百万篇文章同时按分类查询那么可以给category_id建索引但个人博客这个量级加索引的收益并不高。回答这个问题的核心是展示你有“索引意识”而不是真的去调优一个练手项目。5.3 二次开发扩展方向最后聊一聊拿到这套源码之后怎么做二次开发。很多同学有“源码看完了视频也看完了但不知道下一步做什么”的尴尬。我给你几个方向按难度递增排序选择一两个动手做一做整个项目的含金量会有明显提升。第一个方向是引入Redis做文章浏览量统计。现在的浏览量是直接更新数据库的当并发访问量大的时候频繁更新数据库会造成压力。改成Redis的incr命令计数定期把数据同步到MySQL这是一个非常经典的读写性能优化案例。更重要的是这个改动会自然引入“Redis在Spring Boot中的使用”这个话题而它恰好是面试的高频考点。第二个方向是接入Markdown编辑器。现在编辑文章用的可能是基于textarea的简单富文本你可以换成Markdown编辑器通过AJAX把内容提交到后端在文章详情页用前端框架把Markdown渲染成HTML。这个改动让项目的实用性和现代感提升一个档次同时会涉及前后端数据交互、XSS安全过滤等知识点。第三个方向是用Vue做前后端分离改造。把服务端渲染的部分改成纯后端API前端用Vue CLI独立部署。这是一个大工程但做完之后你会对单体架构和前后端分离架构有非常深刻的理解也能顺带掌握跨域处理、Token认证这些现代开发必备的技能。第四个方向是增加搜索引擎。Elasticsearch对个人博客来说偏重但可以用MySQL的全文索引或者引入轻量级的搜索方式。这个改动的价值在于你会接触到搜索技术的基础概念比如分词、倒排索引、相关性排序对整个计算机知识体系来说是一个相当有意思的延伸。写在最后做这类个人博客系统最有意思的地方不在于写了几行代码而在于你通过一个完整项目把Java后端开发的整条链路打通了——数据库建模、服务端接口、页面渲染、权限控制、部署运行每一步都能看到真实结果。我每次带同学做这类项目都喜欢强调同一句话运行起来只是第一步多断点调试几次、改几个功能、踩几个坑你学到的东西才真正属于自己。这套源码和配套的视频资源其实已经帮你把路铺好了把它用好一个能看懂、能讲清楚、能说细节的Spring Boot项目就是你技术成长路上一个非常坚实的里程碑。