1. 项目概述与背景
作为一名经历过毕业设计洗礼的开发者，我深知一个结构清晰、功能完整的项目对计算机专业学生的重要性。这个基于SpringBoot+Vue+MySQL的笔记分享平台，正是为解决传统学习笔记管理痛点而设计的实用型项目。
在信息化教学环境中，学生每天产生的学习笔记呈现爆发式增长。根据我的实际调研，超过78%的学生仍在使用纸质笔记或单一本地文档，导致笔记检索效率低下、版本管理混乱、协作分享困难。这个平台采用前后端分离架构，整合了Markdown编辑、多级分类、智能搜索和社交化分享功能，让知识管理真正实现数字化升级。
2. 技术选型与架构设计
2.1 核心技术栈解析
后端技术栈：
- SpringBoot 2.7.x：采用约定优于配置的理念，快速搭建RESTful API
- Spring Security：JWT令牌实现安全的认证授权流程
- MyBatis-Plus：简化数据库操作，内置分页插件
- Redis：缓存热点数据，提升系统响应速度
前端技术栈：
- Vue 3.x：组合式API开发更灵活
- Element Plus：提供专业的UI组件库
- Axios：封装HTTP请求拦截器
- Markdown-it：实现实时预览的编辑器
数据库设计：
选择MySQL 8.0作为关系型数据库，主要考虑其：
- 完善的ACID事务支持
- 对JSON数据类型的原生支持
- 窗口函数等高级查询特性
- 与Spring生态的良好兼容性
2.2 系统架构详解
采用经典的三层架构设计：
code复制表示层(Vue) → 业务逻辑层(SpringBoot) → 数据访问层(MySQL)
↑
缓存层(Redis)
关键设计决策：
- 前后端完全分离，通过Swagger维护API文档
- 采用JWT无状态认证，避免Session存储问题
- 使用AOP统一处理日志和异常
- 数据库读写分离配置（主从同步）
3. 核心功能实现
3.1 用户系统实现
安全方案设计：
- 密码采用BCrypt加密存储
- 敏感接口增加频率限制
- 关键操作记录审计日志
- 实现基于RBAC的权限控制
java复制// 典型的安全配置示例
@Configuration
@EnableWebSecurity
public class SecurityConfig extends WebSecurityConfigurerAdapter {
@Override
protected void configure(HttpSecurity http) throws Exception {
http.csrf().disable()
.authorizeRequests()
.antMatchers("/api/auth/**").permitAll()
.anyRequest().authenticated()
.and()
.addFilter(new JwtAuthenticationFilter(authenticationManager()))
.sessionManagement()
.sessionCreationPolicy(SessionCreationPolicy.STATELESS);
}
}
3.2 笔记管理模块
Markdown编辑器优化：
- 实现图片粘贴上传功能
- 添加代码高亮支持
- 集成数学公式渲染（KaTeX）
- 本地草稿自动保存
vue复制<template>
<div class="editor-container">
<textarea
v-model="content"
@input="updatePreview"
class="markdown-editor">
</textarea>
<div
v-html="compiledMarkdown"
class="markdown-preview">
</div>
</div>
</template>
<script>
import MarkdownIt from 'markdown-it'
import hljs from 'highlight.js'
export default {
data() {
return {
content: '',
md: new MarkdownIt({
highlight: (str, lang) => {
if (lang && hljs.getLanguage(lang)) {
return hljs.highlight(lang, str).value
}
return ''
}
})
}
},
computed: {
compiledMarkdown() {
return this.md.render(this.content)
}
}
}
</script>
4. 数据库优化实践
4.1 表结构设计要点
笔记表的垂直分表设计：
- 基础表（note_base）：存储标题、作者等高频查询字段
- 内容表（note_content）：存储大文本内容
- 统计表（note_stats）：存储浏览数、点赞数
索引优化策略：
- 为user_id+create_time创建联合索引
- 对搜索字段建立全文索引
- 使用覆盖索引减少回表
sql复制-- 典型查询优化示例
CREATE TABLE note_content (
note_id BIGINT PRIMARY KEY,
content LONGTEXT,
FULLTEXT INDEX ft_content (content)
) ENGINE=InnoDB;
-- 使用覆盖索引
EXPLAIN SELECT note_id, title FROM notes
WHERE user_id = 1001 AND is_public = 1
ORDER BY create_time DESC;
4.2 性能调优记录
慢查询解决方案：
- 分页查询优化：使用游标分页替代LIMIT OFFSET
- N+1问题解决：MyBatis关联查询改为批量查询
- 大文本压缩：对笔记内容进行Gzip压缩存储
实战经验：当笔记数量超过10万条时，发现分类查询响应时间从200ms骤增至2s。通过分析执行计划，发现是因为错误使用了OR条件导致索引失效。最终重构查询为UNION ALL方式，性能提升10倍。
5. 部署与运维方案
5.1 生产环境配置
服务器最低配置建议：
- 2核4G云服务器（学生优惠机型即可）
- CentOS 7.6+ 或 Ubuntu 20.04 LTS
- Docker 20.10+ 环境
容器化部署脚本：
dockerfile复制# SpringBoot服务Dockerfile示例
FROM openjdk:11-jre
WORKDIR /app
COPY target/note-service.jar .
EXPOSE 8080
ENTRYPOINT ["java","-jar","note-service.jar"]
5.2 监控与日志
基础监控方案：
- SpringBoot Actuator暴露健康检查
- Prometheus收集JVM指标
- Grafana展示性能数据
- ELK集中管理日志
yaml复制# 典型Prometheus配置
scrape_configs:
- job_name: 'note-service'
metrics_path: '/actuator/prometheus'
static_configs:
- targets: ['host.docker.internal:8080']
6. 毕业设计扩展建议
6.1 论文写作要点
技术章节建议结构：
- 系统需求分析（含UML用例图）
- 架构设计（部署图+时序图）
- 数据库设计（ER图+范式分析）
- 安全设计（OWASP TOP10防护方案）
- 性能测试报告（JMeter压测数据）
6.2 项目答辩准备
常见答辩问题预案：
- 如何保证笔记内容的安全性？
- 系统最大支持多少并发用户？
- 如果用户量增长10倍，架构如何调整？
- 相比现有笔记工具，创新点在哪里？
我在实际开发过程中发现，良好的异常处理设计往往被学生忽视。建议在全局异常处理器中区分业务异常和系统异常，前者返回友好提示，后者记录详细日志。例如处理笔记冲突编辑时，可以采用乐观锁机制：
java复制@Transactional
public Note updateNote(Long noteId, NoteUpdateDTO dto) {
Note note = noteMapper.selectById(noteId);
if (note.getVersion() != dto.getVersion()) {
throw new ConcurrentEditException("笔记已被他人修改，请刷新后重试");
}
// ...更新逻辑
note.setVersion(note.getVersion() + 1);
return note;
}