简介这是一套面向高校计算机相关专业学生的JavaEE二手图书交易平台完整项目适用于课程设计、期末大作业及毕业设计参考场景对JavaWeb初学者与需要高分项目的同学尤为友好。压缩包共173个文件约25.68MB涵盖21个Java源文件、7个JSP页面、11个HTML与12个CSS样式文件以及10个JavaScript脚本、4个SQL建表脚本和若干图片、字体与配置文件前后端结构完整代码注释清晰便于理解与二次修改。项目功能完善、界面美观、操作简单涵盖用户管理、图书发布、订单交易等核心模块下载后简单部署即可运行。目前已有132人学习关注可作为课程设计的高分参考方案帮助读者快速掌握JavaEE项目开发流程、数据库设计思路与前后端交互逻辑节省从零搭建的时间成本。1. 从一份能跑起来的二手书平台源码说起课程设计选题里二手图书交易平台算是被翻牌最多的一类。原因很直接业务闭环清晰买家、卖家、管理员三种角色天然存在图书信息、订单、留言这些实体关系不复杂答辩时老师也容易听懂。但真正动手时多数人卡在同一个地方——从零搭一个 JavaEE 项目光是把 Spring、MyBatis、前端模板和数据库串起来就能耗掉大半时间最后功能没做几个报告也写不完整。这份基于 JavaEE 的二手图书交易平台源码加报告解决的就是这个从零到能跑的问题。它是一套完整的课程设计级项目包含可部署的源码、带注释的业务代码以及配套的设计报告。适合两类人一是期末大作业临近、需要一份结构完整且能讲清楚的项目作为底子的同学二是想拿一个真实 JavaEE 项目练手、熟悉分层架构和前后端交互的初学者。源码里前端用了 Bootstrap 系列样式文件说明界面走的是响应式布局不是那种裸 HTML 拼出来的粗糙页面。需要先说明一点这类课程设计项目的价值不在于技术多前沿而在于它的完整度和可复现性。你拿到手之后能顺着 Controller 到 Service 再到 Mapper 的调用链把整个请求流程走通这比看十篇架构文章都管用。下面按资源是什么、怎么部署、怎么改、坑在哪的顺序拆开讲。2. 项目结构与技术栈拆解先搞清楚每一层在干什么2.1 分层架构与目录约定JavaEE 项目最常见的组织方式是 MVC 三层加一个实体层。这份源码大概率遵循这个约定目录结构通常长这样src/ main/ java/ com/xxx/controller/ // 接收请求返回视图或数据 com/xxx/service/ // 业务逻辑事务控制 com/xxx/service/impl/ // 业务实现类 com/xxx/mapper/ // 数据访问接口 com/xxx/entity/ // 实体类对应数据库表 com/xxx/util/ // 工具类如分页、日期处理 resources/ mapper/ // MyBatis 的 XML 映射文件 application.properties // 数据库连接、端口等配置 webapp/ static/ // bootstrap.css、sweetalert.css 等 WEB-INF/ views/ // JSP 或 Thymeleaf 模板 web.xml // 过滤器、Servlet 配置这个结构不是随便定的。Controller 层只做参数校验和路由转发不写业务Service 层负责事务边界比如下单时要同时扣库存和生成订单这两步必须在同一个事务里Mapper 层只做 SQL 映射不掺逻辑。分层的好处是改一处不影响其他层比如你要把 JSP 换成 Thymeleaf只动视图层就行。前端资源里出现了bootstrap.css、bootstrap-theme.css、sweetalert.css说明页面用了 Bootstrap 做栅格和组件用 SweetAlert 做弹窗提示。这两个库在课程设计里很常见因为引入简单、效果直观答辩演示时弹窗一出来观感分就上去了。2.2 数据库表设计与实体映射二手图书平台的核心表通常有五六张用户表、图书表、订单表、订单详情表、留言表、分类表。以图书表为例字段设计要能支撑发布二手书这个动作字段名类型说明idint主键自增titlevarchar(100)书名authorvarchar(50)作者pricedecimal(10,2)售价original_pricedecimal(10,2)原价category_idint分类外键seller_idint卖家外键descriptiontext品相描述statustinyint0 在售 1 已售 2 下架create_timedatetime发布时间实体类Book的字段要和这张表一一对应MyBatis 的resultMap里把列名和属性名映射好。这里有个容易忽略的点price用BigDecimal而不是double因为金额计算用浮点数会出现精度丢失0.1 0.2 不等于 0.3 这种问题在订单金额上就是事故。2.3 请求流转从浏览器到数据库再回来理解一个请求怎么走完全程是改代码的前提。以查看图书详情为例浏览器访问/book/detail?id5BookController的detail方法接收请求调用bookService.getById(5)BookServiceImpl调用bookMapper.selectById(5)MyBatis 执行mapper/BookMapper.xml里的 SQL返回Book对象Controller 把Book放进Model返回视图名book/detail视图引擎渲染 JSP/HTML把书名、价格、卖家信息填进去浏览器收到完整页面这条链路里任何一环断了页面就出不来。排查时按顺序看先看浏览器控制台有没有 404再看后端日志有没有 SQL 异常最后看视图有没有渲染错误。这个顺序能帮你快速定位问题在哪一层。3. 本地部署实操从导入到跑通第一个页面3.1 环境准备与依赖确认部署之前先把环境对齐。这份源码是 JavaEE 项目常见运行环境是 JDK 8 加 Tomcat 8/9数据库用 MySQL 5.7 或 8.0。版本不匹配是新手翻车最多的地方比如 JDK 17 跑老项目会因为模块化限制报错MySQL 8 的连接串要加时区参数。先确认本机环境java -version # 期望输出java version 1.8.0_xxx 或 11.0.x mysql --version # 期望输出mysql Ver 8.0.xx 或 5.7.xx # 检查 Tomcat 是否解压可用 ls /path/to/tomcat/bin/startup.sh如果 JDK 版本高于 8建议装一个 JDK 8 专门跑这个项目不要硬改。MySQL 8 的话连接 URL 要写成jdbc:mysql://localhost:3306/secondhand_book?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalseserverTimezone不加会报时区错误useSSLfalse不加会有警告这两个参数是 MySQL 8 的标配。3.2 数据库导入与配置修改源码包里一般有一个.sql文件先建库再导入# 登录 MySQL mysql -u root -p # 创建数据库字符集用 utf8mb4 支持中文和特殊符号 CREATE DATABASE secondhand_book DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; # 退出后用命令行导入 exit mysql -u root -p secondhand_book /path/to/secondhand_book.sql导入完成后打开application.properties或db.properties把数据库连接改成你自己的jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/secondhand_book?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalse jdbc.usernameroot jdbc.password你的密码注意driver这一行MySQL 8 用com.mysql.cj.jdbc.DriverMySQL 5.7 用com.mysql.jdbc.Driver。写错了启动就报ClassNotFoundException这是血泪经验里排第一的坑。3.3 项目导入与启动验证如果用 IDEA按这个流程走File - Open选中项目根目录的pom.xml以 Maven 项目导入等待依赖下载完成看右下角进度条走完配置 TomcatRun - Edit Configurations - - Tomcat Server - Local在Deployment标签页点选Artifact添加war explodedApplication context设成/或/book点运行浏览器自动打开启动成功后先访问首页http://localhost:8080/能看到图书列表就说明数据库通了。如果页面空白但没报错检查视图文件路径对不对如果报 500看控制台异常栈大概率是 SQL 映射或字段类型不匹配。提示第一次启动如果卡在 Deploying web application 很久多半是 Maven 依赖没下完检查网络或换阿里云镜像源。4. 核心功能改造把能跑变成能讲4.1 图书发布与图片上传课程设计答辩时老师最爱问的就是图片怎么存的。这份源码如果支持图书封面通常有两种做法存文件路径到数据库或者直接存 Base64。前者更规范后者省事但数据库会膨胀。文件上传的核心代码在 Controller 里PostMapping(/book/publish) public String publish(Book book, RequestParam(cover) MultipartFile file, HttpServletRequest request) throws IOException { if (!file.isEmpty()) { // 获取上传目录的真实路径 String path request.getServletContext().getRealPath(/upload); File dir new File(path); if (!dir.exists()) dir.mkdirs(); // 用时间戳重命名避免同名覆盖 String fileName System.currentTimeMillis() _ file.getOriginalFilename(); file.transferTo(new File(dir, fileName)); // 数据库只存相对路径 book.setCover(/upload/ fileName); } book.setSellerId((Integer) request.getSession().getAttribute(userId)); book.setStatus(0); bookService.save(book); return redirect:/book/list; }这段代码的逻辑是先判断文件非空拿到 web 应用的 upload 目录不存在就创建然后用时间戳加原文件名做新名字防止两个用户传同名文件互相覆盖。最后把相对路径存进数据库页面上用${book.cover}就能取到。参数上要注意MultipartFile的配置。Spring Boot 默认单文件上限 1MB超过会抛MaxUploadSizeExceededException。在配置文件里加上spring.servlet.multipart.max-file-size5MB spring.servlet.multipart.max-request-size10MB如果是传统 Spring MVC 项目则在spring-mvc.xml里配CommonsMultipartResolvermaxUploadSize设成 52428805MB 的字节数。4.2 订单状态流转与事务控制二手书交易的核心是订单。一个订单从创建到完成状态要经过待付款、已付款、已发货、已完成、已取消。每次状态变更都要校验当前状态是否允许这个操作比如已完成的订单不能再取消。Service 层的方法要加事务注解Service public class OrderServiceImpl implements OrderService { Autowired private OrderMapper orderMapper; Autowired private BookMapper bookMapper; Override Transactional(rollbackFor Exception.class) public void createOrder(Integer bookId, Integer buyerId) { Book book bookMapper.selectById(bookId); // 校验书必须在售且不能买自己的书 if (book null || book.getStatus() ! 0) { throw new RuntimeException(该书已售出或下架); } if (book.getSellerId().equals(buyerId)) { throw new RuntimeException(不能购买自己发布的图书); } // 扣减库存把书状态改为已售 book.setStatus(1); bookMapper.updateStatus(book); // 生成订单 Order order new Order(); order.setBookId(bookId); order.setBuyerId(buyerId); order.setSellerId(book.getSellerId()); order.setAmount(book.getPrice()); order.setStatus(0); order.setCreateTime(new Date()); orderMapper.insert(order); } }Transactional(rollbackFor Exception.class)的意思是只要方法里抛出任何异常前面的数据库操作全部回滚。如果不加这个扣了库存但订单没生成数据就不一致了。rollbackFor默认只回滚RuntimeException加上Exception.class才能覆盖所有受检异常。参数上book.getStatus() ! 0这个判断用的是Integer和int比较会自动拆箱不会出问题。但如果status是Integer且为null拆箱就会空指针。所以实体类里状态字段最好给默认值或者在比较前先判空。4.3 分页查询与条件筛选图书列表页数据多了必须分页。常见做法是用 PageHelper 插件一行代码搞定Override public PageInfoBook listByPage(int pageNum, int pageSize, String keyword, Integer categoryId) { PageHelper.startPage(pageNum, pageSize); ListBook list bookMapper.selectByCondition(keyword, categoryId); return new PageInfo(list); }PageHelper.startPage只对紧接着的第一条查询生效所以必须写在 Mapper 调用之前。PageInfo会自动算出总页数、总记录数、是否有上一页下一页前端直接取这些属性渲染分页条。对应的 Mapper XML 里用动态 SQL 处理条件select idselectByCondition resultMapBookResultMap SELECT * FROM book where if testkeyword ! null and keyword ! AND (title LIKE CONCAT(%, #{keyword}, %) OR author LIKE CONCAT(%, #{keyword}, %)) /if if testcategoryId ! null AND category_id #{categoryId} /if AND status 0 /where ORDER BY create_time DESC /selectwhere标签会自动处理第一个AND不用手写WHERE 11。CONCAT(%, #{keyword}, %)用#{}是预编译占位符能防 SQL 注入如果用${}拼接就有注入风险这是答辩常问的安全点。5. 避坑与排查那些让项目跑不起来的细节5.1 启动报 404但 Tomcat 正常现象Tomcat 启动日志没有异常访问首页显示 404。原因多半是Application context配错了或者web.xml里DispatcherServlet的url-pattern写成了/api/*之类导致根路径没有映射。解决检查 Tomcat 配置里的 context path如果是/book访问地址要带/book。再看web.xml或 Spring Boot 的server.servlet.context-path两者保持一致。5.2 中文乱码数据库里存的是问号现象页面输入中文书名保存后数据库里显示???。原因三个地方的字符集没统一——数据库建库时没用 utf8mb4、连接 URL 没加characterEncodingutf8、Tomcat 的server.xml里 Connector 没加URIEncodingUTF-8。解决建库语句加DEFAULT CHARACTER SET utf8mb4JDBC URL 加characterEncodingutf8Tomcat Connector 加URIEncodingUTF-8。三处都改完重启问题基本消失。5.3 静态资源 404页面没样式现象HTML 出来了但 Bootstrap 样式没加载页面是裸的。原因Spring MVC 的DispatcherServlet默认拦截所有请求包括/static/css/bootstrap.css但没有对应的 Controller 处理。解决在spring-mvc.xml里加mvc:resources mapping/static/** location/static/ / mvc:default-servlet-handler /第一行告诉 Spring 把/static/**的请求当静态资源处理第二行让没匹配上的请求交回给 Tomcat 默认 Servlet。两行配合样式和图片就能正常加载。5.4 订单重复提交同一本书生成两笔订单现象用户快速点两次立即购买数据库里出现两条相同订单。原因前端没有防重复提交后端也没有幂等校验。解决前端在点击后禁用按钮后端在创建订单前先查一次该用户对该书是否有未完成订单有就直接返回。更严谨的做法是用数据库唯一索引比如(book_id, buyer_id, status)加唯一约束插入重复时抛异常回滚。5.5 修改代码后页面没变化现象改了 JSP 或 Java 代码重启后还是旧页面。原因IDEA 的war exploded模式有时不会自动同步或者浏览器缓存了旧资源。解决Build - Rebuild Project强制重新编译Tomcat 配置里勾选On Update action: Update classes and resources。浏览器按Ctrl F5强制刷新绕过缓存。6. 从课程设计到能讲清楚报告撰写与答辩准备报告不是把代码贴一遍就完事。老师看的是你有没有理解自己写的东西。一份能拿高分的报告结构上要包含需求分析、系统设计、数据库设计、核心功能实现、测试与总结。其中数据库设计部分要放 E-R 图系统设计要放架构图核心功能要放关键代码和运行截图。我一般会建议按这个顺序写先画 E-R 图确定实体关系再根据 E-R 图建表然后写 DAO 层和 Service 层最后写 Controller 和页面。这样写出来的报告逻辑是顺的不会出现表里没这个字段但代码里用了这种自相矛盾。答辩时最常被问的三个问题你的项目里事务是怎么控制的、分页是怎么实现的、有没有做权限校验。前两个上面已经讲过权限校验这块常见做法是用拦截器public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { HttpSession session request.getSession(); // 放行登录页和静态资源 String uri request.getRequestURI(); if (uri.contains(/login) || uri.contains(/static/)) { return true; } if (session.getAttribute(userId) null) { response.sendRedirect(request.getContextPath() /login); return false; } return true; } }拦截器在spring-mvc.xml里注册mvc:interceptor配mapping和exclude-mapping。这样未登录用户访问任何业务页面都会被踢回登录页管理员页面再加一层角色判断。还有一个容易被忽略的点报告里的截图要清晰不要用手机拍屏幕。运行项目后按Win Shift S截区域贴进 Word 里调整大小。截图里最好带上浏览器地址栏证明是你自己跑出来的不是网上找的。从那以后我每次拿到一份课程设计源码都强制自己先跑通再改一行代码确认环境没问题再动业务逻辑。这个习惯帮我省了很多改了三天发现是环境问题的时间。希望这份拆解能帮你顺利把项目跑起来、把报告写完整。本文还有配套的精品资源点击获取 JavaEE二手图书交易平台源码部署与核心功能改造实战
简介这是一套面向高校计算机相关专业学生的JavaEE二手图书交易平台完整项目适用于课程设计、期末大作业及毕业设计参考场景对JavaWeb初学者与需要高分项目的同学尤为友好。压缩包共173个文件约25.68MB涵盖21个Java源文件、7个JSP页面、11个HTML与12个CSS样式文件以及10个JavaScript脚本、4个SQL建表脚本和若干图片、字体与配置文件前后端结构完整代码注释清晰便于理解与二次修改。项目功能完善、界面美观、操作简单涵盖用户管理、图书发布、订单交易等核心模块下载后简单部署即可运行。目前已有132人学习关注可作为课程设计的高分参考方案帮助读者快速掌握JavaEE项目开发流程、数据库设计思路与前后端交互逻辑节省从零搭建的时间成本。1. 从一份能跑起来的二手书平台源码说起课程设计选题里二手图书交易平台算是被翻牌最多的一类。原因很直接业务闭环清晰买家、卖家、管理员三种角色天然存在图书信息、订单、留言这些实体关系不复杂答辩时老师也容易听懂。但真正动手时多数人卡在同一个地方——从零搭一个 JavaEE 项目光是把 Spring、MyBatis、前端模板和数据库串起来就能耗掉大半时间最后功能没做几个报告也写不完整。这份基于 JavaEE 的二手图书交易平台源码加报告解决的就是这个从零到能跑的问题。它是一套完整的课程设计级项目包含可部署的源码、带注释的业务代码以及配套的设计报告。适合两类人一是期末大作业临近、需要一份结构完整且能讲清楚的项目作为底子的同学二是想拿一个真实 JavaEE 项目练手、熟悉分层架构和前后端交互的初学者。源码里前端用了 Bootstrap 系列样式文件说明界面走的是响应式布局不是那种裸 HTML 拼出来的粗糙页面。需要先说明一点这类课程设计项目的价值不在于技术多前沿而在于它的完整度和可复现性。你拿到手之后能顺着 Controller 到 Service 再到 Mapper 的调用链把整个请求流程走通这比看十篇架构文章都管用。下面按资源是什么、怎么部署、怎么改、坑在哪的顺序拆开讲。2. 项目结构与技术栈拆解先搞清楚每一层在干什么2.1 分层架构与目录约定JavaEE 项目最常见的组织方式是 MVC 三层加一个实体层。这份源码大概率遵循这个约定目录结构通常长这样src/ main/ java/ com/xxx/controller/ // 接收请求返回视图或数据 com/xxx/service/ // 业务逻辑事务控制 com/xxx/service/impl/ // 业务实现类 com/xxx/mapper/ // 数据访问接口 com/xxx/entity/ // 实体类对应数据库表 com/xxx/util/ // 工具类如分页、日期处理 resources/ mapper/ // MyBatis 的 XML 映射文件 application.properties // 数据库连接、端口等配置 webapp/ static/ // bootstrap.css、sweetalert.css 等 WEB-INF/ views/ // JSP 或 Thymeleaf 模板 web.xml // 过滤器、Servlet 配置这个结构不是随便定的。Controller 层只做参数校验和路由转发不写业务Service 层负责事务边界比如下单时要同时扣库存和生成订单这两步必须在同一个事务里Mapper 层只做 SQL 映射不掺逻辑。分层的好处是改一处不影响其他层比如你要把 JSP 换成 Thymeleaf只动视图层就行。前端资源里出现了bootstrap.css、bootstrap-theme.css、sweetalert.css说明页面用了 Bootstrap 做栅格和组件用 SweetAlert 做弹窗提示。这两个库在课程设计里很常见因为引入简单、效果直观答辩演示时弹窗一出来观感分就上去了。2.2 数据库表设计与实体映射二手图书平台的核心表通常有五六张用户表、图书表、订单表、订单详情表、留言表、分类表。以图书表为例字段设计要能支撑发布二手书这个动作字段名类型说明idint主键自增titlevarchar(100)书名authorvarchar(50)作者pricedecimal(10,2)售价original_pricedecimal(10,2)原价category_idint分类外键seller_idint卖家外键descriptiontext品相描述statustinyint0 在售 1 已售 2 下架create_timedatetime发布时间实体类Book的字段要和这张表一一对应MyBatis 的resultMap里把列名和属性名映射好。这里有个容易忽略的点price用BigDecimal而不是double因为金额计算用浮点数会出现精度丢失0.1 0.2 不等于 0.3 这种问题在订单金额上就是事故。2.3 请求流转从浏览器到数据库再回来理解一个请求怎么走完全程是改代码的前提。以查看图书详情为例浏览器访问/book/detail?id5BookController的detail方法接收请求调用bookService.getById(5)BookServiceImpl调用bookMapper.selectById(5)MyBatis 执行mapper/BookMapper.xml里的 SQL返回Book对象Controller 把Book放进Model返回视图名book/detail视图引擎渲染 JSP/HTML把书名、价格、卖家信息填进去浏览器收到完整页面这条链路里任何一环断了页面就出不来。排查时按顺序看先看浏览器控制台有没有 404再看后端日志有没有 SQL 异常最后看视图有没有渲染错误。这个顺序能帮你快速定位问题在哪一层。3. 本地部署实操从导入到跑通第一个页面3.1 环境准备与依赖确认部署之前先把环境对齐。这份源码是 JavaEE 项目常见运行环境是 JDK 8 加 Tomcat 8/9数据库用 MySQL 5.7 或 8.0。版本不匹配是新手翻车最多的地方比如 JDK 17 跑老项目会因为模块化限制报错MySQL 8 的连接串要加时区参数。先确认本机环境java -version # 期望输出java version 1.8.0_xxx 或 11.0.x mysql --version # 期望输出mysql Ver 8.0.xx 或 5.7.xx # 检查 Tomcat 是否解压可用 ls /path/to/tomcat/bin/startup.sh如果 JDK 版本高于 8建议装一个 JDK 8 专门跑这个项目不要硬改。MySQL 8 的话连接 URL 要写成jdbc:mysql://localhost:3306/secondhand_book?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalseserverTimezone不加会报时区错误useSSLfalse不加会有警告这两个参数是 MySQL 8 的标配。3.2 数据库导入与配置修改源码包里一般有一个.sql文件先建库再导入# 登录 MySQL mysql -u root -p # 创建数据库字符集用 utf8mb4 支持中文和特殊符号 CREATE DATABASE secondhand_book DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; # 退出后用命令行导入 exit mysql -u root -p secondhand_book /path/to/secondhand_book.sql导入完成后打开application.properties或db.properties把数据库连接改成你自己的jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/secondhand_book?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalse jdbc.usernameroot jdbc.password你的密码注意driver这一行MySQL 8 用com.mysql.cj.jdbc.DriverMySQL 5.7 用com.mysql.jdbc.Driver。写错了启动就报ClassNotFoundException这是血泪经验里排第一的坑。3.3 项目导入与启动验证如果用 IDEA按这个流程走File - Open选中项目根目录的pom.xml以 Maven 项目导入等待依赖下载完成看右下角进度条走完配置 TomcatRun - Edit Configurations - - Tomcat Server - Local在Deployment标签页点选Artifact添加war explodedApplication context设成/或/book点运行浏览器自动打开启动成功后先访问首页http://localhost:8080/能看到图书列表就说明数据库通了。如果页面空白但没报错检查视图文件路径对不对如果报 500看控制台异常栈大概率是 SQL 映射或字段类型不匹配。提示第一次启动如果卡在 Deploying web application 很久多半是 Maven 依赖没下完检查网络或换阿里云镜像源。4. 核心功能改造把能跑变成能讲4.1 图书发布与图片上传课程设计答辩时老师最爱问的就是图片怎么存的。这份源码如果支持图书封面通常有两种做法存文件路径到数据库或者直接存 Base64。前者更规范后者省事但数据库会膨胀。文件上传的核心代码在 Controller 里PostMapping(/book/publish) public String publish(Book book, RequestParam(cover) MultipartFile file, HttpServletRequest request) throws IOException { if (!file.isEmpty()) { // 获取上传目录的真实路径 String path request.getServletContext().getRealPath(/upload); File dir new File(path); if (!dir.exists()) dir.mkdirs(); // 用时间戳重命名避免同名覆盖 String fileName System.currentTimeMillis() _ file.getOriginalFilename(); file.transferTo(new File(dir, fileName)); // 数据库只存相对路径 book.setCover(/upload/ fileName); } book.setSellerId((Integer) request.getSession().getAttribute(userId)); book.setStatus(0); bookService.save(book); return redirect:/book/list; }这段代码的逻辑是先判断文件非空拿到 web 应用的 upload 目录不存在就创建然后用时间戳加原文件名做新名字防止两个用户传同名文件互相覆盖。最后把相对路径存进数据库页面上用${book.cover}就能取到。参数上要注意MultipartFile的配置。Spring Boot 默认单文件上限 1MB超过会抛MaxUploadSizeExceededException。在配置文件里加上spring.servlet.multipart.max-file-size5MB spring.servlet.multipart.max-request-size10MB如果是传统 Spring MVC 项目则在spring-mvc.xml里配CommonsMultipartResolvermaxUploadSize设成 52428805MB 的字节数。4.2 订单状态流转与事务控制二手书交易的核心是订单。一个订单从创建到完成状态要经过待付款、已付款、已发货、已完成、已取消。每次状态变更都要校验当前状态是否允许这个操作比如已完成的订单不能再取消。Service 层的方法要加事务注解Service public class OrderServiceImpl implements OrderService { Autowired private OrderMapper orderMapper; Autowired private BookMapper bookMapper; Override Transactional(rollbackFor Exception.class) public void createOrder(Integer bookId, Integer buyerId) { Book book bookMapper.selectById(bookId); // 校验书必须在售且不能买自己的书 if (book null || book.getStatus() ! 0) { throw new RuntimeException(该书已售出或下架); } if (book.getSellerId().equals(buyerId)) { throw new RuntimeException(不能购买自己发布的图书); } // 扣减库存把书状态改为已售 book.setStatus(1); bookMapper.updateStatus(book); // 生成订单 Order order new Order(); order.setBookId(bookId); order.setBuyerId(buyerId); order.setSellerId(book.getSellerId()); order.setAmount(book.getPrice()); order.setStatus(0); order.setCreateTime(new Date()); orderMapper.insert(order); } }Transactional(rollbackFor Exception.class)的意思是只要方法里抛出任何异常前面的数据库操作全部回滚。如果不加这个扣了库存但订单没生成数据就不一致了。rollbackFor默认只回滚RuntimeException加上Exception.class才能覆盖所有受检异常。参数上book.getStatus() ! 0这个判断用的是Integer和int比较会自动拆箱不会出问题。但如果status是Integer且为null拆箱就会空指针。所以实体类里状态字段最好给默认值或者在比较前先判空。4.3 分页查询与条件筛选图书列表页数据多了必须分页。常见做法是用 PageHelper 插件一行代码搞定Override public PageInfoBook listByPage(int pageNum, int pageSize, String keyword, Integer categoryId) { PageHelper.startPage(pageNum, pageSize); ListBook list bookMapper.selectByCondition(keyword, categoryId); return new PageInfo(list); }PageHelper.startPage只对紧接着的第一条查询生效所以必须写在 Mapper 调用之前。PageInfo会自动算出总页数、总记录数、是否有上一页下一页前端直接取这些属性渲染分页条。对应的 Mapper XML 里用动态 SQL 处理条件select idselectByCondition resultMapBookResultMap SELECT * FROM book where if testkeyword ! null and keyword ! AND (title LIKE CONCAT(%, #{keyword}, %) OR author LIKE CONCAT(%, #{keyword}, %)) /if if testcategoryId ! null AND category_id #{categoryId} /if AND status 0 /where ORDER BY create_time DESC /selectwhere标签会自动处理第一个AND不用手写WHERE 11。CONCAT(%, #{keyword}, %)用#{}是预编译占位符能防 SQL 注入如果用${}拼接就有注入风险这是答辩常问的安全点。5. 避坑与排查那些让项目跑不起来的细节5.1 启动报 404但 Tomcat 正常现象Tomcat 启动日志没有异常访问首页显示 404。原因多半是Application context配错了或者web.xml里DispatcherServlet的url-pattern写成了/api/*之类导致根路径没有映射。解决检查 Tomcat 配置里的 context path如果是/book访问地址要带/book。再看web.xml或 Spring Boot 的server.servlet.context-path两者保持一致。5.2 中文乱码数据库里存的是问号现象页面输入中文书名保存后数据库里显示???。原因三个地方的字符集没统一——数据库建库时没用 utf8mb4、连接 URL 没加characterEncodingutf8、Tomcat 的server.xml里 Connector 没加URIEncodingUTF-8。解决建库语句加DEFAULT CHARACTER SET utf8mb4JDBC URL 加characterEncodingutf8Tomcat Connector 加URIEncodingUTF-8。三处都改完重启问题基本消失。5.3 静态资源 404页面没样式现象HTML 出来了但 Bootstrap 样式没加载页面是裸的。原因Spring MVC 的DispatcherServlet默认拦截所有请求包括/static/css/bootstrap.css但没有对应的 Controller 处理。解决在spring-mvc.xml里加mvc:resources mapping/static/** location/static/ / mvc:default-servlet-handler /第一行告诉 Spring 把/static/**的请求当静态资源处理第二行让没匹配上的请求交回给 Tomcat 默认 Servlet。两行配合样式和图片就能正常加载。5.4 订单重复提交同一本书生成两笔订单现象用户快速点两次立即购买数据库里出现两条相同订单。原因前端没有防重复提交后端也没有幂等校验。解决前端在点击后禁用按钮后端在创建订单前先查一次该用户对该书是否有未完成订单有就直接返回。更严谨的做法是用数据库唯一索引比如(book_id, buyer_id, status)加唯一约束插入重复时抛异常回滚。5.5 修改代码后页面没变化现象改了 JSP 或 Java 代码重启后还是旧页面。原因IDEA 的war exploded模式有时不会自动同步或者浏览器缓存了旧资源。解决Build - Rebuild Project强制重新编译Tomcat 配置里勾选On Update action: Update classes and resources。浏览器按Ctrl F5强制刷新绕过缓存。6. 从课程设计到能讲清楚报告撰写与答辩准备报告不是把代码贴一遍就完事。老师看的是你有没有理解自己写的东西。一份能拿高分的报告结构上要包含需求分析、系统设计、数据库设计、核心功能实现、测试与总结。其中数据库设计部分要放 E-R 图系统设计要放架构图核心功能要放关键代码和运行截图。我一般会建议按这个顺序写先画 E-R 图确定实体关系再根据 E-R 图建表然后写 DAO 层和 Service 层最后写 Controller 和页面。这样写出来的报告逻辑是顺的不会出现表里没这个字段但代码里用了这种自相矛盾。答辩时最常被问的三个问题你的项目里事务是怎么控制的、分页是怎么实现的、有没有做权限校验。前两个上面已经讲过权限校验这块常见做法是用拦截器public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { HttpSession session request.getSession(); // 放行登录页和静态资源 String uri request.getRequestURI(); if (uri.contains(/login) || uri.contains(/static/)) { return true; } if (session.getAttribute(userId) null) { response.sendRedirect(request.getContextPath() /login); return false; } return true; } }拦截器在spring-mvc.xml里注册mvc:interceptor配mapping和exclude-mapping。这样未登录用户访问任何业务页面都会被踢回登录页管理员页面再加一层角色判断。还有一个容易被忽略的点报告里的截图要清晰不要用手机拍屏幕。运行项目后按Win Shift S截区域贴进 Word 里调整大小。截图里最好带上浏览器地址栏证明是你自己跑出来的不是网上找的。从那以后我每次拿到一份课程设计源码都强制自己先跑通再改一行代码确认环境没问题再动业务逻辑。这个习惯帮我省了很多改了三天发现是环境问题的时间。希望这份拆解能帮你顺利把项目跑起来、把报告写完整。本文还有配套的精品资源点击获取