简介这是一套面向高校计算机专业学生与Java初学者的校园二手交易平台实战项目基于SSMSpringSpringMVCMyBatis框架构建完整覆盖前后端分离开发模式后端提供RESTful接口前端包含原生Android客户端与JSP后台管理页面切实解决校内闲置物品流转难、信息不对称等实际问题。资源共188个文件压缩包大小60.92MB其中32个Java源文件构成核心业务逻辑与控制器层90个XML文件涵盖MyBatis映射配置与Spring容器定义50个PNG图片支撑Android界面资源另有Gradle构建脚本、Properties配置、WAR部署包及管理端JSP页面结构清晰、模块完整。已有345人学习下载开发者可直接导入IDE运行调试快速掌握SSM整合开发、Android网络请求对接、JSP后台权限管理及校园场景下的数据库设计与事务处理实践。 做毕设或者课设的同学十有八九都被 SSM 这三个字母支配过。Spring、SpringMVC、MyBatis 三件套组合起来的校园二手交易系统几乎是 Java Web 方向最经典的选题之一。这套源码我前后整理过好几个版本也帮人调过不少次问题从数据库表设计到前端页面联调都踩过不少坑。这篇东西不是给你贴一堆代码就完事我会把整个项目的设计思路、核心代码逻辑、部署启动步骤、以及那些报错之后瞎折腾半天的排查过程一次讲清楚。不管你是准备拿它交作业还是想学 SSM 整合的真实项目结构这篇都对你有用。1. 先搞清楚这套SSM系统到底要解决什么问题1.1 为什么选SSM而不是Spring Boot先从选型说起。现在的开发环境里 Spring Boot 几乎成了默认选择但校园二手交易这个题目用 SSM 依然有它的道理。最直接的原因就是课程大纲和毕设要求还停留在 SSM 体系很多学校的教学就是这么安排的。另外一个现实原因是SSM 的配置是显式写到 XML 或者配置类里的像 Spring 容器怎么启动、MyBatis 的 SqlSessionFactory 怎么构建、事务管理器怎么配这些在 Spring Boot 里都是自动配置隐藏掉的。对于学习阶段的人来说把这些配置亲手敲一遍比用 Spring Boot 一键跑起来学到的东西多得多。这套系统的技术选型是标准的 SSM 三层架构。Spring 管对象和事务SpringMVC 管请求路由和参数绑定MyBatis 管数据库访问。三者配合把请求进来、业务处理、数据落库这条链路分得清清楚楚。我见过不少同学拿到源码第一个反应是怎么还有这么多 XML 配置文件其实这些文件就是整个项目的骨架后面调 Bug 的时候你会感谢它们的存在。1.2 系统角色与核心功能边界校园二手交易系统的用户角色就两类普通用户和管理员。普通用户的核心操作是围绕商品展开的注册登录、发布闲置商品、浏览商品列表、按关键词搜索、查看商品详情、收藏商品、下单购买、管理自己发布的商品和订单。管理员的核心操作是围绕平台管控展开的登录后台、审核商品上下架、管理用户状态、查看订单数据。从业务流程来看最核心的一条链路是用户发布商品 - 商品进入待审核/在售状态 - 其他用户浏览搜索 - 买家下单 - 卖家看到订单 - 线下交易 - 商品状态变为已售出。围绕这条链路数据库需要支撑用户、商品、订单、收藏、留言这几类数据。这套源码的功能边界也就是这些没有复杂的支付体系也不需要物流跟踪因为校园场景就是面对面交易这恰好降低了系统的实现难度也符合毕设的复杂度要求。2. 源码目录结构、版本选型与数据库设计2.1 按包名读懂MVC分层拿到源码先别急着跑花十分钟看看目录结构。一个规范的 SSM 项目后端代码一定按 controller、service、mapper、entity或者叫 pojo/model四层分包。controller 层只做参数接收和结果返回service 层放业务逻辑mapper 层就是 MyBatis 的接口entity 对应数据库表结构。这个分包习惯非常重要。很多同学改代码喜欢把业务逻辑写在 controller 里图省事结果后面加个功能要重构半天。我拿到这套源码第一件事就是看它的包结构是否清晰如果 controller 里直接写 SqlSession 操作那这代码基本没法维护。而这套源码的包名结构是这样的com.campus.secondhand.controller放前端请求入口com.campus.secondhand.service下有接口和 impl 实现类com.campus.secondhand.mapper放 MyBatis 的 Mapper 接口com.campus.secondhand.entity放实体类。另外还有common或util包放公共工具类比如 MD5 加密工具、分页工具等。除了后端前端页面在webapp目录下JSP 页面按WEB-INF/views组织静态资源在static目录JS 和 CSS 分离。2.2 版本选型定好版本是避免踩坑的第一步SSM 项目对版本搭配非常敏感。我遇到过很多奇怪的问题比如org.apache.ibatis.binding.BindingException: Invalid bound statement最后发现是 MyBatis 版本和 Spring 整合包的版本不匹配。为了避免这种问题建议直接参照下面的版本组合。组件推荐版本说明JDK1.8老项目兼容性最好别用 11 跑 SSM会有模块访问问题Maven3.6.x3.6 对老插件兼容性稳定Spring5.1.x5.x 系列和 JDK8 配合完美SpringMVC5.1.x与Spring一致统一版本号省得依赖冲突MyBatis3.5.x3.5 版本之后动态 SQL 支持更完善mybatis-spring2.0.x必须与 mybatis 版本对应MySQL5.7 或 8.05.7 最省心8.0 需要改驱动类和时区参数Tomcat8.5支持 Servlet 3.1SSM 项目标准容器IDEA2021对 Maven 项目支持更友好这里特别提醒一下 MySQL 8.0 的坑驱动类从com.mysql.jdbc.Driver改成了com.mysql.cj.jdbc.Driver而且连接 URL 必须加上serverTimezoneAsia/Shanghai不然会报时区错误。如果你用 5.7就老老实实用老的驱动类别混着来。2.3 核心数据表5张表撑起整个交易系统数据库设计决定了一个系统的上限。这套校园二手交易系统的核心表有 5 张用户表t_user、商品表t_goods、订单表t_order、收藏表t_favorite、留言表t_message。每一张表都应该有设计说明不然你改起来根本不知道字段是干嘛的。先看用户表。核心字段有id、username、password、salt盐值、nickname、avatar、phone、status0禁用/1正常、create_time。密码字段存的是加盐后的 MD5 值不是明文这个后面细说。salt字段是每行独立随机生成的它的存在就是为了防止彩虹表反查。商品表字段比较多逐个说清楚。id、user_id发布者外键、title、description、price、original_price、cover_image、images多图地址分号隔开、category分类、status0下架/1在售/2已售出、view_count、create_time、update_time。特别注意status字段它是商品生命周期的核心标记。有些系统的做法是删掉商品记录但更好的设计是状态流转这样管理后台可以追踪每一件商品的历史状态。订单表结构是id、order_no唯一订单号、goods_id、seller_id、buyer_id、price、status0待付款/1已成交/2已取消、create_time、pay_time。这里要解释下order_no它不能用自增 id 代替因为要展示给用户而且后续对接打印或对账时有唯一业务号会方便得多一般用时间戳加随机数生成。收藏表就简单了id、user_id、goods_id、create_time唯一索引建在user_id goods_id上防止同一个用户重复收藏同一件商品。留言表是id、goods_id、from_user_id、to_user_id、content、create_time支撑商品详情页的问答场景。3. 核心功能模块的实现逻辑3.1 注册登录逻辑MD5加盐不是玄学登录注册是每个系统的门面但很多同学在这块写得很随意。这套源码的做法是注册时后端接收用户名和密码先判断用户名是否被占用查一次库然后生成一个随机盐值用MD5(密码 盐值)得到密文把username、密文、salt一起插入数据库。登录时根据用户名查出用户记录取到这条记录的salt把前端传过来的密码加上这个salt再做一次 MD5和库里的密文比对。为什么要加盐因为单纯 MD5 相同密码会得到相同结果攻击者可以用彩虹表反查加了随机盐值之后同样的明文密码在不同用户那里密文完全不同安全性直接上了一个台阶。在 controller 层登录成功后把用户对象放进session同时写一个拦截器Interceptor来拦截需要登录才能访问的路径。比如发布商品、查看订单、个人中心这些操作如果 session 里没有用户直接重定向到登录页。这里有个小细节要注意放行/login、/register、/goods/list、/goods/detail这些公开接口其余路径都拦下来excludePathPatterns要配置好不然静态资源 JS/CSS 也会被拦截掉页面样式全丢。3.2 商品发布与图片上传路径问题是一个大坑商品发布模块是这个系统里坑最多的环节尤其图片上传。前端页面是表单加文件选择框提交时用multipart/form-data格式。后端用 SpringMVC 的MultipartFile接收文件。这套源码的写法是把上传的图片保存到服务器的某个目录然后把访问路径存到数据库cover_image字段。关键踩坑点在于保存文件的物理路径和浏览器访问的 URL 路径是两个完全不同的概念。你存到D:/upload/路径下浏览器访问时不可能直接输入D:/upload/xxx.jpg。正确做法是配置一个虚拟路径映射把/upload/**映射到物理路径。如果用 Tomcat 部署可以在server.xml里加Context配置如果用 IDEA 的 Tomcat 插件也可以配置Deployment里的虚拟目录。还有更简单的做法把图片保存到项目部署目录webapp/upload下这样图片天然能通过域名访问但缺点是项目重新部署时图片会丢生产环境不推荐交作业图省事倒是可以。另外一个细节是文件类型校验。一定要限制只允许.jpg、.jpeg、.png、.gif格式而且要校验文件大小不然有人传一个几十 MB 的图片直接把 Tomcat 卡崩溃。上传文件后一定要重新生成文件名用时间戳加随机数不要直接使用用户上传的原始文件名防止文件名冲突和安全问题。3.3 商品列表、搜索与分页动态SQL是MyBatis的精髓商品列表页看起来简单但要做得好用还是需要动点脑筋。列表页支持按分类筛选、按关键词模糊搜索、按价格或时间排序还有分页。这些需求全部交给 MyBatis 的动态 SQL 处理。Mapper XML 里写一个select用where标签包裹动态条件。比如select idsearchGoods resultTypecom.campus.secondhand.entity.Goods SELECT * FROM t_goods where if testkeyword ! null and keyword ! AND title LIKE CONCAT(%, #{keyword}, %) /if if testcategory ! null and category ! AND category #{category} /if if teststatus ! null AND status #{status} /if /where ORDER BY create_time DESC LIMIT #{offset}, #{pageSize} /selectwhere标签会自动处理第一个条件前面的 AND这个细节能避免拼接 SQL 时的语法错误。分页的做法有两种一种是上面这种手动LIMIT需要自己算offset另一种是用 PageHelper 分页插件在 service 层调用PageHelper.startPage(pageNum, pageSize)然后紧跟着的查询会自动带上分页。这套源码用的是手动 LIMIT我认为这样更好理解也少一个依赖。但如果你敢在 SQL 里用LIMIT #{offset}, #{pageSize}一定要确认两个参数都是 Integer 类型MyBatis 不会帮你自动转换导致报错。3.4 下单流程事务管理不能省用户看到商品详情页点击立即购买这时候后端做了什么第一校验商品是否存在且状态是在售status1第二创建订单记录订单号生成规则一般是yyyyMMddHHmmss 4位随机数第三把商品状态改成已售出status2。这三个操作必须放在同一个事务里因为任何一个步骤失败都不应该留下脏数据。Spring 里实现事务非常方便在 service 方法上加上Transactional注解即可。但要注意这个注解默认只对 RuntimeException 回滚对于受检异常不会回滚。如果业务中 catch 住了异常然后吞掉事务一样不会回滚。我见过有同学在 service 方法里 try-catch把异常存到日志就完事了结果订单表插入了商品状态没改数据就出问题了。最佳实践是事务方法内不要自己 catch 异常抛给上层处理确保Transactional能感知到异常并回滚。3.5 后台管理登录拦截与CRUD管理员进入后台需要独立的后台登录入口。这套源码的做法是写一个AdminInterceptor拦截/admin/**路径检查 session 里的adminUser是否存在不存在就跳转到管理员登录页。管理员登录时除了校验密码还要校验role字段确保只有管理员角色能进后台。后台管理功能就是对商品的审核、上下架操作。审核的本质就是修改t_goods表的status字段下架改成 0通过改成 1卖出改成 2。没有单独建一张审核记录表对于课程设计来说完全够用。用户管理页面是查询t_user列表支持修改用户状态禁用/启用。这里有个小细节禁用用户的时候要考虑他名下正在售卖的商品要不要同时下架很多同学忽略了这个关联逻辑。4. 把源码跑起来从环境准备到启动上线4.1 环境准备清单拿到源码后先别急着导入 IDEA先把基础环境装好。这套系统需要的环境如下JDK 1.8必须高版本容易出兼容问题MySQL 5.7 或 8.0Maven 3.6.xTomcat 8.5IDEA社区版或专业版都行源码自带的 SQL 文件一般是sql/campus_secondhand.sql如果电脑已经有 JDK 11 或更高版本建议把 JDK 8 也装上IDEA 里单独配置这个项目的 SDK 为 JDK 8不影响其他项目。4.2 从导入到启动7个关键步骤第一步在 MySQL 里创建数据库建议把字符集设置成 utf8mb4因为用户可能发布 emoji 表情或者特殊符号utf8 会报Incorrect string value错误。比如mysql -u root -p -e CREATE DATABASE campus_secondhand DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;第二步导入数据表。用 Navicat 或者命令行执行源码里的 SQL 文件导入完成后检查一下有没有t_user、t_goods等表顺便看看数据是否完整。第三步配置 Maven 镜像。打开settings.xml把中央仓库换成阿里云镜像不然下载依赖能下到你怀疑人生mirror idaliyun/id mirrorOfcentral/mirrorOf urlhttps://maven.aliyun.com/repository/public/url /mirror第四步IDEA 导入项目。选择File - Open选中项目的pom.xmlIDEA 会识别为 Maven 项目。然后设置项目 SDK 为 JDK 8设置 Language Level 为 8。第五步修改数据库连接配置。打开src/main/resources/jdbc.properties把用户名、密码改成你自己的数据库账号注意 URL 里的数据库名要和创建的一致jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/campus_secondhand?useUnicodetruecharacterEncodingutf-8useSSLfalseserverTimezoneAsia/Shanghai jdbc.usernameroot jdbc.password123456第六步配置 Tomcat。点 IDEA 右上角Add Configuration选 Tomcat Server - Local然后在Deployment里点加号选Artifact选择war exploded类型的项目。Application context 一般设为/campus或保持根路径/这个决定了访问 URL。第七步启动项目。点运行按钮看到 Tomcat 启动日志里出现Connected to server并且没有异常打开浏览器访问http://localhost:8080/或http://localhost:8080/项目名/能看到首页就算跑起来了。4.3 容易忽略的细节缺一个细节项目就可能在启动时爆错。最常见的就是 Lombok 没装。很多 SSM 项目的实体类会用到 Lombok 的Data注解来省略 getter/setter如果你 IDEA 没装 Lombok 插件编译直接报错找不到 getter 方法。解决办法是在 IDEA 插件市场安装 Lombok并且确保Settings - Build - Compiler - Annotation Processors里勾选了Enable annotation processing。另一个常见问题是web.xml里的启动配置。SSM 项目的web.xml会配置 Spring 的监听器和 SpringMVC 的 DispatcherServlet这两者的contextConfigLocation指错了就会报ClassNotFoundException或BeanDefinitionStoreException。最好确认源码里配置文件路径和web.xml里的路径完全一致。5. 高频报错与排查技巧实录5.1 报错速查表报错现象根本原因解决方案启动 Tomcat 报端口占用8080 被其他进程占用换端口或杀掉占用进程netstat -ano查 PID数据库连接失败Access denied for user用户名密码错误或权限不对检查 jdbc.properties 配置确认 MySQL 账号可远程访问页面打开样式全丢静态资源被拦截器拦截在拦截器配置里放行/static/**、/css/**、/js/**等资源路径图片上传后页面显示 404物理路径和虚拟路径没映射好检查 Tomcat 虚拟目录配置或者上传路径配置MyBatis 报Invalid bound statementMapper 接口和 XML 的 namespace 不对应检查 XML 的 namespace 是否等于接口全限定名方法 id 是否一致数据库中文乱码连接 URL 没有指定 UTF-8 或数据库字符集不对URL 加characterEncodingutf-8并确认数据库是 utf8mb4请求参数传不过来全是 null实体类属性名与前端 name 不一致检查表单 name 与实体类字段名是否一致或是否缺 setter 方法5.2 一个印象深刻的排查案例有一次帮人调一个问题商品列表页点下一页报 500 错误控制台报的是NumberFormatException。查了半天发现是分页参数传递出了问题前端传的pageNum在 JSP 里是字符串后端直接用Integer.parseInt解析但第一页的时候有页码是空字符串一转换就崩了。后来我在 controller 里对分页参数做了默认值处理为空时默认第一页每页 10 条。这个案例说明controller 的参数校验一定要做永远不要信任前端传过来的数据一个空指针异常就够你调半小时。另一个案例是用户注册时提示用户名已存在但明明换个用户名也不行。排查发现是注册的 service 方法里查询用户是否存在的 SQL 条件写错了status字段多加了一个条件导致查询永远返回空。这类问题只能靠仔细查看日志和 SQL 排除MyBatis 控制台打印的 SQL 一定要打开日志级别看到实际执行的 SQL 才好判断哪里出了问题。5.3 二次开发可以做的扩展方向如果这套系统要作为毕设答辩的亮点只做基础 CRUD 是不够的。我建议根据你的时间情况从下面几个方向挑一两个做扩展。第一个方向是引入 Redis 做缓存。把商品分类列表和热门商品列表缓存到 Redis设置过期时间减轻数据库压力。这个扩展在答辩时说提升了系统高并发下的响应速度是加分的点。技术实现上在 service 层先查 Redis没有再查数据库并回填缓存注意删除缓存时机的设计。第二个方向是用 ECharts 给管理员后台加统计报表。统计商品总量、每日新增商品数、订单成交量用柱状图和饼图展示。从t_goods表按create_time分组统计SQL 逻辑不难主要是DATE_FORMAT函数的使用。第三个方向是引入消息通知机制。当一个商品被下单时通过站内信通知卖家。可以在订单表加一个notify_status字段在卖家登录时查询未读消息数量这个功能虽然简单但能显著提升系统的完整度。第四个方向是把密码加密升级为 BCrypt。MD5 加盐虽然比明文安全但已经被证明不够可靠。引入 Spring Security 的BCryptPasswordEncoder替换原来的加密工具类只需要动注册登录两个地方。这个改动在答辩时展示出来会让人感觉你有安全意识。6. 写在最后的经验总结这套校园二手交易系统的源码对我来说最大的价值不是它有多先进而是它足够完整。从数据库设计到前端页面从登录鉴权到文件上传一个真实 Java Web 项目该有的模块它都有了。我做技术这些年见过太多人把毕设当成应付差事复制一套代码改个标题就交上去了。但我建议你拿着源码把每一层代码走一遍尤其是从goodsList.jsp页面点击搜索到数据库返回结果这条链路你用打断点的方式跟着走一遍比看十篇博客都管用。按我的经验这套系统你完全吃透之后SSM 整合开发基本上就入门了。后续再去看 Spring Boot 的项目你会发现很多东西都是一通百通的。最后提醒一句交作业之前先把你自己的数据库账号密码、端口号这些信息改清爽别再拿 jdbc.properties 里留着别人的密码去答辩。这些细节虽然不起眼但给老师的第一印象绝对不一样。本文还有配套的精品资源点击获取 SSM校园二手交易系统源码解析：从架构设计到部署排错
简介这是一套面向高校计算机专业学生与Java初学者的校园二手交易平台实战项目基于SSMSpringSpringMVCMyBatis框架构建完整覆盖前后端分离开发模式后端提供RESTful接口前端包含原生Android客户端与JSP后台管理页面切实解决校内闲置物品流转难、信息不对称等实际问题。资源共188个文件压缩包大小60.92MB其中32个Java源文件构成核心业务逻辑与控制器层90个XML文件涵盖MyBatis映射配置与Spring容器定义50个PNG图片支撑Android界面资源另有Gradle构建脚本、Properties配置、WAR部署包及管理端JSP页面结构清晰、模块完整。已有345人学习下载开发者可直接导入IDE运行调试快速掌握SSM整合开发、Android网络请求对接、JSP后台权限管理及校园场景下的数据库设计与事务处理实践。 做毕设或者课设的同学十有八九都被 SSM 这三个字母支配过。Spring、SpringMVC、MyBatis 三件套组合起来的校园二手交易系统几乎是 Java Web 方向最经典的选题之一。这套源码我前后整理过好几个版本也帮人调过不少次问题从数据库表设计到前端页面联调都踩过不少坑。这篇东西不是给你贴一堆代码就完事我会把整个项目的设计思路、核心代码逻辑、部署启动步骤、以及那些报错之后瞎折腾半天的排查过程一次讲清楚。不管你是准备拿它交作业还是想学 SSM 整合的真实项目结构这篇都对你有用。1. 先搞清楚这套SSM系统到底要解决什么问题1.1 为什么选SSM而不是Spring Boot先从选型说起。现在的开发环境里 Spring Boot 几乎成了默认选择但校园二手交易这个题目用 SSM 依然有它的道理。最直接的原因就是课程大纲和毕设要求还停留在 SSM 体系很多学校的教学就是这么安排的。另外一个现实原因是SSM 的配置是显式写到 XML 或者配置类里的像 Spring 容器怎么启动、MyBatis 的 SqlSessionFactory 怎么构建、事务管理器怎么配这些在 Spring Boot 里都是自动配置隐藏掉的。对于学习阶段的人来说把这些配置亲手敲一遍比用 Spring Boot 一键跑起来学到的东西多得多。这套系统的技术选型是标准的 SSM 三层架构。Spring 管对象和事务SpringMVC 管请求路由和参数绑定MyBatis 管数据库访问。三者配合把请求进来、业务处理、数据落库这条链路分得清清楚楚。我见过不少同学拿到源码第一个反应是怎么还有这么多 XML 配置文件其实这些文件就是整个项目的骨架后面调 Bug 的时候你会感谢它们的存在。1.2 系统角色与核心功能边界校园二手交易系统的用户角色就两类普通用户和管理员。普通用户的核心操作是围绕商品展开的注册登录、发布闲置商品、浏览商品列表、按关键词搜索、查看商品详情、收藏商品、下单购买、管理自己发布的商品和订单。管理员的核心操作是围绕平台管控展开的登录后台、审核商品上下架、管理用户状态、查看订单数据。从业务流程来看最核心的一条链路是用户发布商品 - 商品进入待审核/在售状态 - 其他用户浏览搜索 - 买家下单 - 卖家看到订单 - 线下交易 - 商品状态变为已售出。围绕这条链路数据库需要支撑用户、商品、订单、收藏、留言这几类数据。这套源码的功能边界也就是这些没有复杂的支付体系也不需要物流跟踪因为校园场景就是面对面交易这恰好降低了系统的实现难度也符合毕设的复杂度要求。2. 源码目录结构、版本选型与数据库设计2.1 按包名读懂MVC分层拿到源码先别急着跑花十分钟看看目录结构。一个规范的 SSM 项目后端代码一定按 controller、service、mapper、entity或者叫 pojo/model四层分包。controller 层只做参数接收和结果返回service 层放业务逻辑mapper 层就是 MyBatis 的接口entity 对应数据库表结构。这个分包习惯非常重要。很多同学改代码喜欢把业务逻辑写在 controller 里图省事结果后面加个功能要重构半天。我拿到这套源码第一件事就是看它的包结构是否清晰如果 controller 里直接写 SqlSession 操作那这代码基本没法维护。而这套源码的包名结构是这样的com.campus.secondhand.controller放前端请求入口com.campus.secondhand.service下有接口和 impl 实现类com.campus.secondhand.mapper放 MyBatis 的 Mapper 接口com.campus.secondhand.entity放实体类。另外还有common或util包放公共工具类比如 MD5 加密工具、分页工具等。除了后端前端页面在webapp目录下JSP 页面按WEB-INF/views组织静态资源在static目录JS 和 CSS 分离。2.2 版本选型定好版本是避免踩坑的第一步SSM 项目对版本搭配非常敏感。我遇到过很多奇怪的问题比如org.apache.ibatis.binding.BindingException: Invalid bound statement最后发现是 MyBatis 版本和 Spring 整合包的版本不匹配。为了避免这种问题建议直接参照下面的版本组合。组件推荐版本说明JDK1.8老项目兼容性最好别用 11 跑 SSM会有模块访问问题Maven3.6.x3.6 对老插件兼容性稳定Spring5.1.x5.x 系列和 JDK8 配合完美SpringMVC5.1.x与Spring一致统一版本号省得依赖冲突MyBatis3.5.x3.5 版本之后动态 SQL 支持更完善mybatis-spring2.0.x必须与 mybatis 版本对应MySQL5.7 或 8.05.7 最省心8.0 需要改驱动类和时区参数Tomcat8.5支持 Servlet 3.1SSM 项目标准容器IDEA2021对 Maven 项目支持更友好这里特别提醒一下 MySQL 8.0 的坑驱动类从com.mysql.jdbc.Driver改成了com.mysql.cj.jdbc.Driver而且连接 URL 必须加上serverTimezoneAsia/Shanghai不然会报时区错误。如果你用 5.7就老老实实用老的驱动类别混着来。2.3 核心数据表5张表撑起整个交易系统数据库设计决定了一个系统的上限。这套校园二手交易系统的核心表有 5 张用户表t_user、商品表t_goods、订单表t_order、收藏表t_favorite、留言表t_message。每一张表都应该有设计说明不然你改起来根本不知道字段是干嘛的。先看用户表。核心字段有id、username、password、salt盐值、nickname、avatar、phone、status0禁用/1正常、create_time。密码字段存的是加盐后的 MD5 值不是明文这个后面细说。salt字段是每行独立随机生成的它的存在就是为了防止彩虹表反查。商品表字段比较多逐个说清楚。id、user_id发布者外键、title、description、price、original_price、cover_image、images多图地址分号隔开、category分类、status0下架/1在售/2已售出、view_count、create_time、update_time。特别注意status字段它是商品生命周期的核心标记。有些系统的做法是删掉商品记录但更好的设计是状态流转这样管理后台可以追踪每一件商品的历史状态。订单表结构是id、order_no唯一订单号、goods_id、seller_id、buyer_id、price、status0待付款/1已成交/2已取消、create_time、pay_time。这里要解释下order_no它不能用自增 id 代替因为要展示给用户而且后续对接打印或对账时有唯一业务号会方便得多一般用时间戳加随机数生成。收藏表就简单了id、user_id、goods_id、create_time唯一索引建在user_id goods_id上防止同一个用户重复收藏同一件商品。留言表是id、goods_id、from_user_id、to_user_id、content、create_time支撑商品详情页的问答场景。3. 核心功能模块的实现逻辑3.1 注册登录逻辑MD5加盐不是玄学登录注册是每个系统的门面但很多同学在这块写得很随意。这套源码的做法是注册时后端接收用户名和密码先判断用户名是否被占用查一次库然后生成一个随机盐值用MD5(密码 盐值)得到密文把username、密文、salt一起插入数据库。登录时根据用户名查出用户记录取到这条记录的salt把前端传过来的密码加上这个salt再做一次 MD5和库里的密文比对。为什么要加盐因为单纯 MD5 相同密码会得到相同结果攻击者可以用彩虹表反查加了随机盐值之后同样的明文密码在不同用户那里密文完全不同安全性直接上了一个台阶。在 controller 层登录成功后把用户对象放进session同时写一个拦截器Interceptor来拦截需要登录才能访问的路径。比如发布商品、查看订单、个人中心这些操作如果 session 里没有用户直接重定向到登录页。这里有个小细节要注意放行/login、/register、/goods/list、/goods/detail这些公开接口其余路径都拦下来excludePathPatterns要配置好不然静态资源 JS/CSS 也会被拦截掉页面样式全丢。3.2 商品发布与图片上传路径问题是一个大坑商品发布模块是这个系统里坑最多的环节尤其图片上传。前端页面是表单加文件选择框提交时用multipart/form-data格式。后端用 SpringMVC 的MultipartFile接收文件。这套源码的写法是把上传的图片保存到服务器的某个目录然后把访问路径存到数据库cover_image字段。关键踩坑点在于保存文件的物理路径和浏览器访问的 URL 路径是两个完全不同的概念。你存到D:/upload/路径下浏览器访问时不可能直接输入D:/upload/xxx.jpg。正确做法是配置一个虚拟路径映射把/upload/**映射到物理路径。如果用 Tomcat 部署可以在server.xml里加Context配置如果用 IDEA 的 Tomcat 插件也可以配置Deployment里的虚拟目录。还有更简单的做法把图片保存到项目部署目录webapp/upload下这样图片天然能通过域名访问但缺点是项目重新部署时图片会丢生产环境不推荐交作业图省事倒是可以。另外一个细节是文件类型校验。一定要限制只允许.jpg、.jpeg、.png、.gif格式而且要校验文件大小不然有人传一个几十 MB 的图片直接把 Tomcat 卡崩溃。上传文件后一定要重新生成文件名用时间戳加随机数不要直接使用用户上传的原始文件名防止文件名冲突和安全问题。3.3 商品列表、搜索与分页动态SQL是MyBatis的精髓商品列表页看起来简单但要做得好用还是需要动点脑筋。列表页支持按分类筛选、按关键词模糊搜索、按价格或时间排序还有分页。这些需求全部交给 MyBatis 的动态 SQL 处理。Mapper XML 里写一个select用where标签包裹动态条件。比如select idsearchGoods resultTypecom.campus.secondhand.entity.Goods SELECT * FROM t_goods where if testkeyword ! null and keyword ! AND title LIKE CONCAT(%, #{keyword}, %) /if if testcategory ! null and category ! AND category #{category} /if if teststatus ! null AND status #{status} /if /where ORDER BY create_time DESC LIMIT #{offset}, #{pageSize} /selectwhere标签会自动处理第一个条件前面的 AND这个细节能避免拼接 SQL 时的语法错误。分页的做法有两种一种是上面这种手动LIMIT需要自己算offset另一种是用 PageHelper 分页插件在 service 层调用PageHelper.startPage(pageNum, pageSize)然后紧跟着的查询会自动带上分页。这套源码用的是手动 LIMIT我认为这样更好理解也少一个依赖。但如果你敢在 SQL 里用LIMIT #{offset}, #{pageSize}一定要确认两个参数都是 Integer 类型MyBatis 不会帮你自动转换导致报错。3.4 下单流程事务管理不能省用户看到商品详情页点击立即购买这时候后端做了什么第一校验商品是否存在且状态是在售status1第二创建订单记录订单号生成规则一般是yyyyMMddHHmmss 4位随机数第三把商品状态改成已售出status2。这三个操作必须放在同一个事务里因为任何一个步骤失败都不应该留下脏数据。Spring 里实现事务非常方便在 service 方法上加上Transactional注解即可。但要注意这个注解默认只对 RuntimeException 回滚对于受检异常不会回滚。如果业务中 catch 住了异常然后吞掉事务一样不会回滚。我见过有同学在 service 方法里 try-catch把异常存到日志就完事了结果订单表插入了商品状态没改数据就出问题了。最佳实践是事务方法内不要自己 catch 异常抛给上层处理确保Transactional能感知到异常并回滚。3.5 后台管理登录拦截与CRUD管理员进入后台需要独立的后台登录入口。这套源码的做法是写一个AdminInterceptor拦截/admin/**路径检查 session 里的adminUser是否存在不存在就跳转到管理员登录页。管理员登录时除了校验密码还要校验role字段确保只有管理员角色能进后台。后台管理功能就是对商品的审核、上下架操作。审核的本质就是修改t_goods表的status字段下架改成 0通过改成 1卖出改成 2。没有单独建一张审核记录表对于课程设计来说完全够用。用户管理页面是查询t_user列表支持修改用户状态禁用/启用。这里有个小细节禁用用户的时候要考虑他名下正在售卖的商品要不要同时下架很多同学忽略了这个关联逻辑。4. 把源码跑起来从环境准备到启动上线4.1 环境准备清单拿到源码后先别急着导入 IDEA先把基础环境装好。这套系统需要的环境如下JDK 1.8必须高版本容易出兼容问题MySQL 5.7 或 8.0Maven 3.6.xTomcat 8.5IDEA社区版或专业版都行源码自带的 SQL 文件一般是sql/campus_secondhand.sql如果电脑已经有 JDK 11 或更高版本建议把 JDK 8 也装上IDEA 里单独配置这个项目的 SDK 为 JDK 8不影响其他项目。4.2 从导入到启动7个关键步骤第一步在 MySQL 里创建数据库建议把字符集设置成 utf8mb4因为用户可能发布 emoji 表情或者特殊符号utf8 会报Incorrect string value错误。比如mysql -u root -p -e CREATE DATABASE campus_secondhand DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;第二步导入数据表。用 Navicat 或者命令行执行源码里的 SQL 文件导入完成后检查一下有没有t_user、t_goods等表顺便看看数据是否完整。第三步配置 Maven 镜像。打开settings.xml把中央仓库换成阿里云镜像不然下载依赖能下到你怀疑人生mirror idaliyun/id mirrorOfcentral/mirrorOf urlhttps://maven.aliyun.com/repository/public/url /mirror第四步IDEA 导入项目。选择File - Open选中项目的pom.xmlIDEA 会识别为 Maven 项目。然后设置项目 SDK 为 JDK 8设置 Language Level 为 8。第五步修改数据库连接配置。打开src/main/resources/jdbc.properties把用户名、密码改成你自己的数据库账号注意 URL 里的数据库名要和创建的一致jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/campus_secondhand?useUnicodetruecharacterEncodingutf-8useSSLfalseserverTimezoneAsia/Shanghai jdbc.usernameroot jdbc.password123456第六步配置 Tomcat。点 IDEA 右上角Add Configuration选 Tomcat Server - Local然后在Deployment里点加号选Artifact选择war exploded类型的项目。Application context 一般设为/campus或保持根路径/这个决定了访问 URL。第七步启动项目。点运行按钮看到 Tomcat 启动日志里出现Connected to server并且没有异常打开浏览器访问http://localhost:8080/或http://localhost:8080/项目名/能看到首页就算跑起来了。4.3 容易忽略的细节缺一个细节项目就可能在启动时爆错。最常见的就是 Lombok 没装。很多 SSM 项目的实体类会用到 Lombok 的Data注解来省略 getter/setter如果你 IDEA 没装 Lombok 插件编译直接报错找不到 getter 方法。解决办法是在 IDEA 插件市场安装 Lombok并且确保Settings - Build - Compiler - Annotation Processors里勾选了Enable annotation processing。另一个常见问题是web.xml里的启动配置。SSM 项目的web.xml会配置 Spring 的监听器和 SpringMVC 的 DispatcherServlet这两者的contextConfigLocation指错了就会报ClassNotFoundException或BeanDefinitionStoreException。最好确认源码里配置文件路径和web.xml里的路径完全一致。5. 高频报错与排查技巧实录5.1 报错速查表报错现象根本原因解决方案启动 Tomcat 报端口占用8080 被其他进程占用换端口或杀掉占用进程netstat -ano查 PID数据库连接失败Access denied for user用户名密码错误或权限不对检查 jdbc.properties 配置确认 MySQL 账号可远程访问页面打开样式全丢静态资源被拦截器拦截在拦截器配置里放行/static/**、/css/**、/js/**等资源路径图片上传后页面显示 404物理路径和虚拟路径没映射好检查 Tomcat 虚拟目录配置或者上传路径配置MyBatis 报Invalid bound statementMapper 接口和 XML 的 namespace 不对应检查 XML 的 namespace 是否等于接口全限定名方法 id 是否一致数据库中文乱码连接 URL 没有指定 UTF-8 或数据库字符集不对URL 加characterEncodingutf-8并确认数据库是 utf8mb4请求参数传不过来全是 null实体类属性名与前端 name 不一致检查表单 name 与实体类字段名是否一致或是否缺 setter 方法5.2 一个印象深刻的排查案例有一次帮人调一个问题商品列表页点下一页报 500 错误控制台报的是NumberFormatException。查了半天发现是分页参数传递出了问题前端传的pageNum在 JSP 里是字符串后端直接用Integer.parseInt解析但第一页的时候有页码是空字符串一转换就崩了。后来我在 controller 里对分页参数做了默认值处理为空时默认第一页每页 10 条。这个案例说明controller 的参数校验一定要做永远不要信任前端传过来的数据一个空指针异常就够你调半小时。另一个案例是用户注册时提示用户名已存在但明明换个用户名也不行。排查发现是注册的 service 方法里查询用户是否存在的 SQL 条件写错了status字段多加了一个条件导致查询永远返回空。这类问题只能靠仔细查看日志和 SQL 排除MyBatis 控制台打印的 SQL 一定要打开日志级别看到实际执行的 SQL 才好判断哪里出了问题。5.3 二次开发可以做的扩展方向如果这套系统要作为毕设答辩的亮点只做基础 CRUD 是不够的。我建议根据你的时间情况从下面几个方向挑一两个做扩展。第一个方向是引入 Redis 做缓存。把商品分类列表和热门商品列表缓存到 Redis设置过期时间减轻数据库压力。这个扩展在答辩时说提升了系统高并发下的响应速度是加分的点。技术实现上在 service 层先查 Redis没有再查数据库并回填缓存注意删除缓存时机的设计。第二个方向是用 ECharts 给管理员后台加统计报表。统计商品总量、每日新增商品数、订单成交量用柱状图和饼图展示。从t_goods表按create_time分组统计SQL 逻辑不难主要是DATE_FORMAT函数的使用。第三个方向是引入消息通知机制。当一个商品被下单时通过站内信通知卖家。可以在订单表加一个notify_status字段在卖家登录时查询未读消息数量这个功能虽然简单但能显著提升系统的完整度。第四个方向是把密码加密升级为 BCrypt。MD5 加盐虽然比明文安全但已经被证明不够可靠。引入 Spring Security 的BCryptPasswordEncoder替换原来的加密工具类只需要动注册登录两个地方。这个改动在答辩时展示出来会让人感觉你有安全意识。6. 写在最后的经验总结这套校园二手交易系统的源码对我来说最大的价值不是它有多先进而是它足够完整。从数据库设计到前端页面从登录鉴权到文件上传一个真实 Java Web 项目该有的模块它都有了。我做技术这些年见过太多人把毕设当成应付差事复制一套代码改个标题就交上去了。但我建议你拿着源码把每一层代码走一遍尤其是从goodsList.jsp页面点击搜索到数据库返回结果这条链路你用打断点的方式跟着走一遍比看十篇博客都管用。按我的经验这套系统你完全吃透之后SSM 整合开发基本上就入门了。后续再去看 Spring Boot 的项目你会发现很多东西都是一通百通的。最后提醒一句交作业之前先把你自己的数据库账号密码、端口号这些信息改清爽别再拿 jdbc.properties 里留着别人的密码去答辩。这些细节虽然不起眼但给老师的第一印象绝对不一样。本文还有配套的精品资源点击获取