企业官网建设流程全解析

简介：面向高校毕业设计与课程设计的校园二手交易平台完整源码包，以Java后端、微信小程序前端和MySQL数据库为主体，覆盖商品发布、搜索、交易沟通、用户管理等核心模块，适合计算机专业学生开展项目实践，也便于开发者快速构建同类校园交易场景。资源共1432个文件，包含151个Java源文件、219个JS逻辑脚本、155个Vue组件、上百个WXML/WXSS页面样式文件、126个JSON配置，以及PNG、SVG等图像素材和2个SQL数据库脚本，压缩包约22.39MB，前后端目录划分清晰。目前已有51人学习下载，内容包括环境配置说明、安装/启动/构建脚本、项目文档及PPT演示文稿，可帮助快速完成环境搭建、代码理解和毕业答辩展示，是完整可运行的实践参考。

1. 校园二手交易平台的毕业设计源码：别急着跑，先想清楚这三层

拿到这个 zip 时，大多数人第一反应是解压、导入 IDE、点运行。我劝你先别急。校园二手交易平台这个毕业设计，表面是 Java + 小程序 + MySQL 三件套，实际上真正的难点全在微信侧：登录要换 code、图片要过域名校验、手机号授权有主体限制，任何一个环节卡住，代码再完整也跑不出效果。源码能帮你省掉写业务的时间，却省不掉你理解业务的时间。这篇笔记就按「架构怎么拆 → 环境怎么搭 → 参数怎么调 → 坑在哪」的顺序，把这个题目从能跑讲到能答辩。

2. 读懂 Java + 小程序 + MySQL 三角色：先把订单状态机和数据流刻在脑子里

2.1 小程序端：四个核心页面和登录态怎么串

校园二手交易平台的小程序端，页面再多也逃不出四类：商品列表（首页）、商品详情、发布/编辑、个人中心。个人中心往往还挂着「我发布的」「我买到的」「我卖出的」三个子列表，本质是同一张订单表按 buyer_id 和 seller_id 分别查。拿到源码先别急着翻页面，你该找的是app.js里的onLaunch，看它有没有调wx.login，以及登录成功后的 code 是直接发给了后端换 openid，还是只存在本地缓存里。这决定了你整个联调能不能往下走。

三个登录态要分清：微信侧的 code、后端签发的 token、以及用户主动填写的手机号。小程序端每次冷启动都会重新执行wx.login，拿到新 code；后端拿 code 换 openid 后，再生成自己的 token 存数据库或 Redis，返回给前端。注意，现在wx.getUserProfile弹窗已经被微信收回，头像昵称得用「头像昵称填写能力」（button的open-type="chooseAvatar"），源码里如果还写着旧接口，真机调试时一定会吃闭门羹。

2.2 Java 后端：Spring Boot 分层与 REST 接口约定

哪怕源码里没用 Spring Boot，而是 SSM 的 SSH 的老古董，你也得先把分层捋出来：controller只做参数接收和结果包装，service管业务判断，mapper/dao管 SQL。毕业设计答辩时老师最爱问的一句话就是「你这个项目怎么分层」，答不上来比跑不起来更尴尬。常见的做法是在service层看到@Transactional注解，订单创建和库存扣减必须在一个事务里，否则下单成功但库存没扣，这种低级 bug 一抓一个准。

接口路径上用/api/user/login、/api/goods/list、/api/order/create这类 REST 风格是最稳的。看源码时重点盯两处：一是返回体是否统一，比如{ "code": 0, "msg": "ok", "data": ... }，如果有的接口直接返回Map有的返回String，说明作者写到后期已经放飞自我；二是分页参数，商品列表的page和size是从 query 取还是从 header 取，这直接影响你调小程序端的wx.request。另外，项目如果用了 MyBatis-Plus，实体类上多半有@TableName和@TableId，仔细看下逻辑删除字段@TableLogic，没配逻辑删除的话，删除商品会变成物理删除，数据没了很难向老师解释。

2.3 MySQL 设计：订单状态、商品表和防超卖的唯一真相

数据库是整个项目里最不该糊弄的部分，也是答辩时最好讲的部分。核心表就三张：user、goods、orders，进阶一点再加category和orders_detail。一定要先把订单状态的定义抄下来，常见做法是 0 待付款、1 待发货、2 待收货、3 已完成、4 已取消。不同源码定义不一样，你拿到手先看注释或者OrderStatus枚举，别把状态数字猜错，否则订单流转会乱。

CREATE TABLE `goods` ( `id` bigint NOT NULL AUTO_INCREMENT, `seller_id` bigint NOT NULL COMMENT '卖家ID，关联user.id', `title` varchar(100) NOT NULL, `description` text, `price` decimal(10,2) NOT NULL, `stock` int NOT NULL DEFAULT 1 COMMENT '二手商品通常只有1件', `status` tinyint NOT NULL DEFAULT 0 COMMENT '0上架 1下架 2已售出', `category_id` bigint DEFAULT NULL, `create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

注意：二手平台的商品库存大多是 1，但订单创建时依然要做库存扣减判断。别觉得「库存=1 就不会超卖」，并发场景下两个用户同时下单，照样可能把一件商品卖给两个人。

// 防超卖核心：用数据库行锁保证原子性 int updated = goodsMapper.updateStock(goodsId); // 影响行数为 0 说明 stock <= 0 或商品不存在 if (updated == 0) { throw new BusinessException("商品已售出或库存不足"); }

对应 SQL 是UPDATE goods SET stock = stock - 1 WHERE id = #{id} AND stock > 0，这种写法比先SELECT再UPDATE稳得多，也是面试里常聊的乐观锁思想。源码里如果用的是「先查库存，再 update，再判断」，那你在答辩前最好自己改成原子更新，否则并发压测时必翻车。MySQL 锁的分类里，这属于行锁加乐观控制，能讲清楚这一点，老师的印象分会明显不一样。

3. 一次跑通整套源码：从 JDK 到小程序开发者工具的完整路径

3.1 环境清点：JDK 8 还是 JDK 17，Maven 镜像先换好

先把环境摸清楚，不然后面所有报错都是环境问题。毕设源码绝大多数基于 JDK 8 编写，如果你电脑上是 JDK 17 甚至更高，先别急着跑，看下pom.xml里的<java.version>。JDK 8 写的项目拿到 JDK 17 下编译，最常见的问题是反射和动态代理报IllegalAccessException，还有javax.*和jakarta.*命名空间混乱。我的习惯是：毕设项目一律用 JDK 8，省时间；除非源码明确写了 Spring Boot 3.x，那才用 JDK 17。

Maven 依赖下载慢是另一个大坑，settings.xml里的镜像地址没配好，光拉依赖就能等半小时。配阿里云镜像是最常见做法，改完~/.m2/settings.xml后重新mvn clean install验证。

# 验证 Java 和 Maven java -version mvn -v # 如果 Maven 没配镜像，先检查下载速度 mvn clean compile

mvn clean compile能过，说明编译环境没问题；接下来再考虑数据库。这一步别跳，编译不过的情况下直接启动后端，报错日志会混在一起，反而更难定位。

3.2 MySQL 建库与导入：5.7 与 8.0 的认证插件差异

数据库是第二个大坎。源码一般给一个.sql文件，名叫db_school_secondhand.sql或类似。先建库再导入，字符集选utf8mb4，排序规则选utf8mb4_general_ci就够用。Windows 上装 MySQL 的教程一搜一大把，真正要注意的是版本差异：MySQL 5.7 默认认证插件是mysql_native_password，MySQL 8.0 默认是caching_sha2_password，旧版 JDBC 驱动连 8.0 会报Public Key Retrieval is not allowed。

# 进入 MySQL 命令行 mysql -u root -p # 建库并导入（注意.sql文件的路径） CREATE DATABASE IF NOT EXISTS secondhand DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE secondhand; SOURCE /path/to/your/sql/file.sql;

导入后别急着退出，先查一遍关键表有没有数据。有些源码的.sql里只建表不插数据，商品列表页打开就是空的，你还以为是接口写错了。另外 MySQL 8.0 的 JDBC 连接串里最好加上allowPublicKeyRetrieval=true&useSSL=false，否则 IDE 里连数据库直接报错。要是你喜欢用 Docker 起 MySQL，记得把端口映射和数据卷挂好，docker run -p 3306:3306后连不上，九成是端口冲突或者容器内bind-address没改。

3.3 启动 Spring Boot：端口、数据源和三个关键日志

配好数据库后，打开application.yml（或application.properties），把三样东西核对一遍：端口、数据源账号密码、MyBatis 的 mapper 映射路径。毕设源码常用的端口是 8080，如果被占用，改成 8081，但记得小程序端的request.js里也要同步改。

server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/secondhand?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false&allowPublicKeyRetrieval=true username: root password: 你的密码 driver-class-name: com.mysql.cj.jdbc.Driver

启动后盯着控制台看三个关键日志：一是Tomcat started on port(s): 8080，说明 Web 容器起来了；二是MapperFactoryBean或MyBatis相关日志，说明 mapper 接口被扫描到了；三是数据源HikariPool或Druid的初始化日志，说明数据库连接池成功。三条都出现再碰前端，否则先回头查配置。

# 直接启动 mvn spring-boot:run # 或者打包后启动 mvn clean package -DskipTests java -jar target/*.jar

如果启动报错说 mapper 找不到，八成是@MapperScan的包路径写错，或者 XML 文件没放在resources/mapper下。启动成功后再用curl http://localhost:8080/api/goods/list手动打一次接口，返回 JSON 说明后端已经通了。

3.4 小程序接入：appid、request 域名和第一个页面请求

后端通了你可能会松口气，但真正的坑在小程序端。先用微信开发者工具导入项目，目录选源码里的miniprogram文件夹，然后改project.config.json里的appid，用自己的测试号最好，有些源码里的 appid 是作者本人的，你直接跑会提示「无法获取用户信息」。

{ "appid": "你的appid", "projectname": "secondhand-miniprogram", "setting": { "urlCheck": false } }

urlCheck: false对应开发者工具里「不校验合法域名」的开关，这一步至关重要。然后找到utils/request.js或api.js，把baseUrl改成http://localhost:8080。不要在真机上直接预览，因为手机访问不到电脑的 localhost。常见做法是电脑和手机连同一个 Wi-Fi，把baseUrl改成电脑的局域网 IP，比如http://192.168.1.5:8080。

注意：局域网 IP 调试模式下能跑通，但发布上线时必须换成 HTTPS 的备案域名，这是微信的硬性规定。

改完后点编译，如果首页能刷出商品列表，说明前后端链路已经通了大半。这时用 Charles 打开看请求，能观察到wx.request实际发出的 URL、header 和参数，排查问题效率比瞎猜高得多。

4. 前后端联调的关键参数：request 合法域名、token 过期与图片上传

4.1 wx.request 合法域名：本地调试与真机发布的两种选择

这个坑几乎每个做小程序毕设的人都会踩一遍。开发阶段开发者工具默认会拦截非 HTTPS 域名，你需要在「详情 → 本地设置」里勾选「不校验合法域名、web-view（业务域名）、TLS 版本以及 HTTPS 证书」。这个选项只对开发者工具生效，真机预览时不起作用，所以真机调试必须走两种路：要么用测试号配合局域网 IP，要么把后端部署到有 HTTPS 证书的服务器上。

我的建议是，毕业设计阶段不要为了 HTTPS 去折腾服务器。你只需要在wx.request封装里把http://192.168.x.x:8080作为 baseUrl，然后手机和电脑连同一 Wi-Fi，真机预览就能调通。但你要知道，这个方案只能用于演示，答辩现场的 Wi-Fi 环境如果变了，IP 会跟着变。稳妥做法是答辩前一晚把项目里的 IP 换成现场网络环境下的新 IP，重新预览一次。

// utils/request.js 里的核心封装 const BASE_URL = 'http://192.168.1.5:8080'; // 改成你电脑的局域网IP function request(path, method = 'GET', data = {}) { return new Promise((resolve, reject) => { wx.request({ url: BASE_URL + path, method: method, data: data, header: { 'Content-Type': 'application/json', 'Authorization': wx.getStorageSync('token') || '' }, success: (res) => { if (res.data.code === 0) { resolve(res.data.data); } else if (res.statusCode === 401) { wx.removeStorageSync('token'); wx.navigateTo({ url: '/pages/login/login' }); reject(new Error('登录过期')); } else { reject(new Error(res.data.msg || '请求失败')); } }, fail: reject }); }); }

这段代码把 token 统一放在 header 里，并且对 401 做了拦截。注意wx.getStorageSync('token')在冷启动后可能为空，所以登录页要保证先调登录接口再发起业务请求，否则每次都会跳回登录页。很多源码在这块写得潦草，token 空值也发请求，后端直接 401，页面白屏。

4.2 登录态设计：双 token、过期时间和刷新策略

校园二手平台这种低并发项目，用单 token 也能跑，但你得知道它的问题：token 只有过期时间没有续期机制，用户玩着玩着突然跳回登录页，体验很差。答辩时老师如果问「用户长期不操作后 token 过期怎么办」，你答不上来就是减分项。源码里如果是单 token，建议你自己改成双 token 结构：access_token短时效（2 小时），refresh_token长时效（14 天），接口返回 401 时用 refresh_token 静默换新。

// 后端登录接口返回的简化结构 Map<String, Object> result = new HashMap<>(); result.put("access_token", jwtUtil.createToken(userId, 2 * 60 * 60 * 1000L)); result.put("refresh_token", jwtUtil.createToken(userId, 14 * 24 * 60 * 60 * 1000L)); result.put("expires_in", 2 * 60 * 60);

小程序端要做的就是在收到 401 后，拿着 refresh_token 调/api/user/refresh接口，成功了就把新 token 存回 storage，再用旧 token 重放刚才失败的请求。这个逻辑放在request.js里实现，别散落在各个页面。注意 refresh_token 也要设失效时间，否则就是永久登录，安全问题不谈，答辩时老师也会问。

4.3 图片上传与回显：从 wx.chooseMedia 到静态资源映射

发布商品时传图片，是最容易出「图片裂开」的地方。小程序端用wx.chooseMedia拿到临时文件路径，再用wx.uploadFile传给后端。后端的实现五花八门，有的存本地磁盘，有的传腾讯云 COS。毕设源码一般选本地存储，你也别强求上对象存储，但有一个点必须确认：静态资源映射有没有配。

// 后端静态资源映射配置 @Configuration public class WebMvcConfig implements WebMvcConfigurer { @Override public void addResourceHandlers(ResourceHandlerRegistry registry) { // 把 /upload/** 映射到本地磁盘目录，注意是绝对路径 registry.addResourceHandler("/upload/**") .addResourceResolver(new PathResourceResolver()) .addResourceLocations("file:" + uploadDir + "/"); } }

没配这个映射，数据库里存的是/upload/goods/xxx.jpg，但浏览器访问直接 404。另外检查上传接口的返回，有的源码只返回文件名，有的返回完整 URL。如果返回的是相对路径，小程序端拼图片地址时一定要拼 baseUrl，不然image组件的src会以相对路径解析，同样裂图。还有一个小细节：wx.uploadFile的name参数必须和后端MultipartFile的参数名一致，不一致会在后端报Required request part 'file' is not present，前端还看不出明显报错。

5. 毕业设计最常翻车的七个坑：从 MySQL 时区到微信手机号登录

5.1 连接、时区与编码：MySQL 8.0 认证、serverTimezone 和 utf8mb4

现象：后端启动时报Public Key Retrieval is not allowed，或者接口能通但查出来的时间比实际时间晚了 8 小时。

原因：MySQL 8.0 默认的caching_sha2_password认证插件要求客户端在非 SSL 连接下先取公钥；而 JDBC 连接串里没配serverTimezone时，驱动会用 JVM 默认时区，中国机器上是东八区，但 MySQL 的datetime有时候按 UTC 存，差 8 小时就是这么来的。解决：url里加allowPublicKeyRetrieval=true&useSSL=false&serverTimezone=Asia/Shanghai。如果项目里所有时间字段都是datetime，后端实体类里建议统一用LocalDateTime，别混用Date。

还有个隐性编码坑：商品描述里的 emoji 表情存不进去，报Incorrect string value。这是建库时用了utf8而不是utf8mb4。解决就是重建库或用ALTER TABLE ... CONVERT TO CHARACTER SET utf8mb4，连带 JDBC 连接串里的characterEncoding=utf8改成utf8mb4。这个坑最容易在「趣味描述」「商品昵称」这类用户输入字段里爆出来。

5.2 登录与用户信息：手机号获取、头像昵称填写的权限边界

现象：真机调试点「获取手机号」按钮没反应，或者报getPhoneNumber:fail no permission。

原因：微信的「手机号快速验证组件」不是所有小程序都能用，个人主体小程序没有这个接口权限，必须是企业主体且通过认证。毕设项目大多是个人测试号，天然拿不到手机号。解决：别死磕手机号，后端用wx.login换 openid 作为用户唯一标识就够了，手机号做成选填，或者用一个模拟输入框代替。答辩时老师更看重你懂不懂「为什么不能直接拿手机号」，而不是你真的拿到手机号。

同一批坑还有头像昵称。旧的wx.getUserProfile在基础库 2.27.1 之后已经不能弹出授权框了，得用button open-type="chooseAvatar"拿头像临时路径，昵称用input的type="nickname"让用户填。源码里如果还是旧写法，真机预览时头像永远是个默认图。

5.3 商品与订单：图片 404、超卖、字段长度

现象：商品发布成功，但列表页图片全是灰块，点击图片放大也打不开。

原因：图片存到了本地upload目录，但后端没配静态资源映射；或者图片路径存的是完整本地路径C:/...，前端拼 URL 时拼错了。解决：先确认数据库里的image字段是什么格式。如果是/upload/xxx.jpg，就在前端拼baseUrl + image；如果是完整 URL，检查后端映射和端口。用浏览器直接访问图片地址是最快的排查方式——能开说明后端没问题，不能开就顺着 URL 检查映射。

超卖问题在前面讲过，这里再补一个变体：源码里如果用了 MyBatis-Plus 的QueryWrapper做update，要注意setSql("stock = stock - 1")和eq("stock > 0")的写法，别在 Java 代码里先getStock()再setStock()，这不是原子操作。还有商品表title如果是varchar(50)，标题写长一点就报Data too long，直接把字段改成varchar(200)更省事，不要怪用户乱输入。

5.4 小程序界面：顶部导航栏、radio 样式和真机白屏

现象：自定义导航栏的页面在 iPhone 上顶栏和胶囊按钮重叠，在 Android 上又正常。

原因：navigationStyle: custom后，页面顶部安全区高度要自己适配。胶囊按钮的位置可以用wx.getMenuButtonBoundingClientRect()拿到，再根据wx.getSystemInfoSync()的状态栏高度算出导航栏高度。很多源码直接用写死的44px，换台手机就错位。解决：封装一个getNavBarInfo()，在app.js里算好存到globalData，页面里统一取。

另一个界面坑是分类筛选用的radio-group在自定义组件里样式错乱，原因是原生radio的默认样式在不同基础库表现不一样。常见做法是不用原生radio，直接用view搭配选中态 class，选中项加边框和背景色，简单可控。至于真机白屏，多数是接口返回的数据结构里res.data.data是数组，但页面用{{goodsList}}直接渲染了res.data，调试时看 console 里的报错最快。

6. 把「能跑」变成「能答辩」：用 20 分钟做一次可演示的代码走读

到这一步，项目已经能跑了，但这离「毕业设计答辩通过」还差一口气。我的习惯是花 20 分钟做三件事，专治答辩时脑子空白。

第一，把数据演一遍。注册两个账号，一个当卖家发布三件商品，一个当买家依次走「浏览→下单→模拟支付→确认收货」的完整链路。注意每个操作任务控台里确认后端日志有对应打印，这样演示时你可以随时指着日志说「看，这一步调了/api/order/create，事务提交了」。发布商品时别用你自己的照片，随便拍两张桌上的东西，价格写 9.9、19.9 这种好算的数，方便现场口算校验。

第二，挑两个技术点准备深挖。一个讲库存扣减的原子性，把UPDATE goods SET stock = stock - 1 WHERE id = ? AND stock > 0那行代码背下来，老师问并发你就画这个；另一个讲登录态的双 token 设计，说清楚为什么wx.login拿到的是 code 而不是 openid，以及刷新 token 的作用。这两个点是你和几千份雷同毕设拉开差距的地方。

第三，把数据列表的排序和分页讲明白。商品列表用 SQL 的ORDER BY create_time DESC或price ASC排序，不要在内存里用冒泡排序——真有学生干过这事，答辩现场被笑过。分页可以用 MyBatis-Plus 的Page对象，讲清楚current和size两个参数分别控制什么。

答辩前最后一晚，把数据库脚本重新导入一遍，造好的演示数据清空重来一次，避免现场出现「上一轮测试留下的脏数据导致列表错乱」的尴尬。源码里如果带了 README，把启动步骤照着走一遍，截图存到手机相册，以防现场网络抽风连不上数据库。

我做毕设辅导这几年，见过太多「代码能跑但讲不出为什么」的学生。源码给你省的是造轮子的时间，但状态机、事务边界、登录态这些设计决策，你答不上来就是硬伤。这篇笔记里写的每个坑都是有人真踩过的，你提前避掉，答辩比同组人稳一截。希望帮到你。

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