1. 项目背景与核心需求读书会活动服务平台是针对高校学生社团、社区读书小组等群体开发的线上管理工具。传统线下读书社团面临活动通知效率低、成员参与度难统计、阅读心得无法沉淀等问题。这个基于Java Web的B/S架构系统正是为了解决以下痛点活动管理混乱纸质签到、微信群接龙等方式难以统计真实参与情况资源分散电子书、活动照片、读书笔记分散在不同平台交流低效线下讨论受时空限制优质内容无法留存复用我在实际参与校园读书社运营时曾遇到过活动报名人数虚高微信群接龙50人实际到场不到20人、活动后成员提交的读书笔记散落在个人邮箱等典型问题。这个系统通过三个核心模块解决这些问题活动全周期管理创建-报名-签到-归档阅读资源中心电子书共享/书单推荐互动交流社区话题讨论/笔记分享2. 技术架构设计解析2.1 整体技术选型采用经典三层架构具体技术栈选择基于以下考量层级技术方案选型理由前端Bootstrap Thymeleaf快速响应式布局与Spring生态无缝集成后端Spring Boot 2.7 MyBatis约定优于配置避免XML繁琐配置数据库MySQL 8.0事务支持完善高校场景数据量10W条安全Spring Security现成的RBAC权限控制方案特别注意学生项目常犯的错误是直接使用裸JDBC操作数据库。MyBatis的选用既避免了Hibernate的复杂学习曲线又比纯JDBC更易维护。2.2 关键架构决策为什么选择B/S而非App用户群体学生/社区成员设备碎片化严重维护成本考量毕业设计周期通常3个月微信浏览器即可访问降低使用门槛数据库设计要点-- 典型表结构示例 CREATE TABLE activity ( id INT NOT NULL AUTO_INCREMENT, title VARCHAR(100) NOT NULL COMMENT 活动标题, start_time DATETIME NOT NULL COMMENT 开始时间, location VARCHAR(200) NOT NULL COMMENT 活动地点, max_people INT DEFAULT 50 COMMENT 人数上限, cover_img VARCHAR(255) COMMENT 封面图路径, status TINYINT DEFAULT 0 COMMENT 0未开始 1进行中 2已结束, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;3. 核心功能实现细节3.1 活动管理模块流程控制状态机设计// 枚举定义活动状态流转 public enum ActivityStatus { UNSTARTED(0) { Override public boolean canChangeTo(ActivityStatus newStatus) { return newStatus PROCESSING || newStatus CANCELLED; } }, PROCESSING(1) { Override public boolean canChangeTo(ActivityStatus newStatus) { return newStatus FINISHED; } }, // 其他状态... }二维码签到实现活动创建时生成唯一签到码UUID前端使用QRCode.js生成动态二维码移动端扫码后验证时间/地点有效性防止代签IP限制设备指纹校验3.2 读书笔记功能富文本编辑器选型对比编辑器优点缺点适用场景WangEditor轻量(60KB)功能较少基础笔记TinyMCE插件丰富加载较慢深度编辑Markdown纯文本存储学习成本技术类社团最终选择WangEditor的折中方案关键配置const editor new WangEditor(#editor) editor.config.uploadImgServer /api/upload editor.config.uploadFileName noteImage editor.create()4. 典型问题解决方案4.1 高并发场景应对虽然校园场景并发量通常不高峰值500QPS但毕业答辩时常被问到如何扩展建议准备以下方案缓存策略Cacheable(value hotBooks, key #clubId) public ListBook getHotBooks(int clubId) { // 数据库查询逻辑 }前端优化技巧活动列表页启用HTTP缓存使用WebP格式压缩封面图片分页查询默认加载10条记录4.2 安全性实践常见漏洞及防护方案XSS防御前端wangEditor自带HTML过滤后端Spring HtmlUtils.htmlEscape()CSRF防护Configuration public class SecurityConfig extends WebSecurityConfigurerAdapter { Override protected void configure(HttpSecurity http) throws Exception { http.csrf().csrfTokenRepository(CookieCsrfTokenRepository.withHttpOnlyFalse()); } }SQL注入强制使用MyBatis参数化查询禁止字符串拼接SQL5. 部署与运维建议5.1 最小化部署方案适合毕业设计演示的环境配置1核2G云服务器学生优惠约50元/月JDK17 Tomcat9MySQL单实例需配置定期备份启动参数优化# Tomcat配置 export JAVA_OPTS-Xms512m -Xmx1024m -XX:UseG1GC5.2 监控与日志基础监控方案!-- pom.xml添加 -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-actuator/artifactId /dependency日志分割配置logback.xml示例appender nameFILE classch.qos.logback.core.rolling.RollingFileAppender filelogs/app.log/file rollingPolicy classch.qos.logback.core.rolling.TimeBasedRollingPolicy fileNamePatternlogs/app.%d{yyyy-MM-dd}.log/fileNamePattern maxHistory30/maxHistory /rollingPolicy /appender6. 项目扩展方向如果答辩需要体现创新点可以考虑阅读时长统计集成浏览器API检测页面停留时间移动端使用JS监听屏幕活动状态智能推荐算法// 基于用户标签的简单推荐 public ListBook recommendBooks(User user) { return bookDao.selectByTags( user.getFavoriteTags(), 10 // 推荐数量 ); }微信小程序端复用现有API接口使用uni-app跨平台开发实际开发中遇到的最意外问题是活动地点选择时有小组反馈无法找到具体教室。后来增加了教学楼平面图导航功能通过SVG矢量图点击热区实现。这个小改进让系统在人文学院的试点获得了额外好评