每年四五月份Java毕设相关的聊天群里就会冒出一堆近乎相同的问题SpringBoot项目怎么跑起来论文怎么排版演示视频到底录什么我去年做毕设时也被这些问题轮番折磨最后完成的题目是“基于SpringBoot的老年人营养膳食科普分享服务网站管理系统”一套从源码、论文大家习惯叫LW、部署说明到演示视频全部齐备的项目。这篇文章不打算讲虚的直接把我从选题到交付的完整路径写出来。如果你正在做类似系统或者只是手里有个项目但不知道该怎么补齐论文和部署材料可以拿下面的内容对照参考。1. 为什么选“老年人营养膳食科普分享”这个方向选题逻辑决定项目成败1.1 毕设选题的第一原则需求要能讲成一个完整故事很多同学一开始会想着挑战高并发秒杀、分布式事务这类听起来“高级”的技术方向结果环境配置就折腾半个月最后草草交一个带登录功能的空壳系统。我见过太多这样的情况。我选这个题目的理由很简单它有一个真实、具体、能被一句话说清楚的场景——老年人需要一个能浏览营养膳食食谱、阅读科普知识并把这些内容收藏、分享给家人的网站。评审老师听到这个需求脑子中有画面不用你费劲解释什么是消息队列、什么是Redis缓存。能让人听懂的项目答辩就成功了一半。1.2 从“管理系统”升级到“科普分享服务”传统的图书管理系统、学生管理系统本质是给内部人员使用的工作台业务维度很单薄。而这个网站天然分成两个面C端面向老年人、家属的浏览页面展示膳食食谱、科普文章支持收藏、评论、分享。B端面向营养师和管理员的运营后台负责内容发布、用户管理、数据统计。这样一来需求分析、功能模块、数据库设计、测试用例都有了足够的素材。写论文的时候每一章都有真实内容可以描述而不是靠堆字数凑篇幅。1.3 题目中的三个关键词分别落在哪个模块营养膳食对应食谱分类、每日推荐、食材列表、热量和营养标签。科普对应科普文章、营养师发布、文章详情页、富文本内容展示。分享服务对应收藏、点赞评论、生成分享链接。三个关键词做出三个模块三个模块又能形成数据联动。例如用户收藏了一篇关于高血压饮食的科普文章后首页可以展示同一分类下的清淡食谱推荐。这种功能综合度刚好踩在毕业设计评审对“工作量”的期待上。2. 技术方案定型SpringBoot为主干的选型思路与工程骨架2.1 后端框架为什么锁定SpringBootSpringBoot在Java技术栈里不算新东西但它的确是目前单人完成毕设项目的最优解。过去用SSH或者SSM光配置文件就要写一大堆。SpringBoot内置Tomcat自带自动装配和起步依赖启动一个Web服务只需要一个main方法。我的开发环境锁定为JDK 1.8、SpringBoot 2.7.18、MyBatis-Plus 3.5.3。这三个版本组在一起非常稳定JDK8在学校机房老电脑上兼容性最好SpringBoot 2.7还能直接使用javax命名空间相关的第三方资料也最多。2.2 服务端渲染还是前后端分离这是很多人纠结的问题。我之前也考虑过引入Vue做完全前后端分离但仔细算下来分离式开发意味着要引入Node环境、处理跨域、nginx反向代理对一个以框架应用为主的毕设来说复杂度会成倍增加而且部署时更容易在环境配置上翻车。我最终的方案是SpringBoot集成Thymeleaf做页面渲染再加上少量Ajax完成交互比较强的部分。管理后台也不单独建前端工程而是以Rest接口配合页面实现。如果前端基础好也可以用Vue但请提前做好心理准备部署的时候要折腾静态资源目录和接口转发。对于只想稳定通过评审的同学模板渲染更友好。2.3 工程分层的依据工程结构我采用了最经典的四层划分controller接收参数、返回结果 service核心业务逻辑 mapper数据库访问 entity数据表实体另外增加了common包放统一返回体Result和全局异常处理器config包放拦截器、静态资源配置。这样的结构有三个好处代码职责清晰出问题时能快速定位论文系统设计部分可以直接引用架构图答辩时讲数据从浏览器到数据库的流转过程会非常顺畅。2.4 pom.xml里最关键的一组依赖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 groupIdorg.projectlombok/groupId artifactIdlombok/artifactId /dependency dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-validation/artifactId /dependencyLombok能省掉getter/setter省下的时间非常可观。validation用于参数校验在新增食谱、注册用户时可以少写一大部分手动的空值判断。注意MyBatis-Plus版本不要随意升级到3.5.4以上部分版本对JDK8的兼容性会有变化我用3.5.3基本没有遇到问题。3. 核心功能与数据库建模从营养食谱到科普分享社区3.1 角色与权限三张核心角色的划分系统用户分三类普通用户老年人或家属、营养师、管理员。我在user表里用一个role字段区分分别是user、nutritionist、admin。数据库层不需要引入复杂的RBAC权限模型一个角色字段配合权限拦截器就够用。不同角色登录后前端导航栏展示的菜单不同普通用户浏览食谱、阅读科普文章、收藏、评论、分享。营养师发布食谱、发布科普文章、管理自己发布的内容。管理员用户管理、内容审核、分类管理、系统数据统计。权限控制能做到这个颗粒度论文里已经可以给出清晰的权限设计说明。3.2 食谱模块设计食谱表recipe的字段大概包括id、食谱名称、分类id、封面图、食材列表、做法步骤、热量、适宜人群、创建人、创建时间。分类单独建一张recipe_category表为了减少关联查询我在recipe表里冗余了categoryName字段页面展示时不用每次join分类表。首页推荐我采用的方案是根据当前用户的收藏记录统计收藏最多的食谱分类再从该分类下随机取几个食谱展示。这个算法不高级但它在项目里真实可用比堆一堆用户根本接触不到的“智能推荐”要诚实。答辩的时候你可以直接演示收藏某个分类的文章后刷新首页推荐位的变化。3.3 科普文章与收藏分享article文章表字段id、标题、封面图、摘要、正文富文本格式的HTML、分类id、状态草稿/已发布/已下架、发布人、发布时间。评论表article_comment关联文章id和用户id收藏表user_favorite关联用户id和内容id再加一个类型字段区分是收藏了文章还是食谱。分享功能我采用最直接的方式生成一个带id的URL用户复制后发给自己家人打开链接直接进入详情页。这里不要想复杂做类似SNS的转发卡片反而会增加工作量。点赞、评论、收藏三张交互表建好后整个系统的互动闭环就成立了。3.4 表结构落地与MyBatis-Plus代码生成我不建议打开Navicat才开始建表应该先把ER关系在纸上画清楚。系统核心表我列一下表名作用核心字段user用户表username, password, nickname, role, avatarrecipe_category食谱分类name, sort, statusrecipe食谱表title, category_id, cover, ingredients, steps, caloriesarticle_category科普分类name, sort, statusarticle科普文章title, cover, summary, content, category_id, statususer_favorite收藏表user_id, content_id, typearticle_comment评论表article_id, user_id, contentnotice公告表title, content, status表结构确定后用MyBatis-Plus的代码生成器根据这些表生成entity、mapper、service生成完再手动调整注释和字段类型。之后直接继承BaseMapper单表查询、分页查询都不用手写SQL。4. 开发中的真实踩坑记录权限、图片、时间处理4.1 拦截器把静态资源拦截了第一个让我抓狂的坑是拦截器把css、js、图片全部拦住了页面打开一片混乱。原因很简单拦截器写了路径匹配/**把静态资源也纳入了权限校验。解决方式是在注册拦截器时把/static/**、/upload/**、登录接口、登录页面这些路径显式排除。我建议把放行路径集中写在一个配置类里不要散落在各处否则后期排查很难受。4.2 用户权限校验用注解比用if判断靠谱最开始我是在每个接口方法里写if (!admin.equals(user.getRole())) { return Result.error(无权限); }写多了就会发现到处都是重复代码而且容易漏加。后来我写了一个RequireRole(admin)的自定义注解在拦截器里读取当前接口方法上的注解做统一校验。普通用户访问管理接口时直接返回403。这种做法比引入Spring Security轻量答辩被问到权限设计时也讲得清楚。登录状态我用session保存没有强行上JWT对毕设来说session方案足够而且不容易出现token过期这类给用户添麻烦的问题。4.3 图片上传成功但访问404图片上传是毕设里出现频率最高的“看起来简单但坑很深”的功能。我在application.yml里配置了spring: servlet: multipart: max-file-size: 20MB max-request-size: 100MB文件保存路径用的绝对路径同时手动创建目录。接着写一个WebMvcConfigurer把/upload/**映射到真实的磁盘目录。这里有两个细节必须注意一是文件路径分隔符不要写死/或\用File.separator跨平台兼容二是上传目录必须启动时检查一次如果目录不存在就自动创建否则第一次上传会直接报IOException。4.4 LocalDateTime前后端传递的两个坑Java8的LocalDateTime返回给前端时默认会带一个字母T例如2025-05-01T10:20:30页面上一看就很不专业。解决方式是在实体字段上加JsonFormat(pattern yyyy-MM-dd HH:mm:ss, timezone GMT8) private LocalDateTime createTime;另一个方向的问题是前端传日期字符串给后端如果不加DateTimeFormat请求会直接400。我统一在接收参数的VO字段上也加了DateTimeFormat(pattern yyyy-MM-dd HH:mm:ss)。另外MySQL数据库连接串里必须带上serverTimezoneAsia/Shanghai和useSSLfalse否则本地连接测试容易报时区错误。4.5 物理删除的问题用逻辑删除解决如果用户已经发布过文章、收藏过食谱物理删除这个用户会产生一堆孤儿数据。我给需要支持删除的实体加了逻辑删除字段deleted配合MyBatis-Plus的TableLogic注解。这样删除用户时实际执行的是update语句查询时框架会自动追加deleted0过滤条件。数据库外键我故意没有添加关联关系全部靠应用层逻辑维护这样构造测试数据时更自由也免得外键约束在插入序列不对时把项目卡死。5. 交付物整理源码、论文LW、部署说明、演示视频一个都不能少5.1 源码目录怎么组织才专业一套完整的毕设源码最关键的不是代码多么花哨而是让另一个人拿到手之后能顺利启动。我的目录结构是README.md docs/论文、设计文档 sql/建库建表脚本、初始化数据 src/后端源码README.md只写三件事项目简介、功能清单、启动步骤。启动步骤要具体到“修改application.yml第几行的数据库密码”而不是写“配置好环境后运行”。很多项目源码能跑但换个环境就启动不了问题几乎都出在README没说清楚。一份合格的README应当让导师或评审老师拿到的十分钟内把系统跑起来这件事值得花一小时认真写。5.2 论文的写作顺序别从绪论开始大部分学校的论文模板框架差别不大包括摘要、绪论、需求分析、系统设计、数据库设计、系统实现、系统测试、总结。我的建议是不要从绪论开始写否则你会卡在“研究意义”这种空虚的章节上。最顺畅的顺序是先写数据库设计因为表结构定了后面的代码逻辑就完全固定了然后写系统实现配合运行截图接着写系统测试补充测试用例和结果最后回头写摘要和需求分析。先写能写实的内容再用结论反推背景效率高很多。截图一定要做好标注每个功能模块至少配两张一张列表页一张操作结果页。5.3 部署说明文档要写成“无脑复现手册”部署说明的目的不是证明你会用Linux而是让一个没有接触过项目的人照着步骤把系统跑起来。我会写这些内容环境版本清单JDK 1.8、Maven 3.6、MySQL 5.7。数据库初始化命令mysql -u root -p sql/init.sql。配置文件修改点数据库账号密码、端口、文件上传路径。打包命令mvn clean package -DskipTests。运行命令java -jar target/xxx.jar。访问地址和默认账号密码。同时把端口被占用、权限不足这些常见报错写进FAQ章节。文档写完我自己在另一台电脑上照着执行了一遍确认每一步都和实际命令匹配。5.4 演示视频的录制节奏与脚本演示视频不是开录就一顿乱点需要先写脚本。我的流程是这样的开场一句话介绍系统名称和技术栈。进入前台演示用户注册登录。浏览食谱分类进入详情页。浏览科普文章收藏一篇、发表一条评论。切换管理员后台演示用户管理和文章审核。结尾展示项目目录结构和数据库表。总时长控制在5分钟以内。录制前把浏览器窗口缩放调整到合适比例太小的字导出后根本看不清。另外录屏过程中偶尔把后台接口返回的JSON切出来展示一下让评审看到确实有前后端数据交互而不是只做了个静态页面。6. 部署与验证从本地跑通到服务器上线6.1 本地启动七步法我整理了一个最基础但是最稳的启动清单安装JDK 1.8配置JAVA_HOME。安装Maven 3.6配置镜像仓库。安装MySQL 5.7创建数据库。执行sql目录下的建库脚本和数据初始化脚本。修改application.yml中的数据库账号密码。直接用IDEA启动Application类。浏览器访问首页地址。这套流程执行完系统能跑起来整个项目的信心就会上来。如果第一步就卡住优先检查环境变量是否生效。6.2 配置文件里最容易翻车的三个点数据库连接串必须写完整参考配置spring: datasource: url: jdbc:mysql://localhost:3306/elderly_nutrition?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai username: root password: your_password第二个是端口8080太容易和其他本地服务冲突我直接将server.port改成8081减少麻烦。第三个是上传目录Windows开发时可以写D:/upload/但Linux服务器上要改成/opt/upload这类路径。我通常把它抽成一个配置项app.upload.path部署时只改一处。6.3 服务器上线从jar包到后台运行服务器部署我选择了相对简单的方式不用Docker因为考虑到论文评审老师更熟悉传统部署流程。具体步骤本地打包mvn clean package -DskipTests。把target目录下的jar包上传到服务器。在服务器安装JDK和MySQL导入sql脚本。执行启动命令nohup java -jar elderly-nutrition.jar app.log 21 防火墙放行对应端口浏览器访问服务器IP加端口。这里强调一下nohup命令后面的写法容易打错我一开始写成21导致日志全部丢失排查了半个小时才发现。正确写法是21表示把错误输出也写到日志文件里。6.4 冒烟测试清单部署完成后不能直接宣布结束我按这份清单逐项测试注册一个新用户然后登录。访问首页检查食谱推荐位是否正常。点击一条食谱查看详情页图片是否显示。发布一条评论在文章详情页能看到。收藏一个内容前台“我的收藏”列表出现数据。管理员登录后台修改文章审核状态。上传一张新图片检查图片访问链接是否有效。每一项都通过这个系统才算真正交付。测试过程中发现的问题我会立刻回填到部署文档里保持文档和实际行为始终同步。最后分享一点个人体会毕设做到最后最大的收获不是那套代码而是“把一个项目从零到一完整交付”的能力。哪怕你手里已经拿到了别人整理好的完整源码、论文、部署说明和演示视频也一定不要只当一个下载者要自己动手把工程跑起来把每个模块的代码读一遍再试着改一个功能比如给食谱表增加一个字段、调整一下推荐排序逻辑。答辩现场的老师不会盯着你的文件包看他会问你这个收藏功能是怎么实现的数据库为什么这样设计部署的时候遇到过什么问题只有你自己真正做过的部分才能讲得理直气壮。把这份项目完整复现一遍你对SpringBoot、MyBatis-Plus和整个Web开发流程的理解会达到完全不同的层次。