说到校园信息共享很多人第一反应是想做二手交易、失物招领、活动通知这类功能集合。实际上你去看市面上的毕业设计和课程项目这类题目出现的频率非常高但大部分实现都停留在“能跑通”的水平——点开一个页面能发布信息能登录注册交作业答辩过关然后就结束了。我这次做的这个基于SpringBoot的校园信息共享系统不只是把功能堆出来还重点解决了发布审核、分类检索、用户权限、数据一致性这些容易被忽视的问题。这篇博文我会从设计思路到数据库表结构再到后端实现和前端联调的完整链路复盘一遍把踩过的坑和真正有价值的细节都讲透给正在做同类项目的人一份能直接参考的实录。1. 整体设计与技术选型思路1.1 为什么最终选了SpringBoot这套组合做这个项目之前我也认真比较过SSH、SSM和SpringBoot这三代方案。坦白说如果只是交一个课程设计SSM完全够用但当你真正想把系统做成一个能长期维护、后续能加功能的东西SpringBoot的优势就体现出来了——它把配置从“显式声明”变成“约定优先”大部分组件引入对应的starter就能直接用不需要一堆XML和注解配置堆在那里。我在搭建环境时只用了两个文件就完成了基础配置pom.xml里引入spring-boot-starter-web、spring-boot-starter-data-redis、mybatis-plus-boot-starter用的3.5.3版本加上application.yml里写数据源和Redis连接参数。对比以前写SSM时那一大坨spring-mvc.xml、spring-mybatis.xml这个体验差异是巨大的。对于校园信息共享这种典型的CRUD加少量业务逻辑的系统SpringBoot的自动装配和内嵌Tomcat特性让整个开发周期至少压缩了三分之一。另外我特意选用了MyBatis-Plus而不是原生MyBatis。这个决策基于一个很现实的原因项目里的模块多用户、分类、帖子、评论、收藏、审核记录如果每张表都手写一套完整的Mapper XML工作量会非常吓人。MyBatis-Plus提供了BaseMapper这个通用父接口单表CRUD基本不用写SQL我只需要在Service层处理业务规则。而且它的分页插件实现得很优雅后面我会详细讲。1.2 系统功能模块到底怎么划分功能模块的划分直接决定数据库设计和后续编码效率。我在需求分析阶段把校园信息共享拆成了三个角色视角来思考普通学生用户、信息发布者大概率也是学生、系统管理员。普通学生用户需要注册登录、浏览信息流、按分类筛选、关键词搜索、收藏感兴趣的内容、评论互动、个人中心管理自己发布的内容。信息发布者需要发布二手交易、失物招领、寻物启事、拼车、兼职、活动通知等不同类型的信息上传图片设置联系方式查看自己信息的浏览量和评论收到评论提醒这里用简单的站内消息实现。管理员需要审核新发布的信息防止广告、违规内容、分类管理、用户管理禁用违规账号、数据统计简单统计每日新增帖子和活跃用户数。这三个视角合在一起整个系统的功能地图就清晰了。我在编码阶段严格按照这个边界来建Controller和Service避免了后面想加功能时到处打补丁。1.3 技术栈全览与Redis的定位这套系统完整的技术栈是SpringBoot 2.7.8 MyBatis-Plus 3.5.3 MySQL 8.0 Redis 6.2 Vue 2 Element UI Axios。前端没有用特别复杂的东西因为核心价值在后端。Redis在这个项目里承担了两个关键角色。第一是登录状态管理用户登录成功后生成JWT令牌同时把用户基本信息缓存到Rediskey设计为login:token:{token}设置24小时过期这样每次请求通过拦截器校验完JWT后能直接从Redis取出用户信息不用每次查数据库。第二是热点信息的阅读量统计使用Redis的increment操作给帖子浏览量计数后台定时任务每5分钟把增量同步到MySQL用Spring的Scheduled注解实现这样既保证了阅读量实时性又不会频繁写数据库导致锁竞争。2. 核心细节解析与实操要点2.1 八张核心表的设计与关系梳理数据库设计是这类系统最见功底的部分。我最终设计了八张表用户表user、分类表category、信息发布表post、评论表comment、收藏表favorite、审核记录表audit_record、站内消息表message、操作日志表operation_log。用户表的核心字段除了常规的username、password、nickname我特意加了role字段区分普通用户和管理员status字段控制账号状态0正常 1禁用因为校园信息共享系统必须有管理员介入审核。密码存储用BCrypt加密这是Spring Security里默认用的加密算法每次加密结果都不一样安全性比MD5高一个量级。信息发布表是业务核心字段设计如下post_id用bigint自增主键user_id关联发布者category_id关联分类title长度限制在50字符content用text类型存正文关键的status字段有三个值——0待审核、1已发布、2已拒绝、3已下架。这样就实现了信息发布后先进入审核队列、审核通过才展示的闭环流程。images字段用varchar存图片URL多个图片用逗号分隔后期可以扩展成专门的图片表。评论和收藏都属于附属信息但收藏表必须设置联合唯一索引user_id post_id防止用户重复收藏同一条信息。这个细节在实际测试中很容易发现如果忘了加唯一索引前端用户反复点击收藏按钮就会生成大量重复数据。2.2 字段类型与时间处理的那些细节MySQL里时间字段我用的是datetime类型但Java侧对应的LocalDateTime。这里有个很容易踩的坑MyBatis-Plus默认的映射是java.time.LocalDateTime对应MySQL的datetime可以直接用但要注意在配置里加上jdbcTypeForNullNULL这个参数否则插入空时间字段时会报“无效的列类型”。还有一个我特别想强调的细节发布时间create_time和更新时间update_time这两个字段MyBatis-Plus提供了自动填充功能。我在字段上加了TableField(fill FieldFill.INSERT)和TableField(fill FieldFill.INSERT_UPDATE)注解然后写了一个MetaObjectHandler的实现类在insertFill和updateFill方法里统一赋值为LocalDateTime.now()。这样就不用每次在Service层手动set时间任何表、任何插入操作都能覆盖到。2.3 大字段的索引优化策略信息发布表里的content是text类型title是varchar类型。很多人会不加思考地给content建索引这是低效的。我的做法是title建普通索引用于搜索content不建索引而是配合全文检索思路来优化搜索功能的SQL用LIKE %关键词%匹配title和content两个字段数据量在1万条以内时加个limit 10性能没问题。等数据量真的大了再考虑引入ElasticSearch做分词搜索这个扩展路径我在设计文档里留了备注。分类表用sort字段控制显示顺序因为这个系统的分类数量相对固定二手交易、失物招领、寻物启事、拼车出行、兼职实习、活动通知、校园问答、其他不需要做成无限极分类一个简单的排序字段就够了。3. 实操过程与核心环节实现3.1 项目初始化和分层架构搭建我习惯在IDEA里用Spring Initializr创建项目groupId设置为com.campusartifactId设置为campus-share。创建完成后立刻做三件事把Java版本确认到1.8稳定兼容、检查pom.xml需要的starter依赖web、redis、mybatis-plus、mysql-connector、jjwt、lombok、规划包结构。包结构我保持经典的Controller-Service-Mapper三层额外加几个独立的包config放配置类、common放统一的返回结果Result封装、异常处理器、entity放实体类、dto放前端传参对象、vo放返回给前端的数据对象。这个设计不是摆设dto和vo的拆分在后期联调时帮了大忙前端需要的字段和后端实体类对不上时直接在vo层做字段筛选不污染实体类。先说Result封装这个是整个系统所有接口的统一返回格式。我设计成{ code: 200, message: 操作成功, data: {...} }这样的结构。code用200表示成功400表示参数错误401表示未登录403表示无权限500表示服务器错误。这样前端拦截器只需要判断code就能统一处理错误提示不需要每个页面单独写错误处理逻辑。3.2 JWT鉴权与拦截器的完整实现登录功能是第一个难点。我采用的方案是JWT Redis双重校验流程是用户提交用户名和密码Service层用BCrypt校验密码校验通过后生成JWT令牌用jjwt库令牌里只放userId和username两个声明有效期设置为24小时。然后把令牌存入Rediskey是login:token:{jwt}value是用户信息的JSON字符串同样设置24小时过期。拦截器这部分我实现了一个LoginInterceptor类实现HandlerInterceptor接口。preHandle方法里做三件事从请求头拿到Authorization字段解析出JWT如果JWT无效直接返回401如果有效从Redis查出用户信息并放入ThreadLocal方便Controller层直接获取当前登录用户。配套一个WebConfig类实现WebMvcConfigurer接口在addInterceptors里注册拦截器并通过addPathPatterns和excludePathPatterns配置哪些路径需要拦截哪些不需要比如登录注册接口、图片资源路径、热门信息列表接口。这里最容易被忽略的是excludePathPatterns必须把所有静态资源路径都排除掉否则会导致页面加载图片和CSS时被拦截返回401。这里我要重点强调一个生产环境才容易暴露的问题JWT令牌的密钥问题。很多人直接写死在代码里和前端配合时一旦改了密钥所有已登录用户全部失效。我的做法是在application.yml里配置一个jwt.secret属性通过Value注解注入部署时用环境变量覆盖。这样既灵活又安全。3.3 发布审核流程的业务闭环信息发布是核心中的核心。我用一个状态机思维来管理用户在发布页填写信息提交后post的status字段为0待审核这条信息不会出现在公共列表页里用户在自己的“我的发布”页面可以看到状态为“审核中”。管理员后台有一个审核列表展示所有status为0的帖子点击“通过”则status变为1点击“拒绝”则status变为2同时填写拒绝原因写入审核记录表系统自动生成一条站内消息通知发布者。这个闭环看起来简单但实现的时候有几个细节需要注意。第一用户能编辑和删除的只能是自己的帖子这个权限校验一定要在Service层做不能简单依赖前端隐藏按钮。第二审核通过后的信息要能立刻在列表页展示所以列表查询的SQL条件必须是status 1 AND deleted 0deleted是逻辑删除字段MyBatis-Plus的TableLogic注解自动处理。第三管理员修改用户帖子状态时需要往操作日志表写一条记录方便追溯这也是答辩时候的加分项。3.4 搜索分页与浏览量的缓存优化信息列表页是流量最大的接口。我用MyBatis-Plus的Page对象做分页前端传current和size参数配合LambdaQueryWrapper构造查询条件。首次请求时从数据库查询然后手动把结果缓存到Rediskey设计为post:list:{category}:{page}:{size}缓存时间为10分钟。但这个缓存方案有个明显的坑当有人发布新信息或者管理员审核通过信息后列表缓存还是旧数据。解决办法是在写入和审核操作后主动删除对应分类和分页的缓存Key。这里我偷了个懒——直接删除该分类下的所有post:list:{category}:*开头的Key用Redis的KEYS命令配合通配符实现。数据量小的时候这个方法可行但Redis官方不推荐生产环境用KEYS命令因为会阻塞单线程。正确的做法是使用SCAN命令或者维护一份缓存Key清单这个我在笔记里标注了作为后续优化项。浏览量统计我用了一个巧妙的方式Redis里存post:view:{postId}每次前端请求文章详情时对该Key执行increment操作。定时任务每5分钟扫描一次所有postId把增量写入数据库的view_count字段。实现起来需要一张在内存注册的“热帖ID集合”我用Redis的Set类型存储所有被浏览过的postId定时任务遍历这个Set读对应计数并同步数据库同步完成后把Set清空。这个方案避免了每浏览一次就写一次数据库极大缓解了MySQL的写压力。3.5 文件上传与静态资源映射发布信息时允许上传图片这是很多类似项目必备的功能。我没引入OSS或者MinIO考虑到校园网络的实际情况直接存本地磁盘并做静态资源映射。在application.yml里配置自定义属性file.upload-dir/data/campus-share/images/接收MultipartFile后用UUID重命名保留原文件扩展名然后写入磁盘。再把本地的这个目录映射成URL访问路径这个通过实现WebMvcConfigurer的addResourceHandlers方法来实现registry.addResourceHandler(/images/**).addResourceLocations(file:/data/campus-share/images/)。文件上传还有个隐藏BuffSpringBoot默认单文件大小限制是1MB。我测试时传一张手机拍的照片就报错了后来在配置里加了spring.servlet.multipart.max-file-size10MB和max-request-size50MB才解决。图片压缩和多图上传我后续打算加先保证基础功能完整。3.6 前后端联调Vue页面与Axios请求封装前端我用Vue2配合Element UI组件库页面结构围绕后端接口设计首页信息流、发布页、我的发布页含编辑删除功能、信息详情页含评论和收藏、个人中心页、管理员后台页。这里要重点说Axios的请求封装。我在utils/request.js里创建了一个axios实例设置baseURL为/api后面通过vue.config.js的proxy做代理转发然后添加请求拦截器和响应拦截器。请求拦截器里从localStorage读取token放到请求头响应拦截器里统一处理code401跳转登录页、其他错误弹出ElMessage提示。这样每个页面只需要调用封装的api函数不需要重复处理错误逻辑。开发环境的跨域问题用proxy代理解决vue.config.js里配置devServer.proxy把/api开头的请求转发到http://localhost:8080同时将pathRewrite^/api置为空这样后端Controller的RequestMapping里不用额外加/api前缀。这个细节让前后端联调省了很多事。4. 常见问题与排查技巧实录4.1 数据库连不上的三大经典征兆这个项目开发期遇到最多的问题是数据库连接异常。故障现象通常是启动SpringBoot时报Access denied for user或者Communications link failure。排查步骤我列成速查表报错特征大概率原因解决方案Access denied for user用户名或密码错误确认application.yml里的username和password与实际数据库一致Communications link failure数据库服务没启动或端口不对检查MySQL服务是否启动确认端口是3306而不是3307Public Key Retrieval is not allowedMySQL 8.x的认证插件问题JDBC URL加上allowPublicKeyRetrievaltrue参数第二个经典坑是时区问题。我一开始JDBC URL没带时区参数插入数据时发现数据库里的时间比实际时间少了8个小时。解决方案是URL里加上serverTimezoneAsia/ShanghaiuseUnicodetruecharacterEncodingutf8。这个两个参数强烈建议一次配齐不然后面中文乱码和时区问题轮番找上门。4.2 MyBatis-Plus分页不生效的排查过程用MyBatis-Plus做分页查询时第一次我写完了代码测试发现返回的数据总是全量而不是分页。检查了好几遍代码逻辑都没问题后来才意识到是缺少分页插件配置需要创建一个MybatisPlusInterceptor的Bean并在里面添加PaginationInnerInterceptor。没有这个配置Page参数传进去虽然不报错但SQL里不会拼接LIMIT子句。这个问题相当隐蔽因为代码层面看起来一切正常。后来我在配置类里加上如下代码就解决了Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; }另外分页查询的返回结果需要从Page对象里取records当前页数据和total总条数千万不要直接返回Page对象给前端否则会有很多冗余字段。4.3 Long类型ID在前端精度丢失的问题这个坑我认为是整个项目里最值得分享的。MySQL的bigint主键在Java实体里对应Long类型但当数据量不大时ID值比较小前端显示没问题。一旦数据量增长ID超过了JavaScript的Number类型安全范围2的53次方前端拿到的ID最后几位会变成0导致编辑、删除、详情跳转全部失效。我测试时造了100万条测试数据这个问题才暴露出来。解决方案是引入Jackson的序列化配置将Long类型统一转成String输出Bean public Jackson2ObjectMapperBuilderCustomizer jacksonCustomizer() { return builder - builder .serializerByType(Long.class, ToStringSerializer.instance) .serializerByType(Long.TYPE, ToStringSerializer.instance); }这个配置加上后前端拿到的ID变成字符串就不会有精度丢失问题了。强烈建议任何使用MyBatis-Plus默认雪花ID或者大整数自增ID的项目都加上这个配置。4.4 逻辑删除与唯一索引的冲突我用了MyBatis-Plus的TableLogic注解实现逻辑删除好处是删除数据不会物理消失方便审计恢复。但这里有个大坑如果表结构里有唯一索引逻辑删除后同一用户对同一条信息再次收藏时因为已删除的脏数据还在唯一索引会阻止插入。拿收藏表举例我在建表时给user_id post_id加了联合唯一索引但用户取消收藏后只是deleted字段从0变1物理行还在。用户再次收藏时插入新行触发唯一索引冲突报错。解决办法是去掉联合唯一索引在业务层查询时用WHERE user_id? AND post_id? AND deleted0判断是否存在不存在就插入。这样虽然多一次查询但避免了索引冲突问题。4.5 文件上传路径的打包陷阱本地开发时文件上传路径写的是/data/campus-share/images/工作正常。但用Maven打包成jar后部署到服务器运行tomcat其实是内嵌Tomcat后上传图片时发现目录创建失败。原因是jar包运行时的工作目录和源码目录不一样。排查后我把上传路径改成相对路径并做了目录自动创建String uploadDir System.getProperty(user.dir) File.separator upload File.separator; File dir new File(uploadDir); if (!dir.exists()) { dir.mkdirs(); }这个方法实测在Windows和Linux环境下都能正常运行jar包也不会因为路径问题启动失败。5. 部署上线与性能优化备忘本地开发跑通之后部署到服务器又是一轮考验。我用Maven执行mvn clean package -DskipTests打包生成campus-share.jar然后扔到同一台机器上的MySQL和Redis旁边。启动命令是nohup java -jar campus-share.jar --spring.profiles.activeprod app.log 21 配合application-prod.yml里的独立配置不同的端口、数据库密码、JWT密钥。这里有个我踩过的坑第一次部署时忘了在生产配置里设置spring.datasource.url的时区参数上线后所有时间数据全乱了后来把时区参数固化到所有环境才消停。性能优化这块我做了一个测试并发100个用户同时查看热帖详情Redis缓存命中的情况下TPS在2000以上而直接查数据库时TPS只有300左右。这个数据验证了缓存方案的价值。但Redis缓存只适用于查多写少的场景对于评论和收藏这种写操作我直接走数据库保证数据实时性优先。还有个小优化值得记录连接池参数。SpringBoot默认的HikariCP连接池最大连接数是10测试时并发稍大就会出现连接不够用的警告。我在配置里调成maximum-pool-size: 50并把connection-timeout: 3000030秒实测并发场景下连接等待超时的问题明显减少。连接池参数没有万能配置需要根据自己的业务和数据库性能来调但至少要知道这个参数是干什么的。最后说说Redis宕机时的兜底方案。我把缓存读取的逻辑封装成一个方法先从Redis取取不到就查数据库同时加上同步锁防止多个线程同时查库用setIfAbsent实现分布式锁。如果Redis彻底不可用就降级为永久查数据库模式系统功能不受影响只是性能下降。这个兜底逻辑虽然代码量不大但能让系统的健壮性上一个台阶。这个项目从设计到部署全套流程走下来我最大的体会是框架选型只是起点真正区分“能跑”和“能用”的是那些看不见的边界处理——权限校验在Service层而非前端、Long精度溢出、逻辑删除与唯一索引的冲突、缓存与数据库的一致性。你如果正在做同类项目建议先把这些边角料啃透再回头看业务代码会轻松很多。另外做这类系统不要一上来就追求高级功能把基础CRUD做扎实、把数据关系理顺、把异常处理补齐产出的系统靠谱程度反而更高。
说到校园信息共享很多人第一反应是想做二手交易、失物招领、活动通知这类功能集合。实际上你去看市面上的毕业设计和课程项目这类题目出现的频率非常高但大部分实现都停留在“能跑通”的水平——点开一个页面能发布信息能登录注册交作业答辩过关然后就结束了。我这次做的这个基于SpringBoot的校园信息共享系统不只是把功能堆出来还重点解决了发布审核、分类检索、用户权限、数据一致性这些容易被忽视的问题。这篇博文我会从设计思路到数据库表结构再到后端实现和前端联调的完整链路复盘一遍把踩过的坑和真正有价值的细节都讲透给正在做同类项目的人一份能直接参考的实录。1. 整体设计与技术选型思路1.1 为什么最终选了SpringBoot这套组合做这个项目之前我也认真比较过SSH、SSM和SpringBoot这三代方案。坦白说如果只是交一个课程设计SSM完全够用但当你真正想把系统做成一个能长期维护、后续能加功能的东西SpringBoot的优势就体现出来了——它把配置从“显式声明”变成“约定优先”大部分组件引入对应的starter就能直接用不需要一堆XML和注解配置堆在那里。我在搭建环境时只用了两个文件就完成了基础配置pom.xml里引入spring-boot-starter-web、spring-boot-starter-data-redis、mybatis-plus-boot-starter用的3.5.3版本加上application.yml里写数据源和Redis连接参数。对比以前写SSM时那一大坨spring-mvc.xml、spring-mybatis.xml这个体验差异是巨大的。对于校园信息共享这种典型的CRUD加少量业务逻辑的系统SpringBoot的自动装配和内嵌Tomcat特性让整个开发周期至少压缩了三分之一。另外我特意选用了MyBatis-Plus而不是原生MyBatis。这个决策基于一个很现实的原因项目里的模块多用户、分类、帖子、评论、收藏、审核记录如果每张表都手写一套完整的Mapper XML工作量会非常吓人。MyBatis-Plus提供了BaseMapper这个通用父接口单表CRUD基本不用写SQL我只需要在Service层处理业务规则。而且它的分页插件实现得很优雅后面我会详细讲。1.2 系统功能模块到底怎么划分功能模块的划分直接决定数据库设计和后续编码效率。我在需求分析阶段把校园信息共享拆成了三个角色视角来思考普通学生用户、信息发布者大概率也是学生、系统管理员。普通学生用户需要注册登录、浏览信息流、按分类筛选、关键词搜索、收藏感兴趣的内容、评论互动、个人中心管理自己发布的内容。信息发布者需要发布二手交易、失物招领、寻物启事、拼车、兼职、活动通知等不同类型的信息上传图片设置联系方式查看自己信息的浏览量和评论收到评论提醒这里用简单的站内消息实现。管理员需要审核新发布的信息防止广告、违规内容、分类管理、用户管理禁用违规账号、数据统计简单统计每日新增帖子和活跃用户数。这三个视角合在一起整个系统的功能地图就清晰了。我在编码阶段严格按照这个边界来建Controller和Service避免了后面想加功能时到处打补丁。1.3 技术栈全览与Redis的定位这套系统完整的技术栈是SpringBoot 2.7.8 MyBatis-Plus 3.5.3 MySQL 8.0 Redis 6.2 Vue 2 Element UI Axios。前端没有用特别复杂的东西因为核心价值在后端。Redis在这个项目里承担了两个关键角色。第一是登录状态管理用户登录成功后生成JWT令牌同时把用户基本信息缓存到Rediskey设计为login:token:{token}设置24小时过期这样每次请求通过拦截器校验完JWT后能直接从Redis取出用户信息不用每次查数据库。第二是热点信息的阅读量统计使用Redis的increment操作给帖子浏览量计数后台定时任务每5分钟把增量同步到MySQL用Spring的Scheduled注解实现这样既保证了阅读量实时性又不会频繁写数据库导致锁竞争。2. 核心细节解析与实操要点2.1 八张核心表的设计与关系梳理数据库设计是这类系统最见功底的部分。我最终设计了八张表用户表user、分类表category、信息发布表post、评论表comment、收藏表favorite、审核记录表audit_record、站内消息表message、操作日志表operation_log。用户表的核心字段除了常规的username、password、nickname我特意加了role字段区分普通用户和管理员status字段控制账号状态0正常 1禁用因为校园信息共享系统必须有管理员介入审核。密码存储用BCrypt加密这是Spring Security里默认用的加密算法每次加密结果都不一样安全性比MD5高一个量级。信息发布表是业务核心字段设计如下post_id用bigint自增主键user_id关联发布者category_id关联分类title长度限制在50字符content用text类型存正文关键的status字段有三个值——0待审核、1已发布、2已拒绝、3已下架。这样就实现了信息发布后先进入审核队列、审核通过才展示的闭环流程。images字段用varchar存图片URL多个图片用逗号分隔后期可以扩展成专门的图片表。评论和收藏都属于附属信息但收藏表必须设置联合唯一索引user_id post_id防止用户重复收藏同一条信息。这个细节在实际测试中很容易发现如果忘了加唯一索引前端用户反复点击收藏按钮就会生成大量重复数据。2.2 字段类型与时间处理的那些细节MySQL里时间字段我用的是datetime类型但Java侧对应的LocalDateTime。这里有个很容易踩的坑MyBatis-Plus默认的映射是java.time.LocalDateTime对应MySQL的datetime可以直接用但要注意在配置里加上jdbcTypeForNullNULL这个参数否则插入空时间字段时会报“无效的列类型”。还有一个我特别想强调的细节发布时间create_time和更新时间update_time这两个字段MyBatis-Plus提供了自动填充功能。我在字段上加了TableField(fill FieldFill.INSERT)和TableField(fill FieldFill.INSERT_UPDATE)注解然后写了一个MetaObjectHandler的实现类在insertFill和updateFill方法里统一赋值为LocalDateTime.now()。这样就不用每次在Service层手动set时间任何表、任何插入操作都能覆盖到。2.3 大字段的索引优化策略信息发布表里的content是text类型title是varchar类型。很多人会不加思考地给content建索引这是低效的。我的做法是title建普通索引用于搜索content不建索引而是配合全文检索思路来优化搜索功能的SQL用LIKE %关键词%匹配title和content两个字段数据量在1万条以内时加个limit 10性能没问题。等数据量真的大了再考虑引入ElasticSearch做分词搜索这个扩展路径我在设计文档里留了备注。分类表用sort字段控制显示顺序因为这个系统的分类数量相对固定二手交易、失物招领、寻物启事、拼车出行、兼职实习、活动通知、校园问答、其他不需要做成无限极分类一个简单的排序字段就够了。3. 实操过程与核心环节实现3.1 项目初始化和分层架构搭建我习惯在IDEA里用Spring Initializr创建项目groupId设置为com.campusartifactId设置为campus-share。创建完成后立刻做三件事把Java版本确认到1.8稳定兼容、检查pom.xml需要的starter依赖web、redis、mybatis-plus、mysql-connector、jjwt、lombok、规划包结构。包结构我保持经典的Controller-Service-Mapper三层额外加几个独立的包config放配置类、common放统一的返回结果Result封装、异常处理器、entity放实体类、dto放前端传参对象、vo放返回给前端的数据对象。这个设计不是摆设dto和vo的拆分在后期联调时帮了大忙前端需要的字段和后端实体类对不上时直接在vo层做字段筛选不污染实体类。先说Result封装这个是整个系统所有接口的统一返回格式。我设计成{ code: 200, message: 操作成功, data: {...} }这样的结构。code用200表示成功400表示参数错误401表示未登录403表示无权限500表示服务器错误。这样前端拦截器只需要判断code就能统一处理错误提示不需要每个页面单独写错误处理逻辑。3.2 JWT鉴权与拦截器的完整实现登录功能是第一个难点。我采用的方案是JWT Redis双重校验流程是用户提交用户名和密码Service层用BCrypt校验密码校验通过后生成JWT令牌用jjwt库令牌里只放userId和username两个声明有效期设置为24小时。然后把令牌存入Rediskey是login:token:{jwt}value是用户信息的JSON字符串同样设置24小时过期。拦截器这部分我实现了一个LoginInterceptor类实现HandlerInterceptor接口。preHandle方法里做三件事从请求头拿到Authorization字段解析出JWT如果JWT无效直接返回401如果有效从Redis查出用户信息并放入ThreadLocal方便Controller层直接获取当前登录用户。配套一个WebConfig类实现WebMvcConfigurer接口在addInterceptors里注册拦截器并通过addPathPatterns和excludePathPatterns配置哪些路径需要拦截哪些不需要比如登录注册接口、图片资源路径、热门信息列表接口。这里最容易被忽略的是excludePathPatterns必须把所有静态资源路径都排除掉否则会导致页面加载图片和CSS时被拦截返回401。这里我要重点强调一个生产环境才容易暴露的问题JWT令牌的密钥问题。很多人直接写死在代码里和前端配合时一旦改了密钥所有已登录用户全部失效。我的做法是在application.yml里配置一个jwt.secret属性通过Value注解注入部署时用环境变量覆盖。这样既灵活又安全。3.3 发布审核流程的业务闭环信息发布是核心中的核心。我用一个状态机思维来管理用户在发布页填写信息提交后post的status字段为0待审核这条信息不会出现在公共列表页里用户在自己的“我的发布”页面可以看到状态为“审核中”。管理员后台有一个审核列表展示所有status为0的帖子点击“通过”则status变为1点击“拒绝”则status变为2同时填写拒绝原因写入审核记录表系统自动生成一条站内消息通知发布者。这个闭环看起来简单但实现的时候有几个细节需要注意。第一用户能编辑和删除的只能是自己的帖子这个权限校验一定要在Service层做不能简单依赖前端隐藏按钮。第二审核通过后的信息要能立刻在列表页展示所以列表查询的SQL条件必须是status 1 AND deleted 0deleted是逻辑删除字段MyBatis-Plus的TableLogic注解自动处理。第三管理员修改用户帖子状态时需要往操作日志表写一条记录方便追溯这也是答辩时候的加分项。3.4 搜索分页与浏览量的缓存优化信息列表页是流量最大的接口。我用MyBatis-Plus的Page对象做分页前端传current和size参数配合LambdaQueryWrapper构造查询条件。首次请求时从数据库查询然后手动把结果缓存到Rediskey设计为post:list:{category}:{page}:{size}缓存时间为10分钟。但这个缓存方案有个明显的坑当有人发布新信息或者管理员审核通过信息后列表缓存还是旧数据。解决办法是在写入和审核操作后主动删除对应分类和分页的缓存Key。这里我偷了个懒——直接删除该分类下的所有post:list:{category}:*开头的Key用Redis的KEYS命令配合通配符实现。数据量小的时候这个方法可行但Redis官方不推荐生产环境用KEYS命令因为会阻塞单线程。正确的做法是使用SCAN命令或者维护一份缓存Key清单这个我在笔记里标注了作为后续优化项。浏览量统计我用了一个巧妙的方式Redis里存post:view:{postId}每次前端请求文章详情时对该Key执行increment操作。定时任务每5分钟扫描一次所有postId把增量写入数据库的view_count字段。实现起来需要一张在内存注册的“热帖ID集合”我用Redis的Set类型存储所有被浏览过的postId定时任务遍历这个Set读对应计数并同步数据库同步完成后把Set清空。这个方案避免了每浏览一次就写一次数据库极大缓解了MySQL的写压力。3.5 文件上传与静态资源映射发布信息时允许上传图片这是很多类似项目必备的功能。我没引入OSS或者MinIO考虑到校园网络的实际情况直接存本地磁盘并做静态资源映射。在application.yml里配置自定义属性file.upload-dir/data/campus-share/images/接收MultipartFile后用UUID重命名保留原文件扩展名然后写入磁盘。再把本地的这个目录映射成URL访问路径这个通过实现WebMvcConfigurer的addResourceHandlers方法来实现registry.addResourceHandler(/images/**).addResourceLocations(file:/data/campus-share/images/)。文件上传还有个隐藏BuffSpringBoot默认单文件大小限制是1MB。我测试时传一张手机拍的照片就报错了后来在配置里加了spring.servlet.multipart.max-file-size10MB和max-request-size50MB才解决。图片压缩和多图上传我后续打算加先保证基础功能完整。3.6 前后端联调Vue页面与Axios请求封装前端我用Vue2配合Element UI组件库页面结构围绕后端接口设计首页信息流、发布页、我的发布页含编辑删除功能、信息详情页含评论和收藏、个人中心页、管理员后台页。这里要重点说Axios的请求封装。我在utils/request.js里创建了一个axios实例设置baseURL为/api后面通过vue.config.js的proxy做代理转发然后添加请求拦截器和响应拦截器。请求拦截器里从localStorage读取token放到请求头响应拦截器里统一处理code401跳转登录页、其他错误弹出ElMessage提示。这样每个页面只需要调用封装的api函数不需要重复处理错误逻辑。开发环境的跨域问题用proxy代理解决vue.config.js里配置devServer.proxy把/api开头的请求转发到http://localhost:8080同时将pathRewrite^/api置为空这样后端Controller的RequestMapping里不用额外加/api前缀。这个细节让前后端联调省了很多事。4. 常见问题与排查技巧实录4.1 数据库连不上的三大经典征兆这个项目开发期遇到最多的问题是数据库连接异常。故障现象通常是启动SpringBoot时报Access denied for user或者Communications link failure。排查步骤我列成速查表报错特征大概率原因解决方案Access denied for user用户名或密码错误确认application.yml里的username和password与实际数据库一致Communications link failure数据库服务没启动或端口不对检查MySQL服务是否启动确认端口是3306而不是3307Public Key Retrieval is not allowedMySQL 8.x的认证插件问题JDBC URL加上allowPublicKeyRetrievaltrue参数第二个经典坑是时区问题。我一开始JDBC URL没带时区参数插入数据时发现数据库里的时间比实际时间少了8个小时。解决方案是URL里加上serverTimezoneAsia/ShanghaiuseUnicodetruecharacterEncodingutf8。这个两个参数强烈建议一次配齐不然后面中文乱码和时区问题轮番找上门。4.2 MyBatis-Plus分页不生效的排查过程用MyBatis-Plus做分页查询时第一次我写完了代码测试发现返回的数据总是全量而不是分页。检查了好几遍代码逻辑都没问题后来才意识到是缺少分页插件配置需要创建一个MybatisPlusInterceptor的Bean并在里面添加PaginationInnerInterceptor。没有这个配置Page参数传进去虽然不报错但SQL里不会拼接LIMIT子句。这个问题相当隐蔽因为代码层面看起来一切正常。后来我在配置类里加上如下代码就解决了Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; }另外分页查询的返回结果需要从Page对象里取records当前页数据和total总条数千万不要直接返回Page对象给前端否则会有很多冗余字段。4.3 Long类型ID在前端精度丢失的问题这个坑我认为是整个项目里最值得分享的。MySQL的bigint主键在Java实体里对应Long类型但当数据量不大时ID值比较小前端显示没问题。一旦数据量增长ID超过了JavaScript的Number类型安全范围2的53次方前端拿到的ID最后几位会变成0导致编辑、删除、详情跳转全部失效。我测试时造了100万条测试数据这个问题才暴露出来。解决方案是引入Jackson的序列化配置将Long类型统一转成String输出Bean public Jackson2ObjectMapperBuilderCustomizer jacksonCustomizer() { return builder - builder .serializerByType(Long.class, ToStringSerializer.instance) .serializerByType(Long.TYPE, ToStringSerializer.instance); }这个配置加上后前端拿到的ID变成字符串就不会有精度丢失问题了。强烈建议任何使用MyBatis-Plus默认雪花ID或者大整数自增ID的项目都加上这个配置。4.4 逻辑删除与唯一索引的冲突我用了MyBatis-Plus的TableLogic注解实现逻辑删除好处是删除数据不会物理消失方便审计恢复。但这里有个大坑如果表结构里有唯一索引逻辑删除后同一用户对同一条信息再次收藏时因为已删除的脏数据还在唯一索引会阻止插入。拿收藏表举例我在建表时给user_id post_id加了联合唯一索引但用户取消收藏后只是deleted字段从0变1物理行还在。用户再次收藏时插入新行触发唯一索引冲突报错。解决办法是去掉联合唯一索引在业务层查询时用WHERE user_id? AND post_id? AND deleted0判断是否存在不存在就插入。这样虽然多一次查询但避免了索引冲突问题。4.5 文件上传路径的打包陷阱本地开发时文件上传路径写的是/data/campus-share/images/工作正常。但用Maven打包成jar后部署到服务器运行tomcat其实是内嵌Tomcat后上传图片时发现目录创建失败。原因是jar包运行时的工作目录和源码目录不一样。排查后我把上传路径改成相对路径并做了目录自动创建String uploadDir System.getProperty(user.dir) File.separator upload File.separator; File dir new File(uploadDir); if (!dir.exists()) { dir.mkdirs(); }这个方法实测在Windows和Linux环境下都能正常运行jar包也不会因为路径问题启动失败。5. 部署上线与性能优化备忘本地开发跑通之后部署到服务器又是一轮考验。我用Maven执行mvn clean package -DskipTests打包生成campus-share.jar然后扔到同一台机器上的MySQL和Redis旁边。启动命令是nohup java -jar campus-share.jar --spring.profiles.activeprod app.log 21 配合application-prod.yml里的独立配置不同的端口、数据库密码、JWT密钥。这里有个我踩过的坑第一次部署时忘了在生产配置里设置spring.datasource.url的时区参数上线后所有时间数据全乱了后来把时区参数固化到所有环境才消停。性能优化这块我做了一个测试并发100个用户同时查看热帖详情Redis缓存命中的情况下TPS在2000以上而直接查数据库时TPS只有300左右。这个数据验证了缓存方案的价值。但Redis缓存只适用于查多写少的场景对于评论和收藏这种写操作我直接走数据库保证数据实时性优先。还有个小优化值得记录连接池参数。SpringBoot默认的HikariCP连接池最大连接数是10测试时并发稍大就会出现连接不够用的警告。我在配置里调成maximum-pool-size: 50并把connection-timeout: 3000030秒实测并发场景下连接等待超时的问题明显减少。连接池参数没有万能配置需要根据自己的业务和数据库性能来调但至少要知道这个参数是干什么的。最后说说Redis宕机时的兜底方案。我把缓存读取的逻辑封装成一个方法先从Redis取取不到就查数据库同时加上同步锁防止多个线程同时查库用setIfAbsent实现分布式锁。如果Redis彻底不可用就降级为永久查数据库模式系统功能不受影响只是性能下降。这个兜底逻辑虽然代码量不大但能让系统的健壮性上一个台阶。这个项目从设计到部署全套流程走下来我最大的体会是框架选型只是起点真正区分“能跑”和“能用”的是那些看不见的边界处理——权限校验在Service层而非前端、Long精度溢出、逻辑删除与唯一索引的冲突、缓存与数据库的一致性。你如果正在做同类项目建议先把这些边角料啃透再回头看业务代码会轻松很多。另外做这类系统不要一上来就追求高级功能把基础CRUD做扎实、把数据关系理顺、把异常处理补齐产出的系统靠谱程度反而更高。
