这类期末大作业、课程设计项目最核心的价值不是功能有多炫而是能不能在你自己的电脑上用最少的配置、最清晰的步骤从零跑起来并且能稳定地完成“增删改查”这些基本操作。很多同学拿到源码后卡在环境配置、数据库连接、依赖下载这些前期步骤上导致项目跑不起来最后只能对着代码干瞪眼。这篇文章会围绕一个典型的SpringBoot 学生成绩管理系统拆解从环境准备到功能验证的全过程。我会把重点放在那些容易被忽略但至关重要的细节上比如 Maven 依赖版本冲突、数据库连接配置、以及如何理解并修改源码以适应你自己的需求。目标是让你不仅能运行这个项目更能理解它为什么这么设计遇到类似问题知道从哪里下手排查。1. 项目跑通前先理清技术栈和你的环境拿到一个“SpringBoot 学生成绩管理系统”的源码包先别急着导入 IDE 或运行。第一步应该是解压后快速浏览项目结构确认它的技术栈和运行环境要求。这能帮你避开 80% 的启动失败问题。1.1 快速识别项目依赖和技术构成一个典型的 SpringBoot 成绩管理系统其核心依赖通常写在pom.xml文件里。你需要重点关注以下几项SpringBoot 版本例如2.7.18或3.x.x。这决定了你需要的 JDK 版本。SpringBoot 2.x 通常需要 JDK 8 或 11而 SpringBoot 3.x 则要求 JDK 17 及以上。版本不匹配是启动失败最常见的原因。持久层框架最常见的是MyBatis-Plus或Spring Data JPA。这决定了你如何连接和操作数据库。如果是 MyBatis-Plus你需要找到mapper接口和对应的 XML 文件如果有的话。模板引擎可能是Thymeleaf或Freemarker。这决定了前端页面的渲染方式。你不需要深究其语法但要知道页面文件.html放在哪个目录通常是src/main/resources/templates。数据库驱动肯定是mysql-connector-java。注意它的版本是否与你本地安装的 MySQL 版本兼容。通常驱动版本 8.0.x 可以连接 MySQL 5.7 和 8.0。其他常见依赖Lombok简化实体类代码、Hutool工具集、PageHelper分页插件等。确保你的 IDE 安装了 Lombok 插件否则实体类会编译报错。我的建议是打开pom.xml先把这些关键依赖的版本号记下来。然后打开src/main/resources/application.yml或application.properties文件这里藏着项目的核心配置。1.2 配置你的本地环境JDK、Maven、MySQL、IDE在运行项目之前你的本地环境必须就位。不要假设环境已经配好按这个清单逐一核对JDK根据pom.xml中的 SpringBoot 版本安装对应的 JDK。在命令行输入java -version确认版本。强烈建议使用 JDK 8 或 JDK 11因为绝大多数课程设计项目基于 SpringBoot 2.x这两个版本兼容性最好。Maven用于管理依赖和构建项目。安装后在命令行输入mvn -v确认。你需要配置 Maven 的本地仓库路径和镜像源例如阿里云镜像这能极大加快依赖下载速度。MySQL安装一个 MySQL 5.7 或 8.0。启动 MySQL 服务并记住 root 用户的密码。IDEIntelliJ IDEA 或 Eclipse。IDEA 对 SpringBoot 的支持更友好。务必在 IDEA 中安装 Lombok 插件File - Settings - Plugins搜索 Lombok 并安装。环境检查无误后接下来就是处理数据库。2. 数据库从 SQL 文件到可连接的服务项目源码包里通常会附带一个 SQL 文件如sql/db_student_score.sql或者数据库备份文件。这是创建数据库表结构和初始数据的关键。2.1 执行 SQL 文件创建数据库和表不要直接在 IDE 里连接一个空的数据库。正确的步骤是打开你的 MySQL 客户端如命令行、Navicat、MySQL Workbench。创建一个新的数据库名称通常与项目配置文件中spring.datasource.url里指定的数据库名一致。例如如果配置是jdbc:mysql://localhost:3306/student_score_db?useSSLfalseserverTimezoneUTC那么数据库名就是student_score_db。CREATE DATABASE IF NOT EXISTS student_score_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;选中这个新创建的数据库然后执行源码包里的 SQL 文件。这将创建student学生表、course课程表、score成绩表等核心表并可能插入一些测试数据。关键点执行 SQL 时注意字符集。为了支持中文建议使用utf8mb4。如果 SQL 文件执行报错很可能是语法问题。一个稳妥的做法是用文本编辑器打开 SQL 文件检查是否有不兼容的语法如老版本的TYPEInnoDB并将其改为ENGINEInnoDB。2.2 修改配置文件建立项目与数据库的连接现在回到项目的application.yml配置文件。你需要修改数据库连接信息让它指向你刚创建的数据库。spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/student_score_db?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf8 username: root # 你的MySQL用户名 password: 123456 # 你的MySQL密码特别注意serverTimezone必须设置在中国通常设为Asia/Shanghai或GMT8否则可能遇到时区错误导致插入时间字段出错。useSSLfalse在本地开发环境通常关闭 SSL 连接以简化配置。characterEncodingutf8确保连接使用正确的字符集避免中文乱码。配置好后可以先简单测试一下连接。在 IDEA 里右侧边栏找到Database工具添加一个 MySQL 数据源填入上述信息点击Test Connection。如果成功说明数据库层面已准备就绪。3. 导入、配置与首次启动避开依赖和端口坑环境与数据库都准备好后就可以将项目导入 IDE 了。3.1 在 IDEA 中导入 Maven 项目打开 IDEA选择Open或Import Project。导航到你的项目根目录包含pom.xml的文件夹选中它。IDEA 会自动识别为 Maven 项目并开始下载依赖。这个过程取决于你的网速和镜像源配置可能需要几分钟。观察底部的进度条和Event Log确保没有网络错误。依赖下载完成后检查项目结构。确保src/main/java被标记为源代码根目录蓝色src/main/resources被标记为资源根目录。3.2 解决依赖冲突和编译错误依赖下载完成后项目可能仍然有红色错误提示。按以下顺序排查Lombok 错误如果实体类如Student.java的Data、Getter等注解报错是因为 IDEA 的 Lombok 插件未启用或未安装。去插件设置里确认并重启 IDEA。Maven 依赖问题在 IDEA 右侧 Maven 工具栏点击Reload All Maven Projects刷新按钮。有时需要多刷新几次。JDK 版本不匹配在File - Project Structure - Project中确保Project SDK和Project language level与你安装的 JDK 版本一致。特定类找不到如果报错提示某个类如QueryWrapper找不到可能是依赖未正确下载。尝试在命令行进入项目根目录执行mvn clean compile看更详细的错误信息。3.3 找到主类并启动SpringBoot 项目的入口是一个带有SpringBootApplication注解的类通常命名为XxxApplication例如StudentScoreApplication。找到它右键点击选择Run ‘StudentScoreApplication‘。启动时重点观察控制台日志成功标志看到Started ...Application in x.xx seconds字样并且没有明显的ERROR日志。Tomcat 端口日志中会显示Tomcat started on port(s): 8080。默认是 8080 端口。如果 8080 被占用可以在application.yml中修改server: port: 8081 # 改为其他端口如 8090数据库连接成功日志中应有DataSource初始化成功的信息。如果启动失败控制台的错误信息是你最好的朋友。常见的启动失败原因包括APPLICATION FAILED TO START通常是配置错误如数据库连接失败密码错误、数据库名不对、服务未启动。BeanCreationException可能是依赖注入问题检查Service,Controller,Mapper等注解的类是否在扫描路径下。端口被占用按上述方法修改server.port。4. 功能验证与代码走读理解“增删改查”如何实现项目成功启动后打开浏览器访问http://localhost:8080或你配置的端口。通常登录页或首页会自动跳转。很多演示项目会使用默认账号密码如admin/admin请查看项目README.md或 SQL 文件中的初始数据。4.1 按模块测试核心功能不要一上来就乱点。按照业务模块系统性地测试并观察页面与数据库的联动学生管理增点击“新增学生”输入学号、姓名、性别、班级等信息后提交。然后立刻去数据库的student表里查看是否多了一条记录。查在列表页尝试按姓名或学号搜索。观察页面传给了后端什么参数可以浏览器F12打开开发者工具看Network请求后端返回了什么数据。改点击某条记录的“编辑”修改信息后保存。再次核对数据库对应记录是否更新。删删除一条记录谨慎操作最好先用测试数据。确认数据库记录被删除并思考是物理删除真删还是逻辑删除用字段标记如is_deleted1。逻辑删除是更常见的做法。课程管理 成绩管理重复上述“增删改查”流程分别针对course表和score表。特别注意成绩管理新增成绩时通常需要选择“学生”和“课程”。这涉及到下拉框数据绑定。查看前端页面这两个下拉框的数据是如何从后端加载的通常是页面加载时通过某个接口获取了所有学生和课程的列表。成绩查询可能支持按学生、按课程、按班级等多条件查询。测试这些组合查询观察SQL是如何拼接的。4.2 结合代码理解后端逻辑功能测试通过后才是学习的关键对照着页面操作去看后端代码是怎么写的。找到控制器Controller在controller包下找到StudentController、ScoreController等。每个页面的请求URL都在这里映射。例如学生列表页的请求可能是GET /student/list。在StudentController里找到GetMapping(“/list”)的方法。查看这个方法如何接收参数如RequestParam、如何调用服务层studentService、如何返回结果返回视图名或JSON数据。查看服务层Service和持久层Mapper跟随 Controller 中的studentService.xxx()调用进入StudentService接口及其实现类StudentServiceImpl。服务层包含业务逻辑。例如在删除学生前可能会检查该学生是否有成绩记录。服务层会调用StudentMapper接口的方法来操作数据库。如果用的是 MyBatis-Plus你会看到类似studentMapper.selectList(wrapper)、studentMapper.insert(student)的调用。理解实体类Entity与数据库表的映射打开Student.java实体类。TableName(“student”)注解指定了对应的表名。字段上的TableId指定主键TableField指定字段映射如果字段名与数据库列名不一致。这就是 ORM对象关系映射的核心Java 对象和数据库表记录之间的转换。通过这个走读过程你会清晰地看到一条请求的完整链路浏览器 - Controller - Service - Mapper - 数据库 - 返回数据 - 渲染页面。这就是 MVC 架构的直观体现。5. 自定义修改与扩展将项目变成你自己的能运行和看懂是基础能修改和扩展才能体现你的工作量应对课设或期末作业。5.1 进行简单的定制化修改修改系统名称和Logo系统名称通常在前端页面的title标签或导航栏中。用全局搜索CtrlShiftF查找“学生成绩管理系统”等字样在对应的 HTML 或配置文件里修改。Logo 图片通常放在src/main/resources/static/images目录下。替换为你自己的图片文件并修改页面中引用该图片的路径。增加或修改实体字段需求为学生表增加“邮箱”字段。步骤 a.数据库在 MySQL 中执行ALTER TABLE student ADD COLUMN email VARCHAR(100);。 b.实体类在Student.java中添加private String email;以及 getter/setter如果用了 Lombok 的Data则自动生成。 c.前端页面在新增和编辑学生的表单中增加一个邮箱输入框。注意name属性要与实体类字段名一致。 d.后端Controller 和 Service 通常无需修改因为 MyBatis-Plus 会自动映射。但如果你在 Service 中做了字段非空校验需要更新。5.2 实现一个简单的扩展功能以“统计每门课程的平均分”为例这是一个典型的扩展需求涉及新的 SQL 查询和页面展示。后端实现在ScoreMapper.java或自定义的ScoreStatisticsMapper.java中定义一个新的查询方法。// 假设使用 MyBatis-Plus可以写一个自定义的XML映射或者在Mapper接口上用Select注解 Select(“SELECT c.course_name, AVG(s.score) as avg_score FROM score s JOIN course c ON s.course_id c.id GROUP BY s.course_id”) ListMapString, Object selectCourseAvgScore();在ScoreService中创建一个方法如getCourseAvgScore()来调用这个 Mapper 方法。在ScoreController中新增一个请求映射如GET /score/avg调用 Service 方法并将结果课程名和平均分列表放到模型Model中或者直接返回 JSON。前端展示新建一个页面course_avg_score.html或者在某现有页面如成绩统计页增加一个板块。使用 Thymeleaf 模板语法遍历后端传过来的列表以表格形式展示。table trth课程名称/thth平均分/th/tr tr th:each“item : ${avgScoreList}“ td th:text“${item.course_name}“/td td th:text“${#numbers.formatDecimal(item.avg_score, 1, 2)}“/td /tr /table在导航栏添加一个指向这个新页面的链接。完成这个扩展后你就不仅仅是一个代码的“运行者”而是一个“修改者”和“扩展者”了。这在课程答辩或作业提交时是极大的加分项。6. 项目打包与部署从本地到可交付最后你需要将项目打包生成一个可独立运行的 JAR 文件这通常是作业提交的要求。6.1 使用 Maven 打包项目在 IDEA 右侧 Maven 工具栏展开项目 - Lifecycle。先双击执行clean清理旧的编译文件。再双击执行package进行打包。打包成功后在项目根目录的target文件夹下会生成一个项目名-版本号.jar文件例如student-score-system-0.0.1-SNAPSHOT.jar。关键点确保打包时跳过了测试否则测试失败会导致打包失败。可以在执行package时加上-DskipTests参数或者在pom.xml中配置maven-surefire-plugin来跳过测试。6.2 运行 JAR 包与生产环境配置生成的 JAR 包包含了所有依赖和嵌入式 Tomcat可以直接运行。命令行运行java -jar target/student-score-system-0.0.1-SNAPSHOT.jar指定配置文件如果你有为生产环境准备的配置文件如application-prod.yml可以这样运行java -jar your-project.jar --spring.profiles.activeprod后台运行Linux/Unixnohup java -jar your-project.jar app.log 21 这会将程序放在后台运行并将日志输出到app.log文件。部署注意事项数据库确保部署服务器的 MySQL 服务已启动且数据库、用户名、密码与项目配置文件中的生产环境配置一致。端口检查服务器防火墙是否开放了应用运行的端口如 8080。文件上传如果系统有上传功能如上传学生照片要确保在配置文件中指定了生产环境的文件存储路径并且该路径有写权限。7. 常见问题排查清单遇到问题先看这里即使按照上述步骤你可能还是会遇到一些问题。这里是一个快速排查清单问题启动时报Failed to configure a DataSource原因数据库连接配置错误。排查1. 检查application.yml中的url,username,password。2. 确认 MySQL 服务是否启动。3. 确认数据库名是否存在。4. 检查网络或防火墙如果数据库不在本机。问题页面访问 404原因请求路径不对或 Controller 未映射。排查1. 检查浏览器地址栏 URL 是否正确。2. 检查控制台应用是否真的启动成功。3. 检查 Controller 类上的RequestMapping和方法上的GetMapping/PostMapping注解路径。问题页面显示 Whitelabel Error Page原因SpringBoot 默认的错误页通常是因为请求的路径没有对应的处理器或者处理器内部抛异常了。排查查看控制台输出的完整异常堆栈信息这是解决问题的关键线索。问题前端页面样式CSS/JS丢失原因静态资源路径不对。排查1. 检查静态资源CSS, JS, images是否放在src/main/resources/static目录下。2. 检查页面中引用资源的路径如link href“/css/style.css” rel“stylesheet”开头的/很重要。问题新增或修改数据后页面没变化原因操作未成功或页面缓存。排查1. 直接查数据库看数据是否真的插入或更新了。2. 浏览器按 F12 打开开发者工具在 Network 标签页查看提交请求的响应看后端返回了什么。3. 尝试强制刷新浏览器CtrlF5。把这个项目从头到尾跑一遍、改一遍、再打包部署一遍你对 SpringBoot 项目开发的基本流程就有了一个非常扎实的感性认识。它比你空看理论要有效得多。记住遇到报错不要慌控制台日志和浏览器开发者工具F12是你的两大神器仔细读错误信息十有八九都能自己找到解决方案。
这类期末大作业、课程设计项目最核心的价值不是功能有多炫而是能不能在你自己的电脑上用最少的配置、最清晰的步骤从零跑起来并且能稳定地完成“增删改查”这些基本操作。很多同学拿到源码后卡在环境配置、数据库连接、依赖下载这些前期步骤上导致项目跑不起来最后只能对着代码干瞪眼。这篇文章会围绕一个典型的SpringBoot 学生成绩管理系统拆解从环境准备到功能验证的全过程。我会把重点放在那些容易被忽略但至关重要的细节上比如 Maven 依赖版本冲突、数据库连接配置、以及如何理解并修改源码以适应你自己的需求。目标是让你不仅能运行这个项目更能理解它为什么这么设计遇到类似问题知道从哪里下手排查。1. 项目跑通前先理清技术栈和你的环境拿到一个“SpringBoot 学生成绩管理系统”的源码包先别急着导入 IDE 或运行。第一步应该是解压后快速浏览项目结构确认它的技术栈和运行环境要求。这能帮你避开 80% 的启动失败问题。1.1 快速识别项目依赖和技术构成一个典型的 SpringBoot 成绩管理系统其核心依赖通常写在pom.xml文件里。你需要重点关注以下几项SpringBoot 版本例如2.7.18或3.x.x。这决定了你需要的 JDK 版本。SpringBoot 2.x 通常需要 JDK 8 或 11而 SpringBoot 3.x 则要求 JDK 17 及以上。版本不匹配是启动失败最常见的原因。持久层框架最常见的是MyBatis-Plus或Spring Data JPA。这决定了你如何连接和操作数据库。如果是 MyBatis-Plus你需要找到mapper接口和对应的 XML 文件如果有的话。模板引擎可能是Thymeleaf或Freemarker。这决定了前端页面的渲染方式。你不需要深究其语法但要知道页面文件.html放在哪个目录通常是src/main/resources/templates。数据库驱动肯定是mysql-connector-java。注意它的版本是否与你本地安装的 MySQL 版本兼容。通常驱动版本 8.0.x 可以连接 MySQL 5.7 和 8.0。其他常见依赖Lombok简化实体类代码、Hutool工具集、PageHelper分页插件等。确保你的 IDE 安装了 Lombok 插件否则实体类会编译报错。我的建议是打开pom.xml先把这些关键依赖的版本号记下来。然后打开src/main/resources/application.yml或application.properties文件这里藏着项目的核心配置。1.2 配置你的本地环境JDK、Maven、MySQL、IDE在运行项目之前你的本地环境必须就位。不要假设环境已经配好按这个清单逐一核对JDK根据pom.xml中的 SpringBoot 版本安装对应的 JDK。在命令行输入java -version确认版本。强烈建议使用 JDK 8 或 JDK 11因为绝大多数课程设计项目基于 SpringBoot 2.x这两个版本兼容性最好。Maven用于管理依赖和构建项目。安装后在命令行输入mvn -v确认。你需要配置 Maven 的本地仓库路径和镜像源例如阿里云镜像这能极大加快依赖下载速度。MySQL安装一个 MySQL 5.7 或 8.0。启动 MySQL 服务并记住 root 用户的密码。IDEIntelliJ IDEA 或 Eclipse。IDEA 对 SpringBoot 的支持更友好。务必在 IDEA 中安装 Lombok 插件File - Settings - Plugins搜索 Lombok 并安装。环境检查无误后接下来就是处理数据库。2. 数据库从 SQL 文件到可连接的服务项目源码包里通常会附带一个 SQL 文件如sql/db_student_score.sql或者数据库备份文件。这是创建数据库表结构和初始数据的关键。2.1 执行 SQL 文件创建数据库和表不要直接在 IDE 里连接一个空的数据库。正确的步骤是打开你的 MySQL 客户端如命令行、Navicat、MySQL Workbench。创建一个新的数据库名称通常与项目配置文件中spring.datasource.url里指定的数据库名一致。例如如果配置是jdbc:mysql://localhost:3306/student_score_db?useSSLfalseserverTimezoneUTC那么数据库名就是student_score_db。CREATE DATABASE IF NOT EXISTS student_score_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;选中这个新创建的数据库然后执行源码包里的 SQL 文件。这将创建student学生表、course课程表、score成绩表等核心表并可能插入一些测试数据。关键点执行 SQL 时注意字符集。为了支持中文建议使用utf8mb4。如果 SQL 文件执行报错很可能是语法问题。一个稳妥的做法是用文本编辑器打开 SQL 文件检查是否有不兼容的语法如老版本的TYPEInnoDB并将其改为ENGINEInnoDB。2.2 修改配置文件建立项目与数据库的连接现在回到项目的application.yml配置文件。你需要修改数据库连接信息让它指向你刚创建的数据库。spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/student_score_db?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf8 username: root # 你的MySQL用户名 password: 123456 # 你的MySQL密码特别注意serverTimezone必须设置在中国通常设为Asia/Shanghai或GMT8否则可能遇到时区错误导致插入时间字段出错。useSSLfalse在本地开发环境通常关闭 SSL 连接以简化配置。characterEncodingutf8确保连接使用正确的字符集避免中文乱码。配置好后可以先简单测试一下连接。在 IDEA 里右侧边栏找到Database工具添加一个 MySQL 数据源填入上述信息点击Test Connection。如果成功说明数据库层面已准备就绪。3. 导入、配置与首次启动避开依赖和端口坑环境与数据库都准备好后就可以将项目导入 IDE 了。3.1 在 IDEA 中导入 Maven 项目打开 IDEA选择Open或Import Project。导航到你的项目根目录包含pom.xml的文件夹选中它。IDEA 会自动识别为 Maven 项目并开始下载依赖。这个过程取决于你的网速和镜像源配置可能需要几分钟。观察底部的进度条和Event Log确保没有网络错误。依赖下载完成后检查项目结构。确保src/main/java被标记为源代码根目录蓝色src/main/resources被标记为资源根目录。3.2 解决依赖冲突和编译错误依赖下载完成后项目可能仍然有红色错误提示。按以下顺序排查Lombok 错误如果实体类如Student.java的Data、Getter等注解报错是因为 IDEA 的 Lombok 插件未启用或未安装。去插件设置里确认并重启 IDEA。Maven 依赖问题在 IDEA 右侧 Maven 工具栏点击Reload All Maven Projects刷新按钮。有时需要多刷新几次。JDK 版本不匹配在File - Project Structure - Project中确保Project SDK和Project language level与你安装的 JDK 版本一致。特定类找不到如果报错提示某个类如QueryWrapper找不到可能是依赖未正确下载。尝试在命令行进入项目根目录执行mvn clean compile看更详细的错误信息。3.3 找到主类并启动SpringBoot 项目的入口是一个带有SpringBootApplication注解的类通常命名为XxxApplication例如StudentScoreApplication。找到它右键点击选择Run ‘StudentScoreApplication‘。启动时重点观察控制台日志成功标志看到Started ...Application in x.xx seconds字样并且没有明显的ERROR日志。Tomcat 端口日志中会显示Tomcat started on port(s): 8080。默认是 8080 端口。如果 8080 被占用可以在application.yml中修改server: port: 8081 # 改为其他端口如 8090数据库连接成功日志中应有DataSource初始化成功的信息。如果启动失败控制台的错误信息是你最好的朋友。常见的启动失败原因包括APPLICATION FAILED TO START通常是配置错误如数据库连接失败密码错误、数据库名不对、服务未启动。BeanCreationException可能是依赖注入问题检查Service,Controller,Mapper等注解的类是否在扫描路径下。端口被占用按上述方法修改server.port。4. 功能验证与代码走读理解“增删改查”如何实现项目成功启动后打开浏览器访问http://localhost:8080或你配置的端口。通常登录页或首页会自动跳转。很多演示项目会使用默认账号密码如admin/admin请查看项目README.md或 SQL 文件中的初始数据。4.1 按模块测试核心功能不要一上来就乱点。按照业务模块系统性地测试并观察页面与数据库的联动学生管理增点击“新增学生”输入学号、姓名、性别、班级等信息后提交。然后立刻去数据库的student表里查看是否多了一条记录。查在列表页尝试按姓名或学号搜索。观察页面传给了后端什么参数可以浏览器F12打开开发者工具看Network请求后端返回了什么数据。改点击某条记录的“编辑”修改信息后保存。再次核对数据库对应记录是否更新。删删除一条记录谨慎操作最好先用测试数据。确认数据库记录被删除并思考是物理删除真删还是逻辑删除用字段标记如is_deleted1。逻辑删除是更常见的做法。课程管理 成绩管理重复上述“增删改查”流程分别针对course表和score表。特别注意成绩管理新增成绩时通常需要选择“学生”和“课程”。这涉及到下拉框数据绑定。查看前端页面这两个下拉框的数据是如何从后端加载的通常是页面加载时通过某个接口获取了所有学生和课程的列表。成绩查询可能支持按学生、按课程、按班级等多条件查询。测试这些组合查询观察SQL是如何拼接的。4.2 结合代码理解后端逻辑功能测试通过后才是学习的关键对照着页面操作去看后端代码是怎么写的。找到控制器Controller在controller包下找到StudentController、ScoreController等。每个页面的请求URL都在这里映射。例如学生列表页的请求可能是GET /student/list。在StudentController里找到GetMapping(“/list”)的方法。查看这个方法如何接收参数如RequestParam、如何调用服务层studentService、如何返回结果返回视图名或JSON数据。查看服务层Service和持久层Mapper跟随 Controller 中的studentService.xxx()调用进入StudentService接口及其实现类StudentServiceImpl。服务层包含业务逻辑。例如在删除学生前可能会检查该学生是否有成绩记录。服务层会调用StudentMapper接口的方法来操作数据库。如果用的是 MyBatis-Plus你会看到类似studentMapper.selectList(wrapper)、studentMapper.insert(student)的调用。理解实体类Entity与数据库表的映射打开Student.java实体类。TableName(“student”)注解指定了对应的表名。字段上的TableId指定主键TableField指定字段映射如果字段名与数据库列名不一致。这就是 ORM对象关系映射的核心Java 对象和数据库表记录之间的转换。通过这个走读过程你会清晰地看到一条请求的完整链路浏览器 - Controller - Service - Mapper - 数据库 - 返回数据 - 渲染页面。这就是 MVC 架构的直观体现。5. 自定义修改与扩展将项目变成你自己的能运行和看懂是基础能修改和扩展才能体现你的工作量应对课设或期末作业。5.1 进行简单的定制化修改修改系统名称和Logo系统名称通常在前端页面的title标签或导航栏中。用全局搜索CtrlShiftF查找“学生成绩管理系统”等字样在对应的 HTML 或配置文件里修改。Logo 图片通常放在src/main/resources/static/images目录下。替换为你自己的图片文件并修改页面中引用该图片的路径。增加或修改实体字段需求为学生表增加“邮箱”字段。步骤 a.数据库在 MySQL 中执行ALTER TABLE student ADD COLUMN email VARCHAR(100);。 b.实体类在Student.java中添加private String email;以及 getter/setter如果用了 Lombok 的Data则自动生成。 c.前端页面在新增和编辑学生的表单中增加一个邮箱输入框。注意name属性要与实体类字段名一致。 d.后端Controller 和 Service 通常无需修改因为 MyBatis-Plus 会自动映射。但如果你在 Service 中做了字段非空校验需要更新。5.2 实现一个简单的扩展功能以“统计每门课程的平均分”为例这是一个典型的扩展需求涉及新的 SQL 查询和页面展示。后端实现在ScoreMapper.java或自定义的ScoreStatisticsMapper.java中定义一个新的查询方法。// 假设使用 MyBatis-Plus可以写一个自定义的XML映射或者在Mapper接口上用Select注解 Select(“SELECT c.course_name, AVG(s.score) as avg_score FROM score s JOIN course c ON s.course_id c.id GROUP BY s.course_id”) ListMapString, Object selectCourseAvgScore();在ScoreService中创建一个方法如getCourseAvgScore()来调用这个 Mapper 方法。在ScoreController中新增一个请求映射如GET /score/avg调用 Service 方法并将结果课程名和平均分列表放到模型Model中或者直接返回 JSON。前端展示新建一个页面course_avg_score.html或者在某现有页面如成绩统计页增加一个板块。使用 Thymeleaf 模板语法遍历后端传过来的列表以表格形式展示。table trth课程名称/thth平均分/th/tr tr th:each“item : ${avgScoreList}“ td th:text“${item.course_name}“/td td th:text“${#numbers.formatDecimal(item.avg_score, 1, 2)}“/td /tr /table在导航栏添加一个指向这个新页面的链接。完成这个扩展后你就不仅仅是一个代码的“运行者”而是一个“修改者”和“扩展者”了。这在课程答辩或作业提交时是极大的加分项。6. 项目打包与部署从本地到可交付最后你需要将项目打包生成一个可独立运行的 JAR 文件这通常是作业提交的要求。6.1 使用 Maven 打包项目在 IDEA 右侧 Maven 工具栏展开项目 - Lifecycle。先双击执行clean清理旧的编译文件。再双击执行package进行打包。打包成功后在项目根目录的target文件夹下会生成一个项目名-版本号.jar文件例如student-score-system-0.0.1-SNAPSHOT.jar。关键点确保打包时跳过了测试否则测试失败会导致打包失败。可以在执行package时加上-DskipTests参数或者在pom.xml中配置maven-surefire-plugin来跳过测试。6.2 运行 JAR 包与生产环境配置生成的 JAR 包包含了所有依赖和嵌入式 Tomcat可以直接运行。命令行运行java -jar target/student-score-system-0.0.1-SNAPSHOT.jar指定配置文件如果你有为生产环境准备的配置文件如application-prod.yml可以这样运行java -jar your-project.jar --spring.profiles.activeprod后台运行Linux/Unixnohup java -jar your-project.jar app.log 21 这会将程序放在后台运行并将日志输出到app.log文件。部署注意事项数据库确保部署服务器的 MySQL 服务已启动且数据库、用户名、密码与项目配置文件中的生产环境配置一致。端口检查服务器防火墙是否开放了应用运行的端口如 8080。文件上传如果系统有上传功能如上传学生照片要确保在配置文件中指定了生产环境的文件存储路径并且该路径有写权限。7. 常见问题排查清单遇到问题先看这里即使按照上述步骤你可能还是会遇到一些问题。这里是一个快速排查清单问题启动时报Failed to configure a DataSource原因数据库连接配置错误。排查1. 检查application.yml中的url,username,password。2. 确认 MySQL 服务是否启动。3. 确认数据库名是否存在。4. 检查网络或防火墙如果数据库不在本机。问题页面访问 404原因请求路径不对或 Controller 未映射。排查1. 检查浏览器地址栏 URL 是否正确。2. 检查控制台应用是否真的启动成功。3. 检查 Controller 类上的RequestMapping和方法上的GetMapping/PostMapping注解路径。问题页面显示 Whitelabel Error Page原因SpringBoot 默认的错误页通常是因为请求的路径没有对应的处理器或者处理器内部抛异常了。排查查看控制台输出的完整异常堆栈信息这是解决问题的关键线索。问题前端页面样式CSS/JS丢失原因静态资源路径不对。排查1. 检查静态资源CSS, JS, images是否放在src/main/resources/static目录下。2. 检查页面中引用资源的路径如link href“/css/style.css” rel“stylesheet”开头的/很重要。问题新增或修改数据后页面没变化原因操作未成功或页面缓存。排查1. 直接查数据库看数据是否真的插入或更新了。2. 浏览器按 F12 打开开发者工具在 Network 标签页查看提交请求的响应看后端返回了什么。3. 尝试强制刷新浏览器CtrlF5。把这个项目从头到尾跑一遍、改一遍、再打包部署一遍你对 SpringBoot 项目开发的基本流程就有了一个非常扎实的感性认识。它比你空看理论要有效得多。记住遇到报错不要慌控制台日志和浏览器开发者工具F12是你的两大神器仔细读错误信息十有八九都能自己找到解决方案。
![[C++]内存管理：串顺序存储的内存回收](http://pic.xiahunao.cn/yaotu/[C++]内存管理：串顺序存储的内存回收)
