最近在帮学弟学妹们看毕业设计发现很多同学在用SpringBoot做网站时虽然功能勉强实现了但代码结构一团乱麻部署时更是问题百出。这让我想起自己当年踩过的坑所以决定把一些实战经验和避坑要点整理出来希望能帮到正在为毕设奋斗的你。1. 新手常踩的坑从“能跑就行”到“结构清晰”很多同学拿到毕设题目第一反应就是赶紧把功能堆出来。这种思路往往会带来几个典型问题Controller成了“万能垃圾桶”所有业务逻辑、数据校验、甚至SQL查询都往Controller里塞一个文件动辄几百行后期想改个功能都无从下手。配置全靠“玄学”数据库连接字符串写死在代码里换台电脑就跑不起来。application.properties文件里各种配置一知半解出了问题只会百度照着答案试却不知道为什么。静态资源路径“神秘失踪”本地开发时图片、CSS加载得好好的一打成JAR包部署前端页面就各种404图片不显示样式全乱套。打包部署“一步一坑”用IDE运行得好好的用mvn package打出来的JAR包一运行就报错不是找不到主类就是端口被占用或者依赖冲突。这些问题根源在于大家把SpringBoot当成了一个“快速出活”的黑盒工具而没有理解它背后约定大于配置的工程化思想。毕业设计不仅是功能的实现更是你向未来雇主展示工程能力的第一份作品代码质量至关重要。2. 为什么是SpringBoot技术选型的简单思考在开始之前我们先明确一下为什么毕业设计推荐用SpringBoot而不是传统的SSMSpringSpringMVCMyBatis组合。传统SSM的繁琐记得我大二学SSM的时候光配一个XML文件就头大。要配置DispatcherServlet、视图解析器、数据源、事务管理器……一大堆XML哪个配错了整个项目都启动不了。这对于要在有限时间内完成毕设的新手来说学习成本和调试成本都太高了。SpringBoot的“开箱即用”SpringBoot的核心优势就是自动化配置和起步依赖。你需要Web功能引入spring-boot-starter-web。需要操作数据库引入spring-boot-starter-data-jpa和数据库驱动。它帮你把那些繁琐的XML配置都做好了你只需要在application.properties里写几个关键配置就行。这让我们能把精力集中在业务逻辑上而不是环境搭建上。内嵌Tomcat vs 外置Tomcat内嵌Tomcat默认这是SpringBoot的推荐方式。你的应用会打包成一个可执行的JAR文件里面包含了运行所需的一切包括Tomcat服务器。部署时只需要服务器上有Java环境一句java -jar your-app.jar就能跑起来。非常适合毕业设计演示、个人小项目以及云原生部署。外置Tomcat你需要打成一个WAR包然后部署到独立的Tomcat服务器中。这种方式更接近一些传统企业项目的部署模式。但对你来说增加了服务器配置的复杂度。除非毕设要求必须如此否则强烈建议使用内嵌式简单省心。3. 搭建清晰的三层架构Controller, Service, Repository好的结构是成功的一半。我们遵循最经典的三层架构来组织代码这能让你的项目逻辑清晰易于维护和测试。项目结构预览src/main/java/com/yourname/bishe/ ├── BisheApplication.java // 主启动类 ├── config/ // 配置类可选 ├── controller/ // 控制层处理HTTP请求 ├── service/ // 业务逻辑层 │ └── impl/ // 业务逻辑实现类 ├── repository/ // 数据访问层DAO层 ├── entity/ // 实体类对应数据库表 └── dto/ // 数据传输对象可选1. 实体层 (Entity)定义你的数据模型。这里我们使用JPA注解来映射数据库表。package com.yourname.bishe.entity; import javax.persistence.*; import java.time.LocalDateTime; Entity Table(name article) // 指定表名 public class Article { Id GeneratedValue(strategy GenerationType.IDENTITY) // 主键自增 private Long id; Column(nullable false, length 100) // 非空长度100 private String title; Column(columnDefinition TEXT) // 使用TEXT类型存储大内容 private String content; Column(name author_id) // 数据库列名 private Long authorId; private LocalDateTime createTime LocalDateTime.now(); // 默认值 // 省略 getter, setter 和 toString 方法建议用Lombok注解这里为了清晰手动写 public Long getId() { return id; } public void setId(Long id) { this.id id; } // ... 其他getter/setter }2. 数据访问层 (Repository)Spring Data JPA会让这变得极其简单。你只需要定义一个接口。package com.yourname.bishe.repository; import com.yourname.bishe.entity.Article; import org.springframework.data.jpa.repository.JpaRepository; import org.springframework.stereotype.Repository; import java.util.List; Repository // 可省略Spring会自动识别 public interface ArticleRepository extends JpaRepositoryArticle, Long { // 无需实现Spring Data JPA会根据方法名自动生成查询 // 查找某个作者的所有文章 ListArticle findByAuthorId(Long authorId); // 根据标题关键词模糊查询 ListArticle findByTitleContaining(String keyword); }3. 业务逻辑层 (Service)这里是写业务代码的地方。注意Service接口和实现分离是一种好习惯便于以后扩展和做Mock测试。package com.yourname.bishe.service; import com.yourname.bishe.entity.Article; import java.util.List; public interface ArticleService { Article saveArticle(Article article); Article getArticleById(Long id); ListArticle getAllArticles(); void deleteArticle(Long id); }package com.yourname.bishe.service.impl; import com.yourname.bishe.entity.Article; import com.yourname.bishe.repository.ArticleRepository; import com.yourname.bishe.service.ArticleService; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Service; import org.springframework.transaction.annotation.Transactional; import java.util.List; Service // 标记为Spring管理的Service Bean Transactional // 声明事务保证方法内的数据库操作原子性 public class ArticleServiceImpl implements ArticleService { Autowired private ArticleRepository articleRepository; Override public Article saveArticle(Article article) { // 这里可以加入业务逻辑比如数据校验、日志记录等 if (article.getTitle() null || article.getTitle().trim().isEmpty()) { throw new RuntimeException(文章标题不能为空); } return articleRepository.save(article); } Override public Article getArticleById(Long id) { // orElseThrow是Java8 Optional的用法找不到时抛出异常 return articleRepository.findById(id) .orElseThrow(() - new RuntimeException(文章不存在id: id)); } Override public ListArticle getAllArticles() { return articleRepository.findAll(); } Override public void deleteArticle(Long id) { if (!articleRepository.existsById(id)) { throw new RuntimeException(要删除的文章不存在id: id); } articleRepository.deleteById(id); } }4. 控制层 (Controller)负责接收请求调用Service返回响应。我们设计RESTful风格的API。package com.yourname.bishe.controller; import com.yourname.bishe.entity.Article; import com.yourname.bishe.service.ArticleService; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.http.HttpStatus; import org.springframework.http.ResponseEntity; import org.springframework.web.bind.annotation.*; import java.util.List; RestController // Controller ResponseBody直接返回JSON数据 RequestMapping(/api/articles) // 统一前缀 public class ArticleController { Autowired private ArticleService articleService; PostMapping public ResponseEntityArticle createArticle(RequestBody Article article) { // RequestBody 将前端传来的JSON自动绑定到Article对象 Article savedArticle articleService.saveArticle(article); return new ResponseEntity(savedArticle, HttpStatus.CREATED); // 返回201状态码 } GetMapping(/{id}) public ResponseEntityArticle getArticle(PathVariable Long id) { Article article articleService.getArticleById(id); return ResponseEntity.ok(article); // 返回200状态码和文章数据 } GetMapping public ResponseEntityListArticle getAllArticles() { ListArticle articles articleService.getAllArticles(); return ResponseEntity.ok(articles); } DeleteMapping(/{id}) public ResponseEntityVoid deleteArticle(PathVariable Long id) { articleService.deleteArticle(id); return ResponseEntity.noContent().build(); // 删除成功返回204状态码 } }4. 前端页面调用与静态资源处理后端API写好了前端怎么调用呢我们可以用简单的HTMLJavaScript或者集成Thymeleaf模板引擎。这里以Thymeleaf为例展示如何渲染一个文章列表页。首先在pom.xml中引入Thymeleaf依赖dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-thymeleaf/artifactId /dependency然后在src/main/resources/templates/目录下创建articleList.html!DOCTYPE html html xmlns:thhttp://www.thymeleaf.org head meta charsetUTF-8 title文章列表/title !-- 正确引入静态资源Thymeleaf会用{...}处理上下文路径 -- link relstylesheet th:href{/css/style.css} /head body h1我的文章/h1 table border1 tr thID/th th标题/th th创建时间/th th操作/th /tr !-- th:each 循环渲染后端传来的articles数据 -- tr th:eacharticle : ${articles} td th:text${article.id}/td td th:text${article.title}/td td th:text${article.createTime}/td td a th:href{/article/{id}(id${article.id})}查看/a /td /tr /table !-- 引入jQuery和自定义JS -- script srchttps://code.jquery.com/jquery-3.6.0.min.js/script script th:src{/js/main.js}/script /body /html创建一个Controller来返回这个页面package com.yourname.bishe.controller; import com.yourname.bishe.service.ArticleService; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.stereotype.Controller; import org.springframework.ui.Model; import org.springframework.web.bind.annotation.GetMapping; Controller // 注意这里是Controller不是RestController因为要返回视图 public class PageController { Autowired private ArticleService articleService; GetMapping(/) public String index(Model model) { model.addAttribute(articles, articleService.getAllArticles()); return articleList; // 对应 templates/articleList.html } }静态资源存放位置把你的CSS、JS、图片等放在src/main/resources/static/目录下。SpringBoot会自动映射。src/main/resources/static/ ├── css/ │ └── style.css ├── js/ │ └── main.js └── images/ └── logo.png这样在HTML中通过{/css/style.css}就能正确访问到。5. 基础安全与性能考量毕业设计虽然不用像金融系统那样安全但一些基本措施能体现你的专业性。1. 密码加密存储如果涉及用户登录绝对不要用明文存密码使用Spring Security的BCryptPasswordEncoder。Configuration public class SecurityConfig { Bean public PasswordEncoder passwordEncoder() { return new BCryptPasswordEncoder(); } } // 在保存用户时 user.setPassword(passwordEncoder.encode(rawPassword));2. 配置日志别再用System.out.println()了。在application.properties中配置日志级别方便排查问题。# 设置根日志级别为INFO但自己项目的包可以调为DEBUG logging.level.rootINFO logging.level.com.yourname.bisheDEBUG # 指定日志文件路径打包后也会生效 logging.file.namelogs/my-app.log3. 简单的CSRF防护如果使用Thymeleaf表单提交默认是开启CSRF保护的。确保你的表单这样写form th:action{/login} methodpost input typehidden th:name${_csrf.parameterName} th:value${_csrf.token} / !-- 其他表单项 -- /form6. 生产环境避坑指南打包与部署这是问题高发区请仔细看。1.application.properties的多环境配置开发环境用默认的application.properties。生产环境可以创建application-prod.properties在里面配置生产数据库地址、日志路径等。启动时通过命令行参数激活java -jar your-app.jar --spring.profiles.activeprod2. 打包后静态资源404问题原因Spring Boot 打成的可执行JAR包是一个独立的“文件系统”你的静态资源都在JAR包内部。如果前端页面里用了绝对路径或错误的相对路径就会找不到。解决就像前面例子所示在Thymeleaf中务必使用{...}语法它会自动帮你处理应用上下文路径。对于纯HTML/JS如果不用模板引擎需要确保路径以/开头相对于应用根路径或者使用相对路径时心里清楚当前页面的位置。3. 打包命令与主类确认在项目根目录执行mvn clean package。如果一切顺利会在target目录下生成一个your-app-0.0.1-SNAPSHOT.jar文件。如果打包失败检查pom.xml中的packagingjar/packaging默认就是jar以及Spring Boot Maven插件是否正确引入。确保你的主启动类有SpringBootApplication注解的类在顶级包下并且被正确扫描。4. 端口占用与启动检查运行java -jar target/your-app-0.0.1-SNAPSHOT.jar如果提示Port 8080 already in use可以在启动命令中指定新端口java -jar your-app.jar --server.port8081启动成功后打开浏览器访问http://localhost:8080/应该能看到你的首页。最后动手与思考好了一个结构清晰、具备RESTful API和简单前端的SpringBoot网站骨架就搭好了。但这仅仅是开始。我建议你动手重构对照这个结构去看看自己毕设的代码把混杂在Controller里的业务逻辑抽到Service层把散落的数据库操作归拢到Repository。思考解耦如果你的Service层直接调用了另一个Service层的方法想想是否可以通过事件ApplicationEvent或消息队列如果涉及来解耦补充单元测试给Service层的方法写几个JUnit测试。这不仅能验证逻辑更能让你理解依赖注入和Mock的概念。从SpringBootTest开始尝试。尝试一个前端框架如果你觉得Thymeleaf简单但不够灵活可以尝试用Vue.js或React作为前后端分离的前端通过Axios调用你写好的/api/articles等接口。毕业设计是一个绝佳的练手机会它逼着你去系统性地完成一个项目。把代码写规范把流程走通把坑踩一遍这个过程收获的远比一个“优秀”的分数更重要。祝你编码顺利答辩成功