1. 项目背景与需求拆解1.1 这个网站到底解决什么问题“Java青少年篮球训练营网站设计与实现”这个题目这几年在毕业设计和课程设计里出现频率很高。我第一次看这个题目时第一反应是“这不就是普通的校园网站套了个篮球壳吗”真正动手做才发现青少年篮球训练营的核心痛点其实非常明确报名靠填表、排课靠微信群通知、学员进度无法量化、家长不能实时掌握课程安排。你把这个网站做出来本质上是帮训练营把线下教务管理搬到线上让报名、排课、签到、通知形成闭环。这个项目适合三类人做第一是计算机相关专业需要交课设或毕设的学生第二是刚学完Spring Boot想做一个完整全栈项目的初学者第三是给青少年培训机构做内部管理系统的开发者。难度属于中等偏上但不需要特别高深的技术核心是把业务逻辑理清楚把CRUD做得稳定。如果你正在纠结“要不要用前台官网后台管理两套系统”我的建议是先不要。这个题目更合适做一套单站点系统通过角色权限区分前台和后台功能。用户登录后看到的是自己角色的专属页面家长看到课程和报名管理员看到数据管理和发布这样实现成本低答辩时也更容易把业务闭环讲明白。1.2 角色与功能需求细化我把用户分成四类管理员、家长/学员、教练、游客。游客只能浏览公开页面家长/学员可以注册、登录、浏览课程、在线报名、签到查看教练可以查看自己的授课安排和学员名单管理员负责几乎所有后台配置。具体的功能点我列一下后面写代码和建表都是围绕这些功能来的注册登录手机号密码注册、登录使用JWT管理登录态密码用BCrypt加密存储。课程管理管理员按年龄段U6、U8、U10、U12和班型基础班、提高班创建课程设置课程名称、封面图、课程介绍、价格和总名额。排课管理生成一周内的上课时间表上课地点支持一个课程多期排期。比如“暑期基础班”可以分7月期、8月期。在线报名家长选择排期提交报名信息系统自动扣减名额。一个排期达到名额上限后自动截止报名。订单管理记录报名订单状态待支付、已支付、已取消。因为不是真正的在线支付项目我会用“线下支付后管理员确认”或“模拟支付接口”来实现。签到管理教练上课时扫码或按学员名单签到家长端可以看到出勤记录。资讯公告管理员发布训练营新闻、放假通知、比赛信息前台列表展示。数据统计后台展示报名人数趋势、热销课程排行、学员年龄段分布。很多同学容易只做前两个功能最后答辩时功能单薄缺乏闭环。宁可把“报名-支付-签到”这条链路做完整也比多做个没用的“意见反馈”模块强。2. 技术选型与架构设计2.1 Java技术栈为什么这么选这个项目名里明确带了“Java”所以后端语言没有争议。但具体用哪套方案还是可以考虑的。我建议用Spring Boot MyBatis-Plus MySQL。Spring Boot是目前Java Web开发的事实标准MyBatis-Plus适合快速开发尤其在单表CRUD和分页查询上能省大量代码且对初学者友好。前端我推荐两种选型两种我都做过根据你的开发时间和答辩侧重点来决定方案A服务端渲染Spring Boot Thymeleaf Bootstrap。开发速度快不需要写前后端分离接口适合时间紧张的课设。缺点是你糊到毕业设计里的代码比较传统问到“前后端分离”时不好解释。方案B前后端分离Spring Boot Vue 2/3 Element UI。开发周期略长但呈现效果更现代接口设计也更规范适合有半年以上时间准备毕业设计的同学。我自己做这个项目时选了方案B原因是我当时对Vue正好比较熟而且想体现接口设计能力。如果你对Vue不熟千万不要为了追时髦硬上方案B答辩时被问前端渲染原理可能哑火。其他依赖建议数据库MySQL 5.7或8.0用Navicat/SQLyog管理数据。缓存Redis选配。如果只是为了做毕设不强求但加入Redis可以加分。比如课程热门排行榜、验证码存储可以用Redis。权限控制Spring Security或自定义拦截器。我推荐先用拦截器JWT简单可控出了问题好排查。Spring Security配置复杂入门阶段容易被绕晕。分页插件MyBatis-Plus自带分页插件写完直接调Page对象。2.2 项目分层设计后端代码强烈建议分三层Controller、Service、Mapper。很多同学喜欢把所有逻辑写在Controller里最后Controller有几千行维护起来很痛苦。我的建议是├── controller # 接收参数、校验、返回结果 ├── service # 业务逻辑、事务管理 ├── mapper # 数据库操作MyBatis-Plus的BaseMapper ├── entity # 数据库实体与表字段一致 ├── dto # 接收前端传参比如报名请求、登录请求 ├── vo # 返回前端的数据比如课程列表VO、报名订单VO ├── config # 配置类WebMvcConfig、CorsConfig、JwtConfig ├── common # 公共类统一返回Result、常量类、异常处理 └── utils # 工具类JwtUtils、DateUtils、FileUtilsEntity、DTO、VO要分开。有的同学为省事一个实体类从头用到尾这样数据库字段直接暴露给前端不安全且不灵活。比如课程表有个“备注”字段但前端列表不需要返回用VO就能过滤掉报名时前端只传课程排期ID不需要把整个课程对象传进来用DTO接收更清晰。2.3 统一返回结果与异常处理前后端接口通信最好定义统一的返回结果。我之前写项目时没做统一返回前端每个接口都要单独判断鸡飞狗跳。后来用了一个Result类Data public class ResultT { private Integer code; private String message; private T data; public static T ResultT success(T data) { ResultT result new Result(); result.setCode(200); result.setMessage(success); result.setData(data); return result; } public static T ResultT error(Integer code, String message) { ResultT result new Result(); result.setCode(code); result.setMessage(message); return result; } }同时准备一个全局异常处理器用RestControllerAdvice统一拦截业务异常和未知异常。前端axios拦截器里只需要判断code是否为200统一提示message代码能减少一大半。3. 数据库设计与核心表结构3.1 核心实体关系梳理在设计阶段一定要先画表关系图。我习惯先在纸上画实体关系再用PDMan或Navicat生成建表SQL。训练营网站的表我拆成以下这些sys_user用户表统一存家长、教练、管理员用role字段区分。course课程表存课程名称、类型、年龄段、价格、封面、介绍。course_schedule排期表每个课程有多个排期排期包含上课时间、地点、总名额、已报名人数。enrollment_order报名订单表记录学员ID、排期ID、订单状态、报名时间、报名人信息。check_in签到表记录某排期某学员的到课情况。news资讯公告表。coach_info教练表存教练个人信息、简介、证书。用户和教练也可以复用同一张表但考虑到教练会有简介、教龄、证书等专业字段单独拆一张表更合适通过user_id关联。3.2 核心建表SQL与字段说明我直接给出我实际用的核心表设计。注意我这里把字段命名都用下划线方便MyBatis-Plus的驼峰映射。CREATE TABLE sys_user ( id bigint NOT NULL AUTO_INCREMENT COMMENT 主键, username varchar(30) NOT NULL COMMENT 登录用户名/手机号, password varchar(100) NOT NULL COMMENT BCrypt加密密码, nickname varchar(30) DEFAULT NULL COMMENT 昵称, role tinyint NOT NULL DEFAULT 0 COMMENT 角色0家长1教练2管理员, phone varchar(20) DEFAULT NULL COMMENT 手机号, avatar varchar(255) DEFAULT NULL COMMENT 头像URL, status tinyint NOT NULL DEFAULT 1 COMMENT 状态1正常0禁用, create_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP, update_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_username (username) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;为什么用户名要建唯一索引因为注册接口如果先查再插并发情况下可能重复直接数据库唯一约束做兜底是最稳妥的。CREATE TABLE course ( id bigint NOT NULL AUTO_INCREMENT, course_name varchar(100) NOT NULL, course_type varchar(20) DEFAULT NULL COMMENT 基础班/提高班/特训班, age_group varchar(10) DEFAULT NULL COMMENT U6/U8/U10/U12, cover_image varchar(255) DEFAULT NULL, price decimal(10,2) NOT NULL DEFAULT 0.00, description text, status tinyint NOT NULL DEFAULT 1 COMMENT 1上架0下架, create_time datetime DEFAULT CURRENT_TIMESTAMP, update_time datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;这里有个小经验课程的基本信息和排期信息一定要分开。我第一次做的时候把上课时间直接放课程表里结果同一个课程周一到周五都开班每条数据要重复创建课程非常蠢。拆出排期表后一个课程能对应多个上课时间段灵活多了。CREATE TABLE course_schedule ( id bigint NOT NULL AUTO_INCREMENT, course_id bigint NOT NULL COMMENT 关联课程ID, schedule_date date NOT NULL COMMENT 上课日期, start_time time NOT NULL, -- 实际按某个时间段安排 end_time time NOT NULL, location varchar(100) DEFAULT NULL COMMENT 上课场地, total_slots int NOT NULL DEFAULT 20 COMMENT 总名额, registered_count int NOT NULL DEFAULT 0 COMMENT 已报名人数, status tinyint NOT NULL DEFAULT 1 COMMENT 1可报名0已截止, create_time datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_course_id (course_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;报名订单表我用了两个字段区分状态business_status表达报名状态pay_status单独表达支付状态这样业务扩展更方便。CREATE TABLE enrollment_order ( id bigint NOT NULL AUTO_INCREMENT, order_no varchar(32) NOT NULL COMMENT 订单编号, user_id bigint NOT NULL COMMENT 学员ID, schedule_id bigint NOT NULL COMMENT 排期ID, student_name varchar(30) DEFAULT NULL COMMENT 学员姓名, student_age int DEFAULT NULL, contact_phone varchar(20) DEFAULT NULL, status tinyint NOT NULL DEFAULT 0 COMMENT 0待确认1已确认2已取消, pay_status tinyint NOT NULL DEFAULT 0 COMMENT 0未支付1已支付, create_time datetime DEFAULT CURRENT_TIMESTAMP, update_time datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_order_no (order_no), UNIQUE KEY uk_user_schedule (user_id, schedule_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;我加了联合唯一索引(user_id, schedule_id)意思是一个家长不能在同一个排期重复报名。这个索引在并发场景下能挡住重复请求比在代码里做判断更可靠。4. 核心功能模块的实现细节4.1 注册登录与JWT权限控制登录功能看起来简单但细节不少。密码加密一定要用BCrypt不能明文存数据库。Spring Security内置了BCryptPasswordEncoder单独拿出来用也很方便。public class PasswordUtil { private static final BCryptPasswordEncoder ENCODER new BCryptPasswordEncoder(); public static String encode(String rawPassword) { return ENCODER.encode(rawPassword); } public static boolean matches(String rawPassword, String encodedPassword) { return ENCODER.matches(rawPassword, encodedPassword); } }注册流程前端传手机号用户名、密码、确认密码。后端先查用户名是否已存在再校验两次密码一致然后把密码加密写入sys_userrole默认0。用try-catch捕获数据库唯一索引冲突提示“用户名已注册”。登录成功之后下发JWT。我用的JJWT库核心工具类如下public class JwtUtils { private static final String SECRET your-secret-key-please-change-in-production; private static final long EXPIRE 1000 * 60 * 60 * 24; public static String generateToken(Long userId, Integer role) { return Jwts.builder() .setSubject(String.valueOf(userId)) .claim(role, role) .setIssuedAt(new Date()) .setExpiration(new Date(System.currentTimeMillis() EXPIRE)) .signWith(SignatureAlgorithm.HS256, SECRET) .compact(); } public static Claims parseToken(String token) { return Jwts.parser().setSigningKey(SECRET).parseClaimsJws(token).getBody(); } }然后写一个拦截器拦截除了登录注册、课程列表之外的路径。拦截器里获取请求头Authorization解析token把userId和role放到ThreadLocal或request attribute里供后续Service使用。JWT有个常见问题是过期时间设置过短用户频繁重新登录。我建议课设项目设置24小时过期顺便在拦截器里判断剩余有效期如果低于2小时通过响应头刷新token但这个属于加分项不强求。4.2 课程展示与报名流程前台课程列表不需要登录就能看但报名必须登录。课程列表核心是分页查询用MyBatis-Plus的分页插件。public PageResultCourseVO listCourses(int page, int size, String ageGroup) { PageCourse p new Page(page, size); LambdaQueryWrapperCourse query new LambdaQueryWrapper(); query.eq(StringUtils.hasText(ageGroup), Course::getAgeGroup, ageGroup) .eq(Course::getStatus, 1) .orderByDesc(Course::getCreateTime); PageCourse result courseMapper.selectPage(p, query); ListCourseVO list result.getRecords().stream() .map(course - { CourseVO vo new CourseVO(); BeanUtils.copyProperties(course, vo); // 查询该课程下可报名的排期数量 vo.setOpenScheduleCount(scheduleMapper.countOpenByCourseId(course.getId())); return vo; }).collect(Collectors.toList()); return PageResult.of(result.getTotal(), list); }报名是项目中最重要的业务方法。核心逻辑是先判断排期是否存在且状态为可报名然后用当前报名人数和总名额做校验再插入订单最后更新registered_count。这里一定要加事务并且在更新报名人数时加上条件防止并发超报。我给出的方案是乐观锁条件更新Transactional(rollbackFor Exception.class) public EnrollmentOrder enroll(EnrollRequest request, Long userId) { CourseSchedule schedule scheduleMapper.selectById(request.getScheduleId()); if (schedule null || schedule.getStatus() ! 1) { throw new BizException(该排期不可报名); } if (schedule.getRegisteredCount() schedule.getTotalSlots()) { throw new BizException(名额已满); } // 生成订单号 EnrollmentOrder order new EnrollmentOrder(); order.setOrderNo(OrderNoGenerator.generate()); order.setUserId(userId); order.setScheduleId(request.getScheduleId()); order.setStudentName(request.getStudentName()); order.setStudentAge(request.getStudentAge()); order.setContactPhone(request.getContactPhone()); order.setStatus(0); order.setPayStatus(0); enrollmentOrderMapper.insert(order); // 关键SQLupdate course_schedule set registered_count registered_count 1 // where id ? and registered_count total_slots int rows scheduleMapper.increaseRegisteredCount(schedule.getId()); if (rows 0) { throw new BizException(报名人数已满请更换时间段); } return order; }为什么update后还要再查一次因为MySQL默认隔离级别下两个用户同时读到registered_count 19都判断小于20然后都执行insert再执行update都能成功这样会超报。但如果在update语句的where条件里加上registered_count total_slots数据库层面就能保证只有一个请求能更新成功另一个影响行数为0从而抛出异常回滚。这条经验在答辩时很加分务必掌握。4.3 后台管理与数据统计后台管理功能比较套路化课程列表、新增课程、编辑课程、上下架、排期维护、订单列表、教练管理。我建议后台用Vue Element UI表格组件绑数据弹窗表单提交分页组件同步。数据统计我推荐按以下几点实现按日统计报名订单量计算出最近30天的报名趋势。按课程统计报名人数生成课程热度排行。按年龄段统计学员分布饼图展示。SQL示例SELECT DATE(create_time) AS day, COUNT(*) AS cnt FROM enrollment_order WHERE create_time DATE_SUB(CURDATE(), INTERVAL 30 DAY) GROUP BY DATE(create_time) ORDER BY day;前端ECharts拿到这个List后直接渲染折线图。如果后端不想写统计SQL也可以先用List查出所有订单在Java里用Stream分组。但数据量大时性能差课设数据量小怎么都行。5. 关键难点与优化点5.1 库存扣减为什么不能只用Java代码判断上面已经说了一部分我再展开讲。很多新手会把报名写到三步第一步查询剩余名额第二步判断是否等于0第三步执行insert和update。这在低并发下没问题但一旦同一时间有很多家长抢热门课程就会出现“判断时有名额提交时被抢了”的情况。除了在update语句里加条件还有一个简单办法在报名订单表加一个基于排期和用户唯一索引用DB的约束兜底重复报名。同时订单表和排期表的更新处于同一事务中任何一个失败都全部回滚。要注意事务不要在Controller层开启而应该放在Service层的public方法上并且避免同类内部调用导致事务失效这是一个很隐蔽的坑。5.2 图片上传如何处理最省心课程封面、用户头像都需要上传。开发环境我建议使用本地磁盘存储然后通过配置映射静态资源路径直接访问。例如在application.yml中file: upload-dir: D:/upload/ access-path: /upload/**配置类Configuration public class WebMvcConfig implements WebMvcConfigurer { Value(${file.upload-dir}) private String uploadDir; Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler(/upload/**) .addResourceResolver(new PathResourceResolver()) .addResourceLocations(file: uploadDir /); } }上传接口用MultipartFile接收生成唯一文件名避免中文名和重名。我常用的命名方式是“yyyyMMddHHmmss_随机数.后缀”。另外一定要限制文件大小和类型只允许jpg/png大小限制5MB否则被塞一个恶意文件就麻烦了。5.3 跨域问题与联调经验如果你用前后端分离跨域是必踩的坑。后端允许跨域有三种方式CrossOrigin注解、CorsFilter、实现WebMvcConfigurer的addCorsMappings。我在项目里用了CorsFilter统一处理。注意allowedOrigin不要写成*尤其是当你打算配合JWT带凭证时必须指定来源。Configuration public class CorsConfig { Bean public CorsFilter corsFilter() { CorsConfiguration config new CorsConfiguration(); config.addAllowedOriginPattern(http://localhost:*); config.addAllowedMethod(*); config.addAllowedHeader(*); config.setAllowCredentials(true); UrlBasedCorsConfigurationSource source new UrlBasedCorsConfigurationSource(); source.registerCorsConfiguration(/**, config); return new CorsFilter(source); } }联调时前端口是localhost:8080后端口是localhost:9090注意浏览器发起OPTIONS预检请求后端要能正确响应否则POST请求会莫名失败。这个我当年调了整整一个下午后来发现是预检没通过。6. 常见问题与排错实录6.1 Maven依赖版本不兼容Spring Boot 2.6和2.7之间有一些自动装配配置的变化MyBatis-Plus也有版本差异。建议直接用Spring Boot 2.7.x MyBatis-Plus 3.5.x组合稳定。Spring Boot 3.x基于Jakarta EE很多旧教程里的javax.*包用不了如果你跟着教程写会报错。如果遇到依赖冲突在idea里执行mvn dependency:tree看冲突依赖用exclusion排除掉即可。新手不建议随便升级插件版本稳定高于一切。6.2 数据库时间少8小时这几乎是每个Java Web项目都会遇到的问题。原因是MySQL驱动连接时区设置不对。在你的JDBC URL后面加上serverTimezoneAsia/Shanghai并配置Jackson反序列化时区spring: datasource: url: jdbc:mysql://localhost:3306/basketball_camp?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai jackson: time-zone: GMT8顺便建议时间字段都用datetime类型。如果用了timestampMySQL默认会转换为UTC存储查询回来再做转换容易出乱子。为了少踩坑统一用datetime。6.3 前后端联调时Session不生效如果你用了JWT就没有这个问题。如果你用了传统Session存储登录态又恰好做了前后端分离就会发现后端一直拿不到Session。原因是前端请求没有携带Cookie需要在axios里配置withCredentials: true同时后端CORS配置需要允许具体来源并且Access-Control-Allow-Credentials为true。对比之下JWT把状态放在请求头更简单。6.4 删除排期导致报名数据丢失管理后台删除排期时如果有学员已经报名删了排期会让订单表变成孤儿数据。正确做法是软删除给course_schedule增加is_deleted字段删除时把status改为0或is_deleted1。如果确实要物理删除必须先检查enrollment_order表是否有关联数据。这一点能体现出你的数据保护意识对答辩加分。6.5 MyBatis-Plus mapper注入失败检查Mapper接口上是否有Mapper注解或者在启动类加了MapperScan。我见过很多同学漏掉这个导致Spring容器启动直接报错。还有一种可能是Mapper.xml没匹配到namespaceIDEA里提示Invalid bound statement。确保resources目录下的xml目录结构和Mapper接口包路径一致并且application.yml配置了mapper-locations。7. 从课设到现实项目的几点体会做完这个项目再回头看我最大的感受是答辩和实际开发看重的东西不太一样。答辩更看重你对自己项目的理解程度对很多细节要能自圆其说。比如“为什么用JWT不用Session”“为什么排期要单独拆表”“并发报名怎么处理”只要你把这一层逻辑理清楚哪怕代码简单一点也很容易拿到不错的成绩。在实际开发顺序上建议先搭后端框架和数据表再实现登录注册和基础CRUD然后把报名核心流程跑通最后再做统计和管理页面。不要一开始就扑到前端样式上。很多同学先花两周画页面结果后端一推倒前端全废了得不偿失。关于论文部分如果你需要《设计与实现》论文目录可以这样走绪论背景意义、国内外现状、需求分析业务需求、功能需求、用例图E-R图、系统设计架构设计、模块设计、数据库设计、系统实现功能界面和关键代码、系统测试功能性测试和并发测试。正文里的关键代码尽量贴核心逻辑不要整段复制几百行源码。另外一个小建议把这个项目里的代码命名尽量规范类名、方法名、变量名都用英文语义化不要用拼音缩写比如BaoMingService这种。一个人开发时觉得无所谓但答辩老师翻代码看到会留下不太好的印象。还有业务常量不要满天飞可以统一放在一个Constant类里状态值最好用枚举虽然代码多一点但可读性会好很多。最后我想说这个训练营网站题目虽然不算新颖但如果你把业务闭环做完整并发控制说得清楚再带上一个可视化统计页面它在同类课设里绝对算得上有分量的作品。做项目本身就是不断填坑的过程遇到问题不要急着怀疑“框架坏了”九成情况是你自己把某个配置写错、某个依赖忘记引入。把报错日志从下往上翻一行一行看大多数答案就在那里。