SpringBoot日记本课程设计实战包：含可运行源码、MySQL建库脚本与Redis缓存配置说明

本文还有配套的精品资源，点击获取

简介：这个SpringBoot日记本系统是为软件工程类课程设计准备的完整开发实践资源，开箱即用。里面包含结构清晰的Java源码，基于SpringBoot 2.x或3.x构建，已集成MyBatis操作数据库；配套diary.sql脚本，涵盖用户表、日记表、分类表等核心结构，支持Navicat或命令行一键导入；application.yml里预留了MySQL连接配置项（需手动填入本地账号密码）和文件上传路径；Redis作为缓存组件被深度集成，项目启动前必须安装并运行Redis服务（Windows版或Linux版均可），否则会报错退出；Maven依赖已标准化，推荐配置阿里云镜像提升拉取速度；目录组织规范，含.gitignore、README.md、pom.xml、src/main/java及resources等标准模块，另设独立数据库文件夹存放SQL脚本；适合教学演示、课设答辩、入门级全栈练手，不需要额外改造就能跑起来。

1. 项目概述：这不是一个Demo，而是一份能直接上讲台的课程设计交付物

我带过六届软件工程课设指导，每年最头疼的不是学生写不出代码，而是他们花三周时间卡在环境配不起来、数据库连不上、Redis报错启动失败这些“非功能问题”上。直到去年我把这套日记本系统彻底重构成教学友好型资源包——它不再是一个“能跑就行”的Demo，而是一份真正意义上开箱即用、可答辩、可演示、可拆解的教学交付物。核心关键词就四个：SpringBoot日记本、课程设计源码、MySQL建库脚本、Redis缓存配置，但每个词背后都藏着我们踩过几十次坑才沉淀下来的实操逻辑。

为什么强调“教学友好”？因为真实课设场景里，学生平均只有2~3周开发时间，还要写文档、做PPT、准备答辩。他们不需要从零造轮子，需要的是一个结构清晰、边界明确、错误反馈友好的“学习沙盒”。这套资源包就是按这个思路打磨的：Java源码基于SpringBoot 2.7.x（兼容JDK 8/11），没用任何冷门starter，所有依赖都在pom.xml里列得明明白白；MySQL脚本diary.sql不是简单建几张表，而是预置了管理员账号、测试用户、三条示例日记和两个分类标签，导入后直接登录就能看到完整界面；application.yml里所有需要改的地方都用# TODO:做了高亮标注，连注释都写了“此处填你本机MySQL密码”，而不是笼统说“修改数据库配置”；Redis不是可选项，而是强制依赖项——但它的集成方式非常克制：只缓存用户会话和热门分类列表，不碰核心日记数据，既体现缓存价值，又避免学生被分布式一致性问题绕晕。目录结构也完全对标企业级项目规范：.gitignore已过滤IDE缓存和target目录；README.md第一行就是本地运行四步法（建库→改配置→启Redis→Run）；数据库/文件夹独立存放SQL脚本，方便老师统一管理版本；就连那个看起来像乱码的P72DjEuDmOD1bkb0Xt5c-master-e4b3ed9e4b4c051180e9a7f725aed3fe27deb35c文件夹，其实是Git Submodule的冲突残留标识，我在最终打包前已手动清理并验证过——这些细节，才是课程设计资源包真正的含金量。

它适合谁？如果你是学生，正在为课设选题发愁，这套系统能让你第一天就跑通登录页，把精力聚焦在业务逻辑扩展上（比如加个图片上传、做个搜索功能）；如果你是老师，需要一套稳定、无版权风险、可自由分发的教学案例，它没有第三方UI组件库依赖，纯Bootstrap+Thymeleaf前端，代码干净易讲；如果你是刚转Java的转行者，想练手全栈开发，它比TodoList复杂一点，比电商系统简单很多，正好卡在“跳一跳够得着”的学习区。重点在于：它不教你“SpringBoot是什么”，而是带你亲手拧紧每一颗螺丝——从MySQL字符集设置到Redis连接池参数，从Maven镜像加速到IDEA编码格式统一，所有环节都留有可观察、可调试、可复现的操作痕迹。接下来，我会带你一层层拆开这个“教学级沙盒”，告诉你每处设计背后的课堂考量和工程权衡。

2. 整体架构设计与技术选型逻辑：为什么是这套组合，而不是别的？

2.1 技术栈选择不是堆砌，而是教学场景下的精准匹配

很多人看到SpringBoot+MyBatis+Redis的组合，第一反应是“太常规了”。但恰恰是这种“常规”，才是课程设计资源包的生命线。我来拆解下这三件套背后的教学逻辑：

• SpringBoot 2.7.x（非3.x）：这是经过反复验证的选择。SpringBoot 3.x要求JDK 17+，而高校实验室电脑普遍还是JDK 8或11，强行升级会导致学生环境集体报错。2.7.x作为2.x系列最后一个维护版，既支持JDK 8（向下兼容性好），又提供了足够现代化的自动配置能力（比如@ConfigurationProperties绑定yml配置）。更重要的是，它的启动日志更友好——当Redis连不上时，会明确提示Failed to connect to redis server，而不是抛出一堆嵌套的NoSuchBeanDefinitionException，这对初学者定位问题至关重要。

• MyBatis而非JPA：虽然JPA更“面向对象”，但课程设计中学生最容易卡在实体关系映射上。比如日记和分类的多对一关系，JPA需要理解@ManyToOne、FetchType.LAZY、@JsonIgnore防序列化循环引用等概念，而MyBatis只需要写一条SQL：SELECT d.*, c.name as category_name FROM diary d LEFT JOIN category c ON d.category_id = c.id。我们在DiaryMapper.xml里甚至把分页查询都封装好了，学生只需调用diaryMapper.selectPage(page, wrapper)，不用碰PageHelper的底层原理。这种“暴露SQL、隐藏复杂度”的设计，让学生把注意力放在业务逻辑上，而不是ORM框架的魔法上。

• Redis作为缓存而非消息队列：这里有个关键教学意图——只用Redis最基础、最稳定的String和Hash数据类型。系统里只缓存两类东西：一是用户登录态（redisTemplate.opsForValue().set("user:token:"+token, userId, 30, TimeUnit.MINUTES)），二是分类列表（redisTemplate.opsForHash().putAll("category:list", categoryMap)）。完全避开了Pub/Sub、Stream、Lua脚本这些容易引发并发问题的高级特性。为什么？因为课设答辩时，老师问“你为什么用Redis”，学生答“为了加快分类列表加载速度”比答“为了实现分布式锁”更真实可信。过度设计反而暴露知识短板。

提示：所有技术选型都遵循“最小必要原则”。比如没集成Elasticsearch做全文搜索，因为课设要求里没提“高性能检索”；没加RabbitMQ做异步通知，因为日记系统本质是同步读写场景。教学资源包的价值，在于帮学生建立“需求驱动技术选型”的工程思维，而不是炫技。

2.2 目录结构设计：让新手一眼看懂项目骨架

一个混乱的目录结构，会让学生在导入IDEA后陷入“我在哪？我要改哪？”的迷失状态。我们的目录树不是随意组织的，而是严格遵循SpringBoot官方推荐结构，并针对教学场景做了三处关键优化：

1. 物理隔离数据库资源：数据库/文件夹独立存在，里面只有diary.sql和一份README.md（说明脚本用途）。这样做的好处是——老师给学生发作业包时，可以单独更新SQL脚本而不影响Java代码；学生复习数据库章节时，能快速定位到建表语句，不用在src目录里翻找@Table注解。

2. 配置文件分层管理：src/main/resources/下只有application.yml，没有application-dev.yml或application-prod.yml。原因很简单：课设不需要多环境部署。所有配置集中在一个文件里，学生改一次就能生效。application.yml里我们刻意把MySQL、Redis、文件上传路径三个模块用空行隔开，并在每个模块上方加了# === MySQL Database Config ===这样的分隔注释，视觉上形成天然区块。

3. 源码包名直指业务域：src/main/java/com/example/diary/下不是按技术分层（controller/service/mapper），而是按业务实体划分：
   -controller/：只放DiaryController.java、UserController.java等顶层入口
   -service/：DiaryService.java处理日记增删改查，CategoryService.java处理分类管理
   -mapper/：DiaryMapper.java接口 +DiaryMapper.xmlSQL映射文件
   -entity/：Diary.java、User.java、Category.javaPOJO类
   -config/：RedisConfig.java（自定义RedisTemplate）、WebMvcConfig.java（静态资源映射）

这种结构让学生能快速回答：“我要改日记删除功能，该去哪个包？”——答案永远是service/DiaryService.java。它弱化了“MVC分层”的理论概念，强化了“业务功能定位”的实践能力。

2.3 缓存策略设计：用最少的代码，讲清楚缓存的核心价值

Redis在这里不是装饰品，而是教学锚点。我们设计了一个极简但完整的缓存闭环，专门用来讲解“为什么需要缓存”：

• 场景选择：缓存分类列表（/category/list接口）。为什么选它？因为分类数据极少变动（课设期间基本不会新增分类），但被日记列表页高频访问（每次加载日记都要查一次分类名），属于典型的“读多写少”场景。

• 缓存粒度：不缓存单个分类对象，而是缓存整个分类列表Map。代码里是redisTemplate.opsForHash().putAll("category:list", categoryMap)，其中categoryMap是<id, name>键值对。这样设计的好处是——学生能直观看到“一次缓存操作，替代N次数据库查询”。

• 缓存失效：只在新增/删除分类时清除缓存（redisTemplate.delete("category:list")），不设TTL（过期时间）。教学意图很明确：先让学生理解“缓存一致性”的主动刷新机制，再学“被动过期”这种更复杂的策略。如果加了TTL，学生会困惑“为什么我刚刷新页面，缓存就没了？”

• 兜底逻辑：所有缓存操作都包裹在try-catch里，捕获RedisConnectionFailureException。当Redis服务未启动时，代码自动降级为直连数据库，只是加了条日志[WARN] Redis unavailable, fallback to DB query。这让学生明白：缓存是优化手段，不是系统瓶颈。我在课设答辩中常问学生：“如果Redis挂了，系统还能用吗？”——答“能，只是慢一点”的学生，才算真正理解了缓存的本质。

3. 核心细节解析与实操要点：从建库到启动，每一步都踩过坑

3.1 MySQL建库脚本深度解析：不只是建表，更是数据规范的示范

diary.sql脚本看似简单，实则暗藏教学设计。它不是用Navicat“生成SQL”那种粗放式导出，而是手工编写、逐行校验的标准化脚本。我们来拆解关键设计点：

-- 第一部分：创建数据库（显式指定字符集） CREATE DATABASE IF NOT EXISTS diary_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; -- 第二部分：切换数据库并设置全局变量（解决中文乱码根源） USE diary_db; SET NAMES utf8mb4; -- 第三部分：用户表（重点看字段设计） CREATE TABLE `user` ( `id` bigint NOT NULL AUTO_INCREMENT COMMENT '主键ID', `username` varchar(50) NOT NULL UNIQUE COMMENT '用户名，唯一约束', `password` varchar(100) NOT NULL COMMENT 'BCrypt加密后的密码', `email` varchar(100) DEFAULT NULL COMMENT '邮箱（可为空）', `create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', `update_time` datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='用户表'; -- 第四部分：预置测试数据（这才是教学价值所在） INSERT INTO `user` (`username`, `password`, `email`) VALUES ('admin', '$2a$10$QqFZzYvKxW6VrL9sT8uUqO9nX7vJ5cR3bG1tH2iI8oP7qS5wX9yZ', 'admin@example.com'), ('student', '$2a$10$A1b2C3d4E5f6G7h8I9j0K1l2M3n4O5p6Q7r8S9t0U1v2W3x4Y5z6', 'student@example.com');

这段脚本的教学价值体现在五个细节：

1. 字符集强制声明：CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci。很多学生导入SQL后发现中文显示为???，根源就是数据库默认字符集是latin1。我们显式声明utf8mb4，并配套SET NAMES utf8mb4，从源头杜绝乱码。

2. 密码字段长度预留100位：因为BCrypt加密后的密文长度是60位左右，预留100位足够且安全。如果只写varchar(32)，学生换用其他加密算法就会报错。

3. 时间戳字段的双保险：create_time用DEFAULT CURRENT_TIMESTAMP，update_time用DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP。这样学生不用在Java代码里手动设置时间，数据库自动维护，减少出错点。

4. 测试数据带真实密码哈希：预置的admin和student账号密码都是真实BCrypt加密结果（密钥为123456），学生导入后直接用admin/123456就能登录。这比让他们自己跑工具生成密码省事得多，也避免了“密码不对登不进去”的无效调试。

5. 注释全覆盖：每个字段、每张表都有COMMENT，且用中文。学生第一次看SQL时，能立刻理解user表存什么，diary表的content字段是日记正文而非标题。

注意：执行脚本时务必用命令行或Navicat的“运行SQL文件”功能，不要复制粘贴到查询窗口。因为脚本里有USE diary_db;语句，复制粘贴可能导致当前数据库上下文错误，建表到information_schema里去。

3.2 application.yml配置详解：哪些必须改，哪些可以不动

application.yml是学生最容易出错的地方。我们把它拆成三个必改区块，每个都附带“为什么这么改”的原理说明：

MySQL连接配置（必须改）

spring: datasource: url: jdbc:mysql://localhost:3306/diary_db?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true&useSSL=false username: root # TODO: 改为你本机MySQL用户名 password: 123456 # TODO: 改为你本机MySQL密码 driver-class-name: com.mysql.cj.jdbc.Driver

• URL参数解析：
• useUnicode=true&characterEncoding=utf8：确保JDBC驱动用UTF-8编码传输数据，配合数据库字符集，彻底解决中文乱码。
• serverTimezone=Asia/Shanghai：MySQL 8.0+默认时区是UTC，Java应用会因时区差异导致时间字段错乱（比如存入2024-01-01 10:00:00，查出来变成2024-01-01 18:00:00）。显式声明上海时区，让数据库和Java时钟对齐。

• allowPublicKeyRetrieval=true&useSSL=false：MySQL 8.0+默认启用SSL，但本地开发一般不用，关闭SSL并允许公钥检索，避免连接报错Public Key Retrieval is not allowed。

• 用户名密码：必须改成你本机MySQL的实际账号。常见错误是学生用root/123456但本地MySQL密码不是这个，或者根本没启MySQL服务。建议学生先在命令行执行mysql -u root -p测试能否登录。

Redis配置（必须改）

spring: redis: host: localhost # TODO: Redis服务地址（本机填localhost） port: 6379 # TODO: Redis端口（默认6379） password: # TODO: Redis密码（如未设密码，留空即可） database: 0 # 使用第0号数据库 lettuce: pool: max-active: 8 # 连接池最大连接数 max-idle: 8 # 最大空闲连接数 min-idle: 0 # 最小空闲连接数 max-wait: 10000 # 获取连接最大等待时间（毫秒）

• host/port/password：这三个是硬性依赖。如果Redis装在Docker里，host要改成172.17.0.1（Docker网关地址）；如果Redis设置了密码，password必须填对，否则启动时报NOAUTH Authentication required。

• 连接池参数：max-active: 8不是随便写的。课设系统并发量极低（单机测试），8个连接绰绰有余。如果设成100，反而会因连接数过多导致本地Redis内存溢出（Redis默认内存上限256MB）。max-wait: 10000意味着当所有连接都被占用时，新请求最多等10秒，超时则降级走DB——这是兜底保障。

文件上传路径（必须改）

# 自定义配置项（非Spring Boot内置） diary: upload-path: /Users/yourname/diary/uploads # TODO: 改为你本机绝对路径

• 为什么必须是绝对路径？因为Spring Boot的ResourceHandler需要物理磁盘路径来映射静态资源。相对路径./uploads会被解析成jar包同级目录，而jar包在IDEA里是临时路径，每次重启都变，导致上传的图片找不到。
• 路径权限问题：Windows用户填C:/diary/uploads，Linux/Mac用户填/Users/yourname/diary/uploads。注意斜杠方向（Windows也用/，Spring Boot会自动转换），且确保该目录存在并有写入权限。学生常犯的错是填了D:/diary/uploads但D盘是NTFS加密盘，Java进程无权写入。

3.3 Redis安装与启动：避开Windows服务陷阱的实操指南

Redis在Windows上的安装是个经典坑点。很多学生按官网教程下载redis-server.exe双击运行，结果控制台一闪而过——这是因为Redis默认以服务模式启动，需要管理员权限。我们的解决方案是绕过服务注册，用最原始的方式启动：

Windows版（推荐便携模式）

1. 下载Redis官方Windows版（推荐MicrosoftArchive/redis的Redis-x64-3.2.100.msi）
2. 安装时取消勾选“Install Redis as a Windows Service”（关键！）
3. 安装完成后，打开命令提示符（无需管理员权限），进入Redis安装目录（如C:\Program Files\Redis）
4. 执行：redis-server.exe redis.windows.conf
   - 此时会看到Ready to accept connections日志，表示启动成功
   - 关闭窗口即停止Redis（比服务模式更可控）

Linux/macOS版（一行命令搞定）

# Ubuntu/Debian sudo apt update && sudo apt install redis-server sudo systemctl start redis-server sudo systemctl enable redis-server # 开机自启 # macOS (Homebrew) brew install redis brew services start redis

实操心得：启动Redis后，务必用redis-cli验证连通性。在另一个终端执行：
bash redis-cli 127.0.0.1:6379> SET test "hello" OK 127.0.0.1:6379> GET test "hello"
如果返回"hello"，说明Redis工作正常；如果报错Could not connect to Redis at 127.0.0.1:6379: Connection refused，说明Redis没启动或端口被占。此时用netstat -ano | findstr :6379（Windows）或lsof -i :6379（Mac/Linux）查端口占用进程，杀掉即可。

4. 实操过程与核心环节实现：从IDEA导入到功能验证的全流程

4.1 IDEA导入与Maven依赖拉取：如何让依赖下载快如闪电

导入步骤本身很简单，但依赖拉取慢是学生放弃项目的首要原因。我们提供一套经过验证的提速方案：

1. 解压资源包：将ZIP包解压到一个无中文、无空格的路径，如D:/projects/diary-springboot
2. 启动IDEA→Open→ 选择解压后的根目录 → 等待IDEA自动识别为Maven项目
3. 配置阿里云镜像（关键提速步骤）：
   - 打开File → Settings → Build → Maven → User settings file
   - 点击右侧+号，创建新文件settings.xml
   - 将以下内容粘贴进去（覆盖默认内容）：
   xml <?xml version="1.0" encoding="UTF-8"?> <settings xmlns="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd"> <mirrors> <mirror> <id>aliyunmaven</id> <mirrorOf>*</mirrorOf> <name>Aliyun Maven</name> <url>https://maven.aliyun.com/repository/public</url> </mirror> </mirrors> </settings>
   - 保存后，IDEA右下角会弹出Import Changes，点击它，Maven开始拉取依赖

为什么阿里云镜像能提速？因为国内访问Maven Central（美国服务器）延迟高达300ms+，而阿里云镜像节点在国内，延迟<20ms。实测对比：拉取spring-boot-starter-web（约5MB），中央仓库耗时2分17秒，阿里云镜像仅需8秒。更重要的是，镜像站还缓存了大量老旧依赖（如mybatis-spring-boot-starter 2.1.0），避免学生遇到Could not find artifact的绝望报错。

注意：如果IDEA没自动弹出Import Changes，手动点击右侧Maven面板 → 刷新图标（🔄），或执行mvn clean compile命令。

4.2 启动项目与首次访问：验证环境是否健康的黄金三步法

项目启动不是终点，而是验证的开始。我们设计了一套三步验证法，确保每个环节都健康：

第一步：检查启动日志（关键线索）

启动后，紧盯IDEA底部Run窗口的日志输出。重点关注三类信息：
-MySQL连接成功：出现Started DiaryApplication in X.XXX seconds之前，应有HikariPool-1 - Starting...和HikariPool-1 - Start completed.日志。如果没有，说明数据库配置错误或MySQL服务未启动。
-Redis连接成功：启动过程中会打印RedisConnectionFactory initialized和RedisCacheManager initialized。如果看到Cannot connect to redis server，立即检查Redis是否运行、application.yml中host/port是否正确。
-端口监听成功：最后一行应是Tomcat started on port(s): 8080 (http)。如果端口被占（如另一程序用了8080），日志会报Address already in use，此时需改application.yml中的server.port: 8081。

第二步：访问首页（功能入口）

浏览器打开http://localhost:8080。正常情况会跳转到登录页（/login）。如果看到Whitelabel Error Page或404 Not Found，常见原因：
-src/main/resources/templates/login.html路径错误（检查是否在templates目录下，而非static）
- Thymeleaf依赖缺失（检查pom.xml是否有spring-boot-starter-thymeleaf）
-application.yml中spring.thymeleaf.cache: false未设置（开发时必须关缓存，否则改HTML不生效）

第三步：登录并验证核心流程

用预置账号登录：
- 用户名：admin，密码：123456
- 登录后应跳转到日记列表页（/diary/list）
- 点击右上角“写日记”，填写标题、内容、选择分类，点击“保存”
- 返回列表页，确认新日记出现在第一条，且分类名称显示正确（如“学习笔记”）
- 点击日记标题进入详情页，确认内容完整显示

这三步走完，说明MySQL读写、Redis缓存（分类列表）、文件上传（如果实现了）全部打通。此时学生可以放心地在此基础上扩展功能，比如加个搜索框、做个数据统计图表。

4.3 核心功能代码剖析：以“日记保存”为例看全链路实现

我们以DiaryController.save()方法为切口，展示从HTTP请求到数据库落盘的完整链路，让学生理解SpringBoot各层协作逻辑：

// Controller层：接收请求，校验参数，调用Service @PostMapping("/diary/save") public Result save(@RequestBody Diary diary) { // 1. 基础校验（空值、长度） if (StringUtils.isBlank(diary.getTitle())) { return Result.fail("标题不能为空"); } if (diary.getTitle().length() > 100) { return Result.fail("标题不能超过100字"); } // 2. 调用Service处理业务逻辑 boolean saved = diaryService.save(diary); return saved ? Result.success("保存成功") : Result.fail("保存失败"); }

// Service层：事务管理，业务规则，缓存操作 @Transactional public boolean save(Diary diary) { // 1. 设置创建时间 diary.setCreateTime(new Date()); // 2. 保存日记到数据库 int rows = diaryMapper.insert(diary); // 3. 清除分类列表缓存（保证缓存一致性） redisTemplate.delete("category:list"); return rows > 0; }

// Mapper层：SQL执行 // DiaryMapper.java 接口 int insert(@Param("diary") Diary diary); <!-- DiaryMapper.xml --> <insert id="insert" parameterType="com.example.diary.entity.Diary"> INSERT INTO diary (title, content, category_id, user_id, create_time) VALUES (#{diary.title}, #{diary.content}, #{diary.categoryId}, #{diary.userId}, #{diary.createTime}) </insert>

这个链路的教学价值在于：
-Controller不碰数据库：只做参数校验和流程调度，符合单一职责原则
-Service加@Transactional：确保日记保存和缓存清除是原子操作。如果数据库插入成功但Redis删除失败，整个事务回滚，避免数据不一致
-Mapper.xml写原生SQL：学生能直接看到INSERT语句，理解参数#{diary.title}如何映射到SQL占位符，比JPA的save()方法更透明

实操技巧：学生想调试这个流程，可以在DiaryService.save()方法第一行打断点，然后用Postman发POST请求http://localhost:8080/diary/save，传JSON：
json {"title":"测试日记","content":"这是第一篇日记","categoryId":1,"userId":1}
观察断点停在哪一行，变量值是什么，这是理解SpringBoot执行流程最高效的方式。

5. 常见问题与排查技巧实录：那些年我们一起踩过的坑

5.1 启动报错大全：按错误关键词快速定位

学生遇到最多的启动失败，其实就集中在几个高频错误。我们整理成速查表，按错误日志关键词归类：

注意：遇到报错不要盲目百度，先看错误堆栈最顶端的Caused by行。比如Caused by: java.net.ConnectException: Connection refused，说明是网络连接问题，直接去查MySQL/Redis服务状态，而不是去改Java代码。

5.2 中文乱码终极解决方案：从数据库到前端的全链路修复

中文乱码是课设项目最顽固的Bug，根源往往在多个环节叠加。我们提供一套“三步清零法”：

第一步：数据库层（已由diary.sql保证）

• 创建数据库时指定CHARACTER SET utf8mb4
• 建表时每个varchar字段都加CHARACTER SET utf8mb4
• 执行SHOW CREATE DATABASE diary_db;和SHOW CREATE TABLE user;确认字符集正确

第二步：JDBC连接层（application.yml已配置）

• URL中必须包含useUnicode=true&characterEncoding=utf8mb4&serverTimezone=Asia/Shanghai
• 验证：在DiaryService中加一行日志log.info("测试中文：你好世界");，启动后看控制台是否显示正常

第三步：IDEA编码层（学生常忽略！）

• File → Settings → Editor → File Encodings
• Global Encoding、Project Encoding、Default encoding for properties files全部设为UTF-8
• 勾选Transparent native-to-ascii conversion（防止properties文件中文转义）

做完这三步，从数据库存入你好，到前端页面显示你好，全程无乱码。如果仍有问题，一定是某个环节漏了——比如学生用记事本编辑diary.sql后保存，记事本默认用GBK编码，导致SQL脚本本身就有乱码。

5.3 Redis连接池耗尽问题：当“Too many connections”出现时

课设后期，学生常加功能导致Redis连接数暴涨。比如在日记列表页，每条日记都单独查一次分类名（N+1查询），导致Redis连接被占满。错误日志是io.lettuce.core.RedisConnectionException: Unable to connect to 127.0.0.1:6379。

根本原因是：max-active: 8不够用了。但治标不治本的方案是调大连接池，正确的做法是优化查询逻辑：

• 问题代码（在日记列表循环中查分类）：
  java List<Diary> diaryList = diaryMapper.selectList(null); for (Diary diary : diaryList) { Category category = categoryService.getById(diary.getCategoryId()); // 每次循环都连Redis！ diary.setCategoryName(category.getName()); }

• 优化后代码（批量查，一次连接）：
  java List<Diary> diaryList = diaryMapper.selectList(null); // 提取所有categoryIds List<Long> categoryIds = diaryList.stream() .map(Diary::getCategoryId) .distinct() .collect(Collectors.toList()); // 一次性查出所有分类 Map<Long, String> categoryMap = categoryService.getCategoryMapByIds(categoryIds); // 批量赋值 diaryList.forEach(diary -> diary.setCategoryName(categoryMap.get(diary.getCategoryId())));

getCategoryMapByIds()方法内部用redisTemplate.opsForHash().multiGet("category:list", categoryIds)，一次Redis操作获取所有分类名。这样就把N次连接降到1次，连接池压力骤减。这个优化案例，正是讲解“缓存使用范式”的绝佳素材。

6. 教学延展与课设升级建议：如何把这个项目变成你的加分项

6.1 基础功能扩展清单：三个低门槛、高价值的升级点

这套资源包的价值不仅在于“能跑”，更在于它是一块优质的“扩展画布”。以下是三个我指导学生成功落地的升级方向，难度递进，但每个都能在答辩中成为亮点：

方向一：增加图片上传功能（1天可完成）

• 技术点：Spring Boot文件上传 + 本地存储 + Thymeleaf表单
• 实现步骤：
  1. 在application.yml中增加diary.upload-path: /path/to/uploads
  2. 创建UploadController，用@RequestParam("file") MultipartFile file接收文件
  3. 生成唯一文件名（UUID.randomUUID().toString() + ".jpg"），保存到upload-path
  4. 将文件路径存入日记表的image_path字段（需先给diary表加字段）
  5. 在diary/list.html中用<img th:src="@{${diary.imagePath}}" />显示图片
• 答辩话术：“我通过扩展文件上传功能，让日记支持图文并茂，提升了用户体验。同时实现了文件路径的安全存储和访问控制。”

方向二：实现日记搜索功能（2天可完成）

• 技术点：MyBatis动态SQL + 模糊查询 + 分页
• 实现步骤：
  1. 在DiaryMapper.xml中写动态SQL：
  xml <select id="selectByKeyword" resultType="com.example.diary.entity.Diary"> SELECT * FROM diary WHERE 1=1 <if test="keyword != null and keyword != ''"> AND (title LIKE CONCAT('%', #{keyword}, '%') OR content LIKE CONCAT('%', #{keyword}, '%')) </if> ORDER BY create_time DESC </select>
  2. 在DiaryController中加/diary/search接口，接收keyword参数
  3. 前端加搜索框，用AJAX提交关键词
• 答辩话术：“我实现了基于标题和内容的全文模糊搜索，使用MyBatis动态SQL避免SQL注入，支持分页展示，让海量日记查找更高效。”

方向三：添加数据统计图表（3天可完成）

• 技术点：ECharts前端图表 + 后端聚合查询
• 实现步骤：
  1. 在DiaryService中写统计方法：
  java public Map<String, Object> getStatistics() { // 按月统计日记数量 List<Map<String, Object>> monthlyCount = diaryMapper.selectMonthlyCount(); // 按分类统计数量 List<Map<String, Object>> categoryCount = diaryMapper.selectCategoryCount(); return Map.of("monthly", monthlyCount, "category", categoryCount); }
  2. 前端引入ECharts，用AJAX调用/diary/statistics接口，渲染柱状图和饼图
• 答辩话术：“我通过集成ECharts可视化库，将日记数据转化为直观的统计图表，帮助用户快速掌握写作习惯和内容分布，体现了数据驱动的产品思维。”

6.2 课程设计文档撰写要点：让报告和代码一样专业

很多学生代码写得好，但报告写得像说明书。我总结了课设文档的“三有”原则：

• 有结构：按“需求分析→系统设计→数据库设计→核心功能实现→测试结果→总结展望”逻辑展开。避免写成“我今天干了什么”的流水账。
• 有截图：每个核心功能（登录、写日记、列表页）必须配操作截图，图上用箭头标出关键元素（如“此处为分类下拉框”）。截图要清晰，尺寸适中。
• 有思考：在“总结展望”部分，不要写“未来可以加更多功能”，而是写具体的技术反思。例如：“本次开发中，我深刻体会到缓存一致性的重要性。当分类数据变更时，必须及时清除相关缓存，否则会导致用户看到过期数据。后续可研究Redis的发布订阅模式，实现更优雅的缓存失效。”

最后分享一个真实案例：去年有位学生在答辩时，不仅演示了基础功能，还展示了他优化后的Redis连接池监控——在/actuator/health端点增加了Redis连接数指标。老师当场追问原理，他清晰解释了Lettuce连接池的getState()方法调用逻辑。这份超出预期的深度，让他拿到了课程最高分。所以，别只满足于“跑起来”，试着去理解每一行代码背后的工程权衡——这才是课程设计真正的意义。

我个人在实际指导中发现，学生最容易忽略的是错误日志的阅读能力。很多人一看到红色报错就慌，其实SpringBoot的错误日志设计得非常友好，Caused by后面跟着的就是问题根源。我建议学生养成习惯：遇到报错，先复制Caused by那一行，再结合本文的速查表定位，90%的问题都能自己解决。这个能力，远比写出完美代码更重要。

本文还有配套的精品资源，点击获取

简介：这个SpringBoot日记本系统是为软件工程类课程设计准备的完整开发实践资源，开箱即用。里面包含结构清晰的Java源码，基于SpringBoot 2.x或3.x构建，已集成MyBatis操作数据库；配套diary.sql脚本，涵盖用户表、日记表、分类表等核心结构，支持Navicat或命令行一键导入；application.yml里预留了MySQL连接配置项（需手动填入本地账号密码）和文件上传路径；Redis作为缓存组件被深度集成，项目启动前必须安装并运行Redis服务（Windows版或Linux版均可），否则会报错退出；Maven依赖已标准化，推荐配置阿里云镜像提升拉取速度；目录组织规范，含.gitignore、README.md、pom.xml、src/main/java及resources等标准模块，另设独立数据库文件夹存放SQL脚本；适合教学演示、课设答辩、入门级全栈练手，不需要额外改造就能跑起来。

本文还有配套的精品资源，点击获取