简介这份文档为基于Java的校园博客系统设计与实现的完整毕业设计论文面向计算机相关专业学生及需要开发博客类项目的开发者。内容覆盖系统分析、系统设计、功能实现与测试等完整流程涉及Java、MySQL、Tomcat、Spring Boot等关键技术包含可行性分析、性能分析、数据库E-R图与数据表字段设计、功能模块实现及测试结论可作为课程设计或毕业设计的直接参考模板。资源为单个docx文件压缩包大小4.91MB已有62人学习下载。文档目录结构完整从摘要、前言、开发技术介绍到系统测试、结论与致谢便于快速定位各章节内容结合具体功能模块与数据库设计能够帮助读者快速理解校园博客系统的整体架构和开发思路缩短设计开发周期。1. 校园博客系统到底在做什么一个Java课设背后的真实需求“基于java的校园博客系统”是每届计算机专业学生都会撞上的课题它听着像一个大作业模板实际上踩中了Java Web开发的全套核心前后端交互、数据库设计、权限控制、富文本处理、并发安全。如果你正在对着这个标题查资料大概率是要做毕设或课程设计也可能是在准备面试时遇到类似的“手写博客系统”题目——它几乎就是Java后端入门的标准试金石。这篇笔记不打算给你贴一份万能源码而是把系统从建表到上线的完整路径拆开讲清楚包括每段代码为什么这么写、参数怎么调、哪些地方会翻车。适合能跑通Hello World但没独立做过完整项目的新手也适合想把这套课设改成简历项目的熟手。2. 技术栈与架构设计为什么Spring Boot MySQL能撑起校园博客这套组合2.1 从零选型单体应用、Spring Boot与MyBatis的取舍校园博客系统的典型用户量是几百到几千人一台服务器加一个MySQL就绰绰有余不需要分布式、不需要微服务。所以选型的核心逻辑是“用最成熟的方案解决最明确的问题”而不是追新技术。常见做法是Spring Boot 2.x MyBatis MySQL Thymeleaf或Vue前后端分离这个组合在校园课设里出现率最高原因是资料多、面试常问、部署简单。Spring Boot的价值在于它帮你把复杂的Spring配置收进了自动装配内嵌Tomcat、约定好扫描路径、依赖版本统一管理。相比传统SSHSpring Struts Hibernate时代现在的启动成本低了一个量级。MyBatis则比JPA更贴近SQL学生手写SQL能清晰看到查询执行的每一步调试时也容易定位问题。如果选JPAHibernate的懒加载和N1问题会让新手一头扎进黑匣子MyBatis至少翻车时你能看到SQL长什么样。这里有个常见争论要不要用Spring Cloud我一般会劝退。校园博客系统的业务复杂度撑不起微服务的成本引入Nacos、Feign、Sentinel后反而会让课设答辩变成事故现场——你不光要解释业务还要解释为什么用这些重组件。同样的道理Redis可以做但不是必须如果为了给简历加分可以加一个简单的缓存层但务必将缓存失效和穿透问题处理干净否则面试官追问会露馅。2.2 核心功能模块划分与数据流向校园博客系统按角色拆一般有游客、注册用户、管理员三类。游客只能查看文章列表和详情注册用户能发博客、评论、点赞、管理自己的文章管理员能删帖、封号、查看文章审核。数据流向是典型的单体分模块Controller接收请求 → Service处理业务 → Mapper操作数据库 → 返回视图或JSON。模块核心功能对应数据表用户模块注册、登录、密码重置user文章模块发表、编辑、删除、分页列表article, category评论模块发表评论、删除评论、嵌套回复comment互动模块点赞/取消点赞、阅读量统计like_record, article.read_count管理后台用户管理、文章审核、数据统计user.role, audit_log注意数据流里的“阅读量统计”是个容易被忽略的坑。如果每次请求都UPDATE article SET read_count read_count 1高并发下会锁行如果先用Redis计数再定时回写又增加了部署难度。课设阶段我建议直接UPDATE只要在MySQL连接串上加上乐观锁参数并把文章表调整为InnoDB就足够应付几百并发。真正的压力问题等你上线后再优化这属于“值不值得做”的边界——为课设投入Redis维护时间性价比不高。模块间的依赖方向要控制住Service层只依赖MapperController层只依赖Service禁止跨层调用MyBatis的Session。很多新手图省事在Controller里直接注入Mapper初期开发快后面一旦要加日志、权限就很痛苦重构时想哭的心都有。3. 搭建项目骨架与数据库从建库SQL到MyBatis映射的完整起步3.1 用Spring Initializr生成项目目录结构与依赖说明不要手动新建Maven项目然后一个个填依赖直接去Spring Initializrstart.spring.io生成一个zip包。选择Java 8或Java 11、Spring Boot 2.7.x选择主流稳定版不要用3.x因为3.x要求Java 17并且javax包名变成jakarta很多旧教程会失效。依赖勾选以下四个Spring Web、MyBatis Framework、MySQL Driver、Thymeleaf。如果你想做前后端分离就加Spring Web Validation前端用Vue单独建工程但课设答辩时单体的Thymeleaf更省事——直接跑一个包就是完整站点。生成后目录结构默认如下src/main/java/com/example/campusblog ├── CampusBlogApplication.java ├── controller/ // 控制器层 ├── service/ // 业务层接口实现 ├── mapper/ // MyBatis Mapper接口 ├── entity/ // 数据库实体类 ├── config/ // 配置类拦截器、WebMvc配置 └── utils/ // 工具类MD5、JWT等 src/main/resources ├── static/ // 静态资源 ├── templates/ // Thymeleaf模板页面 └── application.yml // 配置文件 src/test/java // 测试目录启动类默认就有不用改。关键在于application.yml里的配置这里直接决定你后续能不能连上数据库server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/campus_blog?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalse username: root password: your_password thymeleaf: cache: false mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.example.campusblog.entity configuration: map-underscore-to-camel-case: true logging: level: com.example.campusblog.mapper: debug参数说明serverTimezoneAsia/Shanghai必须加否则连接MySQL 8.x会报时区错误map-underscore-to-camel-case设为true后数据库字段read_count能自动映射到实体的readCount省去大量Results注解logging.level.mapper: debug会在控制台打印所有SQL开发期务必打开这是你排查“查不到数据”最直接的手段。注意MyBatis的mapper-locations路径如果你把XML放在resources/mapper下就用这个配置如果你改成注解SQL这个配置就不需要但我建议项目用XML——复杂动态SQL只有XML才写得清楚。3.2 建表SQL用户、文章、评论、点赞四张核心表数据库名建议用campus_blog字符集统一utf8mb4。utf8mb4比utf8多支持emoji和生僻字校园博客里用户昵称千奇百怪用utf8会在插入某些字符时直接报错。以下是四张核心表的建设脚本CREATE TABLE user ( id bigint NOT NULL AUTO_INCREMENT, username varchar(50) NOT NULL COMMENT 登录名, password varchar(64) NOT NULL COMMENT MD5加盐后的密码, nickname varchar(50) DEFAULT NULL, avatar_url varchar(255) DEFAULT NULL, role tinyint NOT NULL DEFAULT 1 COMMENT 0-管理员 1-普通用户, status tinyint NOT NULL DEFAULT 1 COMMENT 1-正常 0-禁用, create_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_username (username) ) ENGINEInnoDB AUTO_INCREMENT1 DEFAULT CHARSETutf8mb4 COMMENT用户表; CREATE TABLE article ( id bigint NOT NULL AUTO_INCREMENT, user_id bigint NOT NULL, category_id int DEFAULT NULL, title varchar(200) NOT NULL, content longtext NOT NULL COMMENT 富文本HTML, summary varchar(500) DEFAULT NULL, read_count int NOT NULL DEFAULT 0, like_count int NOT NULL DEFAULT 0, status tinyint NOT NULL DEFAULT 1 COMMENT 0-草稿 1-发布 2-审核中, create_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP, update_time datetime DEFAULT NULL ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_user_id (user_id), KEY idx_category_id (category_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT文章表; CREATE TABLE comment ( id bigint NOT NULL AUTO_INCREMENT, article_id bigint NOT NULL, user_id bigint NOT NULL, parent_id bigint DEFAULT 0 COMMENT 0-顶级评论非0为回复某条评论, content varchar(1000) NOT NULL, create_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_article_id (article_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT评论表; CREATE TABLE like_record ( id bigint NOT NULL AUTO_INCREMENT, article_id bigint NOT NULL, user_id bigint NOT NULL, create_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_article_user (article_id,user_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT点赞记录表防止重复点赞;设计说明user.password字段存的是加盐后的MD5值不是明文article.content用longtext因为富文本的HTML可能很大text最多64KB写一篇带代码高亮的文章很容易超like_record的唯一键uk_article_user从数据库层面保证同一用户不能对同一文章重复点赞这比在Service层先查询再插入更可靠——并发下查询再插入会产生两条记录唯一键会直接让第二条插入报错你捕获异常即可。comment.parent_id支持嵌套回复但深度不要超过两层校园博客场景两层足够。另外记得给所有表的create_time都加上DEFAULT CURRENT_TIMESTAMP这样插入数据时不显式赋值也能自动写入时间避免Java代码里到处System.currentTimeMillis()。3.3 MyBatis Generator与手写Mapper什么时候用代码生成器项目里entity和mapper可以直接手写毕竟只有四张表代码量不大但如果你习惯用MyBatis Generator也可以用它生成基础CRUD然后再手工补充复杂查询。用Generator的最大好处是实体类字段不用手敲但生成的XML会包含大量用不上的resultMap和Example类这些代码会让项目显得冗余。课设答辩时老师会问“这个ResultMap里为什么有version字段”你要是答不上来会被质疑代码是否自己写的。我一般建议实体类手写Mapper接口手写XML手写但基础的单表查询用Select注解写在接口上只有动态条件查询才放到XML里。这样避免了一开始就被Generator生成的几百行XML淹没。比如用户登录查询一行注解就能解决Mapper public interface UserMapper { Select(SELECT * FROM user WHERE username #{username} AND status 1) User findActiveByUsername(String username); }当你后续需要“按关键词分页搜索文章同时过滤状态和分类”时再在XML里写动态SQL。原则是简单查询用注解复杂查询用XML。这个边界能让你保持代码整洁也方便面试时讲解每个方法的SQL逻辑。4. 核心业务实现注册登录、发布博客、评论点赞的代码级拆解4.1 注册登录MD5加盐与Spring Security的轻量替代方案网上很多校园博客项目用的是Spring Security JWT但Spring Security的过滤器链配置对新手极不友好一个SecurityConfig能调一整天。我做课设时更推荐轻量方案用拦截器校验登录状态密码用MD5加盐存储登录成功后把User对象存在Session里。这套方案代码量少、逻辑透明面试时也能讲清楚。注册接口的Service代码如下Service public class UserServiceImpl implements UserService { Autowired private UserMapper userMapper; Override public Result register(UserRegisterDTO dto) { // 1. 校验用户名唯一 if (userMapper.findByUsername(dto.getUsername()) ! null) { return Result.error(用户名已存在); } // 2. 密码加盐后MD5盐用固定字符串用户名的组合 String salt campus_blog_ dto.getUsername(); String encrypted DigestUtils.md5DigestAsHex((salt dto.getPassword()).getBytes()); // 3. 保存用户 User user new User(); user.setUsername(dto.getUsername()); user.setPassword(encrypted); user.setNickname(dto.getNickname()); userMapper.insert(user); return Result.success(注册成功); } Override public User login(String username, String password) { User user userMapper.findByUsername(username); if (user null) { throw new BusinessException(用户不存在); } String salt campus_blog_ username; String encrypted DigestUtils.md5DigestAsHex((salt password).getBytes()); if (!encrypted.equals(user.getPassword())) { throw new BusinessException(密码错误); } if (user.getStatus() 0) { throw new BusinessException(账号已被禁用); } return user; } }逻辑说明加盐方式很多种这里用“固定前缀用户名”当盐避免两次注册相同用户名产生相同哈希虽然用户名唯一但加盐后更安全。真正的生产系统会用BCrypt且盐是随机生成的但MD5加盐对课设足够答辩时如果你主动说“我知道MD5不够强生产上应该用BCrypt”会加分。注册时没有对密码做二次确认DTO里用NotBlank注解让他完成前端和Controller验证。登录成功后的会话处理写一个拦截器最直观public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { if (request.getSession().getAttribute(loginUser) null) { // 判断是否为AJAX请求是则返回401状态码否则重定向到登录页 if (XMLHttpRequest.equals(request.getHeader(X-Requested-With))) { response.setStatus(401); } else { response.sendRedirect(/login); } return false; } return true; } }参数说明这里用了Session而不是Token好处是登录状态由服务端控制退出时直接session.invalidate()就行不用处理Token过期。键名loginUser是约定的后续在Thymeleaf模板中通过${session.loginUser.nickname}取昵称。AJAX判断很关键否则前端发ajax请求被拦截后返回的是整个登录页HTML前端解析不了。4.2 发布博客与富文本处理XSS过滤与HTML白名单发布博客是文章模块的核心。前端我用的是一套开源的富文本编辑器传递过来的content是一段带样式的HTML。存入数据库前必须做XSS过滤——否则用户在内容里写scriptalert(xss)/script每次有人看这篇文章就会执行他的脚本轻则弹窗重则窃取登录态。这里推荐使用Jsoup这个Java库来清洗HTML。public String cleanContent(String content) { // 使用Jsoup的Safelist配置白名单只允许基本文本和排版标签 Safelist safelist Safelist.relaxed() .addTags(code, pre, blockquote) .addAttributes(p, style); return Jsoup.clean(content, safelist); }逻辑说明Safelist.relaxed()默认允许a、b、i、img等常见标签但会去掉class、id、style等属性。校园博客经常要贴代码所以手动加上code和pre标签如果你允许用户自定义文字颜色就给p标签增加style属性。注意iframe和script标签默认不在白名单里会被Jsoup自动移除这就能挡住大部分恶意脚本。这个clean方法在Service层调用在article插入前对content执行一次。发布文章时还有两个参数需要关注。一个是summary摘要如果没有手动填写就从content中提取纯文本前200个字符。用Jsoup.parse(content).text()可以轻松去除HTML标签拿纯文本。另一个是status状态位默认存为1发布如果你加了管理员审核机制就先存为2审核中。课设阶段我建议直接发布不要给自己增加审核需求——审核意味着后台页面、操作日志、状态流转复杂度直线上升除非你的课题明确要求。文章分页查询是另一个高频点常见做法是用PageHelper插件PageHelper.startPage(pageNum, pageSize); ListArticleVO list articleMapper.selectByCondition(title, categoryId, status); PageInfoArticleVO pageInfo new PageInfo(list);参数说明PageHelper.startPage(pageNum, pageSize)必须在查询方法的第一行调用它只作用于下一条SQL。注意返回的list是Page类型直接用PageInfo包装就能得到总页数、当前页、是否首页等字段。常见翻车是在startPage之前执行了其他Mapper查询导致PageHelper拦截错了SQL所以Service里要把分页放在该方法的第一个Mapper调用之前。PageHelper分页后返回的集合必须new PageInfo(list)获取总数直接用list.size()会是当前页条数而不是总记录数。4.3 评论与点赞事务边界与并发控制评论和点赞是典型的“写多读少”交互涉及两张表的状态同步最容易出现数据不一致。先看评论插入的ServiceTransactional(rollbackFor Exception.class) public void addComment(CommentDTO dto, Long userId) { Article article articleMapper.selectById(dto.getArticleId()); if (article null) { throw new BusinessException(文章不存在); } Comment comment new Comment(); comment.setArticleId(dto.getArticleId()); comment.setUserId(userId); comment.setContent(dto.getContent()); comment.setParentId(dto.getParentId() null ? 0 : dto.getParentId()); commentMapper.insert(comment); // 更新文章的评论数量如果评论表有comment_count字段则更新否则可省略 }逻辑说明这里的Transactional保证“插入评论”和“更新文章评论数”要么都成功要么都失败。rollbackFor Exception.class很重要——Spring事务默认只回滚RuntimeException和Error如果你在业务里抛的是自定义BusinessException继承自RuntimeException没问题但万一抛的是受检异常不加这个参数事务不会回滚数据库就插入了一条评论但文章计数没变。这条血泪经验在面试和答辩中经常被问到。点赞功能则需要处理“重复点赞”和“取消点赞”两种操作。由于数据库有like_record的唯一键约束可以直接用插入结果判断Transactional(rollbackFor Exception.class) public boolean toggleLike(Long articleId, Long userId) { try { LikeRecord record new LikeRecord(); record.setArticleId(articleId); record.setUserId(userId); likeRecordMapper.insert(record); articleMapper.incrementLikeCount(articleId); return true; // 点赞成功 } catch (DuplicateKeyException e) { // 记录已存在说明要取消点赞 likeRecordMapper.deleteByArticleIdAndUserId(articleId, userId); articleMapper.decrementLikeCount(articleId); return false; } }逻辑说明用try-catch捕获唯一键冲突把“是否已点赞”的判断交给数据库而不是先select再insert。先查再插在并发下会产生两条记录虽然唯一键最终会阻止但会多一次无效的数据库往返。DuplicateKeyException是Spring翻译过的异常能被Transactional捕获并继续执行后续操作这要求articleMapper.incrementLikeCount和delete在同一个事务里否则取消点赞时更新计数失败会导致脏数据。注意高并发下like_count字段的更新会有线程竞争课设阶段靠MySQL行锁足够不需要Redis分布式锁——那属于过度设计。评论列表的查询性能也需要优化。如果文章有几千条评论一次全查出来再在Java内存里组装树形结构会很卡。常见做法是分两级查询先查顶级评论parent_id 0用LIMIT分页再按顶评论id批量查子评论在内存里组装。SQL用WHERE parent_id IN (...)来避免N1查询。5. 避坑指南校园博客系统从开发到上线的5个高频翻车点5.1 翻车点一MySQL连接时区报错一启动就红字现象Spring Boot启动时报The server time zone value Öйú±ê׼ʱ¼ä is unrecognized数据库连接不上。原因MySQL 8.x驱动的时区识别与系统默认时区不一致。解决在JDBC连接串里加serverTimezoneAsia/Shanghai同时确保数据库端的全局时区也设置了执行SET GLOBAL time_zone 8:00。这个坑几乎每个搭环境的人都会遇到网上教程往往没写这条属于“环境配置教程”遗漏的典型细节。5.2 翻车点二Thymeleaf页面端口下找不到静态资源现象页面能打开但CSS、JS全都404。原因Spring Boot默认把resources/static下的资源映射到根路径但当Controller的请求路径是/admin/**时Thymeleaf模板里用相对路径../static/css/style.css引错了位置。解决模板中统一使用Thymeleaf的{}表达式th:href{/css/style.css}这样不管Controller在哪层都能正确解析。另外检查application.yml中spring.mvc.static-path-pattern是否被改成自定义路径如果改了就换回来。5.3 翻车点三MyBatis查询结果全是null但SQL控制台能查到数据现象控制台打印SQL返回一条记录但Java对象里所有字段都null。原因数据库字段使用下划线命名read_count实体类用驼峰readCount没有开启map-underscore-to-camel-case。解决在application.yml的mybatis.configuration里配置map-underscore-to-camel-case: true。如果你是用MyBatis Generator生成的XML那resultMap已经手动映射过了不会出现这个问题但手写Select注解查询时最容易漏这个开关。另一个小坑实体类中字段是Integer readCount数据库read_count为NULL时MyBatis会直接赋值nullJava里不会自动变成0所以你需要在实体类定义时用private Integer readCount 0;初始化或者在SQL用IFNULL(read_count, 0)。5.4 翻车点四发布文章后内容里的图片不显示现象文章列表能显示标题点进详情页后图片裂开。原因富文本编辑器上传图片时返回的是相对路径比如/upload/2024/01/xx.png文章详情页是/article/detail/12这个URL浏览器会把相对路径解析成/article/upload/...自然访问不到。解决发布文章时在Service层把内容里的src/upload替换成srchttp://你的域名/upload或者给图片加上完整的上下文路径。更稳妥的做法是上传图片时直接返回完整URL这样无论文章被导出或分享到哪图片都不会丢。这个坑用编辑器自带的图片上传接口调试时特别常见你需要在后端文件上传接口返回数据里加上serverAddress /upload/ relativePath。5.5 翻车点五点赞计数与记录表不一致用户取消点赞后数字不更新现象用户点击取消点赞like_record记录删了但文章上的like_count没减。原因toggleLike方法里likeRecordMapper.delete和articleMapper.decrementLikeCount没有在同一个事务中因为类上没有Transactional或者异常被吞掉了。解决确保类级别或方法级别有Transactional(rollbackFor Exception.class)同时检查articleMapper.decrementLikeCount的SQL是否写了UPDATE article SET like_count like_count - 1 WHERE id ?如果之前写过like_count - 1但忘了加WHERE所有文章都会被减一遍。这个翻车现场我见过好几个组员踩过还是那句话——事务边界是你自己控制的别依赖运气。6. 上线前的进阶验证日志、压测与部署让课设真正能跑起来如果你的目标是让这个校园博客系统成为简历上的“真实项目”只跑通本地还不够。至少要完成三项验证第一统一日志记录推荐在Service层用Slf4j打印关键操作日志比如用户注册、文章发布、异常堆栈第二用JMeter或Postman的Runner做一轮简单的并发压测重点接口就是登录和文章分页观察QPS和错误率这个数据放到简历上比“功能完成”更有说服力第三部署到云服务器用java -jar运行打包后的jar包配一个Nginx做反向代理和静态资源缓存再把数据库连接串改成服务器的内网地址。我的习惯是最后检查一遍这三个地方Session是否设置了过期时间建议30分钟文件上传目录是否隔离开了还有没有在代码里硬编码数据库密码。记住Spring Boot的默认配置文件中如果含有真实密码打包后也会被解压看到最好通过环境变量传入比如password: ${DB_PASSWORD}部署时在启动命令里加--DB_PASSWORDxxx。这个习惯不能丢等你的项目上线后被人扫到数据库明文密码那才是真正的“后悔药没处买”。最后给你一个实操技巧在application.yml里把spring.thymeleaf.cache设为false本地开发修改页面立刻生效部署时记得改回true否则缓存把页面活着你改了代码看不到效果会一头雾水。还有用mvn clean package -DskipTests打jar包时如果出现端口被占用先查lsof -i:8080或netstat -ano别急着改端口。这套流程走下来你的校园博客系统既能应付答辩也能经得住面试官一问到底。希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/10/30 16:48:32 · 阅读 1.2k 基于Java的校园博客系统：Spring Boot+MySQL全栈实现与避坑指南
简介这份文档为基于Java的校园博客系统设计与实现的完整毕业设计论文面向计算机相关专业学生及需要开发博客类项目的开发者。内容覆盖系统分析、系统设计、功能实现与测试等完整流程涉及Java、MySQL、Tomcat、Spring Boot等关键技术包含可行性分析、性能分析、数据库E-R图与数据表字段设计、功能模块实现及测试结论可作为课程设计或毕业设计的直接参考模板。资源为单个docx文件压缩包大小4.91MB已有62人学习下载。文档目录结构完整从摘要、前言、开发技术介绍到系统测试、结论与致谢便于快速定位各章节内容结合具体功能模块与数据库设计能够帮助读者快速理解校园博客系统的整体架构和开发思路缩短设计开发周期。1. 校园博客系统到底在做什么一个Java课设背后的真实需求“基于java的校园博客系统”是每届计算机专业学生都会撞上的课题它听着像一个大作业模板实际上踩中了Java Web开发的全套核心前后端交互、数据库设计、权限控制、富文本处理、并发安全。如果你正在对着这个标题查资料大概率是要做毕设或课程设计也可能是在准备面试时遇到类似的“手写博客系统”题目——它几乎就是Java后端入门的标准试金石。这篇笔记不打算给你贴一份万能源码而是把系统从建表到上线的完整路径拆开讲清楚包括每段代码为什么这么写、参数怎么调、哪些地方会翻车。适合能跑通Hello World但没独立做过完整项目的新手也适合想把这套课设改成简历项目的熟手。2. 技术栈与架构设计为什么Spring Boot MySQL能撑起校园博客这套组合2.1 从零选型单体应用、Spring Boot与MyBatis的取舍校园博客系统的典型用户量是几百到几千人一台服务器加一个MySQL就绰绰有余不需要分布式、不需要微服务。所以选型的核心逻辑是“用最成熟的方案解决最明确的问题”而不是追新技术。常见做法是Spring Boot 2.x MyBatis MySQL Thymeleaf或Vue前后端分离这个组合在校园课设里出现率最高原因是资料多、面试常问、部署简单。Spring Boot的价值在于它帮你把复杂的Spring配置收进了自动装配内嵌Tomcat、约定好扫描路径、依赖版本统一管理。相比传统SSHSpring Struts Hibernate时代现在的启动成本低了一个量级。MyBatis则比JPA更贴近SQL学生手写SQL能清晰看到查询执行的每一步调试时也容易定位问题。如果选JPAHibernate的懒加载和N1问题会让新手一头扎进黑匣子MyBatis至少翻车时你能看到SQL长什么样。这里有个常见争论要不要用Spring Cloud我一般会劝退。校园博客系统的业务复杂度撑不起微服务的成本引入Nacos、Feign、Sentinel后反而会让课设答辩变成事故现场——你不光要解释业务还要解释为什么用这些重组件。同样的道理Redis可以做但不是必须如果为了给简历加分可以加一个简单的缓存层但务必将缓存失效和穿透问题处理干净否则面试官追问会露馅。2.2 核心功能模块划分与数据流向校园博客系统按角色拆一般有游客、注册用户、管理员三类。游客只能查看文章列表和详情注册用户能发博客、评论、点赞、管理自己的文章管理员能删帖、封号、查看文章审核。数据流向是典型的单体分模块Controller接收请求 → Service处理业务 → Mapper操作数据库 → 返回视图或JSON。模块核心功能对应数据表用户模块注册、登录、密码重置user文章模块发表、编辑、删除、分页列表article, category评论模块发表评论、删除评论、嵌套回复comment互动模块点赞/取消点赞、阅读量统计like_record, article.read_count管理后台用户管理、文章审核、数据统计user.role, audit_log注意数据流里的“阅读量统计”是个容易被忽略的坑。如果每次请求都UPDATE article SET read_count read_count 1高并发下会锁行如果先用Redis计数再定时回写又增加了部署难度。课设阶段我建议直接UPDATE只要在MySQL连接串上加上乐观锁参数并把文章表调整为InnoDB就足够应付几百并发。真正的压力问题等你上线后再优化这属于“值不值得做”的边界——为课设投入Redis维护时间性价比不高。模块间的依赖方向要控制住Service层只依赖MapperController层只依赖Service禁止跨层调用MyBatis的Session。很多新手图省事在Controller里直接注入Mapper初期开发快后面一旦要加日志、权限就很痛苦重构时想哭的心都有。3. 搭建项目骨架与数据库从建库SQL到MyBatis映射的完整起步3.1 用Spring Initializr生成项目目录结构与依赖说明不要手动新建Maven项目然后一个个填依赖直接去Spring Initializrstart.spring.io生成一个zip包。选择Java 8或Java 11、Spring Boot 2.7.x选择主流稳定版不要用3.x因为3.x要求Java 17并且javax包名变成jakarta很多旧教程会失效。依赖勾选以下四个Spring Web、MyBatis Framework、MySQL Driver、Thymeleaf。如果你想做前后端分离就加Spring Web Validation前端用Vue单独建工程但课设答辩时单体的Thymeleaf更省事——直接跑一个包就是完整站点。生成后目录结构默认如下src/main/java/com/example/campusblog ├── CampusBlogApplication.java ├── controller/ // 控制器层 ├── service/ // 业务层接口实现 ├── mapper/ // MyBatis Mapper接口 ├── entity/ // 数据库实体类 ├── config/ // 配置类拦截器、WebMvc配置 └── utils/ // 工具类MD5、JWT等 src/main/resources ├── static/ // 静态资源 ├── templates/ // Thymeleaf模板页面 └── application.yml // 配置文件 src/test/java // 测试目录启动类默认就有不用改。关键在于application.yml里的配置这里直接决定你后续能不能连上数据库server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/campus_blog?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalse username: root password: your_password thymeleaf: cache: false mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.example.campusblog.entity configuration: map-underscore-to-camel-case: true logging: level: com.example.campusblog.mapper: debug参数说明serverTimezoneAsia/Shanghai必须加否则连接MySQL 8.x会报时区错误map-underscore-to-camel-case设为true后数据库字段read_count能自动映射到实体的readCount省去大量Results注解logging.level.mapper: debug会在控制台打印所有SQL开发期务必打开这是你排查“查不到数据”最直接的手段。注意MyBatis的mapper-locations路径如果你把XML放在resources/mapper下就用这个配置如果你改成注解SQL这个配置就不需要但我建议项目用XML——复杂动态SQL只有XML才写得清楚。3.2 建表SQL用户、文章、评论、点赞四张核心表数据库名建议用campus_blog字符集统一utf8mb4。utf8mb4比utf8多支持emoji和生僻字校园博客里用户昵称千奇百怪用utf8会在插入某些字符时直接报错。以下是四张核心表的建设脚本CREATE TABLE user ( id bigint NOT NULL AUTO_INCREMENT, username varchar(50) NOT NULL COMMENT 登录名, password varchar(64) NOT NULL COMMENT MD5加盐后的密码, nickname varchar(50) DEFAULT NULL, avatar_url varchar(255) DEFAULT NULL, role tinyint NOT NULL DEFAULT 1 COMMENT 0-管理员 1-普通用户, status tinyint NOT NULL DEFAULT 1 COMMENT 1-正常 0-禁用, create_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_username (username) ) ENGINEInnoDB AUTO_INCREMENT1 DEFAULT CHARSETutf8mb4 COMMENT用户表; CREATE TABLE article ( id bigint NOT NULL AUTO_INCREMENT, user_id bigint NOT NULL, category_id int DEFAULT NULL, title varchar(200) NOT NULL, content longtext NOT NULL COMMENT 富文本HTML, summary varchar(500) DEFAULT NULL, read_count int NOT NULL DEFAULT 0, like_count int NOT NULL DEFAULT 0, status tinyint NOT NULL DEFAULT 1 COMMENT 0-草稿 1-发布 2-审核中, create_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP, update_time datetime DEFAULT NULL ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_user_id (user_id), KEY idx_category_id (category_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT文章表; CREATE TABLE comment ( id bigint NOT NULL AUTO_INCREMENT, article_id bigint NOT NULL, user_id bigint NOT NULL, parent_id bigint DEFAULT 0 COMMENT 0-顶级评论非0为回复某条评论, content varchar(1000) NOT NULL, create_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_article_id (article_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT评论表; CREATE TABLE like_record ( id bigint NOT NULL AUTO_INCREMENT, article_id bigint NOT NULL, user_id bigint NOT NULL, create_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_article_user (article_id,user_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT点赞记录表防止重复点赞;设计说明user.password字段存的是加盐后的MD5值不是明文article.content用longtext因为富文本的HTML可能很大text最多64KB写一篇带代码高亮的文章很容易超like_record的唯一键uk_article_user从数据库层面保证同一用户不能对同一文章重复点赞这比在Service层先查询再插入更可靠——并发下查询再插入会产生两条记录唯一键会直接让第二条插入报错你捕获异常即可。comment.parent_id支持嵌套回复但深度不要超过两层校园博客场景两层足够。另外记得给所有表的create_time都加上DEFAULT CURRENT_TIMESTAMP这样插入数据时不显式赋值也能自动写入时间避免Java代码里到处System.currentTimeMillis()。3.3 MyBatis Generator与手写Mapper什么时候用代码生成器项目里entity和mapper可以直接手写毕竟只有四张表代码量不大但如果你习惯用MyBatis Generator也可以用它生成基础CRUD然后再手工补充复杂查询。用Generator的最大好处是实体类字段不用手敲但生成的XML会包含大量用不上的resultMap和Example类这些代码会让项目显得冗余。课设答辩时老师会问“这个ResultMap里为什么有version字段”你要是答不上来会被质疑代码是否自己写的。我一般建议实体类手写Mapper接口手写XML手写但基础的单表查询用Select注解写在接口上只有动态条件查询才放到XML里。这样避免了一开始就被Generator生成的几百行XML淹没。比如用户登录查询一行注解就能解决Mapper public interface UserMapper { Select(SELECT * FROM user WHERE username #{username} AND status 1) User findActiveByUsername(String username); }当你后续需要“按关键词分页搜索文章同时过滤状态和分类”时再在XML里写动态SQL。原则是简单查询用注解复杂查询用XML。这个边界能让你保持代码整洁也方便面试时讲解每个方法的SQL逻辑。4. 核心业务实现注册登录、发布博客、评论点赞的代码级拆解4.1 注册登录MD5加盐与Spring Security的轻量替代方案网上很多校园博客项目用的是Spring Security JWT但Spring Security的过滤器链配置对新手极不友好一个SecurityConfig能调一整天。我做课设时更推荐轻量方案用拦截器校验登录状态密码用MD5加盐存储登录成功后把User对象存在Session里。这套方案代码量少、逻辑透明面试时也能讲清楚。注册接口的Service代码如下Service public class UserServiceImpl implements UserService { Autowired private UserMapper userMapper; Override public Result register(UserRegisterDTO dto) { // 1. 校验用户名唯一 if (userMapper.findByUsername(dto.getUsername()) ! null) { return Result.error(用户名已存在); } // 2. 密码加盐后MD5盐用固定字符串用户名的组合 String salt campus_blog_ dto.getUsername(); String encrypted DigestUtils.md5DigestAsHex((salt dto.getPassword()).getBytes()); // 3. 保存用户 User user new User(); user.setUsername(dto.getUsername()); user.setPassword(encrypted); user.setNickname(dto.getNickname()); userMapper.insert(user); return Result.success(注册成功); } Override public User login(String username, String password) { User user userMapper.findByUsername(username); if (user null) { throw new BusinessException(用户不存在); } String salt campus_blog_ username; String encrypted DigestUtils.md5DigestAsHex((salt password).getBytes()); if (!encrypted.equals(user.getPassword())) { throw new BusinessException(密码错误); } if (user.getStatus() 0) { throw new BusinessException(账号已被禁用); } return user; } }逻辑说明加盐方式很多种这里用“固定前缀用户名”当盐避免两次注册相同用户名产生相同哈希虽然用户名唯一但加盐后更安全。真正的生产系统会用BCrypt且盐是随机生成的但MD5加盐对课设足够答辩时如果你主动说“我知道MD5不够强生产上应该用BCrypt”会加分。注册时没有对密码做二次确认DTO里用NotBlank注解让他完成前端和Controller验证。登录成功后的会话处理写一个拦截器最直观public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { if (request.getSession().getAttribute(loginUser) null) { // 判断是否为AJAX请求是则返回401状态码否则重定向到登录页 if (XMLHttpRequest.equals(request.getHeader(X-Requested-With))) { response.setStatus(401); } else { response.sendRedirect(/login); } return false; } return true; } }参数说明这里用了Session而不是Token好处是登录状态由服务端控制退出时直接session.invalidate()就行不用处理Token过期。键名loginUser是约定的后续在Thymeleaf模板中通过${session.loginUser.nickname}取昵称。AJAX判断很关键否则前端发ajax请求被拦截后返回的是整个登录页HTML前端解析不了。4.2 发布博客与富文本处理XSS过滤与HTML白名单发布博客是文章模块的核心。前端我用的是一套开源的富文本编辑器传递过来的content是一段带样式的HTML。存入数据库前必须做XSS过滤——否则用户在内容里写scriptalert(xss)/script每次有人看这篇文章就会执行他的脚本轻则弹窗重则窃取登录态。这里推荐使用Jsoup这个Java库来清洗HTML。public String cleanContent(String content) { // 使用Jsoup的Safelist配置白名单只允许基本文本和排版标签 Safelist safelist Safelist.relaxed() .addTags(code, pre, blockquote) .addAttributes(p, style); return Jsoup.clean(content, safelist); }逻辑说明Safelist.relaxed()默认允许a、b、i、img等常见标签但会去掉class、id、style等属性。校园博客经常要贴代码所以手动加上code和pre标签如果你允许用户自定义文字颜色就给p标签增加style属性。注意iframe和script标签默认不在白名单里会被Jsoup自动移除这就能挡住大部分恶意脚本。这个clean方法在Service层调用在article插入前对content执行一次。发布文章时还有两个参数需要关注。一个是summary摘要如果没有手动填写就从content中提取纯文本前200个字符。用Jsoup.parse(content).text()可以轻松去除HTML标签拿纯文本。另一个是status状态位默认存为1发布如果你加了管理员审核机制就先存为2审核中。课设阶段我建议直接发布不要给自己增加审核需求——审核意味着后台页面、操作日志、状态流转复杂度直线上升除非你的课题明确要求。文章分页查询是另一个高频点常见做法是用PageHelper插件PageHelper.startPage(pageNum, pageSize); ListArticleVO list articleMapper.selectByCondition(title, categoryId, status); PageInfoArticleVO pageInfo new PageInfo(list);参数说明PageHelper.startPage(pageNum, pageSize)必须在查询方法的第一行调用它只作用于下一条SQL。注意返回的list是Page类型直接用PageInfo包装就能得到总页数、当前页、是否首页等字段。常见翻车是在startPage之前执行了其他Mapper查询导致PageHelper拦截错了SQL所以Service里要把分页放在该方法的第一个Mapper调用之前。PageHelper分页后返回的集合必须new PageInfo(list)获取总数直接用list.size()会是当前页条数而不是总记录数。4.3 评论与点赞事务边界与并发控制评论和点赞是典型的“写多读少”交互涉及两张表的状态同步最容易出现数据不一致。先看评论插入的ServiceTransactional(rollbackFor Exception.class) public void addComment(CommentDTO dto, Long userId) { Article article articleMapper.selectById(dto.getArticleId()); if (article null) { throw new BusinessException(文章不存在); } Comment comment new Comment(); comment.setArticleId(dto.getArticleId()); comment.setUserId(userId); comment.setContent(dto.getContent()); comment.setParentId(dto.getParentId() null ? 0 : dto.getParentId()); commentMapper.insert(comment); // 更新文章的评论数量如果评论表有comment_count字段则更新否则可省略 }逻辑说明这里的Transactional保证“插入评论”和“更新文章评论数”要么都成功要么都失败。rollbackFor Exception.class很重要——Spring事务默认只回滚RuntimeException和Error如果你在业务里抛的是自定义BusinessException继承自RuntimeException没问题但万一抛的是受检异常不加这个参数事务不会回滚数据库就插入了一条评论但文章计数没变。这条血泪经验在面试和答辩中经常被问到。点赞功能则需要处理“重复点赞”和“取消点赞”两种操作。由于数据库有like_record的唯一键约束可以直接用插入结果判断Transactional(rollbackFor Exception.class) public boolean toggleLike(Long articleId, Long userId) { try { LikeRecord record new LikeRecord(); record.setArticleId(articleId); record.setUserId(userId); likeRecordMapper.insert(record); articleMapper.incrementLikeCount(articleId); return true; // 点赞成功 } catch (DuplicateKeyException e) { // 记录已存在说明要取消点赞 likeRecordMapper.deleteByArticleIdAndUserId(articleId, userId); articleMapper.decrementLikeCount(articleId); return false; } }逻辑说明用try-catch捕获唯一键冲突把“是否已点赞”的判断交给数据库而不是先select再insert。先查再插在并发下会产生两条记录虽然唯一键最终会阻止但会多一次无效的数据库往返。DuplicateKeyException是Spring翻译过的异常能被Transactional捕获并继续执行后续操作这要求articleMapper.incrementLikeCount和delete在同一个事务里否则取消点赞时更新计数失败会导致脏数据。注意高并发下like_count字段的更新会有线程竞争课设阶段靠MySQL行锁足够不需要Redis分布式锁——那属于过度设计。评论列表的查询性能也需要优化。如果文章有几千条评论一次全查出来再在Java内存里组装树形结构会很卡。常见做法是分两级查询先查顶级评论parent_id 0用LIMIT分页再按顶评论id批量查子评论在内存里组装。SQL用WHERE parent_id IN (...)来避免N1查询。5. 避坑指南校园博客系统从开发到上线的5个高频翻车点5.1 翻车点一MySQL连接时区报错一启动就红字现象Spring Boot启动时报The server time zone value Öйú±ê׼ʱ¼ä is unrecognized数据库连接不上。原因MySQL 8.x驱动的时区识别与系统默认时区不一致。解决在JDBC连接串里加serverTimezoneAsia/Shanghai同时确保数据库端的全局时区也设置了执行SET GLOBAL time_zone 8:00。这个坑几乎每个搭环境的人都会遇到网上教程往往没写这条属于“环境配置教程”遗漏的典型细节。5.2 翻车点二Thymeleaf页面端口下找不到静态资源现象页面能打开但CSS、JS全都404。原因Spring Boot默认把resources/static下的资源映射到根路径但当Controller的请求路径是/admin/**时Thymeleaf模板里用相对路径../static/css/style.css引错了位置。解决模板中统一使用Thymeleaf的{}表达式th:href{/css/style.css}这样不管Controller在哪层都能正确解析。另外检查application.yml中spring.mvc.static-path-pattern是否被改成自定义路径如果改了就换回来。5.3 翻车点三MyBatis查询结果全是null但SQL控制台能查到数据现象控制台打印SQL返回一条记录但Java对象里所有字段都null。原因数据库字段使用下划线命名read_count实体类用驼峰readCount没有开启map-underscore-to-camel-case。解决在application.yml的mybatis.configuration里配置map-underscore-to-camel-case: true。如果你是用MyBatis Generator生成的XML那resultMap已经手动映射过了不会出现这个问题但手写Select注解查询时最容易漏这个开关。另一个小坑实体类中字段是Integer readCount数据库read_count为NULL时MyBatis会直接赋值nullJava里不会自动变成0所以你需要在实体类定义时用private Integer readCount 0;初始化或者在SQL用IFNULL(read_count, 0)。5.4 翻车点四发布文章后内容里的图片不显示现象文章列表能显示标题点进详情页后图片裂开。原因富文本编辑器上传图片时返回的是相对路径比如/upload/2024/01/xx.png文章详情页是/article/detail/12这个URL浏览器会把相对路径解析成/article/upload/...自然访问不到。解决发布文章时在Service层把内容里的src/upload替换成srchttp://你的域名/upload或者给图片加上完整的上下文路径。更稳妥的做法是上传图片时直接返回完整URL这样无论文章被导出或分享到哪图片都不会丢。这个坑用编辑器自带的图片上传接口调试时特别常见你需要在后端文件上传接口返回数据里加上serverAddress /upload/ relativePath。5.5 翻车点五点赞计数与记录表不一致用户取消点赞后数字不更新现象用户点击取消点赞like_record记录删了但文章上的like_count没减。原因toggleLike方法里likeRecordMapper.delete和articleMapper.decrementLikeCount没有在同一个事务中因为类上没有Transactional或者异常被吞掉了。解决确保类级别或方法级别有Transactional(rollbackFor Exception.class)同时检查articleMapper.decrementLikeCount的SQL是否写了UPDATE article SET like_count like_count - 1 WHERE id ?如果之前写过like_count - 1但忘了加WHERE所有文章都会被减一遍。这个翻车现场我见过好几个组员踩过还是那句话——事务边界是你自己控制的别依赖运气。6. 上线前的进阶验证日志、压测与部署让课设真正能跑起来如果你的目标是让这个校园博客系统成为简历上的“真实项目”只跑通本地还不够。至少要完成三项验证第一统一日志记录推荐在Service层用Slf4j打印关键操作日志比如用户注册、文章发布、异常堆栈第二用JMeter或Postman的Runner做一轮简单的并发压测重点接口就是登录和文章分页观察QPS和错误率这个数据放到简历上比“功能完成”更有说服力第三部署到云服务器用java -jar运行打包后的jar包配一个Nginx做反向代理和静态资源缓存再把数据库连接串改成服务器的内网地址。我的习惯是最后检查一遍这三个地方Session是否设置了过期时间建议30分钟文件上传目录是否隔离开了还有没有在代码里硬编码数据库密码。记住Spring Boot的默认配置文件中如果含有真实密码打包后也会被解压看到最好通过环境变量传入比如password: ${DB_PASSWORD}部署时在启动命令里加--DB_PASSWORDxxx。这个习惯不能丢等你的项目上线后被人扫到数据库明文密码那才是真正的“后悔药没处买”。最后给你一个实操技巧在application.yml里把spring.thymeleaf.cache设为false本地开发修改页面立刻生效部署时记得改回true否则缓存把页面活着你改了代码看不到效果会一头雾水。还有用mvn clean package -DskipTests打jar包时如果出现端口被占用先查lsof -i:8080或netstat -ano别急着改端口。这套流程走下来你的校园博客系统既能应付答辩也能经得住面试官一问到底。希望帮到你。本文还有配套的精品资源点击获取