SSM+微信小程序校园二手交易系统开发实战

简介：本资源是一套高分通过的Java毕业设计项目，面向计算机相关专业本科生、研究生及初入职场的开发者，聚焦校园场景下的二手物品流转需求，提供完整的SSM后端+微信小程序前端一体化解决方案。压缩包共22.98MB，含可直接运行的源码、MySQL数据库脚本及详细使用文档，涵盖用户管理、商品发布、在线浏览、订单交易、消息通知等核心模块，代码经本地编译与功能测试验证，答辩评审分达95分，内容由助教审定，难度适中且扩展性强。目前已有63人学习下载，适合用作毕业设计参考、课程设计原型、实训项目演示或小白进阶学习范例；读者可快速部署运行，理解前后端协同逻辑，掌握微信小程序对接Java Web服务的关键实践，并基于现有结构灵活拓展如信用评价、即时通讯等新功能。

1. 为什么校园二手交易系统成了Java毕业设计的“稳拿高分题”？——SSM+微信小程序组合如何把真实需求拆解成可交付模块

校园里每到毕业季，宿舍楼道堆满闲置教材、耳机、小电锅；开学初又涌出大量求购二手自行车、台灯、考研笔记的群消息。这类高频、低客单、强地域性的流转需求，天然适合做成轻量级Web+小程序双端系统——既避开电商大厂的复杂风控与支付链路，又能覆盖“登录即用、扫码即看、校内自提”的闭环场景。而SSM（Spring+SpringMVC+MyBatis）作为高校Java课程体系里讲得最透、资料最全、调试最友好的后端栈，配合微信小程序无需安装、即用即走的前端形态，构成了毕业设计中技术可控、业务清晰、答辩有话说、代码能跑通、文档好填充的黄金组合。它不是炫技型项目，而是典型的“用成熟技术解决具体场景问题”的工程实践：数据库要设计好用户-商品-订单-评价四张核心表的关联约束，后端接口要兼顾小程序wx.request的RESTful习惯和SSM的Controller层规范，前端页面要适配校园场景下的图片压缩、地理位置授权、校内通知推送等细节。如果你正卡在选题、开题或中期调试阶段，这篇笔记就是按真实开发节奏拆解的“防翻车指南”——不讲原理图，只告诉你每个模块怎么建、参数怎么填、日志怎么看、哪里最容易报错。

2. 从零初始化SSM后端：Maven依赖、MyBatis配置与Controller层骨架搭建

2.1 创建Maven Web项目并引入SSM核心依赖（含版本锁定逻辑）

新建Maven项目时，务必选择maven-archetype-webapp模板，避免使用IDE自动创建的Spring Boot项目（本项目明确要求SSM传统三层架构）。关键在于pom.xml中对Spring、MyBatis、MySQL驱动等依赖的版本协同——Spring 5.3.x与MyBatis 3.4.x是当前高校环境兼容性最好的组合，过高版本会因JDK版本限制（多数教学机仍为JDK 8）导致编译失败。

<!-- pom.xml 核心依赖片段 --> <properties> <spring.version>5.3.31</spring.version> <mybatis.version>3.4.6</mybatis.version> <mysql.version>8.0.28</mysql.version> </properties> <dependencies> <!-- Spring核心 --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-context</artifactId> <version>${spring.version}</version> </dependency> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-webmvc</artifactId> <version>${spring.version}</version> </dependency> <!-- MyBatis整合 --> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis-spring</artifactId> <version>1.3.2</version> </dependency> <!-- MySQL驱动（注意8.0+需加cj后缀） --> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>${mysql.version}</version> <scope>runtime</scope> </dependency> <!-- JSP支持（用于后台管理页，非必须但便于调试） --> <dependency> <groupId>javax.servlet</groupId> <artifactId>jstl</artifactId> <version>1.2</version> </dependency> </dependencies>

提示：mysql-connector-java必须用8.0.x版本并带cj标识，否则连接URL中serverTimezone=GMT%2B8参数无效，启动时抛java.sql.SQLException: The server time zone value '...' is unrecognized。这是新手第一道墙，别在数据库连不上时怀疑自己写错了密码。

2.2 配置MyBatis核心文件：SqlMapConfig.xml与Mapper扫描逻辑

SSM中MyBatis的配置分两层：全局配置SqlMapConfig.xml定义数据源、事务、类型别名；Mapper XML文件（如UserMapper.xml）写SQL。重点在于<mappers>标签的路径写法——必须用classpath:前缀指向resources/mapper/目录，而非相对路径或file:协议，否则Spring容器启动时报Invalid bound statement (not found)。

<!-- src/main/resources/SqlMapConfig.xml --> <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd"> <configuration> <typeAliases> <package name="com.example.entity"/> </typeAliases> <environments default="development"> <environment id="development"> <transactionManager type="JDBC"/> <dataSource type="POOLED"> <property name="driver" value="com.mysql.cj.jdbc.Driver"/> <property name="url" value="jdbc:mysql://localhost:3306/campus_market?useSSL=false&amp;serverTimezone=GMT%2B8&amp;characterEncoding=utf8"/> <property name="username" value="root"/> <property name="password" value="123456"/> </dataSource> </environment> </environments> <mappers> <!-- 关键：必须用classpath:且路径与实际文件位置严格一致 --> <mapper resource="mapper/UserMapper.xml"/> <mapper resource="mapper/GoodsMapper.xml"/> <mapper resource="mapper/OrderMapper.xml"/> </mappers> </configuration>

2.3 编写第一个RESTful Controller：处理小程序端商品列表请求

微信小程序调用后端接口时，习惯用GET传参（如/api/goods/list?page=1&size=10），因此Controller方法需用@RequestParam接收分页参数，并返回JSON格式数据。这里不推荐直接返回List<Goods>，而应封装为统一响应体ResultVO，方便小程序端统一处理code和data字段。

// com.example.controller.GoodsController.java @RestController @RequestMapping("/api/goods") public class GoodsController { @Autowired private GoodsService goodsService; /** * 小程序端获取商品列表（支持关键词搜索、分类筛选） * 注意：page和size必须设默认值，否则小程序未传参时会400错误 */ @GetMapping("/list") public ResultVO list( @RequestParam(defaultValue = "1") Integer page, @RequestParam(defaultValue = "10") Integer size, @RequestParam(required = false) String keyword, @RequestParam(required = false) Integer categoryId) { PageHelper.startPage(page, size); // 使用PageHelper插件实现物理分页 List<Goods> goodsList = goodsService.selectList(keyword, categoryId); PageInfo<Goods> pageInfo = new PageInfo<>(goodsList); return ResultVO.success(pageInfo); } }

逻辑说明：@RequestParam(defaultValue = "1")是血泪经验——小程序wx.request若未显式传page参数，后端不设默认值会直接返回400 Bad Request，而不是进入方法体。PageHelper.startPage()必须在service查询语句之前调用，且PageInfo对象包含total、pages等分页元数据，小程序可据此渲染页码栏。ResultVO.success()是自定义的响应工具类，内部固定结构为{"code":200,"msg":"success","data":{...}}，避免小程序端反复解析不同接口的JSON结构。

3. 微信小程序端对接：登录态维护、商品列表渲染与图片上传规范

3.1 小程序登录态与后端Session绑定：wx.login + 自定义token方案

微信小程序不支持传统Cookie，因此不能直接复用SSM的HttpSession。常见做法是：小程序调用wx.login()获取临时code，传给后端/api/user/login接口；后端用该code向微信服务器换取openid，生成自定义token（如JWT）返回给小程序，后续所有请求在Header中携带Authorization: Bearer xxx。此方案比直接存openid更安全，且便于扩展权限字段。

// pages/index/index.js 小程序首页onLoad中触发登录 onLoad() { wx.login({ success: res => { // 1. 将code发给后端 wx.request({ url: 'https://your-domain.com/api/user/login', method: 'POST', data: { code: res.code }, success: loginRes => { const token = loginRes.data.data.token; // 2. 存入本地缓存，后续请求自动携带 wx.setStorageSync('auth_token', token); this.loadGoodsList(); // 加载商品 } }); } }); }

后端对应Controller需调用微信接口：

// com.example.controller.UserController.java @PostMapping("/login") public ResultVO login(@RequestBody Map<String, String> params) { String code = params.get("code"); // 调用微信接口换取openid（需配置AppID/AppSecret） String url = "https://api.weixin.qq.com/sns/jscode2session?" + "appid=wx1234567890&secret=your_secret&js_code=" + code + "&grant_type=authorization_code"; String response = HttpUtil.get(url); // 使用Apache HttpClient或OkHttp JSONObject json = JSON.parseObject(response); String openid = json.getString("openid"); // 生成JWT token（此处简化，实际应含过期时间、签名） String token = JWT.create() .withClaim("openid", openid) .sign(Algorithm.HMAC256("your_secret_key")); return ResultVO.success(Map.of("token", token)); }

注意：AppID和AppSecret必须从微信公众平台后台获取，切勿硬编码在前端或Git仓库中。测试阶段可用wx1234567890占位，但部署前必须替换。

3.2 商品列表页WXML结构与图片加载优化策略

校园二手商品图多为手机实拍，原始尺寸大、网络差时加载慢。小程序端必须做两件事：1）WXML中<image>标签设置mode="aspectFill"避免拉伸变形；2）后端接口返回的图片URL需指向已压缩的缩略图（如/upload/thumbnail/xxx.jpg），而非原图路径。

<!-- pages/goods/list.wxml --> <view class="goods-list"> <block wx:for="{{goodsList}}" wx:key="id"> <navigator url="/pages/goods/detail?id={{item.id}}" class="goods-item"> <image src="{{item.thumbnailUrl}}" mode="aspectFill" class="goods-img"/> <view class="goods-info"> <text class="goods-title">{{item.title}}</text> <text class="goods-price">¥{{item.price}}</text> <text class="goods-location">{{item.location}}</text> </view> </navigator> </block> </view>

关键点：thumbnailUrl字段由后端在查询商品时拼接，例如/upload/thumbnail/+goods.getImageName()。实际部署时，/upload/目录需配置Nginx静态资源映射，避免经过Tomcat Servlet处理，提升图片访问速度。

3.3 小程序端图片上传至后端：wx.chooseImage + wx.uploadFile全流程

二手交易核心动作是发布商品，必然涉及图片上传。小程序调用wx.chooseImage()选图后，必须用wx.uploadFile()上传至后端/api/upload接口，后端用MultipartFile接收并保存到服务器指定目录（如/var/www/upload/）。

// pages/goods/publish.js chooseImage() { wx.chooseImage({ count: 3, // 最多3张 sizeType: ['compressed'], // 必须压缩，否则超2MB限制 sourceType: ['album', 'camera'], success: res => { this.setData({ tempImages: res.tempFilePaths }); // 立即上传第一张（示例） this.uploadImage(res.tempFilePaths[0]); } }); }, uploadImage(filePath) { const token = wx.getStorageSync('auth_token'); wx.uploadFile({ url: 'https://your-domain.com/api/upload', filePath: filePath, name: 'file', // 后端@RequestParam("file")对应name header: { 'Authorization': 'Bearer ' + token }, success: uploadRes => { const data = JSON.parse(uploadRes.data); if (data.code === 200) { this.setData({ imageUrl: data.data.url }); // 后端返回存储后的URL } } }); }

后端接收代码需注意@RequestParam("file") MultipartFile file的写法，且application.properties中要配置文件大小限制：

# application.properties spring.servlet.multipart.max-file-size=10MB spring.servlet.multipart.max-request-size=10MB

4. 数据库设计与关键SQL实现：四张核心表的字段取舍与索引策略

4.1 用户表（user）与校园身份强绑定字段设计

校园二手场景下，“用户是否本校学生”是信任基石。因此user表必须包含student_id（学号）、campus（校区，如“东校区”、“南校区”）、verify_status（认证状态：0-未认证，1-已认证）字段。学号作为唯一索引，比手机号更可靠（新生可能没办卡），且便于后期对接教务系统。

-- user表结构（MySQL 8.0） CREATE TABLE `user` ( `id` bigint NOT NULL AUTO_INCREMENT, `open_id` varchar(64) NOT NULL COMMENT '微信openid', `student_id` varchar(20) DEFAULT NULL COMMENT '学号，用于校内认证', `nickname` varchar(50) NOT NULL COMMENT '微信昵称', `avatar_url` varchar(255) DEFAULT NULL COMMENT '头像URL', `campus` varchar(20) DEFAULT NULL COMMENT '所属校区', `verify_status` tinyint NOT NULL DEFAULT '0' COMMENT '认证状态：0-未认证，1-已认证', `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (`id`), UNIQUE KEY `uk_openid` (`open_id`), UNIQUE KEY `uk_student_id` (`student_id`) -- 学号唯一，防止重复认证 ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='用户表';

提示：student_id设为UNIQUE而非NOT NULL，因为游客模式下可为空，但一旦填写就必须唯一。verify_status字段为后期增加“学生认证”功能预留，答辩时可作为“可扩展性设计”亮点。

4.2 商品表（goods）与状态机字段的必要性

二手商品生命周期比电商短：上架→被咨询→达成意向→下架→删除。因此goods表需设计status字段（0-草稿，1-上架，2-已售出，3-已下架），而非简单用is_deleted软删除。这样既能查“在售商品”，也能统计“历史成交数”，还能在小程序端根据状态显示不同按钮（如“已售出”显示“联系卖家”而非“立即购买”）。

-- goods表核心字段 CREATE TABLE `goods` ( `id` bigint NOT NULL AUTO_INCREMENT, `user_id` bigint NOT NULL COMMENT '发布者ID', `title` varchar(100) NOT NULL COMMENT '标题', `description` text COMMENT '描述', `price` decimal(10,2) NOT NULL COMMENT '价格', `category_id` int NOT NULL COMMENT '分类ID', `location` varchar(50) NOT NULL COMMENT '交易地点，如“图书馆北门”', `status` tinyint NOT NULL DEFAULT '1' COMMENT '状态：0-草稿，1-上架，2-已售出，3-已下架', `views` int NOT NULL DEFAULT '0' COMMENT '浏览量', `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP, `update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (`id`), KEY `idx_user_id_status` (`user_id`,`status`), -- 联合索引：查某用户所有状态商品 KEY `idx_category_status` (`category_id`,`status`) -- 联合索引：查某分类下架商品 ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='商品表';

4.3 订单表（order）与幂等性保障：防重复提交的关键字段

小程序下单是典型“读-改-写”场景：先查商品库存，再扣减，最后生成订单。若用户手抖连点两次，后端必须保证只生成一个订单。解决方案是在order表中增加out_trade_no（商户订单号）字段，并设为唯一索引。该字段由小程序端生成（如Date.now()+Math.random()），后端插入前校验是否存在，存在则直接返回原订单，避免重复扣库存。

-- order表关键字段 CREATE TABLE `order` ( `id` bigint NOT NULL AUTO_INCREMENT, `out_trade_no` varchar(64) NOT NULL COMMENT '商户订单号，小程序生成，全局唯一', `user_id` bigint NOT NULL COMMENT '买家ID', `seller_id` bigint NOT NULL COMMENT '卖家ID', `goods_id` bigint NOT NULL COMMENT '商品ID', `amount` decimal(10,2) NOT NULL COMMENT '金额', `status` tinyint NOT NULL DEFAULT '0' COMMENT '状态：0-待付款，1-已付款，2-已发货，3-已完成，4-已取消', `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (`id`), UNIQUE KEY `uk_out_trade_no` (`out_trade_no`) -- 强制唯一，实现幂等 ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='订单表';

5. 常见问题排查：5个让90%毕业生卡住的硬核坑点与解法

5.1 现象：小程序调用/api/goods/list返回404

原因：SpringMVC的DispatcherServlet未正确拦截.html以外的请求，或web.xml中<url-pattern>配置为/而非/*。
解决：检查web.xml中Servlet映射，必须为<url-pattern>/*</url-pattern>，否则/api/xxx路径不被Spring接管。若用Spring Boot则无此问题，但本项目是传统SSM，此配置是前提。

5.2 现象：MyBatis执行selectList时控制台打印SQL但返回空List

原因：Mapper.xml中<resultMap>的id与<select resultMap="">引用的id不一致，或<resultMap>内<id>/<result>的column名与数据库字段名大小写不匹配（MySQL在Linux下默认区分大小写）。
解决：打开MyBatis日志，在log4j2.xml中添加<Logger name="org.apache.ibatis" level="debug"/>，观察日志中Mapped Statements是否找到对应SQL；确认resultMap的id全小写，且column名与show create table结果完全一致。

5.3 现象：小程序上传图片后，后端MultipartFile始终为null

原因：wx.uploadFile()的name参数与后端@RequestParam("xxx")的字符串不一致，或前端未在header中携带Authorization导致拦截器提前返回401，MultipartFile根本未到达Controller。
解决：用Fiddler或微信开发者工具Network面板抓包，确认请求Header中有Authorization且Body中Content-Disposition的name="file"；后端Controller方法参数名必须与name值相同，且不要加required=false（上传必填）。

5.4 现象：商品详情页图片显示为“图片无法显示”

原因：后端返回的thumbnailUrl是相对路径（如/upload/abc.jpg），但小程序<image>标签要求绝对URL（https://your-domain.com/upload/abc.jpg）。
解决：在Controller返回数据前，用request.getScheme() + "://" + request.getServerName() + ":" + request.getServerPort()拼接完整域名，或在Nginx配置中将/upload/反向代理到静态目录，确保URL可直接访问。

5.5 现象：登录后调用需要鉴权的接口（如/api/order/create）返回401

原因：自定义JWT拦截器中，request.getHeader("Authorization")取到的值为"Bearer xxx"，但解析时未去掉Bearer前缀，导致token校验失败。
解决：拦截器中提取token时必须截取：

String authHeader = request.getHeader("Authorization"); if (authHeader != null && authHeader.startsWith("Bearer ")) { String token = authHeader.substring(7); // 去掉"Bearer "的7个字符 // 后续校验token... }

6. 高分答辩技巧：3个让导师眼前一亮的落地细节与验证方法

6.1 用“校园地理围栏”替代模糊定位：基于校区字段的精准筛选

很多同学在答辩时只会说“用了微信定位”，但实际小程序wx.getLocation()返回的是经纬度，而校园内不同校区（如相距5公里的东、西校区）交易需隔离。高分做法是：在用户注册时强制选择校区（小程序端用picker组件），商品发布时也绑定campus字段，后端接口增加campus参数，SQL查询时加AND campus = ?条件。这样“东校区用户看不到西校区商品”，既符合真实场景，又体现数据建模能力。验证方法：在数据库中插入两条同名商品，campus分别为“东校区”和“西校区”，用不同校区账号登录小程序，确认列表仅显示本校区商品。

6.2 订单状态机可视化：用PlantUML生成状态流转图嵌入文档

答辩PPT里放一张手绘的状态图远不如一份可执行的PlantUML代码。在docs/目录下新建order-state.puml，用标准语法描述状态迁移：

@startuml [*] --> 待付款 待付款 --> 已付款: 支付成功 待付款 --> 已取消: 用户取消 已付款 --> 已发货: 卖家发货 已发货 --> 已完成: 买家确认收货 已发货 --> 已取消: 申请退款 已完成 --> [*] @enduml

用PlantUML插件一键转PNG，插入答辩文档。这比口头说“我们有状态管理”有力得多，且证明你理解了领域驱动设计（DDD）中的状态模式。

6.3 性能压测报告：用JMeter模拟100并发用户浏览商品列表

高分项目必须有量化验证。用JMeter创建线程组，设置100个线程、Ramp-Up Period 10秒，HTTP请求目标为/api/goods/list?page=1&size=20。运行后导出聚合报告，重点关注90% Line（90%请求响应时间）是否低于800ms。若超时，说明PageHelper分页未生效或缺少索引——此时回到goods表，为status和create_time添加联合索引：KEY idx_status_time (status, create_time)。这个动作本身就能成为答辩时的技术亮点：“我们通过压测发现性能瓶颈，并针对性优化了数据库索引”。

我带过的某高校毕业设计小组，曾因在答辩现场实时演示JMeter压测对比（优化前90%响应2.1s vs 优化后0.4s），被导师当场评为“近三年最扎实的工程实践”。技术没有玄学，只有可测量、可复现、可解释的细节。希望帮到你。

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