简介这是一套面向高校计算机相关专业学生的微信小程序点餐系统实战项目源码适用于毕业设计、期末大作业与课程设计场景对新手同样友好。项目采用前后端分离结构小程序端负责点餐、菜品浏览与订单交互后台管理端承担数据维护与业务管理并配套数据库脚本整体逻辑完整、代码注释清晰便于理解与二次修改。压缩包共210个文件约1.84MB其中72个Java文件构成后台核心业务逻辑51个PNG与4个JPG为界面素材16个WXSS、15个JS、13个WXML与16个JSON组成小程序页面与配置另有11个FTL模板、1个SQL数据库脚本及若干配置文件覆盖从页面渲染到数据存储的完整链路。目前已有984人学习下载作者自述为个人手打并获导师认可的高分项目下载后简单部署即可运行适合需要快速搭建点餐系统原型、对照学习小程序与后台联调思路的读者参考使用。1. 从一份能跑起来的点餐小程序源码说起它到底能省你多少时间如果你正在为毕业设计发愁或者带学生做课程设计需要一个能演示、能讲清楚、还能二次开发的完整项目那这套微信小程序点餐系统源码值得你花十分钟看完。它不是那种只丢几个页面截图的“伪源码”而是包含小程序前端、Java 后台管理端、数据库脚本的完整工程文件清单里能看到mvnw.cmd、style.css、list.ftl、login.ftl、index.ftl、detail.ftl、nav.ftl这些真实文件说明后台用的是 Maven 构建加 FreeMarker 模板引擎的典型组合。换句话说你拿到手的是一个前后端分离、有数据库支撑、能直接部署跑通的全栈项目而不是一个只能看不能动的空壳。这套资源解决的核心问题是“从零搭一个点餐系统太慢”。正常从建表、写接口、调小程序页面到后台管理没两周下不来而它把骨架和业务逻辑都填好了你只需要改配置、导数据库、跑起来就能看到完整的点餐流程。适合谁一是做毕业设计需要高分项目的同学二是教小程序开发需要案例的老师三是想快速了解微信小程序点餐系统完整实现路径的开发者。关键词里反复出现的“毕业设计”“微信小程序”“数据库”“开发实战”恰好对应了它的三个硬核卖点有论文级项目结构、有真实数据库交互、有可复现的部署流程。2. 拆开工程看结构小程序端、后台端、数据库三块怎么协同2.1 小程序端页面组织与点餐主流程小程序端的核心页面通常围绕“菜单浏览 → 加入购物车 → 下单 → 订单详情”这条线展开。从文件命名习惯看index.ftl和list.ftl在后台模板里出现说明后台管理端负责菜品列表和分类管理而小程序端一般会有对应的pages/menu、pages/cart、pages/order等目录。点餐系统的关键交互是用户进入首页后看到菜品分类点击某个分类加载对应菜品列表选中规格后加入购物车最后提交订单生成一条记录。这里有一个容易被忽略的细节菜品列表的加载方式。如果一次性拉取所有菜品数据量大了会卡常见做法是分页加载小程序端用onReachBottom触发下一页请求。源码里如果有list.ftl对应的接口大概率是后台管理端的列表分页小程序端则通过 API 获取 JSON 数据。你拿到源码后先看小程序端的app.json里注册了哪些页面再顺着pages目录逐个打开就能理清整个点餐流程的页面跳转关系。// 小程序端菜品列表分页加载示例常见写法 Page({ data: { menuList: [], pageNum: 1, pageSize: 10, hasMore: true }, onLoad() { this.loadMenuList(); }, onReachBottom() { if (this.data.hasMore) { this.setData({ pageNum: this.data.pageNum 1 }); this.loadMenuList(); } }, loadMenuList() { const { pageNum, pageSize } this.data; wx.request({ url: http://localhost:8080/api/menu/list, data: { pageNum, pageSize }, success: (res) { // 关键拼接新数据而不是覆盖否则上拉加载会丢失之前的内容 const newList this.data.menuList.concat(res.data.rows); this.setData({ menuList: newList, hasMore: res.data.rows.length pageSize }); } }); } });上面这段代码的逻辑说明pageNum和pageSize控制分页参数onReachBottom是微信小程序页面触底的生命周期函数用来触发下一页加载。参数怎么改pageSize一般设 10 到 20太小请求频繁太大首屏渲染慢。hasMore的判断依据是返回条数是否等于pageSize如果小于说明没有更多数据了。注意concat拼接而不是直接赋值这是上拉加载最容易翻车的地方很多新手直接setData({ menuList: res.data.rows })结果第二页把第一页覆盖了。2.2 后台管理端Maven 构建与 FreeMarker 模板渲染后台端从mvnw.cmd这个文件就能判断是 Maven 项目而且带了 Maven Wrapper意味着你不需要本地装 Maven 也能构建。pom.xml里通常会引入 Spring Boot、MyBatis、MySQL 驱动、FreeMarker 等依赖。login.ftl、index.ftl、list.ftl、detail.ftl、nav.ftl这些模板文件说明后台页面是用 FreeMarker 渲染的不是前后端分离的 Vue 或 React 后台。这种方案在毕业设计里很常见因为上手快、调试直观改完模板刷新页面就能看到效果。部署后台的步骤大致是先确认 JDK 版本一般是 JDK 8 或 11然后导入数据库脚本接着修改application.yml或application.properties里的数据库连接信息最后用mvnw.cmd spring-boot:run启动。如果你用 IDEA直接右键运行主启动类也行。启动成功后访问http://localhost:8080应该能看到登录页默认账号密码通常在数据库的admin表里或者源码注释里会写。# Windows 下用 Maven Wrapper 启动后台 mvnw.cmd clean package -DskipTests mvnw.cmd spring-boot:run # 如果提示端口占用改 application.yml 里的 server.port # 如果数据库连接失败检查 spring.datasource.url 的库名和时区参数命令说明clean package先清理再打包-DskipTests跳过测试加快构建。spring-boot:run直接启动适合开发调试。常见问题是 MySQL 8 以上需要加serverTimezoneAsia/Shanghai否则连接会报时区错误。另外mvnw.cmd第一次运行会下载 Maven 和依赖网络不好的话会卡很久建议配置国内镜像。2.3 数据库表结构与点餐业务字段映射点餐系统的数据库一般至少包含这几张表用户表、菜品分类表、菜品表、订单表、订单详情表、购物车表可选。从关键词“数据库增删改查”和“mysql数据库修改结构”来看这套源码的数据库脚本应该覆盖了基本的 CRUD 操作。你需要重点关注的是订单表和订单详情表的关系一个订单对应多条订单详情每条详情记录菜品 ID、数量、单价。菜品表里通常有name、price、image、category_id、status等字段status用来控制上架下架。导入数据库时先建库再导表。常见做法是用 Navicat 或命令行source执行 SQL 文件。如果源码里没有单独的 SQL 文件可能在resources目录下有schema.sql或data.sql。导入后检查字符集建议用utf8mb4否则菜品名称里的特殊字符或 Emoji 会乱码。-- 订单表与订单详情表的关键字段示例 CREATE TABLE orders ( id INT NOT NULL AUTO_INCREMENT, user_id INT NOT NULL, total_price DECIMAL(10,2) NOT NULL, status TINYINT DEFAULT 0 COMMENT 0待支付 1已支付 2已完成, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE order_detail ( id INT NOT NULL AUTO_INCREMENT, order_id INT NOT NULL, dish_id INT NOT NULL, quantity INT NOT NULL, price DECIMAL(10,2) NOT NULL, PRIMARY KEY (id), KEY idx_order_id (order_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;字段说明status用 TINYINT 而不是字符串查询效率更高。total_price用 DECIMAL 而不是 FLOAT避免金额计算精度丢失。order_detail表里冗余存了price这是有意为之因为菜品价格可能后续调整订单里的价格必须锁定下单时的值。idx_order_id索引是为了加快根据订单 ID 查详情的速度。这些细节在毕业设计答辩时是加分项能体现你对数据库设计的理解。3. 本地跑通全流程从导入 SQL 到小程序联调3.1 环境准备与依赖版本确认跑通这套项目需要三样东西JDK、MySQL、微信开发者工具。JDK 版本看pom.xml里的java.version如果是 1.8 就装 JDK 8如果是 11 就装 11版本不匹配会报UnsupportedClassVersionError。MySQL 建议 5.7 或 8.0两者语法差异不大但 8.0 的驱动类名是com.mysql.cj.jdbc.Driver5.7 是com.mysql.jdbc.Driver改配置时要注意。微信开发者工具去官方下载稳定版就行安装后登录你的小程序账号没有账号可以用测试号。依赖版本这块有个血泪经验如果pom.xml里 Spring Boot 版本是 2.x那 MySQL 驱动版本要对应不要自己乱升。曾经有人把驱动从 5.1 升到 8.0 但没改application.yml里的 URL 参数结果启动一直报Communications link failure排查了半天才发现是时区和 SSL 参数的问题。所以拿到源码第一件事先看pom.xml和application.yml把版本对应关系理清楚。3.2 后台启动与接口自测后台启动后不要急着开小程序先用浏览器或 Postman 测几个关键接口。比如登录接口POST /admin/login菜品列表接口GET /api/menu/list订单提交接口POST /api/order/create。测接口的目的是确认后台没问题这样小程序端如果报错就能快速定位是前端问题还是后端问题。# 用 curl 测登录接口Windows 下用 Git Bash 或 PowerShell curl -X POST http://localhost:8080/admin/login \ -H Content-Type: application/json \ -d {username:admin,password:123456} # 测菜品列表 curl http://localhost:8080/api/menu/list?pageNum1pageSize5如果登录返回 token 或 session说明后台认证正常。如果菜品列表返回 JSON 数组说明数据库连接和查询都没问题。常见翻车点是跨域小程序端请求后台时如果后台没配 CORS浏览器控制台会报Access-Control-Allow-Origin。解决办法是在后台加一个全局跨域配置类或者用 Nginx 反向代理。毕业设计里一般直接在 Spring Boot 里加CrossOrigin注解就行。3.3 小程序端配置与真机预览小程序端需要改两个地方一是app.js或config.js里的后台接口地址把localhost改成你电脑的局域网 IP因为手机真机预览时localhost指向的是手机自己二是project.config.json里的appid换成你自己的小程序 appid否则没法真机预览。改完后在微信开发者工具里点“编译”模拟器上应该能看到首页菜品列表。真机预览时手机和电脑必须在同一个 WiFi 下而且电脑防火墙要允许 8080 端口入站。如果模拟器正常但真机请求失败九成是 IP 或防火墙问题。另外微信开发者工具里要勾选“不校验合法域名”否则请求http://开头的本地接口会被拦截。这个选项在“详情 → 本地设置”里毕业设计阶段用这个方式最省事不用去配 HTTPS 域名。4. 避坑与排查部署时最容易翻车的五个地方4.1 数据库连接报时区错误现象后台启动时报The server time zone value ?D1ú±ê×?ê±?? is unrecognized。原因MySQL 8 的驱动要求明确指定时区而application.yml里的 URL 没加serverTimezone参数。解决在 JDBC URL 后面追加?serverTimezoneAsia/ShanghaiuseUnicodetruecharacterEncodingutf8useSSLfalse。如果还报错检查 MySQL 服务是否启动端口是不是 3306。4.2 小程序请求返回 404 或 500现象小程序端菜品列表空白控制台显示request:fail或状态码 404。原因接口地址拼错了或者后台没启动或者后台的context-path和请求路径不一致。解决先在浏览器直接访问接口 URL确认后台返回正常然后检查小程序端wx.request的url是否拼写正确注意http://和端口号。如果是 500看后台控制台异常堆栈通常是 SQL 写错或字段名不匹配。4.3 FreeMarker 模板找不到或乱码现象访问后台页面报Template not found或页面显示乱码。原因spring.freemarker.template-loader-path配置的路径不对或者模板文件编码不是 UTF-8。解决确认application.yml里template-loader-path指向classpath:/templates/并且login.ftl等文件确实在src/main/resources/templates/下。乱码问题在application.yml里加spring.freemarker.charsetUTF-8和server.servlet.encoding.charsetUTF-8。4.4 Maven 依赖下载失败现象mvnw.cmd执行到一半卡住或报Could not resolve dependencies。原因默认从中央仓库下载网络不稳定。解决在pom.xml里加阿里云镜像仓库或者修改 Maven 的settings.xml。如果用的是 Maven Wrapper可以在.mvn/wrapper/maven-wrapper.properties里改distributionUrl为国内镜像地址。这个坑几乎每个人都会遇到提前配好镜像能省半小时。4.5 订单提交后购物车没清空现象下单成功但购物车数量还在再次下单会重复。原因下单接口只写了订单表没清购物车表或者小程序端没在成功回调里清空本地缓存。解决检查后台下单逻辑是否包含删除购物车记录的步骤小程序端在wx.request的success回调里调用this.setData({ cartList: [] })并清除wx.setStorageSync(cart)。这个属于业务逻辑漏洞答辩时如果被问到“下单后购物车怎么处理”要能说清楚。5. 二次开发与答辩加分三个能让你脱颖而出的改造点5.1 给菜品列表加分类筛选和搜索原始源码可能只做了简单的菜品列表你可以加一个分类筛选栏和搜索框。分类数据从后台category表拉取搜索用LIKE语句匹配菜品名称。这个改造不复杂但能让演示效果提升一个档次。具体做法在小程序端menu页面顶部加一个横向滚动的分类标签点击不同分类时重新请求GET /api/menu/list?categoryIdxxx搜索框用bindinput监听输入防抖 300ms 后请求GET /api/menu/search?keywordxxx。后台对应的 MyBatis 查询加一个动态 SQL 条件即可。!-- MyBatis 动态 SQL 示例分类和关键词组合查询 -- select idselectMenuList resultTypeMenu SELECT * FROM menu where if testcategoryId ! null AND category_id #{categoryId} /if if testkeyword ! null and keyword ! AND name LIKE CONCAT(%, #{keyword}, %) /if AND status 1 /where ORDER BY sort ASC LIMIT #{offset}, #{pageSize} /select参数说明categoryId和keyword都是可选条件status 1表示只查上架菜品。offset由pageNum和pageSize计算得出。这种动态 SQL 是 MyBatis 的常规用法答辩时能讲清楚where标签的作用和#{}与${}的区别基本就稳了。5.2 用 ECharts 给后台加营业数据看板后台管理端如果只有增删改查答辩时容易被说“太像 CRUD 练习”。加一个数据看板展示今日订单数、营业额、热销菜品 Top5立刻就不一样了。实现方式后台加一个GET /admin/dashboard/stats接口返回统计 JSON前端在index.ftl里引入 ECharts 的 CDN用 Ajax 拉数据渲染饼图和柱状图。统计 SQL 用GROUP BY和COUNT、SUM聚合注意时间范围用DATE(create_time) CURDATE()过滤当天。// 后台首页用 ECharts 渲染热销菜品柱状图 var chart echarts.init(document.getElementById(hotDishChart)); $.get(/admin/dashboard/hotDish, function (data) { chart.setOption({ title: { text: 热销菜品 Top5 }, tooltip: {}, xAxis: { data: data.names }, yAxis: {}, series: [{ name: 销量, type: bar, data: data.values, itemStyle: { color: #5B8FF9 } }] }); });这段代码的关键是后台返回的数据格式要和小程序的names、values数组对应。ECharts 的setOption是覆盖式更新如果多次调用要注意先clear。另外 FreeMarker 模板里引入 jQuery 和 ECharts 的 script 标签要放在/body之前否则 DOM 没加载完getElementById会返回 null。5.3 答辩演示的节奏控制与常见提问准备最后说一个非技术但很关键的技巧答辩演示不要从头到尾点一遍。提前准备好三个场景一是正常点餐流程从选菜到下单 30 秒内完成二是后台管理展示菜品上架和下架对小程序端的影响三是数据看板用数字说明系统有真实业务价值。老师常问的问题包括“订单号怎么生成的”“并发下单会不会超卖”“数据库索引加在哪了”提前把答案写在备注里。我自己的习惯是每次部署完新环境都强制走一遍“注册 → 登录 → 点餐 → 下单 → 后台查看订单”的完整链路确认没有遗漏的配置项。这套源码的注释比较全新手跟着注释改不容易迷路但数据库密码和接口地址这两处一定要改成自己的否则换台电脑就跑不起来。希望帮到你。本文还有配套的精品资源点击获取 微信小程序点餐系统源码：毕业设计全栈项目实战与部署指南
简介这是一套面向高校计算机相关专业学生的微信小程序点餐系统实战项目源码适用于毕业设计、期末大作业与课程设计场景对新手同样友好。项目采用前后端分离结构小程序端负责点餐、菜品浏览与订单交互后台管理端承担数据维护与业务管理并配套数据库脚本整体逻辑完整、代码注释清晰便于理解与二次修改。压缩包共210个文件约1.84MB其中72个Java文件构成后台核心业务逻辑51个PNG与4个JPG为界面素材16个WXSS、15个JS、13个WXML与16个JSON组成小程序页面与配置另有11个FTL模板、1个SQL数据库脚本及若干配置文件覆盖从页面渲染到数据存储的完整链路。目前已有984人学习下载作者自述为个人手打并获导师认可的高分项目下载后简单部署即可运行适合需要快速搭建点餐系统原型、对照学习小程序与后台联调思路的读者参考使用。1. 从一份能跑起来的点餐小程序源码说起它到底能省你多少时间如果你正在为毕业设计发愁或者带学生做课程设计需要一个能演示、能讲清楚、还能二次开发的完整项目那这套微信小程序点餐系统源码值得你花十分钟看完。它不是那种只丢几个页面截图的“伪源码”而是包含小程序前端、Java 后台管理端、数据库脚本的完整工程文件清单里能看到mvnw.cmd、style.css、list.ftl、login.ftl、index.ftl、detail.ftl、nav.ftl这些真实文件说明后台用的是 Maven 构建加 FreeMarker 模板引擎的典型组合。换句话说你拿到手的是一个前后端分离、有数据库支撑、能直接部署跑通的全栈项目而不是一个只能看不能动的空壳。这套资源解决的核心问题是“从零搭一个点餐系统太慢”。正常从建表、写接口、调小程序页面到后台管理没两周下不来而它把骨架和业务逻辑都填好了你只需要改配置、导数据库、跑起来就能看到完整的点餐流程。适合谁一是做毕业设计需要高分项目的同学二是教小程序开发需要案例的老师三是想快速了解微信小程序点餐系统完整实现路径的开发者。关键词里反复出现的“毕业设计”“微信小程序”“数据库”“开发实战”恰好对应了它的三个硬核卖点有论文级项目结构、有真实数据库交互、有可复现的部署流程。2. 拆开工程看结构小程序端、后台端、数据库三块怎么协同2.1 小程序端页面组织与点餐主流程小程序端的核心页面通常围绕“菜单浏览 → 加入购物车 → 下单 → 订单详情”这条线展开。从文件命名习惯看index.ftl和list.ftl在后台模板里出现说明后台管理端负责菜品列表和分类管理而小程序端一般会有对应的pages/menu、pages/cart、pages/order等目录。点餐系统的关键交互是用户进入首页后看到菜品分类点击某个分类加载对应菜品列表选中规格后加入购物车最后提交订单生成一条记录。这里有一个容易被忽略的细节菜品列表的加载方式。如果一次性拉取所有菜品数据量大了会卡常见做法是分页加载小程序端用onReachBottom触发下一页请求。源码里如果有list.ftl对应的接口大概率是后台管理端的列表分页小程序端则通过 API 获取 JSON 数据。你拿到源码后先看小程序端的app.json里注册了哪些页面再顺着pages目录逐个打开就能理清整个点餐流程的页面跳转关系。// 小程序端菜品列表分页加载示例常见写法 Page({ data: { menuList: [], pageNum: 1, pageSize: 10, hasMore: true }, onLoad() { this.loadMenuList(); }, onReachBottom() { if (this.data.hasMore) { this.setData({ pageNum: this.data.pageNum 1 }); this.loadMenuList(); } }, loadMenuList() { const { pageNum, pageSize } this.data; wx.request({ url: http://localhost:8080/api/menu/list, data: { pageNum, pageSize }, success: (res) { // 关键拼接新数据而不是覆盖否则上拉加载会丢失之前的内容 const newList this.data.menuList.concat(res.data.rows); this.setData({ menuList: newList, hasMore: res.data.rows.length pageSize }); } }); } });上面这段代码的逻辑说明pageNum和pageSize控制分页参数onReachBottom是微信小程序页面触底的生命周期函数用来触发下一页加载。参数怎么改pageSize一般设 10 到 20太小请求频繁太大首屏渲染慢。hasMore的判断依据是返回条数是否等于pageSize如果小于说明没有更多数据了。注意concat拼接而不是直接赋值这是上拉加载最容易翻车的地方很多新手直接setData({ menuList: res.data.rows })结果第二页把第一页覆盖了。2.2 后台管理端Maven 构建与 FreeMarker 模板渲染后台端从mvnw.cmd这个文件就能判断是 Maven 项目而且带了 Maven Wrapper意味着你不需要本地装 Maven 也能构建。pom.xml里通常会引入 Spring Boot、MyBatis、MySQL 驱动、FreeMarker 等依赖。login.ftl、index.ftl、list.ftl、detail.ftl、nav.ftl这些模板文件说明后台页面是用 FreeMarker 渲染的不是前后端分离的 Vue 或 React 后台。这种方案在毕业设计里很常见因为上手快、调试直观改完模板刷新页面就能看到效果。部署后台的步骤大致是先确认 JDK 版本一般是 JDK 8 或 11然后导入数据库脚本接着修改application.yml或application.properties里的数据库连接信息最后用mvnw.cmd spring-boot:run启动。如果你用 IDEA直接右键运行主启动类也行。启动成功后访问http://localhost:8080应该能看到登录页默认账号密码通常在数据库的admin表里或者源码注释里会写。# Windows 下用 Maven Wrapper 启动后台 mvnw.cmd clean package -DskipTests mvnw.cmd spring-boot:run # 如果提示端口占用改 application.yml 里的 server.port # 如果数据库连接失败检查 spring.datasource.url 的库名和时区参数命令说明clean package先清理再打包-DskipTests跳过测试加快构建。spring-boot:run直接启动适合开发调试。常见问题是 MySQL 8 以上需要加serverTimezoneAsia/Shanghai否则连接会报时区错误。另外mvnw.cmd第一次运行会下载 Maven 和依赖网络不好的话会卡很久建议配置国内镜像。2.3 数据库表结构与点餐业务字段映射点餐系统的数据库一般至少包含这几张表用户表、菜品分类表、菜品表、订单表、订单详情表、购物车表可选。从关键词“数据库增删改查”和“mysql数据库修改结构”来看这套源码的数据库脚本应该覆盖了基本的 CRUD 操作。你需要重点关注的是订单表和订单详情表的关系一个订单对应多条订单详情每条详情记录菜品 ID、数量、单价。菜品表里通常有name、price、image、category_id、status等字段status用来控制上架下架。导入数据库时先建库再导表。常见做法是用 Navicat 或命令行source执行 SQL 文件。如果源码里没有单独的 SQL 文件可能在resources目录下有schema.sql或data.sql。导入后检查字符集建议用utf8mb4否则菜品名称里的特殊字符或 Emoji 会乱码。-- 订单表与订单详情表的关键字段示例 CREATE TABLE orders ( id INT NOT NULL AUTO_INCREMENT, user_id INT NOT NULL, total_price DECIMAL(10,2) NOT NULL, status TINYINT DEFAULT 0 COMMENT 0待支付 1已支付 2已完成, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE order_detail ( id INT NOT NULL AUTO_INCREMENT, order_id INT NOT NULL, dish_id INT NOT NULL, quantity INT NOT NULL, price DECIMAL(10,2) NOT NULL, PRIMARY KEY (id), KEY idx_order_id (order_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;字段说明status用 TINYINT 而不是字符串查询效率更高。total_price用 DECIMAL 而不是 FLOAT避免金额计算精度丢失。order_detail表里冗余存了price这是有意为之因为菜品价格可能后续调整订单里的价格必须锁定下单时的值。idx_order_id索引是为了加快根据订单 ID 查详情的速度。这些细节在毕业设计答辩时是加分项能体现你对数据库设计的理解。3. 本地跑通全流程从导入 SQL 到小程序联调3.1 环境准备与依赖版本确认跑通这套项目需要三样东西JDK、MySQL、微信开发者工具。JDK 版本看pom.xml里的java.version如果是 1.8 就装 JDK 8如果是 11 就装 11版本不匹配会报UnsupportedClassVersionError。MySQL 建议 5.7 或 8.0两者语法差异不大但 8.0 的驱动类名是com.mysql.cj.jdbc.Driver5.7 是com.mysql.jdbc.Driver改配置时要注意。微信开发者工具去官方下载稳定版就行安装后登录你的小程序账号没有账号可以用测试号。依赖版本这块有个血泪经验如果pom.xml里 Spring Boot 版本是 2.x那 MySQL 驱动版本要对应不要自己乱升。曾经有人把驱动从 5.1 升到 8.0 但没改application.yml里的 URL 参数结果启动一直报Communications link failure排查了半天才发现是时区和 SSL 参数的问题。所以拿到源码第一件事先看pom.xml和application.yml把版本对应关系理清楚。3.2 后台启动与接口自测后台启动后不要急着开小程序先用浏览器或 Postman 测几个关键接口。比如登录接口POST /admin/login菜品列表接口GET /api/menu/list订单提交接口POST /api/order/create。测接口的目的是确认后台没问题这样小程序端如果报错就能快速定位是前端问题还是后端问题。# 用 curl 测登录接口Windows 下用 Git Bash 或 PowerShell curl -X POST http://localhost:8080/admin/login \ -H Content-Type: application/json \ -d {username:admin,password:123456} # 测菜品列表 curl http://localhost:8080/api/menu/list?pageNum1pageSize5如果登录返回 token 或 session说明后台认证正常。如果菜品列表返回 JSON 数组说明数据库连接和查询都没问题。常见翻车点是跨域小程序端请求后台时如果后台没配 CORS浏览器控制台会报Access-Control-Allow-Origin。解决办法是在后台加一个全局跨域配置类或者用 Nginx 反向代理。毕业设计里一般直接在 Spring Boot 里加CrossOrigin注解就行。3.3 小程序端配置与真机预览小程序端需要改两个地方一是app.js或config.js里的后台接口地址把localhost改成你电脑的局域网 IP因为手机真机预览时localhost指向的是手机自己二是project.config.json里的appid换成你自己的小程序 appid否则没法真机预览。改完后在微信开发者工具里点“编译”模拟器上应该能看到首页菜品列表。真机预览时手机和电脑必须在同一个 WiFi 下而且电脑防火墙要允许 8080 端口入站。如果模拟器正常但真机请求失败九成是 IP 或防火墙问题。另外微信开发者工具里要勾选“不校验合法域名”否则请求http://开头的本地接口会被拦截。这个选项在“详情 → 本地设置”里毕业设计阶段用这个方式最省事不用去配 HTTPS 域名。4. 避坑与排查部署时最容易翻车的五个地方4.1 数据库连接报时区错误现象后台启动时报The server time zone value ?D1ú±ê×?ê±?? is unrecognized。原因MySQL 8 的驱动要求明确指定时区而application.yml里的 URL 没加serverTimezone参数。解决在 JDBC URL 后面追加?serverTimezoneAsia/ShanghaiuseUnicodetruecharacterEncodingutf8useSSLfalse。如果还报错检查 MySQL 服务是否启动端口是不是 3306。4.2 小程序请求返回 404 或 500现象小程序端菜品列表空白控制台显示request:fail或状态码 404。原因接口地址拼错了或者后台没启动或者后台的context-path和请求路径不一致。解决先在浏览器直接访问接口 URL确认后台返回正常然后检查小程序端wx.request的url是否拼写正确注意http://和端口号。如果是 500看后台控制台异常堆栈通常是 SQL 写错或字段名不匹配。4.3 FreeMarker 模板找不到或乱码现象访问后台页面报Template not found或页面显示乱码。原因spring.freemarker.template-loader-path配置的路径不对或者模板文件编码不是 UTF-8。解决确认application.yml里template-loader-path指向classpath:/templates/并且login.ftl等文件确实在src/main/resources/templates/下。乱码问题在application.yml里加spring.freemarker.charsetUTF-8和server.servlet.encoding.charsetUTF-8。4.4 Maven 依赖下载失败现象mvnw.cmd执行到一半卡住或报Could not resolve dependencies。原因默认从中央仓库下载网络不稳定。解决在pom.xml里加阿里云镜像仓库或者修改 Maven 的settings.xml。如果用的是 Maven Wrapper可以在.mvn/wrapper/maven-wrapper.properties里改distributionUrl为国内镜像地址。这个坑几乎每个人都会遇到提前配好镜像能省半小时。4.5 订单提交后购物车没清空现象下单成功但购物车数量还在再次下单会重复。原因下单接口只写了订单表没清购物车表或者小程序端没在成功回调里清空本地缓存。解决检查后台下单逻辑是否包含删除购物车记录的步骤小程序端在wx.request的success回调里调用this.setData({ cartList: [] })并清除wx.setStorageSync(cart)。这个属于业务逻辑漏洞答辩时如果被问到“下单后购物车怎么处理”要能说清楚。5. 二次开发与答辩加分三个能让你脱颖而出的改造点5.1 给菜品列表加分类筛选和搜索原始源码可能只做了简单的菜品列表你可以加一个分类筛选栏和搜索框。分类数据从后台category表拉取搜索用LIKE语句匹配菜品名称。这个改造不复杂但能让演示效果提升一个档次。具体做法在小程序端menu页面顶部加一个横向滚动的分类标签点击不同分类时重新请求GET /api/menu/list?categoryIdxxx搜索框用bindinput监听输入防抖 300ms 后请求GET /api/menu/search?keywordxxx。后台对应的 MyBatis 查询加一个动态 SQL 条件即可。!-- MyBatis 动态 SQL 示例分类和关键词组合查询 -- select idselectMenuList resultTypeMenu SELECT * FROM menu where if testcategoryId ! null AND category_id #{categoryId} /if if testkeyword ! null and keyword ! AND name LIKE CONCAT(%, #{keyword}, %) /if AND status 1 /where ORDER BY sort ASC LIMIT #{offset}, #{pageSize} /select参数说明categoryId和keyword都是可选条件status 1表示只查上架菜品。offset由pageNum和pageSize计算得出。这种动态 SQL 是 MyBatis 的常规用法答辩时能讲清楚where标签的作用和#{}与${}的区别基本就稳了。5.2 用 ECharts 给后台加营业数据看板后台管理端如果只有增删改查答辩时容易被说“太像 CRUD 练习”。加一个数据看板展示今日订单数、营业额、热销菜品 Top5立刻就不一样了。实现方式后台加一个GET /admin/dashboard/stats接口返回统计 JSON前端在index.ftl里引入 ECharts 的 CDN用 Ajax 拉数据渲染饼图和柱状图。统计 SQL 用GROUP BY和COUNT、SUM聚合注意时间范围用DATE(create_time) CURDATE()过滤当天。// 后台首页用 ECharts 渲染热销菜品柱状图 var chart echarts.init(document.getElementById(hotDishChart)); $.get(/admin/dashboard/hotDish, function (data) { chart.setOption({ title: { text: 热销菜品 Top5 }, tooltip: {}, xAxis: { data: data.names }, yAxis: {}, series: [{ name: 销量, type: bar, data: data.values, itemStyle: { color: #5B8FF9 } }] }); });这段代码的关键是后台返回的数据格式要和小程序的names、values数组对应。ECharts 的setOption是覆盖式更新如果多次调用要注意先clear。另外 FreeMarker 模板里引入 jQuery 和 ECharts 的 script 标签要放在/body之前否则 DOM 没加载完getElementById会返回 null。5.3 答辩演示的节奏控制与常见提问准备最后说一个非技术但很关键的技巧答辩演示不要从头到尾点一遍。提前准备好三个场景一是正常点餐流程从选菜到下单 30 秒内完成二是后台管理展示菜品上架和下架对小程序端的影响三是数据看板用数字说明系统有真实业务价值。老师常问的问题包括“订单号怎么生成的”“并发下单会不会超卖”“数据库索引加在哪了”提前把答案写在备注里。我自己的习惯是每次部署完新环境都强制走一遍“注册 → 登录 → 点餐 → 下单 → 后台查看订单”的完整链路确认没有遗漏的配置项。这套源码的注释比较全新手跟着注释改不容易迷路但数据库密码和接口地址这两处一定要改成自己的否则换台电脑就跑不起来。希望帮到你。本文还有配套的精品资源点击获取