简介这是一套面向计算机相关专业学生的校园二手交易平台完整项目资源基于微信小程序与SSMSpring、SpringMVC、MyBatis框架开发适合用作毕业设计、期末大作业或项目实战练习。资源包共1433个文件约44.16MB涵盖Java后端源码、Vue管理端页面、小程序端wxml与wxss样式、js逻辑脚本以及png、svg、jpg等界面素材并附有论文报告、PPT、数据库脚本与说明文档结构完整、层次清晰。项目源码经过本地编译与严格调试可运行性有保障读者可直接部署观察实际效果理解用户界面、交易流程与数据处理的设计思路。开发文档记录了需求分析、系统设计与接口设计过程数据文档则展示数据表结构与存储管理方式论文部分还包含项目背景、实现过程与问题解决方案有助于提升学术写作能力。目前已有66人学习难度适中适合需要完整参考方案的学习者。1. 校园二手交易平台的小程序SSM一套能跑通的毕设级全栈方案每年毕业季计算机专业的学生都会面对同一个问题选什么题目既能覆盖足够的技术栈又能在有限时间内真正跑通。校园二手交易平台几乎是出现频率最高的选题之一原因很直接——业务逻辑清晰、用户角色明确、功能边界可控而且小程序SSM的组合恰好覆盖了前端交互、后端接口、数据库设计三个核心能力点。但真正动手时你会发现网上能找到的资料要么只有后端没有前端要么代码跑不起来要么数据库文档和实际表结构对不上。这篇内容围绕一套完整的校园二手交易平台交付物展开把小程序端、SSM后端、数据库文档、说明文档这几块拆开讲清楚每一部分该怎么做、参数怎么设、哪些地方容易翻车。适合正在做毕设的本科生也适合想拿一个完整项目练手全栈开发的人。2. 小程序端与SSM后端的分工边界谁管什么、接口怎么定2.1 为什么选小程序做前端而不是Vue或React校园二手交易平台的用户群体是在校学生使用场景高度集中在手机端。微信小程序在这个场景下的优势不是技术上的而是使用路径上的学生不需要下载安装扫码或搜索就能进入分享到班级群也方便。从开发成本看小程序的页面结构和API设计对新手足够友好WXMLWXSSJS的组合学习曲线比VueWebpack要平缓得多。但小程序端有一个必须提前想清楚的问题哪些逻辑放在前端哪些交给后端。我的习惯是小程序端只负责展示和收集用户输入所有涉及数据校验、权限判断、状态流转的逻辑全部放在SSM后端。比如发布商品时前端只做非空校验和图片尺寸压缩价格合法性、用户是否被禁言、分类是否存在这些判断全部由后端接口返回。这样做的好处是当你在论文里写“系统采用前后端分离架构”时是真的分离了而不是把业务逻辑散落在两端。答辩时老师问“如果小程序端被篡改怎么办”你可以直接回答“所有关键校验在后端前端篡改只能骗自己”。2.2 SSM后端的分层结构与接口约定SSM是SpringSpringMVCMyBatis的缩写这套组合在国内高校和中小型项目中仍然是主流。它的分层逻辑很清晰Controller层接收请求和返回响应Service层处理业务逻辑Dao层Mapper负责数据库操作。对于校园二手交易平台我一般会按业务模块划分Controller用户模块UserController、商品模块ProductController、订单模块OrderController、分类模块CategoryController。每个Controller下的接口路径遵循RESTful风格比如// 商品模块接口示例 RestController RequestMapping(/api/product) public class ProductController { Autowired private ProductService productService; // 分页查询商品列表支持按分类和关键词筛选 GetMapping(/list) public Result list(RequestParam(defaultValue 1) Integer page, RequestParam(defaultValue 10) Integer size, RequestParam(required false) Integer categoryId, RequestParam(required false) String keyword) { // 分页参数校验page不能小于1size不能超过50 if (page 1) page 1; if (size 50) size 50; PageInfoProductVO pageInfo productService.listProducts(page, size, categoryId, keyword); return Result.success(pageInfo); } // 发布商品需要登录态 PostMapping(/publish) public Result publish(RequestBody ProductDTO productDTO, HttpServletRequest request) { // 从token中解析用户ID而不是从前端传参获取 Integer userId (Integer) request.getAttribute(userId); if (userId null) { return Result.error(请先登录); } productService.publishProduct(userId, productDTO); return Result.success(发布成功); } }这段代码里有两个关键设计。第一分页参数在后端做了二次校验size最大限制为50防止前端传入超大值导致数据库压力。第二用户ID从请求属性中获取而不是让前端传userId参数——这是防止越权操作的基本手段。很多同学在写毕设时习惯让前端传用户ID答辩时被问到“我改一下请求参数是不是就能以别人身份发布商品”就答不上来了。Result是一个统一响应封装类包含code、msg、data三个字段。这个类看起来简单但它是前后端联调的基础。没有统一响应格式小程序端就要为每个接口写不同的解析逻辑后期维护成本会翻倍。2.3 数据库表设计与小程序页面列表的对应关系数据库文档是这套交付物里最容易被忽视的部分。很多同学的做法是先写代码最后用Navicat反向生成一份文档结果表字段和实际业务对不上。我的建议是先画ER图确定核心表和关系再动手写代码。校园二手交易平台的核心表不多但关系要理清楚表名核心字段与其他表的关系userid, openid, nickname, avatar, phone, status一个用户对应多个商品、多个订单productid, user_id, category_id, title, description, price, images, status属于一个用户、一个分类categoryid, name, sort_order一个分类对应多个商品orderid, product_id, buyer_id, seller_id, status, create_time关联商品、买家、卖家messageid, from_user_id, to_user_id, product_id, content关联两个用户和商品小程序端的商品列表页直接对应product表的查询但要注意一个细节列表页展示的是商品缩略信息不需要返回description字段的全部内容。如果数据库里description是TEXT类型一次性查出来会拖慢接口响应。常见做法是在Mapper的查询语句里只取需要的字段或者单独建一个product_list视图。!-- ProductMapper.xml 中的列表查询 -- select idselectProductList resultTypeProductVO SELECT p.id, p.title, p.price, p.images, p.status, c.name AS categoryName, u.nickname AS sellerName FROM product p LEFT JOIN category c ON p.category_id c.id LEFT JOIN user u ON p.user_id u.id WHERE p.status 1 if testcategoryId ! null AND p.category_id #{categoryId} /if if testkeyword ! null and keyword ! AND p.title LIKE CONCAT(%, #{keyword}, %) /if ORDER BY p.create_time DESC LIMIT #{offset}, #{size} /select这里用LEFT JOIN而不是INNER JOIN是因为商品可能没有分类比如用户发布时没选但列表仍然要展示。status1表示商品处于在售状态已下架或已售出的商品不出现在列表中。LIMIT的offset由Service层根据页码计算不要在前端算好传过来。3. 从零跑通项目环境搭建、配置修改与启动顺序3.1 开发环境清单与版本选择拿到一套源码后第一步不是急着导入IDE而是确认环境版本。SSM项目对版本比较敏感尤其是Spring和MyBatis的版本不匹配时启动会报各种NoSuchMethodError。以下是我验证过的稳定组合组件推荐版本说明JDK1.8SSM项目不建议用JDK 11部分老版本依赖不兼容Maven3.6.x3.8有时会报HTTP仓库连接问题MySQL5.78.0需要改驱动类和连接URL参数Tomcat8.59.0对部分JSP标签支持有变化IDEA2021.x社区版够用但Web开发建议用旗舰版如果电脑上已经装了MySQL 8.0不想重装也可以在连接URL里加参数解决# MySQL 8.0的连接配置 jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/campus_trade?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalseallowPublicKeyRetrievaltrueserverTimezone必须设置否则会报时区错误。allowPublicKeyRetrievaltrue是MySQL 8.0的密码插件要求不加会连接失败。3.2 数据库导入与配置文件的三个必改项源码包里通常有一个.sql文件导入之前先创建一个空数据库CREATE DATABASE campus_trade DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;用utf8mb4而不是utf8是因为商品描述和聊天消息里可能出现Emojiutf8存不进去会报错。导入SQL文件后检查一下表里有没有初始数据特别是category表如果没有分类数据小程序端的分类筛选就是空的。接下来改配置文件。SSM项目的配置文件通常有三个地方需要改# db.properties - 数据库连接 jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/campus_trade?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalse jdbc.usernameroot jdbc.password你的密码 # 小程序端配置文件 app.js 或 config.js const config { baseUrl: http://localhost:8080/api, // 后端接口地址 imageBaseUrl: http://localhost:8080/upload/ // 图片访问地址 }三个必改项数据库密码、后端接口地址、图片上传路径。图片上传路径特别容易漏因为本地开发时图片存在Tomcat的webapps目录下但小程序端访问时需要完整的URL。如果后端和图片不在同一个域名下还要处理跨域问题。3.3 启动顺序与验证方法启动顺序不对会出现“后端启动了但小程序请求404”的情况。正确的顺序是启动MySQL确认数据库连接正常启动Tomcat或在IDEA中运行Tomcat打开浏览器访问http://localhost:8080/api/category/list看是否返回JSON数据用微信开发者工具打开小程序项目修改baseUrl为本地地址在开发者工具中点击“编译”观察Console面板是否有报错如果第3步返回404检查Tomcat的Application context是否设置为/。如果返回500看Tomcat日志里的异常堆栈通常是数据库连接失败或Mapper文件路径不对。小程序端有一个常见问题开发者工具默认开启“域名合法性检查”本地开发时需要在“详情-本地设置”中勾选“不校验合法域名”。这个选项只影响开发阶段上线前必须配置正式域名。4. 避坑与排查源码跑不起来时先看这五个地方4.1 现象启动Tomcat报“ClassNotFoundException: com.mysql.jdbc.Driver”原因MySQL驱动版本和驱动类名不匹配。MySQL 5.x用com.mysql.jdbc.DriverMySQL 8.x用com.mysql.cj.jdbc.Driver。解决确认pom.xml中mysql-connector-java的版本5.x对应5.x的驱动类8.x对应8.x的驱动类。如果用的是8.x驱动但配置文件里写的是旧类名改成com.mysql.cj.jdbc.Driver即可。4.2 现象小程序端请求接口返回“request:fail url not in domain list”原因微信开发者工具的域名校验拦截了本地请求。解决在开发者工具右上角“详情-本地设置”中勾选“不校验合法域名、web-view业务域名、TLS版本以及HTTPS证书”。注意这个设置只在开发阶段有效真机预览时如果没配置正式域名同样会报错。4.3 现象商品列表页图片不显示控制台报403原因图片上传到了Tomcat的webapps目录但Tomcat没有配置静态资源映射或者图片路径拼接错误。解决检查后端是否配置了静态资源映射。在SpringMVC配置文件中添加!-- 静态资源映射将 /upload/** 映射到本地磁盘目录 -- mvc:resources mapping/upload/** locationfile:/data/upload//如果图片存在项目根目录下的upload文件夹location改为/upload/。同时确认小程序端拼接的图片URL是imageBaseUrl 图片文件名不要重复拼接路径。4.4 现象发布商品时提示“用户未登录”但明明已经登录了原因Token没有正确传递或解析。常见情况是小程序端在请求头中加了token但后端拦截器没有读取这个头或者Token过期后没有刷新机制。解决先确认小程序端wx.request的header中是否带了token字段。然后在后端拦截器中打印请求头确认能取到值。如果Token存在但解析失败检查JWT工具类的密钥是否和生成时一致。很多源码包里密钥是硬编码的换一台机器编译后密钥变了旧Token全部失效。4.5 现象数据库中文乱码商品标题显示问号原因数据库、表、连接URL三处的字符集不一致。解决按以下顺序检查——数据库创建时是否用utf8mb4表的字符集是否继承数据库连接URL是否加了characterEncodingutf8。如果已经建表且数据乱码需要改表的字符集ALTER TABLE product CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;改完之后之前存进去的乱码数据不会自动恢复需要重新录入。5. 论文与说明文档的写法让答辩老师看到工程思维5.1 论文里该放什么图、不该放什么图很多同学的论文里堆了大量截图登录页面截图、商品列表截图、数据库表截图。这些图不是不能放但放多了显得像操作手册不像毕业论文。我的建议是论文里放三类图就够了系统架构图、ER图、核心业务流程图。页面截图放在附录或说明文档里。系统架构图用Visio或Draw.io画体现小程序端、后端、数据库三层结构。ER图体现表之间的关系重点标出外键和索引。业务流程图选一个核心流程比如“商品发布到审核通过”或“下单到确认收货”把状态流转画清楚。5.2 说明文档的目录结构与关键内容说明文档是给“拿到这套源码的人”看的不是给答辩老师看的。它的目标是让一个没接触过项目的人能在30分钟内跑起来。目录结构建议如下项目概述技术栈、功能模块环境要求JDK、Maven、MySQL、Tomcat版本数据库导入步骤含SQL文件位置和导入命令后端配置修改数据库连接、文件上传路径小程序端配置修改接口地址、AppID启动步骤后端启动、小程序编译常见问题至少包含本文第4章的五个问题关键内容是配置修改和常见问题。配置修改要写清楚“改哪个文件的哪一行改成什么”不要写“根据实际情况修改”。常见问题要写现象和解决步骤不要只写“检查配置”。5.3 数据库文档的字段说明怎么写才不被挑毛病数据库文档不是把Navicat的导出结果贴上去就完事了。每个字段需要说明字段名、类型、是否允许为空、默认值、含义。对于枚举类型的字段要列出所有可能的值。比如order表的status字段字段名类型允许空默认值含义statustinyint否0订单状态0待付款1已付款2已发货3已完成4已取消这样写的好处是答辩老师问“订单状态怎么流转的”你可以直接指着文档回答。另外索引也要在文档里标出来比如product表的category_id和status建了联合索引说明为什么要建这个索引——因为列表查询经常同时按分类和状态筛选。5.4 答辩时被问到“这个项目有什么创新点”怎么答校园二手交易平台的功能是固定的很难在业务上做出创新。但可以在技术实现上找亮点。比如商品列表的分页查询用了懒加载小程序端滚动到底部自动加载下一页而不是一次性请求全部数据图片上传做了压缩处理小程序端先用wx.compressImage压缩再上传减少服务器存储压力和加载时间用户身份验证用了JWT而不是Session后端可以无状态部署适合后续扩展这些点不需要多高深但能体现你在实现过程中考虑了性能和可扩展性。答辩老师想听到的不是“我用了SSM”而是“我为什么用SSM以及我在哪里做了取舍”。5.5 一套源码交付物的自检清单在把项目交出去之前按这个清单过一遍数据库SQL文件能否在空库上完整导入不报错后端配置文件里的数据库密码是否已改为占位符或说明小程序端的baseUrl是否已改为可配置项而不是硬编码说明文档里的启动步骤是否和实际一致有没有漏掉某一步论文里的截图是否清晰代码截图有没有包含敏感信息如真实密码压缩包解压后目录结构是否清晰有没有多余的.idea、target、node_modules文件夹最后一条特别重要。很多同学直接把IDEA的项目目录打包里面包含了.idea文件夹和编译产物解压后别人导入时各种报错。正确的做法是只打包源码、SQL文件、文档编译产物和IDE配置全部排除。我在第一次做毕设交付时把整个项目文件夹压缩发给了同学结果他导入后一直报“找不到符号”。排查了半天才发现我打包时把target目录也带上了他导入的是编译后的class文件而不是源码。后来我养成了一个习惯交付前新建一个空文件夹只把源码和文档复制进去在这个干净目录里重新跑一遍启动流程确认没问题再打包。这个习惯帮我省了很多来回沟通的时间。希望帮到你。本文还有配套的精品资源点击获取 校园二手交易平台小程序+SSM全栈方案：从环境搭建到论文答辩的完整交付指南
简介这是一套面向计算机相关专业学生的校园二手交易平台完整项目资源基于微信小程序与SSMSpring、SpringMVC、MyBatis框架开发适合用作毕业设计、期末大作业或项目实战练习。资源包共1433个文件约44.16MB涵盖Java后端源码、Vue管理端页面、小程序端wxml与wxss样式、js逻辑脚本以及png、svg、jpg等界面素材并附有论文报告、PPT、数据库脚本与说明文档结构完整、层次清晰。项目源码经过本地编译与严格调试可运行性有保障读者可直接部署观察实际效果理解用户界面、交易流程与数据处理的设计思路。开发文档记录了需求分析、系统设计与接口设计过程数据文档则展示数据表结构与存储管理方式论文部分还包含项目背景、实现过程与问题解决方案有助于提升学术写作能力。目前已有66人学习难度适中适合需要完整参考方案的学习者。1. 校园二手交易平台的小程序SSM一套能跑通的毕设级全栈方案每年毕业季计算机专业的学生都会面对同一个问题选什么题目既能覆盖足够的技术栈又能在有限时间内真正跑通。校园二手交易平台几乎是出现频率最高的选题之一原因很直接——业务逻辑清晰、用户角色明确、功能边界可控而且小程序SSM的组合恰好覆盖了前端交互、后端接口、数据库设计三个核心能力点。但真正动手时你会发现网上能找到的资料要么只有后端没有前端要么代码跑不起来要么数据库文档和实际表结构对不上。这篇内容围绕一套完整的校园二手交易平台交付物展开把小程序端、SSM后端、数据库文档、说明文档这几块拆开讲清楚每一部分该怎么做、参数怎么设、哪些地方容易翻车。适合正在做毕设的本科生也适合想拿一个完整项目练手全栈开发的人。2. 小程序端与SSM后端的分工边界谁管什么、接口怎么定2.1 为什么选小程序做前端而不是Vue或React校园二手交易平台的用户群体是在校学生使用场景高度集中在手机端。微信小程序在这个场景下的优势不是技术上的而是使用路径上的学生不需要下载安装扫码或搜索就能进入分享到班级群也方便。从开发成本看小程序的页面结构和API设计对新手足够友好WXMLWXSSJS的组合学习曲线比VueWebpack要平缓得多。但小程序端有一个必须提前想清楚的问题哪些逻辑放在前端哪些交给后端。我的习惯是小程序端只负责展示和收集用户输入所有涉及数据校验、权限判断、状态流转的逻辑全部放在SSM后端。比如发布商品时前端只做非空校验和图片尺寸压缩价格合法性、用户是否被禁言、分类是否存在这些判断全部由后端接口返回。这样做的好处是当你在论文里写“系统采用前后端分离架构”时是真的分离了而不是把业务逻辑散落在两端。答辩时老师问“如果小程序端被篡改怎么办”你可以直接回答“所有关键校验在后端前端篡改只能骗自己”。2.2 SSM后端的分层结构与接口约定SSM是SpringSpringMVCMyBatis的缩写这套组合在国内高校和中小型项目中仍然是主流。它的分层逻辑很清晰Controller层接收请求和返回响应Service层处理业务逻辑Dao层Mapper负责数据库操作。对于校园二手交易平台我一般会按业务模块划分Controller用户模块UserController、商品模块ProductController、订单模块OrderController、分类模块CategoryController。每个Controller下的接口路径遵循RESTful风格比如// 商品模块接口示例 RestController RequestMapping(/api/product) public class ProductController { Autowired private ProductService productService; // 分页查询商品列表支持按分类和关键词筛选 GetMapping(/list) public Result list(RequestParam(defaultValue 1) Integer page, RequestParam(defaultValue 10) Integer size, RequestParam(required false) Integer categoryId, RequestParam(required false) String keyword) { // 分页参数校验page不能小于1size不能超过50 if (page 1) page 1; if (size 50) size 50; PageInfoProductVO pageInfo productService.listProducts(page, size, categoryId, keyword); return Result.success(pageInfo); } // 发布商品需要登录态 PostMapping(/publish) public Result publish(RequestBody ProductDTO productDTO, HttpServletRequest request) { // 从token中解析用户ID而不是从前端传参获取 Integer userId (Integer) request.getAttribute(userId); if (userId null) { return Result.error(请先登录); } productService.publishProduct(userId, productDTO); return Result.success(发布成功); } }这段代码里有两个关键设计。第一分页参数在后端做了二次校验size最大限制为50防止前端传入超大值导致数据库压力。第二用户ID从请求属性中获取而不是让前端传userId参数——这是防止越权操作的基本手段。很多同学在写毕设时习惯让前端传用户ID答辩时被问到“我改一下请求参数是不是就能以别人身份发布商品”就答不上来了。Result是一个统一响应封装类包含code、msg、data三个字段。这个类看起来简单但它是前后端联调的基础。没有统一响应格式小程序端就要为每个接口写不同的解析逻辑后期维护成本会翻倍。2.3 数据库表设计与小程序页面列表的对应关系数据库文档是这套交付物里最容易被忽视的部分。很多同学的做法是先写代码最后用Navicat反向生成一份文档结果表字段和实际业务对不上。我的建议是先画ER图确定核心表和关系再动手写代码。校园二手交易平台的核心表不多但关系要理清楚表名核心字段与其他表的关系userid, openid, nickname, avatar, phone, status一个用户对应多个商品、多个订单productid, user_id, category_id, title, description, price, images, status属于一个用户、一个分类categoryid, name, sort_order一个分类对应多个商品orderid, product_id, buyer_id, seller_id, status, create_time关联商品、买家、卖家messageid, from_user_id, to_user_id, product_id, content关联两个用户和商品小程序端的商品列表页直接对应product表的查询但要注意一个细节列表页展示的是商品缩略信息不需要返回description字段的全部内容。如果数据库里description是TEXT类型一次性查出来会拖慢接口响应。常见做法是在Mapper的查询语句里只取需要的字段或者单独建一个product_list视图。!-- ProductMapper.xml 中的列表查询 -- select idselectProductList resultTypeProductVO SELECT p.id, p.title, p.price, p.images, p.status, c.name AS categoryName, u.nickname AS sellerName FROM product p LEFT JOIN category c ON p.category_id c.id LEFT JOIN user u ON p.user_id u.id WHERE p.status 1 if testcategoryId ! null AND p.category_id #{categoryId} /if if testkeyword ! null and keyword ! AND p.title LIKE CONCAT(%, #{keyword}, %) /if ORDER BY p.create_time DESC LIMIT #{offset}, #{size} /select这里用LEFT JOIN而不是INNER JOIN是因为商品可能没有分类比如用户发布时没选但列表仍然要展示。status1表示商品处于在售状态已下架或已售出的商品不出现在列表中。LIMIT的offset由Service层根据页码计算不要在前端算好传过来。3. 从零跑通项目环境搭建、配置修改与启动顺序3.1 开发环境清单与版本选择拿到一套源码后第一步不是急着导入IDE而是确认环境版本。SSM项目对版本比较敏感尤其是Spring和MyBatis的版本不匹配时启动会报各种NoSuchMethodError。以下是我验证过的稳定组合组件推荐版本说明JDK1.8SSM项目不建议用JDK 11部分老版本依赖不兼容Maven3.6.x3.8有时会报HTTP仓库连接问题MySQL5.78.0需要改驱动类和连接URL参数Tomcat8.59.0对部分JSP标签支持有变化IDEA2021.x社区版够用但Web开发建议用旗舰版如果电脑上已经装了MySQL 8.0不想重装也可以在连接URL里加参数解决# MySQL 8.0的连接配置 jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/campus_trade?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalseallowPublicKeyRetrievaltrueserverTimezone必须设置否则会报时区错误。allowPublicKeyRetrievaltrue是MySQL 8.0的密码插件要求不加会连接失败。3.2 数据库导入与配置文件的三个必改项源码包里通常有一个.sql文件导入之前先创建一个空数据库CREATE DATABASE campus_trade DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;用utf8mb4而不是utf8是因为商品描述和聊天消息里可能出现Emojiutf8存不进去会报错。导入SQL文件后检查一下表里有没有初始数据特别是category表如果没有分类数据小程序端的分类筛选就是空的。接下来改配置文件。SSM项目的配置文件通常有三个地方需要改# db.properties - 数据库连接 jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/campus_trade?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalse jdbc.usernameroot jdbc.password你的密码 # 小程序端配置文件 app.js 或 config.js const config { baseUrl: http://localhost:8080/api, // 后端接口地址 imageBaseUrl: http://localhost:8080/upload/ // 图片访问地址 }三个必改项数据库密码、后端接口地址、图片上传路径。图片上传路径特别容易漏因为本地开发时图片存在Tomcat的webapps目录下但小程序端访问时需要完整的URL。如果后端和图片不在同一个域名下还要处理跨域问题。3.3 启动顺序与验证方法启动顺序不对会出现“后端启动了但小程序请求404”的情况。正确的顺序是启动MySQL确认数据库连接正常启动Tomcat或在IDEA中运行Tomcat打开浏览器访问http://localhost:8080/api/category/list看是否返回JSON数据用微信开发者工具打开小程序项目修改baseUrl为本地地址在开发者工具中点击“编译”观察Console面板是否有报错如果第3步返回404检查Tomcat的Application context是否设置为/。如果返回500看Tomcat日志里的异常堆栈通常是数据库连接失败或Mapper文件路径不对。小程序端有一个常见问题开发者工具默认开启“域名合法性检查”本地开发时需要在“详情-本地设置”中勾选“不校验合法域名”。这个选项只影响开发阶段上线前必须配置正式域名。4. 避坑与排查源码跑不起来时先看这五个地方4.1 现象启动Tomcat报“ClassNotFoundException: com.mysql.jdbc.Driver”原因MySQL驱动版本和驱动类名不匹配。MySQL 5.x用com.mysql.jdbc.DriverMySQL 8.x用com.mysql.cj.jdbc.Driver。解决确认pom.xml中mysql-connector-java的版本5.x对应5.x的驱动类8.x对应8.x的驱动类。如果用的是8.x驱动但配置文件里写的是旧类名改成com.mysql.cj.jdbc.Driver即可。4.2 现象小程序端请求接口返回“request:fail url not in domain list”原因微信开发者工具的域名校验拦截了本地请求。解决在开发者工具右上角“详情-本地设置”中勾选“不校验合法域名、web-view业务域名、TLS版本以及HTTPS证书”。注意这个设置只在开发阶段有效真机预览时如果没配置正式域名同样会报错。4.3 现象商品列表页图片不显示控制台报403原因图片上传到了Tomcat的webapps目录但Tomcat没有配置静态资源映射或者图片路径拼接错误。解决检查后端是否配置了静态资源映射。在SpringMVC配置文件中添加!-- 静态资源映射将 /upload/** 映射到本地磁盘目录 -- mvc:resources mapping/upload/** locationfile:/data/upload//如果图片存在项目根目录下的upload文件夹location改为/upload/。同时确认小程序端拼接的图片URL是imageBaseUrl 图片文件名不要重复拼接路径。4.4 现象发布商品时提示“用户未登录”但明明已经登录了原因Token没有正确传递或解析。常见情况是小程序端在请求头中加了token但后端拦截器没有读取这个头或者Token过期后没有刷新机制。解决先确认小程序端wx.request的header中是否带了token字段。然后在后端拦截器中打印请求头确认能取到值。如果Token存在但解析失败检查JWT工具类的密钥是否和生成时一致。很多源码包里密钥是硬编码的换一台机器编译后密钥变了旧Token全部失效。4.5 现象数据库中文乱码商品标题显示问号原因数据库、表、连接URL三处的字符集不一致。解决按以下顺序检查——数据库创建时是否用utf8mb4表的字符集是否继承数据库连接URL是否加了characterEncodingutf8。如果已经建表且数据乱码需要改表的字符集ALTER TABLE product CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;改完之后之前存进去的乱码数据不会自动恢复需要重新录入。5. 论文与说明文档的写法让答辩老师看到工程思维5.1 论文里该放什么图、不该放什么图很多同学的论文里堆了大量截图登录页面截图、商品列表截图、数据库表截图。这些图不是不能放但放多了显得像操作手册不像毕业论文。我的建议是论文里放三类图就够了系统架构图、ER图、核心业务流程图。页面截图放在附录或说明文档里。系统架构图用Visio或Draw.io画体现小程序端、后端、数据库三层结构。ER图体现表之间的关系重点标出外键和索引。业务流程图选一个核心流程比如“商品发布到审核通过”或“下单到确认收货”把状态流转画清楚。5.2 说明文档的目录结构与关键内容说明文档是给“拿到这套源码的人”看的不是给答辩老师看的。它的目标是让一个没接触过项目的人能在30分钟内跑起来。目录结构建议如下项目概述技术栈、功能模块环境要求JDK、Maven、MySQL、Tomcat版本数据库导入步骤含SQL文件位置和导入命令后端配置修改数据库连接、文件上传路径小程序端配置修改接口地址、AppID启动步骤后端启动、小程序编译常见问题至少包含本文第4章的五个问题关键内容是配置修改和常见问题。配置修改要写清楚“改哪个文件的哪一行改成什么”不要写“根据实际情况修改”。常见问题要写现象和解决步骤不要只写“检查配置”。5.3 数据库文档的字段说明怎么写才不被挑毛病数据库文档不是把Navicat的导出结果贴上去就完事了。每个字段需要说明字段名、类型、是否允许为空、默认值、含义。对于枚举类型的字段要列出所有可能的值。比如order表的status字段字段名类型允许空默认值含义statustinyint否0订单状态0待付款1已付款2已发货3已完成4已取消这样写的好处是答辩老师问“订单状态怎么流转的”你可以直接指着文档回答。另外索引也要在文档里标出来比如product表的category_id和status建了联合索引说明为什么要建这个索引——因为列表查询经常同时按分类和状态筛选。5.4 答辩时被问到“这个项目有什么创新点”怎么答校园二手交易平台的功能是固定的很难在业务上做出创新。但可以在技术实现上找亮点。比如商品列表的分页查询用了懒加载小程序端滚动到底部自动加载下一页而不是一次性请求全部数据图片上传做了压缩处理小程序端先用wx.compressImage压缩再上传减少服务器存储压力和加载时间用户身份验证用了JWT而不是Session后端可以无状态部署适合后续扩展这些点不需要多高深但能体现你在实现过程中考虑了性能和可扩展性。答辩老师想听到的不是“我用了SSM”而是“我为什么用SSM以及我在哪里做了取舍”。5.5 一套源码交付物的自检清单在把项目交出去之前按这个清单过一遍数据库SQL文件能否在空库上完整导入不报错后端配置文件里的数据库密码是否已改为占位符或说明小程序端的baseUrl是否已改为可配置项而不是硬编码说明文档里的启动步骤是否和实际一致有没有漏掉某一步论文里的截图是否清晰代码截图有没有包含敏感信息如真实密码压缩包解压后目录结构是否清晰有没有多余的.idea、target、node_modules文件夹最后一条特别重要。很多同学直接把IDEA的项目目录打包里面包含了.idea文件夹和编译产物解压后别人导入时各种报错。正确的做法是只打包源码、SQL文件、文档编译产物和IDE配置全部排除。我在第一次做毕设交付时把整个项目文件夹压缩发给了同学结果他导入后一直报“找不到符号”。排查了半天才发现我打包时把target目录也带上了他导入的是编译后的class文件而不是源码。后来我养成了一个习惯交付前新建一个空文件夹只把源码和文档复制进去在这个干净目录里重新跑一遍启动流程确认没问题再打包。这个习惯帮我省了很多来回沟通的时间。希望帮到你。本文还有配套的精品资源点击获取 RELATED READING
延伸阅读
更多一线实战笔记与深度复盘，助您持续精进
