作为从大二就开始用SpringBoot接外包的老人我见过太多把项目做成“启动类 Controller 贫血Service”的玩法。这次帮人完整做了一套美食分享平台从数据库设计到部署上线走了一遍想把它沉淀成一篇能直接抄作业的记录。基于SpringBoot的美食分享平台本质上是一个典型的社区内容系统用户注册登录、发布带图片的美食帖子、其他用户点赞评论关注平台按菜系和关键词搜索内容。相比常见的学生管理系统它真正有含金量的地方在于文件上传、互动计数和内容检索这也是面试官最愿意深挖的点。整个项目我用了三周左右前端选了Vue3 Element Plus后端用SpringBoot提供RESTful接口数据库用MySQL缓存按需上Redis。下面不按教科书那种“需求分析→概要设计→详细设计”的顺序来写而是把我在实际编码过程中最关键的技术决策、版本选型和踩坑记录串起来给正在做毕业设计、或者想拿全栈项目练手的人一个可参照的模板。1. 项目整体设计与技术选型1.1 为什么用SpringBoot而不是SSH或SSM先说一个很多人不太愿意面对的事实现在2025年SSH早就没人讨论了SSM也基本退到老项目维护的场景里。我大四实习时维护过一套SSM的电商后台光spring-mvc.xml、mybatis-config.xml、web.xml加起来就几百行还要手工处理各种jar包冲突部署时把war扔到Tomcat里等半天启动。SpringBoot通过starter和自动配置把“配置”变成了“约定”。比如数据源只要引入spring-boot-starter-jdbc再写上数据库url、用户名和密码它就能直接创建DataSource省掉一整个xml文件。这里要特别说一个知识点springboot自定义自动配置。很多人会用starter但不知道自动配置的原理。简单讲SpringBoot启动时会扫描当前classpath下的spring.factories或AutoConfiguration.imports文件把里面声明的配置类加载进来再配合ConditionalOnClass、ConditionalOnMissingBean这些条件注解决定要不要生效。这也是为什么你引入redis-starter后不写任何配置类也能直接用RedisTemplate——因为有Spring Boot帮你在启动时自动配置了它。理解这个机制以后想封装自己的公共模块、写公司内部starter思路就是现成的。版本选择上面我踩了一个所有人都可能踩的坑SpringBoot版本不是越高越好。最开始我图新鲜用了SpringBoot 3.2结果JDK必须先升到17MyBatis-Plus还得换成spring-boot3专用依赖更麻烦的是javax.servlet包全部变成了jakarta.servlet网上搜到的老教程代码直接编译不过。后来我退回2.7.18JDK8就能跑各种第三方兼容性最稳。如果你是做课程设计或者毕业设计没有硬性要求就别追求最新版本2.7.x是目前最舒服的区间。1.2 技术栈选型与整体目录结构这套项目用到的技术栈我整理成了一张表方便你直接参考层次技术选型选择理由后端框架SpringBoot 2.7.18稳定、资料多、JDK8兼容数据访问MyBatis-Plus 3.5.3单表CRUD不用手写SQL分页插件成熟数据库MySQL 8.0主流关系型数据库功能验证方便缓存Redis 5验证码、热点数据缓存也可存点赞状态认证鉴权JWT 拦截器无状态认证前后端分离友好文件存储本地磁盘 静态资源映射毕设级别够用不增加额外成本前端Vue3 Element Plus Vite组件丰富开发效率高我见过不少同学用SSM或者SpringMVC的老项目改造结果前端换成Vue3后跨域问题、session共享问题层出不穷。SpringBoot天然适合RESTful风格接口返回JSON太方便了这也是选它的一个重要原因。再讲项目结构。很多人一上来就controller/service/mapper三层打天下小项目还好一旦功能多了就乱。我的建议是加上entity、dto、common、config这些包职责分清楚。实际目录大概长这样com.example.foodshare ├── controller # 接口层只做参数接收和返回 ├── service # 业务逻辑层事务、业务规则放这里 ├── mapper # MyBatis-Plus的数据访问接口 ├── entity # 和数据库表字段一一对应的实体 ├── dto # 前端交互的数据对象避免暴露实体 ├── common # 统一返回结构、全局异常、常量 ├── config # 跨域配置、静态资源映射、拦截器注册 ├── interceptor # JWT登录拦截器 └── utils # JwtUtil、FileUtil等工具干嘛要单独搞一套dto因为数据库实体里往往有password这类敏感字段直接序列化返回给前端就是事故。把实体和返回对象分离既能保护字段又能根据页面需要灵活组合数据。这个习惯越早建立越好后面面试聊项目时也能说出点门道。1.3 数据库设计与核心表结构数据库设计决定了这个项目的天花板。美食分享平台最少需要七张表用户表、帖子表、图片表、评论表、点赞表、关注表、分类表。用户表user字段类型说明idbigint主键自增usernamevarchar(50)登录账号唯一索引passwordvarchar(100)BCrypt加密后的密码nicknamevarchar(50)昵称avatarvarchar(255)头像地址cityvarchar(50)城市便于同城美食推荐create_timedatetime注册时间帖子表food_post字段类型说明idbigint主键user_idbigint发布人category_idint菜品分类titlevarchar(100)标题contenttext美食描述cover_imagevarchar(255)封面图like_countint点赞数冗余字段comment_countint评论数冗余字段statustinyint0草稿 1已发布 2下架create_timedatetime发布时间图片表post_imageid、post_id、image_url、sort_order用来存一个帖子多张图对应的地址排序字段控制展示顺序。评论表commentid、post_id、user_id、content、parent_id、create_time。parent_id支持楼中楼简单场景解析成两层就够了。点赞表like_recordid、user_id、post_id、create_time。这里必须加联合唯一索引uk_user_post(user_id, post_id)保证一个人不能对同一个帖子重复点赞。关注表user_followid、user_id、follow_user_id、create_time同样加唯一索引防止重复关注。分类表categoryid、name、sort_order比如火锅、烧烤、甜品、家常菜。为什么要把like_count和comment_count冗余在帖子里因为列表页和详情页要高频展示这两个数字。如果每次都去count点赞表数据量一上来页面会明显变慢。冗余字段会增加一点维护成本但通过事务和原子更新SQL可以保证最终一致。这个设计思路面试时非常加分属于“会用索引和反范式设计”的体现。2. 核心功能模块设计与实现2.1 用户注册登录与保存登录态注册流程看起来简单里面有两个必须处理的点密码加密和用户名唯一性检查。密码绝不能用MD5直接存现在GPU暴力破解MD5速度太快应该用BCrypt加密。Spring Security里有一个现成的BCryptPasswordEncoder即使不引入完整Spring Security也可以单独引一个spring-security-crypto包来用。登录时用bcrypt.matches(rawPassword, encodedPassword)校验不需要解密因为BCrypt本身是不可逆的。登录成功后的登录态保存我选了JWT。JWT的核心原理是服务端不保存session把一个包含用户id、用户名和过期时间的token签发给客户端客户端之后每次请求都带上这个token服务端验签后就能确认身份。对前后端分离场景相当友好后端多个实例部署时也不需要共享session。代码实现并不复杂核心就是生成token和校验token// JwtUtil的核心方法 public String generateToken(Long userId, String username) { MapString, Object claims new HashMap(); claims.put(userId, userId); claims.put(username, username); return Jwts.builder() .setClaims(claims) .setSubject(username) .setIssuedAt(new Date()) .setExpiration(new Date(System.currentTimeMillis() 7 * 24 * 3600 * 1000L)) .signWith(SignatureAlgorithm.HS256, SECRET_KEY) .compact(); }然后写一个拦截器对需要登录的接口做token校验。我用自定义注解RequireLogin标记接口拦截器里判断handler是否标注了这个注解如果有就取Header中的token并解析解析成功就把userId放入ThreadLocal供后续业务逻辑直接获取。这个方式比在Controller里每个方法都传一个token参数干净得多。2.2 美食帖子发布与图片上传发布帖子的前端表单包含标题、内容、分类、封面图、多张展示图。后端接收时用RequestPart(files) ListMultipartFile files接收文件列表同时用RequestParam接收其他表单字段。这里的事务控制要特别注意必须先保存food_post主记录拿到自增id然后再循环保存post_image图片关联记录这整个过程必须在同一个事务里。如果帖子保存成功图片记录插入时报错整个方法要回滚否则会出现一个没有图片的空壳帖子。图片上传其实是个容易翻车的地方。我不建议直接存到数据库BLOB字段也先不建议一上来就接阿里云OSS除非你确实有钱有券。最稳妥的做法是存在本地磁盘指定目录文件名用UUID重命名后缀保留原文件的扩展名。这样做有两个好处一是避免上传同名文件互相覆盖二是避免文件名里有中文或特殊字符导致访问路径解析出错。2.3 点赞、评论与关注互动这些互动功能不要想复杂靠数据库约束和原子操作就能做得可靠。点赞功能我用的是“先插入、后计数”的策略。like_record表有(user_id, post_id)联合唯一索引用户点一次赞就执行一次INSERT如果重复点赞数据库会直接报DuplicateEntry异常我们捕获这个异常就知道他已经点过了。点赞数不用先查后改而是执行一条原子SQLUPDATE food_post SET like_count like_count 1 WHERE id #{postId}这样在高并发下也不会把数字改错。很多新手喜欢先select出来在Java里加1再update回去两个请求同时进来就会丢更新。这个知识点面试时也经常出现属于必须掌握的基础。评论表用parent_id支持回复。如果parentId为null就表示顶级评论如果有值就表示回复某一条评论。做前端展示时只需要查顶层评论再按parentId批量查出子评论组装成一棵两层树。这个方案对美食分享的评论场景完全够用不必上重型的评论组件。关注功能本质上是记录一个“谁关注了谁”的关系。用户点关注时先查user_follow表有没有记录没有就插入同时更新对方的粉丝数取消关注则删除记录并减掉粉丝数。这里同样依靠唯一索引保证不会出现一条重复关注记录。2.4 搜索与推荐功能的实用做法搜索别一上来就上Elasticsearch那是给自己找罪受。你做一个毕设数据量撑死几万条用MySQL的LIKE模糊查询就够了。核心代码写在Mapper里Select(SELECT * FROM food_post WHERE status 1 AND (title LIKE CONCAT(%, #{keyword}, %) OR content LIKE CONCAT(%, #{keyword}, %))) ListFoodPost searchPosts(String keyword);配合分类条件的where和分页插件就能实现“按关键词按分类分页”的搜索效果。唯一的坑是模糊查询以通配符开头时MySQL会放弃索引但这在数据量小的项目里影响不大不要为了优化而过度设计。推荐功能不要做成用户画像推荐系统那是算法工程师的活。美食平台的合理推荐方式很简单给你列表页加一个“热门排序”。热度我用的公式是score like_count * 1 comment_count * 2 (create_time_unix / 3600)解释一下评论的互动深度比点赞高所以权重设为2create_time_unix除以3600是为了让新发布的帖子在分数上享有一点时间优势不然老帖子永远霸榜。这个公式看起来朴素但实际效果比单纯按时间倒序好很多。如果你还想更动态一点可以用SpringBoot的定时任务Scheduled每天凌晨算一次热度并更新到帖子的score字段查询时直接order by score。3. 实操过程与关键代码实现3.1 项目搭建与常用依赖配置我直接通过IDEA的Spring Initializr创建项目选Java 8和SpringBoot 2.7.18。如果你对maven比较熟也可以直接在pom.xml里自己配。下面这几个依赖是美食分享平台的核心parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.18/version /parent dependencies dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.3/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId scoperuntime/scope /dependency dependency groupIdio.jsonwebtoken/groupId artifactIdjjwt/artifactId version0.9.1/version /dependency /dependencies这里有个版本匹配的经验SpringBoot 2.7.x对应的mysql-connector-java版本由parent自动管理不需要自己写版本号而mybatis-plus-boot-starter 3.5.x同时兼容SpringBoot 2.x和3.x但3.x要加额外的适配包。我为什么反复强调版本因为真正拖垮你三天进度的往往不是业务逻辑而是依赖冲突。application.yml里的核心配置我也放在下面spring: datasource: url: jdbc:mysql://localhost:3306/food_share?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: yourpassword servlet: multipart: max-file-size: 10MB max-request-size: 30MB mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl map-underscore-to-camel-case: true把log-impl设为StdOutImpl开发时能在控制台直接看到生成的SQL排查数据访问问题特别有用。map-underscore-to-camel-case让数据库的create_time自动映射成Java的createTime省去一堆ResultMap。3.2 登录拦截器与全局用户信息注入我之前说过用自定义注解拦截器这里给你看最关键的实现。先定义一个注解Target(ElementType.METHOD) Retention(RetentionPolicy.RUNTIME) public interface RequireLogin { }矛拦截器核心代码public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { if (!(handler instanceof HandlerMethod)) { return true; } HandlerMethod method (HandlerMethod) handler; RequireLogin requireLogin method.getMethodAnnotation(RequireLogin.class); if (requireLogin null) { return true; } String token request.getHeader(Authorization); if (!StringUtils.hasText(token)) { throw new BusinessException(401, 未登录); } Claims claims JwtUtil.parseToken(token); UserContext.set(claims.get(userId, Long.class), claims.get(username, String.class)); return true; } Override public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) { UserContext.clear(); } }UserContext本质是一个ThreadLocal存当前请求的用户id。这样在service层直接UserContext.getUserId()就能知道是谁在操作不需要在接口方法里一次次传userId。注意必须在afterCompletion清理ThreadLocal否则线程池复用时数据会串。注册拦截器也很简单Configuration public class WebConfig implements WebMvcConfigurer { Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(new LoginInterceptor()) .addPathPatterns(/**) .excludePathPatterns(/api/auth/login, /api/auth/register, /uploads/**, /error); } }哪些接口需要登录由方法上的RequireLogin决定而不是在路径匹配里写死这样灵活很多。3.3 图片上传与静态资源路径映射图片上传的文件处理代码我把完整流程贴出来public String storeFile(MultipartFile file) throws IOException { String originalFilename file.getOriginalFilename(); String extension StringUtils.getFilenameExtension(originalFilename); String newFilename UUID.randomUUID().toString().replace(-, ) . extension; Path uploadPath Paths.get(uploadDir).toAbsolutePath().normalize(); Files.createDirectories(uploadPath); Path targetPath uploadPath.resolve(newFilename); file.transferTo(targetPath); return /uploads/ newFilename; }这里一定要用Paths.get(uploadDir).toAbsolutePath().normalize()把路径里的..和符号处理掉否则用户构造特殊文件名时可能造成路径穿越这是安全上必须注意的。保存文件后还要让SpringBoot能把/uploads/开头的URL映射到本地目录。写一个静态资源配置Override public void addResourceHandlers(ResourceHandlerRegistry registry) { String location file: uploadDir /; registry.addResourceHandler(/uploads/**).addResourceLocations(location); }注意Windows下路径可能类似E:/upload/要在配置里写成带盘符的绝对路径Linux则是/home/app/upload/。配置不对时浏览器访问图片会404而且是那种明明文件存在却访问不到的404排查起来很恼火。还有一个容易踩的坑SpringBoot默认单文件最大是1MB。美食帖子图片动辄几MB不调配置就会抛异常spring: servlet: multipart: max-file-size: 10MB max-request-size: 30MB我做项目时把单文件限到10MB一次请求总大小限到30MB这样一次上传多图时不会卡的太死。3.4 统一返回结构、异常处理与前端联调细节前后端对接最烦的就是返回格式不统一。一会儿直接返回对象一会儿返回Map前端根本没法写拦截器。我在这套项目里统一用Result 包装public class ResultT { private Integer code; private String message; private T data; public static T ResultT success(T data) { ResultT r new Result(); r.code 200; r.message ok; r.data data; return r; } public static T ResultT error(Integer code, String message) { ResultT r new Result(); r.code code; r.message message; return r; } }配合RestControllerAdvice做全局异常捕获把所有业务异常、校验异常、上传异常统一转成Result返回。这样前端在axios响应拦截器里只需要判断code是否等于200其他所有情况都走全局错误提示组件不需要每个页面都写重复的try-catch。前端联调时还要处理跨域。Vue3开发服务器默认在5173端口后端在8080端口怎么都算跨域。我在后端加一个CorsFilterBean public CorsFilter corsFilter() { CorsConfiguration config new CorsConfiguration(); config.addAllowedOriginPattern(*); config.addAllowedMethod(*); config.addAllowedHeader(*); config.setAllowCredentials(true); UrlBasedCorsConfigurationSource source new UrlBasedCorsConfigurationSource(); source.registerCorsConfiguration(/api/**, config); return new CorsFilter(source); }记住生产环境里别用allowedOriginPattern(*)配合credentials有安全隐患开发阶段图省事可以这么干。4. 常见问题与排查技巧实录4.1 SpringBoot版本过高导致的依赖迁移问题前面已经说了我在3.2上的遭遇。最典型的问题是网上绝大多数的SpringBoot教学视频、老教程都默认使用javax.servlet和javax.validation包。而SpringBoot 3.0开始整个Java EE标准被迁移到Jakarta命名空间所有import javax.*的代码全部编译报错。你还要把JDK升到17但很多学校的毕设环境还是JDK8这就非常被动。对比项SpringBoot 2.7.xSpringBoot 3.2.xJDK版本8及以上17及以上包名javax.*jakarta.*MyBatis-Plus普通starter需要spring-boot3专用starter第三方兼容大量成熟方案新库兼容老库可能要换版我的建议很直接毕业设计和课程设计首选2.7.x除非你的毕业设计题目明确要求用新版本。实际工作里公司系统也不会整天升大版本稳定压倒一切。4.2 图片上传失败和访问404的排查方向我在做这个项目时把图片上传的问题按现象拆解过如果上传文件报SizeLimitExceededException那就是multipart配置没改我上面那段配置抄上去就行。如果文件保存成功但前端访问/uploads/xxx.jpg返回404优先检查静态资源映射目录和实际存储目录是否一致。尤其要注意映射的目录最后有没有斜杠以及uploadDir是相对路径还是绝对路径。最傻的一次是我把file:后面的路径写成了uploadDir变量但uploadDir是相对路径“upload”配置文件放在项目根目录运行时有项目根路径兜着还好打成jar包部署后就完全找不到目录了。最后我把路径配置改成绝对路径才算彻底解决。还有一个不算坑但很常见的需求如果想在上传后生成缩略图比如列表页用压缩图建议参考thumbnailator这类轻量库。我因为在detail和列表共用同一张原图导致列表页图片加载明显变慢后来干脆给列表页返回封面图地址详情页才加载完整图集。4.3 MyBatis-Plus字段自动填充失效和分页插件很多同学用MyBatis-Plus时遇到一个问题TableField(fill FieldFill.INSERT)在insert时没有自动填充创建时间。这通常是缺少MetaObjectHandler实现。我写了一个公共的字段填充器Component public class MyMetaObjectHandler implements MetaObjectHandler { Override public void insertFill(MetaObject metaObject) { this.strictInsertFill(metaObject, createTime, LocalDateTime.class, LocalDateTime.now()); this.strictInsertFill(metaObject, updateTime, LocalDateTime.class, LocalDateTime.now()); } Override public void updateFill(MetaObject metaObject) { this.strictUpdateFill(metaObject, updateTime, LocalDateTime.class, LocalDateTime.now()); } }还有一个问题想用MyBatis-Plus的分页查询需要显式加一个分页插件BeanConfiguration public class MybatisPlusConfig { Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; } }不加这个Bean你调selectPage时得到的记录数是0或者分页参数不生效这是踩过的人最多的坑。4.4 并发点赞和数据一致性处理真实场景里两个人同时点赞如果代码是先select再update极可能造成点赞数丢失一次。我的方案已经讲过唯一的联合索引约束 原子UPDATE。但值得一提的是当用户取消点赞时也要用原子的like_count like_count - 1并且要做下限控制避免减成负数。SQL可以写成UPDATE food_post SET like_count GREATEST(like_count - 1, 0) WHERE id #{postId}如果你后续想用Redis来扛更高的并发点赞状态可以写进Redis的set点赞数用incr/decr命令再通过定时任务异步刷回MySQL。但在此之前先把纯MySQL方案做到正确。很多同学的“高并发设计”只是嘴上说说真实项目里先把唯一索引和原子更新用明白已经超过了很大一部分人。5. 部署上线与后续扩展建议5.1 项目打包与部署方式后端代码写完后用Maven打包mvn clean package -DskipTests打完包会在target目录下生成foodshare-0.0.1-SNAPSHOT.jar。直接上传到服务器用java命令启动nohup java -jar foodshare-0.0.1-SNAPSHOT.jar --spring.profiles.activeprod app.log 21 生产环境的数据库地址、上传目录这些配置我建议通过application-prod.yml单独维护里面写服务器对应的MySQL连接和绝对路径。不要把本地开发配置和生产混在一起否则上线第一个晚上就在改数据源。如果你想用宝塔面板这类工具部署操作流程也很简单先在软件商店安装MySQL和JDK然后上传jar包在网站页面里添加一个Java项目指定jar路径和端口再把MySQL数据库数据导入进去。如果遇到外部访问不了检查一下防火墙是否放行了对应端口。这套流程对没有运维基础的同学非常友好。考虑到以后可能会有多环境复制需求也可以写一个简单的DockerfileFROM openjdk:8-jdk-slim COPY target/foodshare-0.0.1-SNAPSHOT.jar app.jar ENTRYPOINT [java, -jar, /app.jar]Docker的好处是部署时只需要build一个镜像所有依赖环境都封装在里面换服务器不需要重新配JDK。前端打包用npm run build把生成的dist目录放到Nginx的静态目录里再把/api开头的请求反向代理到后端的8080端口。这是目前最常见的前后端分离部署方式比把前端手动扔进SpringBoot的static目录要干净得多。5.2 后续可以扩展的方向功能上建议留好口子但不建议一开始全做完。合理路线是先保证“发帖-浏览-互动”这个主链路完整稳定再考虑下面这些扩展方向。第一个是引入OSS对象存储。本地磁盘方案在部署到云服务器时有两个硬伤磁盘空间有限以及如果应用扩容到多台服务器文件不在同一台机器上就会访问不到。换成阿里云OSS或腾讯云COS后上传接口只需拿到文件流然后直传云端返回的是云上的URL性能和维护体验都好很多。第二个是把Redis用起来。除了登录验证码还可以把热门帖子的详情缓存到Redis给列表接口做缓存减少数据库压力。第三个是消息队列。比如用户关注后、帖子被点赞后可以发MQ消息通知对方不过这个对毕设来说有点重属于锦上添花。第四个是写一个小程序端。后端RESTful接口天然适配小程序前端复用经度整个项目的复杂度会提升一个档次。5.3 实用小技巧把调试过程做得更顺最后分享一个我从这个项目里总结出的经验开发阶段一定要把SQL日志打开。很多人排查问题只会断点调试但大量和数据相关的问题只要看到MyBatis打印出来的SQL一秒就能定位是参数问题还是SQL写法问题。MyBatis-Plus的log-impl配成StdOutImpl就是干这个用的。另外前端联调时在浏览器Network里先把请求和响应结构固定好不要后端改一个字段前端改一个字段那样永远联调不完。接口文档可以先不写得很重但要保证每个接口的返回字段命名是稳定的比如时间统一用String类型返回前端不用单独转换格式。这套项目我做下来最大的感受是技术选型不需要炫技把SpringBoot的数据访问、文件上传、认证鉴权这些基本功磨扎实比堆几个花哨的组件更有价值。你如果正准备做类似题目不妨先按这个路径把主流程走通再根据自己情况往上面加细节。等把数据访问、文件处理、权限控制这几个环节都亲手调过一遍你对SpringBoot的理解肯定就不只是会打一个RestController注解了。
