简介《校园二手交易平台》是一份基于微信小程序与SSM框架的完整实训项目套件面向计算机类毕业设计、期末大作业及需要项目实战练习的开发者。项目以校园二手物品买卖为核心覆盖从用户界面到数据处理的安全与易用设计适合作为课设参照或能力提升素材。压缩包共1433个文件大小44.16MB主要包含小程序前端wxml/wxss/js、SSM后端java/xml、管理端页面vue、数据库脚本sql以及说明文档等同时有png、jpg等设计图与svg图标结构清晰便于分类检索。目前已有65人浏览学习。除可运行源码外还附有论文报告、PPT、数据库文档和开发说明完整记录了需求分析、系统设计、数据库设计、接口设计等环节。源码均经本地编译与调试配合数据表和说明文档能帮助理解二手交易系统从业务逻辑到技术落地的全过程是较实用的毕业设计参考资料。1. 校园二手交易平台项目小程序SSM这套组合先看清再动手毕设季和课设季最常收到的就是这类压缩包标题写着“校园二手交易平台的小程序ssm”解压之后是一堆文件夹源码、论文、PPT、数据库文档、说明文档全混在一起。很多人第一反应是双击打开说明文档然后卡在环境配置上半天跑不起来。这个标题本质上是两件事一个跑在微信里的小程序前端一个用SSMSpringSpringMVCMyBatis写的Java后端中间通过JSON接口通信。它解决的是“从0到1搭一个可演示的完整系统”的问题适合正在做Java课程设计、毕业设计的人也适合想在微信小程序和后端之间打通一条真实数据链的初学者。要说清楚它值不值得做得先把这套组合拆开看。2. SSM后端与微信小程序的分工先看懂架构再动手很多同学拿到源码第一件事是点“运行”结果后端起来了小程序白屏或者小程序起来了接口报404。原因都一样没先分清两端各自管什么。小程序端只管页面渲染和用户操作它不直接连数据库所有数据都通过wx.request调后端接口拿SSM后端负责业务逻辑、权限校验、读写数据库然后把结果以JSON格式返回给小程序。这条链路是理解整个项目的钥匙。校园二手交易平台的典型流程是用户在小程序里浏览商品列表点击详情发起购买或留言小程序把请求发到后端接口后端查数据库再返回商品数据。登录、下单、我的发布、订单状态这些功能前端做展示和交互后端做校验和存储。哪个先启动、哪个后启动取决于谁依赖谁后端必须先跑起来小程序才有接口可调。2.1 微信小程序端和后端的数据通路wx.request、JSON与接口约定小程序端所有和后端的交互都走wx.request。它类似浏览器的fetch但有一些自己的限制比如域名必须备案、必须配HTTPS本地开发可以勾选“不校验合法域名”。一个标准的请求长这样// pages/index/index.js const app getApp() Page({ data: { goodsList: [] }, onLoad() { wx.request({ url: app.globalData.baseUrl /goods/list, method: GET, header: { Authorization: wx.getStorageSync(token) }, success: (res) { if (res.data.code 200) { this.setData({ goodsList: res.data.data }) } else { wx.showToast({ title: 加载失败, icon: none }) } } }) } })这段代码里的关键点有三个。url是后端接口地址baseUrl通常放在app.js的globalData里这样换环境时只改一处header里带Authorization是登录后的身份凭证后端SSM通过它判断当前用户是谁success回调里的res.data是后端返回的JSON一般会有code、message、data三个字段。后端返回的结构越统一前端处理越省事。参数说明method不写默认是GETPOST请求要对data做对象传参而不是拼接URLheader里的token如果为空登录校验接口会直接拒绝。很多项目模板里会把wx.request封装成一个request.js文件统一处理token过期、错误提示这是推荐做法别在每页都写一遍。2.2 SSM三层结构在二手交易场景里的落地形态Controller、Service、MapperSSM是三个框架的合称Spring管对象和事务SpringMVC管接口路由MyBatis管数据库读写。对应到代码里就是三层Controller层接收小程序发来的请求Service层写业务规则Mapper层操作数据库表。二手交易平台的一个商品列表接口在代码里大概长这样RestController RequestMapping(/goods) public class GoodsController { Autowired private GoodsService goodsService; GetMapping(/list) public Result list(RequestParam(defaultValue 1) Integer page, RequestParam(defaultValue 10) Integer size) { ListGoods goods goodsService.findOnSale(page, size); return Result.ok(goods); } }Controller只做三件事接收参数、调Service、包装返回结果。真正的逻辑在Service里比如查询“只返回上架中的商品、过滤掉已下架”的规则写在Service而不是Controller里。Mapper层是最后的SQL落地public interface GoodsMapper { ListGoods selectOnSale(Param(offset) int offset, Param(size) int size); }对应的XML文件里写SQL比如WHERE status 1 ORDER BY create_time DESC LIMIT #{offset}, #{size}。这样做的好处是SQL和Java代码分离改查询条件不用重新编译Java。对课程设计来说三层结构是评分点之一论文里的架构图也是按这个画。2.3 数据库文档里最该先看的四张业务表用户表、商品表、订单表、收藏表拿到数据库文档先别急着导入打开ER图看业务表。校园二手交易平台最核心的四张表是这些表名主要字段作用t_userid, openid, nickname, avatar, phone用户信息和微信openid绑定t_goodsid, user_id, title, price, image, status商品发布与上下架状态t_orderid, goods_id, buyer_id, seller_id, status交易订单与状态流转t_favoriteid, user_id, goods_id, create_time收藏夹二手场景常见用户表里的openid是微信登录的唯一凭证后端的登录接口先调微信接口换openid再在t_user里查或创建用户。商品表里的status字段很关键它决定了商品出现在“在售列表”还是“已卖出”里很多bug都出在这个字段的状态流转上。订单表同时存了buyer_id和seller_id因为二手交易里买卖双方都是普通用户不是平台管理员。收藏表是典型的关联表两个外键拼成一个唯一索引防止重复收藏。建议拿到数据库文档后先画一遍ER图再对照代码里的Mapper接口看重点确认每个表的主键策略是自增还是雪花ID。SSM课设项目大多用MySQL自增写SQL时要注意别把自增列的值手动填进去。3. 把项目和数据库跑通从解压到接口自测的完整步骤源码类项目的硬门槛永远是“跑起来”。这一章按我平时带人做课设的顺序来先把压缩包里的东西分类再导数据库、启后端、配小程序每一步做完都有验证方式不要到最后才一起排错。整个流程走完大概半小时到一小时取决于MySQL和JDK版本是否顺手。3.1 先识别压缩包里的文件源码、SQL脚本和文档各看什么解压之后一般会看到这几个目录一个Java工程目录、一个小程序目录、论文和PPT文档、数据库脚本。先建立文件清单比盲目点开任何文件都重要。文件/目录常见形态使用时机后端源码Maven工程含pom.xml导入IntelliJ编译启动小程序前端含app.js、pages目录微信开发者工具导入数据库脚本xxx.sql导入MySQL论文.docx写文档时对照代码改PPT.pptx答辩前调整说明文档.txt或.docx最先读看环境版本需求注意后端的pom.xml是判断项目类型最直接的凭证。看到packagingwar/packaging就知道要部署到Tomcat看到packagingjar/packaging才可能直接启动。校园二手交易平台这种课设项目大多是war包因为SSM时代Tomcat部署是标配。3.2 用Navicat导入数据库脚本并改JDBC连接配置数据库脚本是项目的“地基”。我一般用Navicat导入也可以用命令行。两种方式任选命令行更通用mysql -u root -p db_second_hand.sql导入完成后用Navicat看一下表是否齐全。然后打开后端的jdbc.properties或application.properties改数据库连接jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/second_hand?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai jdbc.usernameroot jdbc.password123456这里的坑主要在url参数。useSSLfalse是必须的不然MySQL 8.0会频繁警告serverTimezoneAsia/Shanghai是必须的MySQL 8.0默认时区和本地不一致会直接报错。密码改成你自己本机的密码别照抄文档里的默认值。如果XML里MyBatis配置了driver旧值com.mysql.jdbc.Driver记得换成新值否则MySQL 8.0会直接抛ClassNotFoundException。3.3 用IntelliJ导入Maven工程启动Tomcat并自测接口IntelliJ里选“Open”选中后端源码目录等Maven把依赖下载完。SSM项目一般用Tomcat 8或8.5配好Artifact后启动。如果是Maven插件方式命令行也能跑mvn tomcat7:run这个是tomcat7-maven-plugin的常见用法端口默认8080。启动日志里看到“Starting ProtocolHandler”和“Server startup in xxx ms”就算成功。然后自测接口先别急着开小程序用浏览器或curl验证后端活着curl -X GET http://localhost:8080/second_hand/goods/list?page1size10这里的second_hand是Context Path和你后端项目名一致。返回JSON里有商品数组说明后端和数据库通了。如果返回404先看Controller的RequestMapping里的路径和这里拼的是否一致这是最常见的路径不匹配坑。返回500就去看IntelliJ控制台的异常堆栈定位到具体哪一行。3.4 用微信开发者工具导入小程序端统一替换接口地址后端通了接着导小程序。微信开发者工具里选“导入项目”AppID可以选测试号。导入后第一件事是找到app.js或config.js里的baseUrl把它从文档里的示例IP改成你的本机地址// app.js globalData: { baseUrl: http://localhost:8080/second_hand }注意微信开发者工具默认要求HTTPS本地调试要在“详情-本地设置”里勾选“不校验合法域名、web-view业务域名、TLS版本以及HTTPS证书”。不勾这一项所有请求都会报request:fail url not in domain list这是新手最容易卡住的地方而且报错信息有迷惑性。改完地址后在开发者工具里点“编译”看到商品列表渲染出来说明整条链路通了。到这里“跑起来”的目标就完成了接下来才进入排查和打磨阶段。4. 论文、PPT和说明文档要怎么用把文档变成答辩素材源码包里带的论文、PPT、数据库文档不是装饰品它们决定了这个项目的“上限”。很多人的问题是代码跑通了但论文里写的功能和自己改过的代码对不上。原因很简单——拿到手的论文是原作者在另一个环境下的产物而你已经改过代码或者换了表结构。正确做法是先梳理文档结构再对照当前代码逐章修正。4.1 论文和技术实现对不上用数据库文档先对齐表结构论文第4章和第5章通常写“系统设计”和“数据库设计”里面有ER图和表结构描述。如果源码包里同时有数据库文档那先打开它对比论文里的表名、字段名和实际SQL脚本是否一致。常见的不一致有论文里表名是goodsSQL里是t_goods论文里字段是priceSQL里是gprice。这种差异答辩时老师一问一个准。我一般的做法是列一张“论文章节-代码模块对照表”论文章节对应代码位置需要核对的内容需求分析小程序pages目录页面数量、角色划分系统设计Controller类列表接口是否一一对应数据库设计sql脚本表名、字段、索引系统测试测试截图复现结果是否一致对照表的目的不是让你重写论文而是把差异标出来统一改成当前代码的实际状态。改论文里的SQL描述比重写代码省事得多。4.2 从现有代码倒推需求分析与系统设计两章课设论文最难写的两章是“需求分析”和“系统设计”因为它们看起来像“写作文”。不擅长写的人可以反过来从代码里倒推需求。先把Controller里的接口列出来比如登录接口、商品列表、发布商品、下架商品、下单、订单列表、收藏。每个接口对应一个“用户故事”把故事串起来就是需求分析。系统设计章更简单直接画图。架构图按SSM三层画展示层是微信小程序业务层是ControllerService数据层是MyBatisMySQL。时序图挑一条主链路画比如“用户登录到查看商品列表”的请求顺序。画完图再写文字描述字数基本就够了。注意别把论文写成“操作手册”。论文里写“系统分为管理员端和用户端”这种话没有意义要写“用户点击商品详情后系统根据goodsId查询t_goods表校验status为1后返回商品信息”这种和代码强相关的描述。4.3 答辩PPT的核心三张图架构图、ER图和时序图PPT页数不用多但要保证三张图清晰。第一张是系统架构图画小程序端、后端SSM、数据库三层标出接口协议是JSON第二张是数据库ER图把四张核心表的关联画出来尤其是订单表和商品表、用户表的关系第三张是功能模块图或时序图选一个完整流程比如“发布商品-管理员审核-商品上架-用户下单”画出状态和接口调用的顺序。答辩老师最常问的三个问题分别是为什么选微信小程序而不是App、SSM相比Servlet好在哪、数据库为什么这样设计。PPT里给每张图配两三句说明其余内容放在讲稿里背熟。每页PPT的正文别超过五行字图旁边留白这是最稳妥的格式。4.4 说明文档里的环境信息JDK、MySQL、Tomcat版本别忽略说明文档往往放在压缩包最外层容易被忽略但它是最值钱的文件。里面一般写着开发环境版本、部署步骤和初始账号。先确认三件事JDK是1.7还是1.8这决定你能不能直接跑Maven编译MySQL是5.7还是8.0这决定JDBC连接串和驱动jarTomcat是8还是9这决定servlet-api版本兼容性。这三处版本直接决定你的“跑不起来”成本。举例来说JDK 1.8编译的代码放到JDK 1.7会报UnsupportedClassVersionErrorMySQL 8.0用老驱动连不上Tomcat 9对javax.servlet包名兼容性有差异。拿到项目后先把说明文档里的版本记在本子上再对照本地已装的环境不一致的部分能改环境就改环境不能改再改代码配置。5. 小程序SSM跑通之后的排查日志5个高频翻车现场前后端联调阶段的问题千奇百怪但校园二手交易平台这类项目的问题高度集中。这里记录5个最常见的翻车现场每一条都有现象、原因和解决路径排查时按这个顺序走能省不少时间。5.1 商品列表空白但后端接口正常现象后端用curl访问能返回JSON数据库里也有数据但小程序页面一直白屏或显示加载失败。打开调试器Network面板请求是pending或者报request:fail。原因最常见是微信开发者工具没有勾选“不校验合法域名”小程序默认拦截所有HTTP非HTTPS请求。第二种可能是baseUrl写错了比如后端Context Path是second_hand前端拼成了secondhand。解决在“详情-本地设置”勾选跳过域名校验然后检查app.js里的baseUrl和请求拼接路径。建议在Page的onLoad里先console.log一下完整url确认拼出来的字符串能在浏览器直接打开。5.2 登录接口总是返回401或token失效现象登录后能拿到token但过一会儿再操作就报401或者登录接口本身就一直提示“凭证无效”。来回改代码没用像是玄学。原因这类项目的token一般是一个UUID存数据库或Redis服务端设置有效期常见是30分钟或2小时。如果代码里同时存在两个登录入口一个生成新token另一个还在校验旧token就会出现时而有效时而失效。数据库里的token字段长度不够也是常见原因UUID存进去被截断校验时永远对不上。解决先打开数据库看t_user表里的token字段长度改成varchar(64)再检查后端登录接口是不是每次登录都刷新token刷新后老token在哪里失效。课程设计阶段最简单可靠的方案是token里直接存userId不加过期时间答辩前再把过期逻辑补上。5.3 发布商品时图片上传失败现象填完商品信息点“提交”文字字段能保存但图片要么显示上传中要么提交后详情页图片裂了。后端控制台偶尔报MultipartException。原因SSM项目的文件上传依赖CommonsMultipartResolver配置文件里漏配或bean的id写错都会导致上传接口直接报错。另一种情况是图片保存到了Tomcat部署目录下的临时文件夹重启Tomcat后图片全没了。解决检查spring-mvc.xml里的multipartResolver配置maxUploadSize一般设2MB或5MB编码统一UTF-8把图片存储路径改成Tomcat之外的绝对路径比如D:/upload/再给Tomcat配置虚拟目录映射。这样重启服务图片还在答辩演示时不至于翻车。5.4 数据库脚本导入报错utf8mb4和MySQL 8.0的兼容问题现象用Navicat导入SQL脚本时报错错误信息是Unknown collation: utf8mb4_0900_ai_ci或者Duplicate column name。多发生在脚本不是原作者的而是从5.7迁移到8.0时倒出来的。原因MySQL 8.0默认字符集是utf8mb4默认排序规则是utf8mb4_0900_ai_ciMySQL 5.7不认这个排序规则倒过来5.7的脚本导入8.0也可能因为utf8_general_ci没兼容而报错。脚本里还可能有重复的CREATE TABLE语句没做IF NOT EXISTS保护。解决用文本编辑器打开SQL脚本把utf8mb4_0900_ai_ci替换成utf8mb4_general_ci再把所有CREATE TABLE改成CREATE TABLE IF NOT EXISTS。导入前先确认目标数据库的字符集是utf8mb4避免表建好了中文显示成问号。5.5 改完后端代码小程序里还显示旧数据现象Controller里改了返回逻辑重启了Tomcat小程序重新编译但页面上还是旧数据。清缓存、关掉重开都没用特别像“没部署成功”。原因微信开发者工具默认会缓存接口响应wx.request的success回调如果没做处理会直接拿缓存数据渲染另外Tomcat的war热部署有时没生效改的是target里重新编译的class但Tomcat加载的还是旧的。解决先确认接口到底改了没浏览器直接访问后端接口看返回再确认小程序的wx.request有没有设置cache: false最后看开发者工具Network面板的请求是不是走了from cache。如果是这样把模拟器的“清除缓存”点一遍再重新编译。后端侧最简单粗暴但有效的方法是重启Tomcat而不是热部署等百分百生效再继续改。6. 把课程设计变成可演示的项目验证与上线前的准备跑通只是开始答辩和简历上能站住脚才算做完。最后一步做两件事一次完整的真机验证以及一个可以对外演示的部署方案。真机验证的目的不是图新鲜而是模拟器和真机在屏幕尺寸、网络环境上的差异会让布局和加载问题现出原形。在开发者工具里点“预览”会生成一个二维码用手机扫码就能在真机里打开。重点测三件事登录流程是否顺滑、发布商品时相册选图是否正常、订单状态变化后页面是否刷新。我踩过最大的坑是图片上传后详情页不刷新后来发现是发布成功的回调里只关了loading没重新调详情接口。改成在success回调里主动刷新就正常了。如果你想把项目放到云服务器上注意小程序正式版要求后端域名必须备案且支持HTTPS本地IP地址只在开发版里能用。把Tomcat配好HTTPS证书再把小程序里baseUrl从http换成https才算走完上线前的最后一步。这个环节别临时抱佛脚证书申请和备案流程都耗时。这套SSM小程序的组合虽然不算新但对你理解前后端分离和接口设计很有帮助。我当年把商品列表的请求从每次都查数据库改成加了一层缓存论文里多写了一节“性能优化”答辩时老师恰好问的就是这个。技术可以旧但你要有能力在里面找到一个可以讲清楚的点把它做扎实。希望这些经验帮你在同样的路上少走几步把项目从“能跑”做成“能讲”。本文还有配套的精品资源点击获取 校园二手交易平台小程序+SSM开发：从架构到排坑全指南
简介《校园二手交易平台》是一份基于微信小程序与SSM框架的完整实训项目套件面向计算机类毕业设计、期末大作业及需要项目实战练习的开发者。项目以校园二手物品买卖为核心覆盖从用户界面到数据处理的安全与易用设计适合作为课设参照或能力提升素材。压缩包共1433个文件大小44.16MB主要包含小程序前端wxml/wxss/js、SSM后端java/xml、管理端页面vue、数据库脚本sql以及说明文档等同时有png、jpg等设计图与svg图标结构清晰便于分类检索。目前已有65人浏览学习。除可运行源码外还附有论文报告、PPT、数据库文档和开发说明完整记录了需求分析、系统设计、数据库设计、接口设计等环节。源码均经本地编译与调试配合数据表和说明文档能帮助理解二手交易系统从业务逻辑到技术落地的全过程是较实用的毕业设计参考资料。1. 校园二手交易平台项目小程序SSM这套组合先看清再动手毕设季和课设季最常收到的就是这类压缩包标题写着“校园二手交易平台的小程序ssm”解压之后是一堆文件夹源码、论文、PPT、数据库文档、说明文档全混在一起。很多人第一反应是双击打开说明文档然后卡在环境配置上半天跑不起来。这个标题本质上是两件事一个跑在微信里的小程序前端一个用SSMSpringSpringMVCMyBatis写的Java后端中间通过JSON接口通信。它解决的是“从0到1搭一个可演示的完整系统”的问题适合正在做Java课程设计、毕业设计的人也适合想在微信小程序和后端之间打通一条真实数据链的初学者。要说清楚它值不值得做得先把这套组合拆开看。2. SSM后端与微信小程序的分工先看懂架构再动手很多同学拿到源码第一件事是点“运行”结果后端起来了小程序白屏或者小程序起来了接口报404。原因都一样没先分清两端各自管什么。小程序端只管页面渲染和用户操作它不直接连数据库所有数据都通过wx.request调后端接口拿SSM后端负责业务逻辑、权限校验、读写数据库然后把结果以JSON格式返回给小程序。这条链路是理解整个项目的钥匙。校园二手交易平台的典型流程是用户在小程序里浏览商品列表点击详情发起购买或留言小程序把请求发到后端接口后端查数据库再返回商品数据。登录、下单、我的发布、订单状态这些功能前端做展示和交互后端做校验和存储。哪个先启动、哪个后启动取决于谁依赖谁后端必须先跑起来小程序才有接口可调。2.1 微信小程序端和后端的数据通路wx.request、JSON与接口约定小程序端所有和后端的交互都走wx.request。它类似浏览器的fetch但有一些自己的限制比如域名必须备案、必须配HTTPS本地开发可以勾选“不校验合法域名”。一个标准的请求长这样// pages/index/index.js const app getApp() Page({ data: { goodsList: [] }, onLoad() { wx.request({ url: app.globalData.baseUrl /goods/list, method: GET, header: { Authorization: wx.getStorageSync(token) }, success: (res) { if (res.data.code 200) { this.setData({ goodsList: res.data.data }) } else { wx.showToast({ title: 加载失败, icon: none }) } } }) } })这段代码里的关键点有三个。url是后端接口地址baseUrl通常放在app.js的globalData里这样换环境时只改一处header里带Authorization是登录后的身份凭证后端SSM通过它判断当前用户是谁success回调里的res.data是后端返回的JSON一般会有code、message、data三个字段。后端返回的结构越统一前端处理越省事。参数说明method不写默认是GETPOST请求要对data做对象传参而不是拼接URLheader里的token如果为空登录校验接口会直接拒绝。很多项目模板里会把wx.request封装成一个request.js文件统一处理token过期、错误提示这是推荐做法别在每页都写一遍。2.2 SSM三层结构在二手交易场景里的落地形态Controller、Service、MapperSSM是三个框架的合称Spring管对象和事务SpringMVC管接口路由MyBatis管数据库读写。对应到代码里就是三层Controller层接收小程序发来的请求Service层写业务规则Mapper层操作数据库表。二手交易平台的一个商品列表接口在代码里大概长这样RestController RequestMapping(/goods) public class GoodsController { Autowired private GoodsService goodsService; GetMapping(/list) public Result list(RequestParam(defaultValue 1) Integer page, RequestParam(defaultValue 10) Integer size) { ListGoods goods goodsService.findOnSale(page, size); return Result.ok(goods); } }Controller只做三件事接收参数、调Service、包装返回结果。真正的逻辑在Service里比如查询“只返回上架中的商品、过滤掉已下架”的规则写在Service而不是Controller里。Mapper层是最后的SQL落地public interface GoodsMapper { ListGoods selectOnSale(Param(offset) int offset, Param(size) int size); }对应的XML文件里写SQL比如WHERE status 1 ORDER BY create_time DESC LIMIT #{offset}, #{size}。这样做的好处是SQL和Java代码分离改查询条件不用重新编译Java。对课程设计来说三层结构是评分点之一论文里的架构图也是按这个画。2.3 数据库文档里最该先看的四张业务表用户表、商品表、订单表、收藏表拿到数据库文档先别急着导入打开ER图看业务表。校园二手交易平台最核心的四张表是这些表名主要字段作用t_userid, openid, nickname, avatar, phone用户信息和微信openid绑定t_goodsid, user_id, title, price, image, status商品发布与上下架状态t_orderid, goods_id, buyer_id, seller_id, status交易订单与状态流转t_favoriteid, user_id, goods_id, create_time收藏夹二手场景常见用户表里的openid是微信登录的唯一凭证后端的登录接口先调微信接口换openid再在t_user里查或创建用户。商品表里的status字段很关键它决定了商品出现在“在售列表”还是“已卖出”里很多bug都出在这个字段的状态流转上。订单表同时存了buyer_id和seller_id因为二手交易里买卖双方都是普通用户不是平台管理员。收藏表是典型的关联表两个外键拼成一个唯一索引防止重复收藏。建议拿到数据库文档后先画一遍ER图再对照代码里的Mapper接口看重点确认每个表的主键策略是自增还是雪花ID。SSM课设项目大多用MySQL自增写SQL时要注意别把自增列的值手动填进去。3. 把项目和数据库跑通从解压到接口自测的完整步骤源码类项目的硬门槛永远是“跑起来”。这一章按我平时带人做课设的顺序来先把压缩包里的东西分类再导数据库、启后端、配小程序每一步做完都有验证方式不要到最后才一起排错。整个流程走完大概半小时到一小时取决于MySQL和JDK版本是否顺手。3.1 先识别压缩包里的文件源码、SQL脚本和文档各看什么解压之后一般会看到这几个目录一个Java工程目录、一个小程序目录、论文和PPT文档、数据库脚本。先建立文件清单比盲目点开任何文件都重要。文件/目录常见形态使用时机后端源码Maven工程含pom.xml导入IntelliJ编译启动小程序前端含app.js、pages目录微信开发者工具导入数据库脚本xxx.sql导入MySQL论文.docx写文档时对照代码改PPT.pptx答辩前调整说明文档.txt或.docx最先读看环境版本需求注意后端的pom.xml是判断项目类型最直接的凭证。看到packagingwar/packaging就知道要部署到Tomcat看到packagingjar/packaging才可能直接启动。校园二手交易平台这种课设项目大多是war包因为SSM时代Tomcat部署是标配。3.2 用Navicat导入数据库脚本并改JDBC连接配置数据库脚本是项目的“地基”。我一般用Navicat导入也可以用命令行。两种方式任选命令行更通用mysql -u root -p db_second_hand.sql导入完成后用Navicat看一下表是否齐全。然后打开后端的jdbc.properties或application.properties改数据库连接jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/second_hand?useUnicodetruecharacterEncodingutf8useSSLfalseserverTimezoneAsia/Shanghai jdbc.usernameroot jdbc.password123456这里的坑主要在url参数。useSSLfalse是必须的不然MySQL 8.0会频繁警告serverTimezoneAsia/Shanghai是必须的MySQL 8.0默认时区和本地不一致会直接报错。密码改成你自己本机的密码别照抄文档里的默认值。如果XML里MyBatis配置了driver旧值com.mysql.jdbc.Driver记得换成新值否则MySQL 8.0会直接抛ClassNotFoundException。3.3 用IntelliJ导入Maven工程启动Tomcat并自测接口IntelliJ里选“Open”选中后端源码目录等Maven把依赖下载完。SSM项目一般用Tomcat 8或8.5配好Artifact后启动。如果是Maven插件方式命令行也能跑mvn tomcat7:run这个是tomcat7-maven-plugin的常见用法端口默认8080。启动日志里看到“Starting ProtocolHandler”和“Server startup in xxx ms”就算成功。然后自测接口先别急着开小程序用浏览器或curl验证后端活着curl -X GET http://localhost:8080/second_hand/goods/list?page1size10这里的second_hand是Context Path和你后端项目名一致。返回JSON里有商品数组说明后端和数据库通了。如果返回404先看Controller的RequestMapping里的路径和这里拼的是否一致这是最常见的路径不匹配坑。返回500就去看IntelliJ控制台的异常堆栈定位到具体哪一行。3.4 用微信开发者工具导入小程序端统一替换接口地址后端通了接着导小程序。微信开发者工具里选“导入项目”AppID可以选测试号。导入后第一件事是找到app.js或config.js里的baseUrl把它从文档里的示例IP改成你的本机地址// app.js globalData: { baseUrl: http://localhost:8080/second_hand }注意微信开发者工具默认要求HTTPS本地调试要在“详情-本地设置”里勾选“不校验合法域名、web-view业务域名、TLS版本以及HTTPS证书”。不勾这一项所有请求都会报request:fail url not in domain list这是新手最容易卡住的地方而且报错信息有迷惑性。改完地址后在开发者工具里点“编译”看到商品列表渲染出来说明整条链路通了。到这里“跑起来”的目标就完成了接下来才进入排查和打磨阶段。4. 论文、PPT和说明文档要怎么用把文档变成答辩素材源码包里带的论文、PPT、数据库文档不是装饰品它们决定了这个项目的“上限”。很多人的问题是代码跑通了但论文里写的功能和自己改过的代码对不上。原因很简单——拿到手的论文是原作者在另一个环境下的产物而你已经改过代码或者换了表结构。正确做法是先梳理文档结构再对照当前代码逐章修正。4.1 论文和技术实现对不上用数据库文档先对齐表结构论文第4章和第5章通常写“系统设计”和“数据库设计”里面有ER图和表结构描述。如果源码包里同时有数据库文档那先打开它对比论文里的表名、字段名和实际SQL脚本是否一致。常见的不一致有论文里表名是goodsSQL里是t_goods论文里字段是priceSQL里是gprice。这种差异答辩时老师一问一个准。我一般的做法是列一张“论文章节-代码模块对照表”论文章节对应代码位置需要核对的内容需求分析小程序pages目录页面数量、角色划分系统设计Controller类列表接口是否一一对应数据库设计sql脚本表名、字段、索引系统测试测试截图复现结果是否一致对照表的目的不是让你重写论文而是把差异标出来统一改成当前代码的实际状态。改论文里的SQL描述比重写代码省事得多。4.2 从现有代码倒推需求分析与系统设计两章课设论文最难写的两章是“需求分析”和“系统设计”因为它们看起来像“写作文”。不擅长写的人可以反过来从代码里倒推需求。先把Controller里的接口列出来比如登录接口、商品列表、发布商品、下架商品、下单、订单列表、收藏。每个接口对应一个“用户故事”把故事串起来就是需求分析。系统设计章更简单直接画图。架构图按SSM三层画展示层是微信小程序业务层是ControllerService数据层是MyBatisMySQL。时序图挑一条主链路画比如“用户登录到查看商品列表”的请求顺序。画完图再写文字描述字数基本就够了。注意别把论文写成“操作手册”。论文里写“系统分为管理员端和用户端”这种话没有意义要写“用户点击商品详情后系统根据goodsId查询t_goods表校验status为1后返回商品信息”这种和代码强相关的描述。4.3 答辩PPT的核心三张图架构图、ER图和时序图PPT页数不用多但要保证三张图清晰。第一张是系统架构图画小程序端、后端SSM、数据库三层标出接口协议是JSON第二张是数据库ER图把四张核心表的关联画出来尤其是订单表和商品表、用户表的关系第三张是功能模块图或时序图选一个完整流程比如“发布商品-管理员审核-商品上架-用户下单”画出状态和接口调用的顺序。答辩老师最常问的三个问题分别是为什么选微信小程序而不是App、SSM相比Servlet好在哪、数据库为什么这样设计。PPT里给每张图配两三句说明其余内容放在讲稿里背熟。每页PPT的正文别超过五行字图旁边留白这是最稳妥的格式。4.4 说明文档里的环境信息JDK、MySQL、Tomcat版本别忽略说明文档往往放在压缩包最外层容易被忽略但它是最值钱的文件。里面一般写着开发环境版本、部署步骤和初始账号。先确认三件事JDK是1.7还是1.8这决定你能不能直接跑Maven编译MySQL是5.7还是8.0这决定JDBC连接串和驱动jarTomcat是8还是9这决定servlet-api版本兼容性。这三处版本直接决定你的“跑不起来”成本。举例来说JDK 1.8编译的代码放到JDK 1.7会报UnsupportedClassVersionErrorMySQL 8.0用老驱动连不上Tomcat 9对javax.servlet包名兼容性有差异。拿到项目后先把说明文档里的版本记在本子上再对照本地已装的环境不一致的部分能改环境就改环境不能改再改代码配置。5. 小程序SSM跑通之后的排查日志5个高频翻车现场前后端联调阶段的问题千奇百怪但校园二手交易平台这类项目的问题高度集中。这里记录5个最常见的翻车现场每一条都有现象、原因和解决路径排查时按这个顺序走能省不少时间。5.1 商品列表空白但后端接口正常现象后端用curl访问能返回JSON数据库里也有数据但小程序页面一直白屏或显示加载失败。打开调试器Network面板请求是pending或者报request:fail。原因最常见是微信开发者工具没有勾选“不校验合法域名”小程序默认拦截所有HTTP非HTTPS请求。第二种可能是baseUrl写错了比如后端Context Path是second_hand前端拼成了secondhand。解决在“详情-本地设置”勾选跳过域名校验然后检查app.js里的baseUrl和请求拼接路径。建议在Page的onLoad里先console.log一下完整url确认拼出来的字符串能在浏览器直接打开。5.2 登录接口总是返回401或token失效现象登录后能拿到token但过一会儿再操作就报401或者登录接口本身就一直提示“凭证无效”。来回改代码没用像是玄学。原因这类项目的token一般是一个UUID存数据库或Redis服务端设置有效期常见是30分钟或2小时。如果代码里同时存在两个登录入口一个生成新token另一个还在校验旧token就会出现时而有效时而失效。数据库里的token字段长度不够也是常见原因UUID存进去被截断校验时永远对不上。解决先打开数据库看t_user表里的token字段长度改成varchar(64)再检查后端登录接口是不是每次登录都刷新token刷新后老token在哪里失效。课程设计阶段最简单可靠的方案是token里直接存userId不加过期时间答辩前再把过期逻辑补上。5.3 发布商品时图片上传失败现象填完商品信息点“提交”文字字段能保存但图片要么显示上传中要么提交后详情页图片裂了。后端控制台偶尔报MultipartException。原因SSM项目的文件上传依赖CommonsMultipartResolver配置文件里漏配或bean的id写错都会导致上传接口直接报错。另一种情况是图片保存到了Tomcat部署目录下的临时文件夹重启Tomcat后图片全没了。解决检查spring-mvc.xml里的multipartResolver配置maxUploadSize一般设2MB或5MB编码统一UTF-8把图片存储路径改成Tomcat之外的绝对路径比如D:/upload/再给Tomcat配置虚拟目录映射。这样重启服务图片还在答辩演示时不至于翻车。5.4 数据库脚本导入报错utf8mb4和MySQL 8.0的兼容问题现象用Navicat导入SQL脚本时报错错误信息是Unknown collation: utf8mb4_0900_ai_ci或者Duplicate column name。多发生在脚本不是原作者的而是从5.7迁移到8.0时倒出来的。原因MySQL 8.0默认字符集是utf8mb4默认排序规则是utf8mb4_0900_ai_ciMySQL 5.7不认这个排序规则倒过来5.7的脚本导入8.0也可能因为utf8_general_ci没兼容而报错。脚本里还可能有重复的CREATE TABLE语句没做IF NOT EXISTS保护。解决用文本编辑器打开SQL脚本把utf8mb4_0900_ai_ci替换成utf8mb4_general_ci再把所有CREATE TABLE改成CREATE TABLE IF NOT EXISTS。导入前先确认目标数据库的字符集是utf8mb4避免表建好了中文显示成问号。5.5 改完后端代码小程序里还显示旧数据现象Controller里改了返回逻辑重启了Tomcat小程序重新编译但页面上还是旧数据。清缓存、关掉重开都没用特别像“没部署成功”。原因微信开发者工具默认会缓存接口响应wx.request的success回调如果没做处理会直接拿缓存数据渲染另外Tomcat的war热部署有时没生效改的是target里重新编译的class但Tomcat加载的还是旧的。解决先确认接口到底改了没浏览器直接访问后端接口看返回再确认小程序的wx.request有没有设置cache: false最后看开发者工具Network面板的请求是不是走了from cache。如果是这样把模拟器的“清除缓存”点一遍再重新编译。后端侧最简单粗暴但有效的方法是重启Tomcat而不是热部署等百分百生效再继续改。6. 把课程设计变成可演示的项目验证与上线前的准备跑通只是开始答辩和简历上能站住脚才算做完。最后一步做两件事一次完整的真机验证以及一个可以对外演示的部署方案。真机验证的目的不是图新鲜而是模拟器和真机在屏幕尺寸、网络环境上的差异会让布局和加载问题现出原形。在开发者工具里点“预览”会生成一个二维码用手机扫码就能在真机里打开。重点测三件事登录流程是否顺滑、发布商品时相册选图是否正常、订单状态变化后页面是否刷新。我踩过最大的坑是图片上传后详情页不刷新后来发现是发布成功的回调里只关了loading没重新调详情接口。改成在success回调里主动刷新就正常了。如果你想把项目放到云服务器上注意小程序正式版要求后端域名必须备案且支持HTTPS本地IP地址只在开发版里能用。把Tomcat配好HTTPS证书再把小程序里baseUrl从http换成https才算走完上线前的最后一步。这个环节别临时抱佛脚证书申请和备案流程都耗时。这套SSM小程序的组合虽然不算新但对你理解前后端分离和接口设计很有帮助。我当年把商品列表的请求从每次都查数据库改成加了一层缓存论文里多写了一节“性能优化”答辩时老师恰好问的就是这个。技术可以旧但你要有能力在里面找到一个可以讲清楚的点把它做扎实。希望这些经验帮你在同样的路上少走几步把项目从“能跑”做成“能讲”。本文还有配套的精品资源点击获取