SpringBoot课程设计选题管理系统：从需求到部署的完整实践-育师

简介：本资源是一套面向高校计算机类专业毕业设计的完整课程设计选题管理系统解决方案，基于SpringBoot框架开发，聚焦教学管理场景中学生选题、教师命题、管理员审核三大核心流程，适用于本科毕设指导、课程设计实践及教学信息化项目实训。压缩包共6个文件，含SQL数据库脚本（db.sql）、万字详细设计文档（.docx）、系统部署与功能说明（.doc）、答辩用PPT（.pptx）、源码工程（.zip）及简要说明文本（.txt），总大小13.99MB，结构清晰、开箱即用。已有115人学习下载，资源覆盖前后端完整实现，提供角色权限控制、自拟课题审批流、课题分类管理等典型业务模块，并附带可直接导入运行的MySQL数据库与图文并茂的系统操作说明，便于快速部署、二次开发或作为毕设参考范例深入理解SpringBoot+MyBatis+Thymeleaf技术栈在教务系统中的落地实践。

1. 项目概述与核心价值

最近在整理过往的课程设计项目时，翻出了这个基于SpringBoot的课程设计选题管理系统。这算是我带学生做毕设和课程设计时，一个非常经典的“教学练战”一体化案例。它麻雀虽小，五脏俱全，从需求分析、技术选型、数据库设计到前后端实现，完整覆盖了一个Web应用开发的核心流程。对于正在学习Java Web开发，特别是SpringBoot框架的同学来说，这个项目具有很高的参考价值。它解决的痛点非常明确：每到课程设计或毕业设计季，老师和学生之间关于选题的沟通、确认、调整过程繁琐且低效，通过一个线上系统来管理，能极大提升效率，规范流程。

这个系统本质上是一个轻量级的教务管理工具，核心用户是教师和学生。教师可以发布课题、审核学生的选题申请、管理课题状态；学生则可以浏览所有可选课题、提交选题申请、查看审核结果。围绕这个核心，系统还衍生出用户管理、通知公告、数据统计等功能模块。技术栈上，我们选择了经典的SpringBoot + MyBatis-Plus + MySQL + Thymeleaf的组合，前端辅以Bootstrap和一点jQuery，保证开发效率的同时，也易于初学者理解和上手。接下来，我会把这个项目的设计思路、关键技术实现、以及开发中踩过的坑和心得，毫无保留地拆解一遍。

2. 系统整体设计与架构拆解

2.1 需求分析与功能模块规划

做任何系统，第一步永远是厘清需求。课程设计选题管理，看似简单，但细究起来，流程中的角色和状态转换是关键。我们主要识别出两类核心角色：管理员（通常由教师或教务人员兼任）和学生。有些场景下，可能会将“教师”单独作为一个角色，拥有发布和管理自己课题的权限，而管理员拥有更高权限。在这个基础版设计中，我们进行了简化，将课题发布和管理权限都赋予了管理员角色。

基于角色，我们梳理出核心功能流：

课题生命周期管理：管理员发布课题（包含标题、描述、要求、最大可选人数等） -> 课题进入“可被选择”状态 -> 学生选择课题并提交申请 -> 申请进入“待审核”状态 -> 管理员审核（通过或拒绝）-> 若通过，课题被锁定，学生选题成功；若拒绝，课题恢复“可选”状态，学生可重选。
学生端操作流：学生注册/登录 -> 浏览所有可选课题（可按条件筛选）-> 查看课题详情 -> 选择心仪课题并提交申请（通常一人只能同时申请一个）-> 查看个人申请历史与审核状态。
管理端管控流：管理员管理用户（学生）信息 -> 发布、编辑、删除课题 -> 批量导入课题 -> 审核学生的选题申请 -> 查看所有选题结果统计报表 -> 发布系统通知。

注意：一个容易被忽略但至关重要的业务规则是“选题冲突处理”。例如，一个课题限选5人，当第6个学生申请时，系统应如何响应？是直接拒绝，还是放入等待队列？在基础版本中，我们采用了简单的“先到先得，额满即止”策略，并在申请时进行实时人数校验。更复杂的策略可以留作扩展功能。

2.2 技术栈选型背后的考量

为什么是SpringBoot？对于课程设计或初学者项目而言，SpringBoot的“约定大于配置”和快速启动特性是决定性优势。它屏蔽了大量繁琐的XML配置和依赖冲突问题，让开发者能快速聚焦业务逻辑。我们不必再从零开始搭建SSH或SSM框架，一个spring-boot-starter-web依赖就带来了内嵌Tomcat和基本的MVC支持。

持久层：MyBatis-Plus vs. JPA：这里选择了MyBatis-Plus。原因在于，对于学生而言，SQL是必须掌握的基础技能。MyBatis-Plus在保留手写SQL灵活性的同时，通过强大的条件构造器和通用Mapper（BaseMapper）提供了极高的单表CRUD效率。例如，分页查询、逻辑删除这些常用功能，一行代码就能实现，既学了ORM思想，又没脱离SQL本质。而JPA的“对象化”思维和复杂查询的编写方式，对初学者可能有一定门槛。
模板引擎：Thymeleaf：相较于JSP，Thymeleaf是天然的原生HTML，语法更现代，与SpringBoot集成度极高。它的“自然模板”特性（即使不启动服务，HTML在浏览器里也能正常显示）对前端调试非常友好。虽然现在前后端分离是主流，但对于一个以教学和快速交付为核心的管理系统，服务端渲染的Thymeleaf在开发速度和简单性上仍有优势，也避免了初学者同时面对后端和复杂前端框架（如Vue/React）的双重压力。
数据库：MySQL：毫无悬念的选择。社区活跃、资料丰富、安装简单，是学习关系型数据库的最佳入门选择。5.7或8.0版本均可。
前端：Bootstrap + jQuery：Bootstrap提供了现成、美观、响应式的UI组件，让我们不必深究CSS就能构建出风格统一的界面。jQuery则用于处理简单的DOM操作和Ajax交互，例如实现异步的选题申请、局部刷新课题列表等。这个组合能让后端开发者以最小成本构建出可用的前端界面。

2.3 数据库设计核心表结构

数据库设计是系统的基石。围绕核心业务，我们设计了以下几张关键表：

用户表 (sys_user)

字段名	类型	描述	约束
`id`	bigint	主键ID	自增
`username`	varchar	用户名/学号/工号	唯一
`password`	varchar	加密后的密码
`real_name`	varchar	真实姓名
`role`	varchar	角色（`admin`/`student`）
`class_info`	varchar	班级信息（学生用）
`create_time`	datetime	创建时间

课题表 (project)

字段名	类型	描述	约束
`id`	bigint	主键ID	自增
`title`	varchar	课题标题
`description`	text	课题详细描述与要求
`requirement`	text	技术要求
`max_number`	int	最大可选人数	默认1
`selected_number`	int	已选人数	默认0
`status`	varchar	状态（`published`发布/`closed`关闭）
`teacher_id`	bigint	发布教师ID（外键关联用户表）
`publish_time`	datetime	发布时间

选题记录表 (selection_record)

字段名	类型	描述	约束
`id`	bigint	主键ID	自增
`student_id`	bigint	学生ID	外键
`project_id`	bigint	课题ID	外键
`apply_time`	datetime	申请时间
`status`	varchar	审核状态（`pending`待审核/`approved`通过/`rejected`拒绝）
`review_time`	datetime	审核时间
`review_comment`	varchar	审核意见

实操心得：在selection_record表中，student_id和project_id的组合应该建立唯一索引，防止同一学生重复申请同一课题（尽管前端可以拦截，但数据库约束是最后防线）。此外，project表的selected_number字段是一个重要的“冗余”字段，用于快速判断课题是否已满，避免每次都需要关联selection_record表进行count查询，这是一种用空间换时间的常见优化手段。

3. 核心功能模块实现详解

3.1 用户认证与权限控制

安全是管理系统的底线。我们采用经典的Session-Cookie机制实现认证，并用**拦截器（Interceptor）**实现简单的权限控制。

1. 密码加密存储绝对不能在数据库中明文存储密码。我们使用Spring Security提供的BCryptPasswordEncoder进行哈希加密。它的encode(rawPassword)方法会生成一个随机的salt并混入哈希结果中，即使两个用户密码相同，加密后的字符串也不同，安全性很高。

@Service public class UserServiceImpl implements UserService { @Autowired private BCryptPasswordEncoder passwordEncoder; public boolean register(User user) { // 注册时加密密码 user.setPassword(passwordEncoder.encode(user.getPassword())); return save(user); } public User login(String username, String plainPassword) { User user = findByUsername(username); if (user != null && passwordEncoder.matches(plainPassword, user.getPassword())) { // 密码匹配，登录成功 return user; } return null; } }

2. 登录与会话管理用户登录成功后，将其关键信息（如id, username, role）存入HttpSession。同时，我们定义一个LoginUser对象（或直接使用User对象，但建议脱敏），方便在控制器和视图中获取当前用户。

@PostMapping("/login") public String login(String username, String password, HttpSession session) { User user = userService.login(username, password); if (user != null) { session.setAttribute("loginUser", user); // 根据角色跳转到不同首页 if ("admin".equals(user.getRole())) { return "redirect:/admin/index"; } else { return "redirect:/student/index"; } } else { // 返回登录页并提示错误 return "login"; } }

3. 权限拦截器实现我们创建一个AuthInterceptor，拦截所有需要登录才能访问的请求路径。

@Component public class AuthInterceptor implements HandlerInterceptor { @Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { HttpSession session = request.getSession(); User loginUser = (User) session.getAttribute("loginUser"); // 1. 检查是否登录 if (loginUser == null) { response.sendRedirect("/login"); return false; } // 2. (可选)检查接口权限，例如/admin/开头的路径需要admin角色 String uri = request.getRequestURI(); if (uri.startsWith("/admin/") && !"admin".equals(loginUser.getRole())) { response.sendError(HttpStatus.FORBIDDEN.value(), "权限不足"); return false; } return true; } }

然后在SpringBoot配置类中注册这个拦截器，并指定拦截路径（如/**）和排除路径（如/login,/register,/static/**）。

3.2 课题管理与发布的业务逻辑

课题的CRUD是管理员的核心工作。这里重点讲发布和状态更新的逻辑。

发布课题：除了基本的字段校验，关键是要初始化课题状态（published）和已选人数（0）。同时，需要关联当前登录的管理员ID作为发布者。

课题列表查询与分页：这是高频操作。我们使用MyBatis-Plus的分页插件，配合条件构造器，可以轻松实现多条件分页查询。

@GetMapping("/admin/project/list") public String listProjects( @RequestParam(defaultValue = "1") Integer pageNum, @RequestParam(defaultValue = "10") Integer pageSize, String keyword, // 搜索关键词 HttpSession session, Model model) { // 1. 构建分页对象 Page<Project> page = new Page<>(pageNum, pageSize); // 2. 构建查询条件 LambdaQueryWrapper<Project> wrapper = new LambdaQueryWrapper<>(); wrapper.like(StringUtils.hasText(keyword), Project::getTitle, keyword) .or() .like(StringUtils.hasText(keyword), Project::getDescription, keyword); wrapper.orderByDesc(Project::getPublishTime); // 按发布时间倒序 // 3. 执行分页查询 Page<Project> projectPage = projectService.page(page, wrapper); // 4. 将数据放入模型，供前端Thymeleaf渲染 model.addAttribute("pageInfo", projectPage); return "admin/project_list"; }

前端Thymeleaf页面配合Bootstrap的分页组件，就能渲染出美观的分页导航。

课题状态管理：管理员可以手动关闭（closed）一个课题，使其不再接受申请。这个操作需要谨慎，通常需要检查是否有学生已经选中该课题，如果有，可能需要先处理这些学生的选题状态（如强制退选或迁移）。

3.3 学生选题申请与并发控制

这是系统最核心、也最容易出问题的业务环节。核心流程是：学生查看课题详情 -> 点击“申请” -> 系统校验 -> 生成申请记录。

关键校验逻辑：

学生身份校验：确保当前登录用户是学生角色。
课题状态校验：课题必须是published状态。
人数校验：selected_number<max_number。
重复申请校验：该学生是否已经申请过此课题（查selection_record表）。
互斥申请校验：该学生是否已经有其他正在pending或已approved的申请（即一人只能同时有一个有效选题）。这个规则根据实际需求可调整。

并发问题与解决方案：想象一个热门课题只剩最后一个名额，两个学生几乎同时点击“申请”。如果校验和插入记录不是原子操作，就可能出现超选。这是一个典型的“库存超卖”问题。

解决方案一：数据库悲观锁（SELECT ... FOR UPDATE）在事务中，先对目标课题记录加行锁，再进行校验和更新。MyBatis-Plus中可以通过自定义Mapper XML实现。

<!-- ProjectMapper.xml --> <select id="selectProjectForUpdate" resultType="Project"> SELECT * FROM project WHERE id = #{id} FOR UPDATE </select>

然后在Service层方法上添加@Transactional注解，并在方法内先调用selectProjectForUpdate锁定记录。

解决方案二：基于版本号的乐观锁在project表中增加一个version字段（整数类型）。更新时，带上版本号条件。

UPDATE project SET selected_number = selected_number + 1, version = version + 1 WHERE id = #{id} AND version = #{oldVersion} AND selected_number < max_number

如果更新影响的行数为0，说明版本号不对或人数已满，更新失败，业务层抛出异常或返回错误信息。MyBatis-Plus的@Version注解可以方便地实现乐观锁。

实操心得：对于课程设计这类并发压力不大的系统，使用数据库唯一索引配合事务是更简单有效的方案。我们可以在selection_record表上建立(student_id, project_id)的唯一索引，防止重复申请。在申请事务中，顺序执行：1. 检查课题人数（SELECT ...）；2. 插入申请记录（INSERT，唯一索引保证原子性）；3. 更新课题已选人数（UPDATE ... set selected_number = selected_number + 1）。如果第2步因唯一约束冲突失败，事务回滚，整个申请失败。这种方式避免了显式加锁，代码更简洁。但需要确保数据库隔离级别至少是READ_COMMITTED。

3.4 管理员审核流程的实现

审核功能需要提供一个列表界面，展示所有待审核（pending）的申请，每条申请旁边有“通过”和“拒绝”按钮。

后端审核接口设计：

@PostMapping("/admin/selection/review") @ResponseBody // 返回JSON，用于前端异步更新 public ApiResult reviewSelection(Long recordId, String status, String comment) { // status: 'approved' or 'rejected' SelectionRecord record = selectionService.getById(recordId); if (record == null || !"pending".equals(record.getStatus())) { return ApiResult.error("申请记录不存在或状态已变更"); } // 开启事务 boolean success = selectionService.reviewSelection(recordId, status, comment); return success ? ApiResult.ok() : ApiResult.error("审核失败"); }

Service层事务方法：审核不是一个简单的状态更新，它关联着课题已选人数的增减。

@Transactional(rollbackFor = Exception.class) public boolean reviewSelection(Long recordId, String status, String comment) { SelectionRecord record = getById(recordId); record.setStatus(status); record.setReviewTime(new Date()); record.setReviewComment(comment); // 更新申请记录状态 updateById(record); Project project = projectService.getById(record.getProjectId()); if ("approved".equals(status)) { // 审核通过，课题已选人数+1 if (project.getSelectedNumber() >= project.getMaxNumber()) { throw new RuntimeException("课题人数已满，审核通过失败"); } project.setSelectedNumber(project.getSelectedNumber() + 1); // 如果人数已满，自动关闭课题 if (project.getSelectedNumber() >= project.getMaxNumber()) { project.setStatus("closed"); } } else if ("rejected".equals(status) && "approved".equals(record.getStatus())) { // 如果是将已通过的申请拒绝，需要扣减人数（业务上较少见，但逻辑要完整） project.setSelectedNumber(project.getSelectedNumber() - 1); if (project.getStatus().equals("closed")) { project.setStatus("published"); // 重新开放 } } projectService.updateById(project); return true; }

4. 前端页面交互与用户体验优化

虽然后端是重点，但一个友好的前端能极大提升系统可用性。我们使用Thymeleaf模板和Bootstrap组件来构建页面。

4.1 课题列表页的动态筛选与异步加载

初始版本，列表页是服务端渲染后一次性返回。当课题数量很多时，页面加载慢。我们可以引入简单的异步加载。

技术方案：使用jQuery的$.ajax或原生fetchAPI。后端提供一个只返回JSON数据的接口（如/api/project/list）。

// 前端JavaScript片段 function loadProjects(page = 1) { let keyword = $('#searchInput').val(); $.ajax({ url: '/api/project/list', type: 'GET', data: { pageNum: page, pageSize: 10, keyword: keyword }, success: function(result) { // 清空现有列表 $('#projectList').empty(); // 遍历result.data.records，动态生成HTML并追加到#projectList $.each(result.data.records, function(index, project) { let itemHtml = `<div class="card mb-3"> <div class="card-body"> <h5 class="card-title">${project.title}</h5> <p class="card-text">${project.description.substring(0, 100)}...</p> <span class="badge bg-info">已选 ${project.selectedNumber}/${project.maxNumber}</span> <a href="/project/detail/${project.id}" class="btn btn-primary btn-sm float-end">查看详情</a> </div> </div>`; $('#projectList').append(itemHtml); }); // 渲染分页组件 renderPagination(result.data); } }); }

这样，搜索和翻页就不再需要刷新整个页面，体验更流畅。注意，这种混合模式（部分页面服务端渲染，部分数据异步加载）在简单系统中很实用。

4.2 选题申请的防重复提交与状态提示

学生点击“申请”按钮后，应立即禁用按钮，防止网络延迟导致用户多次点击，产生重复请求。

$('#applyBtn').on('click', function() { let $btn = $(this); let projectId = $btn.data('project-id'); // 禁用按钮，显示加载中 $btn.prop('disabled', true).html('<span class="spinner-border spinner-border-sm" role="status" aria-hidden="true"></span> 提交中...'); $.ajax({ url: '/student/selection/apply', type: 'POST', contentType: 'application/json', data: JSON.stringify({projectId: projectId}), success: function(result) { if (result.success) { alert('申请提交成功，请等待审核！'); // 更新页面状态，例如将按钮变为“已申请” $btn.removeClass('btn-primary').addClass('btn-secondary').text('已申请').prop('disabled', true); } else { alert('申请失败：' + result.message); // 恢复按钮 $btn.prop('disabled', false).text('申请'); } }, error: function() { alert('网络错误，请重试'); $btn.prop('disabled', false).text('申请'); } }); });

4.3 响应式布局与移动端适配

Bootstrap本身就是响应式的，但我们需要确保自定义的CSS和HTML结构也遵循响应式原则。

使用container-fluid或container作为布局容器。
多使用Bootstrap的栅格系统（row和col-*-*）来布局，而不是写死宽度。
表格在移动端查看时容易溢出，可以给表格外层添加<div class="table-responsive">，使其可以横向滚动。
导航栏在移动端应折叠，使用Bootstrap的Navbar组件即可自动实现。

5. 系统部署、测试与常见问题排查

5.1 本地开发环境搭建与运行

环境准备：JDK 8或11， Maven 3.6+， MySQL 5.7+， IDE（IntelliJ IDEA或Eclipse）。
导入项目：将源码作为Maven项目导入IDE。
数据库初始化：在MySQL中创建数据库（如course_design_db），然后执行项目sql目录下的建表脚本。更优雅的方式是使用Flyway或Liquibase进行数据库版本管理，但对于课程设计，直接执行SQL脚本更简单直接。

配置文件修改：打开src/main/resources/application.yml或application.properties，修改数据库连接信息、服务器端口等。

spring: datasource: url: jdbc:mysql://localhost:3306/course_design_db?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai username: root password: yourpassword driver-class-name: com.mysql.cj.jdbc.Driver thymeleaf: cache: false # 开发时关闭缓存，修改HTML立即生效 server: port: 8080

启动项目：找到主启动类（通常命名为*Application，包含@SpringBootApplication注解），直接运行其main方法。看到控制台输出Started ... Application in x.xxx seconds即表示启动成功。
访问系统：打开浏览器，访问http://localhost:8080。初始管理员账号密码通常在代码中写死或通过SQL脚本初始化，需要查看代码或文档确认。

5.2 打包与部署到服务器

项目开发完成后，需要打包部署到Linux服务器。

打包：在项目根目录下执行Maven命令。
```
mvn clean package -DskipTests
```
成功后，会在target目录下生成一个*.jar文件（如course-design-system-0.0.1-SNAPSHOT.jar）。
服务器准备：确保服务器已安装JDK（版本与开发环境一致）和MySQL。
上传与运行：将jar包和配置文件（如果需要外部化配置，可使用application-prod.yml）上传到服务器。使用nohup命令在后台运行。
```
nohup java -jar course-design-system-0.0.1-SNAPSHOT.jar --spring.profiles.active=prod > app.log 2>&1 &
```
这条命令指定使用prod配置文件，并将所有输出重定向到app.log文件。&表示后台运行。
使用Nginx进行反向代理（可选但推荐）：直接通过8080端口访问不友好且不安全。可以安装Nginx，配置一个反向代理，将80端口的请求转发到8080。
```
server { listen 80; server_name your-domain.com; # 或服务器IP location / { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } }
```
然后重启Nginx，就可以通过域名或IP直接访问了。

5.3 常见问题与排查技巧实录

在开发和部署过程中，一定会遇到各种问题。这里记录几个典型场景：

问题1：启动报错java.sql.SQLException: Access denied for user 'root'@'localhost' (using password: YES)

排查：这是最常见的数据库连接问题。首先，检查application.yml中的用户名和密码是否正确。其次，确认MySQL服务是否启动。最后，检查MySQL的root用户是否允许从localhost连接，以及密码是否正确。可以尝试在命令行用mysql -u root -p登录验证。
解决：修正配置文件，或修改MySQL用户权限。

问题2：页面显示乱码（尤其是中文）

排查：乱码通常出现在三个环节：数据库、应用服务器、浏览器。
1. 数据库：确认建表语句和数据库本身是utf8mb4字符集。连接URL中也要指定characterEncoding=utf8。
2. SpringBoot应用：在application.yml中确保spring.http.encoding.charset=UTF-8和spring.http.encoding.enabled=true。Thymeleaf默认就是UTF-8。
3. 浏览器：检查HTML文件的<meta charset="UTF-8">标签。
解决：统一所有环节的字符集为UTF-8。

问题3：静态资源（CSS, JS, 图片）无法加载

排查：SpringBoot默认将/static,/public,/resources,/META-INF/resources目录下的文件映射为静态资源。检查你的资源文件是否放对了位置（如src/main/resources/static/css/style.css）。浏览器按F12打开开发者工具，查看“网络(Network)”标签，看资源文件的请求是否返回404。
解决：将资源文件移动到正确的目录。如果使用了自定义的拦截器，要确保放行静态资源的请求路径。

问题4：事务不生效，数据不一致

排查：首先检查方法是否被public修饰，因为Spring AOP代理基于接口或CGLIB，对非public方法无效。其次，检查是否在同一个类内部调用事务方法（例如A方法调用本类的B方法），这会导致代理失效。最后，确认方法抛出的异常是否是RuntimeException或Error，默认只回滚这些异常，如果是检查型异常（Exception），需要在@Transactional注解中指定rollbackFor。
解决：确保事务方法是public的；避免自调用；明确指定回滚的异常类型。

问题5：部署后，上传文件找不到或权限不足

排查：在开发时，上传文件可能保存在项目路径下（如/uploads）。但打成jar包后，jar内的路径是只读的。部署后，应用运行在某个用户（如www或nobody）下，该用户可能没有对目标上传目录的写权限。
解决：绝对不要将文件上传到jar包同级或内部的目录。应该使用一个绝对路径，并在配置文件中配置。例如：
```
file: upload-dir: /var/www/upload/course-design
```
然后在代码中，使用@Value("${file.upload-dir}")注入该路径。同时，确保运行Jar包的系统用户对该目录有读写权限（chown和chmod）。

这个基于SpringBoot的课程设计选题管理系统，从技术上看，它串联了Web开发的绝大部分基础知识点；从业务上看，它逻辑完整，贴近实际应用。无论是用于学习SpringBoot全家桶，还是作为课程设计、毕业设计的蓝本，都具有很强的实践价值。开发过程中，最重要的是理解业务逻辑和数据流，其次才是框架的具体用法。多思考“如果我是用户，我需要什么”，很多设计问题就会迎刃而解。代码和文档只是结果的呈现，真正的收获在于解决一个个具体问题时积累的经验和思路。

本文还有配套的精品资源，点击获取