簡(jiǎn)介這是一套完整的微信小程序購(gòu)物商城全棧開發(fā)項(xiàng)目面向Java后端與小程序前端初學(xué)者及課程設(shè)計(jì)學(xué)生解決電商類應(yīng)用從用戶端到管理端的全流程開發(fā)實(shí)踐需求。資源包含可本地編譯運(yùn)行的Java Spring Boot后端、WXML/WXSS/JS構(gòu)成的小程序前端、MySQL數(shù)據(jù)庫(kù)腳本及詳細(xì)文檔說(shuō)明覆蓋商品瀏覽、購(gòu)物車管理、訂單提交、物流跟蹤、評(píng)價(jià)反饋與后臺(tái)商品/訂單/用戶地址管理等核心業(yè)務(wù)模塊。壓縮包共1539個(gè)文件以176個(gè)Java后端邏輯文件、385個(gè)HTML頁(yè)面模板、305個(gè)JS交互腳本、219個(gè)PNG與32個(gè)JPG圖片資源為主輔以CSS樣式、JSON配置及SQL建庫(kù)腳本整體大小為10.27MB結(jié)構(gòu)清晰、模塊分離明確便于分層學(xué)習(xí)與調(diào)試。已有205人下載學(xué)習(xí)配套文檔詳實(shí)、代碼注釋充分評(píng)審得分達(dá)95分以上適合作為高校課程設(shè)計(jì)、畢業(yè)設(shè)計(jì)參考或全棧開發(fā)入門實(shí)戰(zhàn)范例。1. 微信小程序購(gòu)物商城 Java 后端為什么這個(gè)組合在畢業(yè)設(shè)計(jì)和中小商業(yè)項(xiàng)目里穩(wěn)拿高分你手頭這個(gè).zip文件不是“又一個(gè)練手 demo”而是一套能跑通、能部署、能講清楚技術(shù)鏈路的完整閉環(huán)系統(tǒng)前端是微信原生小程序非 uni-app 或 Taro后端用 Spring Boot MyBatis-Plus 寫成標(biāo)準(zhǔn) RESTful 接口數(shù)據(jù)庫(kù)用 MySQL 5.7配套有建表 SQL、接口文檔 Markdown、前后端分離部署說(shuō)明甚至包含微信登錄 手機(jī)號(hào)授權(quán) 訂單狀態(tài)機(jī) 支付回調(diào)模擬等真實(shí)業(yè)務(wù)模塊。它之所以常被標(biāo)注為“高分項(xiàng)目”根本原因不是代碼多炫酷而是踩中了三個(gè)硬性得分點(diǎn)一是微信小程序側(cè)符合最新基礎(chǔ)庫(kù)要求如wx.logingetPhoneNumber的雙階段鑒權(quán)流程二是 Java 后端用了 MyBatis-Plus 的TableNameTableId注解驅(qū)動(dòng)實(shí)體與數(shù)據(jù)庫(kù)映射避免手寫 XML三是數(shù)據(jù)庫(kù)設(shè)計(jì)含外鍵約束、索引優(yōu)化比如訂單表user_id和goods_id均建了 BTree 索引不是純 CRUD 堆砌。適合兩類人計(jì)算機(jī)專業(yè)本科生做畢設(shè)答辯時(shí)能講清「為什么選 MyBatis-Plus 而不是 JPA」「小程序如何規(guī)避wx.request并發(fā)限制」以及小團(tuán)隊(duì)快速上線 MVP 商城把a(bǔ)pplication-prod.yml里的數(shù)據(jù)庫(kù)地址一換加個(gè) Nginx 反向代理就能對(duì)外提供服務(wù)。別被“高分”二字帶偏——它真正的價(jià)值在于所有模塊都可驗(yàn)證、可替換、可壓測(cè)。2. 從 ZIP 解壓到本地運(yùn)行四步走通全棧鏈路2.1 解壓后目錄結(jié)構(gòu)解析看清哪些文件真有用哪些只是占空間拿到微信小程序購(gòu)物商城app設(shè)計(jì)帶Java后端源代碼文檔說(shuō)明數(shù)據(jù)庫(kù)高分項(xiàng)目.zip后先別急著mvn clean install。用unzip -l xxx.zip | head -20快速掃一眼頂層結(jié)構(gòu)Windows 用戶可用 7-Zip 查看你會(huì)看到類似這樣的關(guān)鍵路徑├── docs/ # 文檔目錄重點(diǎn)看 API.md 和 數(shù)據(jù)庫(kù)設(shè)計(jì)說(shuō)明.md ├── frontend/ # 小程序源碼注意不是 /miniprogram而是 /frontend說(shuō)明是獨(dú)立工程 │ ├── project.config.json # 小程序開發(fā)者工具配置含 appid │ ├── app.js # 全局邏輯含 wx.login 攔截器 │ └── pages/ ├── backend/ # Java 后端Spring Boot 2.7.x非 3.x │ ├── pom.xml # 關(guān)鍵確認(rèn) spring-boot.version 是 2.7.18兼容 JDK8 │ ├── src/main/java/com/example/mall/ │ │ ├── MallApplication.java # 啟動(dòng)類 │ │ ├── controller/ # REST 接口如 GoodsController.java │ │ ├── service/ # 業(yè)務(wù)邏輯含 OrderService 的狀態(tài)流轉(zhuǎn) │ │ └── mapper/ # MyBatis-Plus Mapper帶 Mapper 注解 │ └── src/main/resources/ │ ├── application-dev.yml # 開發(fā)環(huán)境配置數(shù)據(jù)庫(kù)賬號(hào)密碼明文 │ └── mapper/ # XML 映射文件實(shí)際項(xiàng)目中可能為空因用了注解式 └── db/ # 數(shù)據(jù)庫(kù)腳本重點(diǎn)看 mall_init.sql └── mall_init.sql # 包含建庫(kù)、建表、初始數(shù)據(jù)admin 用戶、測(cè)試商品提示frontend/下沒有node_modules說(shuō)明小程序代碼是純?cè)_發(fā)WXML WXSS JS不依賴 npm 構(gòu)建backend/pom.xml中若出現(xiàn)artifactIdspring-boot-starter-web/artifactId且無(wú)spring-boot-starter-reactor-netty基本可斷定是 Tomcat 嵌入式容器不是 WebFlux。2.2 后端啟動(dòng)繞過(guò) Maven 鏡像坑用最簡(jiǎn)命令跑通接口很多同學(xué)卡在第一步mvn spring-boot:run報(bào)錯(cuò)Could not resolve dependencies。這不是代碼問(wèn)題而是國(guó)內(nèi) Maven 鏡像源失效或pom.xml里寫了已下線的倉(cāng)庫(kù)地址如https://repo.spring.io/release在 Spring Boot 2.7 后已停用。正確做法是跳過(guò) Maven直接用 IDE 啟動(dòng)# 進(jìn)入 backend 目錄 cd backend # 方式一IntelliJ IDEA推薦 # 1. File → Open → 選擇 backend/pom.xml # 2. 等待 Maven 自動(dòng)導(dǎo)入右下角提示 Importing Maven project... # 3. 找到 MallApplication.java → 右鍵 → Run MallApplication # 4. 控制臺(tái)輸出 Started MallApplication in X.XXX seconds 即成功 # 方式二命令行需確保 JAVA_HOME 指向 JDK8 或 JDK11 # 先清理舊 target避免 classpath 沖突 rm -rf target/ # 用 Maven Wrapper 啟動(dòng)比全局 mvn 更可靠 ./mvnw spring-boot:run -Dspring.profiles.activedev啟動(dòng)成功后訪問(wèn)http://localhost:8080/swagger-ui.html如果pom.xml引入了springfox-swagger2或http://localhost:8080/doc.html若用的是knife4j能看到/api/goods/list、/api/user/login等接口列表。此時(shí)不要急著調(diào)小程序先用 curl 測(cè)通基礎(chǔ)接口# 測(cè)試商品列表GET curl http://localhost:8080/api/goods/list?page1size10 # 測(cè)試用戶登錄POST模擬小程序 wx.login code curl -X POST http://localhost:8080/api/user/login \ -H Content-Type: application/json \ -d {code:mock_code_123}參數(shù)說(shuō)明code字段是模擬值真實(shí)場(chǎng)景下由小程序wx.login()獲取后端用該 code 向微信服務(wù)器換取openid。項(xiàng)目中通常在UserController.login()方法里調(diào)用微信sns/jscode2session接口返回{openid:xxx,session_key:yyy}再存入 Redis 緩存key 為login:xxx過(guò)期時(shí)間 2 小時(shí)。若你發(fā)現(xiàn)接口返回{code:500,msg:微信服務(wù)器請(qǐng)求失敗}大概率是application-dev.yml里的wechat.appid和wechat.secret未填——這兩個(gè)值必須去 微信公眾平臺(tái) 的「開發(fā)管理 → 開發(fā)者ID」頁(yè)獲取。2.3 小程序端配置與真機(jī)調(diào)試解決「開發(fā)者工具能跑手機(jī)打不開」的玄學(xué)問(wèn)題小程序代碼在frontend/目錄但直接用微信開發(fā)者工具打開會(huì)報(bào)錯(cuò)project.config.json 中 appid 無(wú)效。這是因?yàn)閜roject.config.json里的appid是占位符如wx1234567890abcdef必須替換成你自己的測(cè)試號(hào) AppID// frontend/project.config.json { description: 項(xiàng)目配置文件, packOptions: { ignore: [] }, setting: { urlCheck: false, es6: true, enhance: true }, appid: wx1234567890abcdef, // ← 替換為你在 mp.weixin.qq.com 申請(qǐng)的測(cè)試號(hào) AppID projectname: mall-miniapp, libVersion: 2.28.0, // ← 必須 ≥ 2.25.0否則 getPhoneNumber 會(huì)報(bào)錯(cuò) condition: { ... } }注意微信小程序頂部導(dǎo)航欄高度在不同機(jī)型差異極大iPhone X 系列是 88px安卓全面屏是 64px項(xiàng)目中通常用wx.getSystemInfoSync().statusBarHeight動(dòng)態(tài)計(jì)算但frontend/app.js里若寫死padding-top: 88rpx真機(jī)就會(huì)錯(cuò)位。檢查app.wxss是否含.nav-bar { padding-top: env(safe-area-inset-top) }—— 這才是適配劉海屏的正解。啟動(dòng)開發(fā)者工具后點(diǎn)擊「預(yù)覽」生成二維碼用自己手機(jī)微信掃碼。此時(shí)若頁(yè)面空白或報(bào)request:fail url not in domain list說(shuō)明app.js里的baseUrl還指向http://localhost:8080開發(fā)者工具允許真機(jī)禁止。必須改成局域網(wǎng) IP// frontend/app.js App({ globalData: { baseUrl: http://192.168.1.100:8080, // ← 改成你電腦的局域網(wǎng) IP非 127.0.0.1 // ... } })然后重啟小程序。如果仍報(bào)錯(cuò)打開手機(jī)微信「設(shè)置 → 通用 → 輔助功能 → 微信內(nèi)網(wǎng)頁(yè)」關(guān)閉「網(wǎng)頁(yè)版文件傳輸助手」——這個(gè)開關(guān)會(huì)劫持所有http://請(qǐng)求導(dǎo)致接口 404。3. 數(shù)據(jù)庫(kù)初始化與 MyBatis-Plus 實(shí)體映射讓增刪改查不靠猜3.1 用mall_init.sql初始化 MySQL避開字符集和時(shí)區(qū)兩大雷區(qū)db/mall_init.sql通常是建庫(kù) 建表 插入測(cè)試數(shù)據(jù)的一體化腳本。但直接mysql -u root -p mall_init.sql很可能失敗原因就兩個(gè)字符集不匹配腳本開頭若沒寫CREATE DATABASE IF NOT EXISTS mall DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;而你的 MySQL 默認(rèn)是latin1中文字段會(huì)變??時(shí)區(qū)錯(cuò)誤datetime字段插入2024-01-01 00:00:00時(shí)若 MySQL 時(shí)區(qū)是SYSTEM即服務(wù)器本地時(shí)區(qū)而 Java 讀取時(shí)用GMT8解析時(shí)間會(huì)差 8 小時(shí)。安全做法是手動(dòng)執(zhí)行建庫(kù)語(yǔ)句-- 步驟 1創(chuàng)建數(shù)據(jù)庫(kù)顯式指定字符集 CREATE DATABASE IF NOT EXISTS mall DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; -- 步驟 2切換數(shù)據(jù)庫(kù) USE mall; -- 步驟 3執(zhí)行建表語(yǔ)句從 mall_init.sql 復(fù)制 CREATE TABLE 部分 -- 注意檢查每個(gè)表是否含 ENGINEInnoDBMyBatis-Plus 要求事務(wù)支持 -- 示例 goods 表 CREATE TABLE goods ( id bigint NOT NULL AUTO_INCREMENT, name varchar(100) NOT NULL COMMENT 商品名稱, price decimal(10,2) NOT NULL COMMENT 價(jià)格, stock int NOT NULL DEFAULT 0 COMMENT 庫(kù)存, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COLLATEutf8mb4_unicode_ci;提示utf8mb4是必須的因?yàn)槲⑿抨欠Q、商品描述可能含 emoji如 utf8在 MySQL 中實(shí)際只支持 3 字節(jié)無(wú)法存 需 4 字節(jié)。3.2 MyBatis-Plus 實(shí)體類與數(shù)據(jù)庫(kù)字段映射為什么TableId(type IdType.AUTO)比TableId(type IdType.INPUT)更安全后端src/main/java/com/example/mall/entity/Goods.java是核心實(shí)體類。它的字段與goods表一一對(duì)應(yīng)但關(guān)鍵在于TableId和TableField注解的用法package com.example.mall.entity; import com.baomidou.mybatisplus.annotation.*; TableName(goods) // 顯式指定表名避免駝峰轉(zhuǎn)下劃線出錯(cuò) public class Goods { TableId(type IdType.AUTO) // 主鍵由數(shù)據(jù)庫(kù)自增推薦 private Long id; TableField(name) // 顯式指定字段名避免 name → name_id 錯(cuò)誤映射 private String name; TableField(price) private BigDecimal price; TableField(stock) private Integer stock; // getter/setter 省略 }為什么IdType.AUTO比IdType.INPUT安全I(xiàn)dType.INPUT要求前端傳id但小程序端不可能知道下一個(gè) ID 是多少極易沖突IdType.AUTO由 MySQLAUTO_INCREMENT生成后端goodsMapper.insert(goods)后goods.getId()會(huì)自動(dòng)回填新 ID方便后續(xù)關(guān)聯(lián)操作如插入訂單項(xiàng)時(shí)用此 ID。參數(shù)說(shuō)明TableField(fill FieldFill.INSERT)可用于create_time字段配合MetaObjectHandler自動(dòng)填充但本項(xiàng)目若沒實(shí)現(xiàn)就別亂加否則插入時(shí)報(bào)Field create_time doesnt have a default value。3.3 用 MyBatis-Plus 生成建表 SQL告別手寫 DDL 的血淚經(jīng)驗(yàn)如果你要基于現(xiàn)有實(shí)體類反向生成建表語(yǔ)句比如新增coupon表別手寫 SQL。MyBatis-Plus 提供MybatisPlusGenerator工具類但更簡(jiǎn)單的是用MyBatis-Plus的AutoGenerator需額外引入mybatis-plus-generator依賴!-- backend/pom.xml -- dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-generator/artifactId version3.5.3.1/version !-- 注意必須與 mybatis-plus-boot-starter 版本一致 -- /dependency然后寫一個(gè)CodeGenerator.java放在test/java下public class CodeGenerator { public static void main(String[] args) { AutoGenerator generator new AutoGenerator(); // 數(shù)據(jù)源配置 DataSourceConfig dsc new DataSourceConfig(); dsc.setUrl(jdbc:mysql://localhost:3306/mall?useUnicodetruecharacterEncodingutf8); dsc.setDriverName(com.mysql.cj.jdbc.Driver); dsc.setUsername(root); dsc.setPassword(123456); generator.setDataSource(dsc); // 包配置 PackageConfig pc new PackageConfig(); pc.setModuleName(coupon); // 模塊名 pc.setParent(com.example.mall); generator.setPackageInfo(pc); // 策略配置 StrategyConfig strategy new StrategyConfig(); strategy.setNaming(NamingStrategy.underline_to_camel); // 下劃線轉(zhuǎn)駝峰 strategy.setColumnNaming(NamingStrategy.underline_to_camel); strategy.setEntityLombokModel(true); strategy.setInclude(coupon); // 只生成 coupon 表 generator.setStrategy(strategy); generator.execute(); } }運(yùn)行后會(huì)在src/main/java下生成Coupon.java實(shí)體類并在src/main/resources/mapper/下生成CouponMapper.xml。但注意XML 文件里insert標(biāo)簽?zāi)J(rèn)不含useGeneratedKeystrue必須手動(dòng)加上否則insert后getId()返回 null!-- src/main/resources/mapper/CouponMapper.xml -- insert idinsert parameterTypecom.example.mall.entity.Coupon useGeneratedKeystrue keyPropertyid INSERT INTO coupon (name, discount, start_time, end_time) VALUES (#{name}, #{discount}, #{startTime}, #{endTime}) /insert4. 微信小程序登錄與手機(jī)號(hào)獲取兩階段鑒權(quán)的硬核落地細(xì)節(jié)4.1wx.login()code2Session為什么不能省掉后端校驗(yàn)這一步小程序登錄看似簡(jiǎn)單wx.login()獲取code傳給后端后端用code換openid。但很多同學(xué)直接在小程序端用wx.request({url: http://localhost:8080/api/user/login, data: {code}})結(jié)果被微信攔截——因?yàn)閣x.request的域名必須在「小程序后臺(tái) → 開發(fā)管理 → 業(yè)務(wù)域名」里備案HTTP 域名已不支持必須 HTTPS。正確鏈路是小程序 → 自己后端 → 微信服務(wù)器// frontend/pages/login/login.js onLoad() { wx.login({ success: res { // 1. 將 code 發(fā)給自己的后端HTTPS 域名 wx.request({ url: getApp().globalData.baseUrl /api/user/login, method: POST, data: { code: res.code }, // 僅傳 code success: resp { if (resp.data.code 200) { // 2. 后端返回 session_token非 openid wx.setStorageSync(token, resp.data.data.token); wx.switchTab({ url: /pages/index/index }); } } }) } }) }后端UserController.login()接收code拼接微信 URL// backend/src/main/java/com/example/mall/controller/UserController.java PostMapping(/login) public Result login(RequestBody MapString, String params) { String code params.get(code); // 拼微信接口 URL注意必須用 https String url https://api.weixin.qq.com/sns/jscode2session? appid wechatConfig.getAppid() secret wechatConfig.getSecret() js_code code grant_typeauthorization_code; // 用 RestTemplate 調(diào)用微信別用 HttpClient太重 String result restTemplate.getForObject(url, String.class); JSONObject json JSONObject.parseObject(result); if (json.containsKey(openid)) { String openid json.getString(openid); String sessionKey json.getString(session_key); // 3. 用 openid 查庫(kù)不存在則 insert返回自定義 token String token JWTUtil.generateToken(openid); return Result.success(token); } else { return Result.fail(微信登錄失敗 json.getString(errmsg)); } }關(guān)鍵點(diǎn)session_key必須和服務(wù)端token綁定存儲(chǔ)如 Redis后續(xù)解密手機(jī)號(hào)時(shí)要用它。千萬(wàn)別把session_key返回給小程序端4.2getPhoneNumber獲取手機(jī)號(hào)為什么必須用button open-typegetPhoneNumber而不是wx.getPhoneNumber微信在 2023 年底強(qiáng)制要求獲取手機(jī)號(hào)必須用button open-typegetPhoneNumber組件wx.getPhoneNumberAPI 已廢棄。項(xiàng)目中frontend/pages/user/bind-phone/bind-phone.wxml應(yīng)類似!-- 綁定手機(jī)號(hào)頁(yè)面 -- button open-typegetPhoneNumber bindgetphonenumberonGetPhoneNumber classbind-btn 一鍵綁定手機(jī)號(hào) /button對(duì)應(yīng)的 JS 邏輯// frontend/pages/user/bind-phone/bind-phone.js onGetPhoneNumber(e) { if (e.detail.code) { // 1. 將加密數(shù)據(jù)傳給后端 wx.request({ url: getApp().globalData.baseUrl /api/user/bind-phone, method: POST, data: { encryptedData: e.detail.encryptedData, iv: e.detail.iv, code: e.detail.code // 注意這是微信回調(diào)的 code不是 login 的 code }, header: { Authorization: wx.getStorageSync(token) // 攜帶登錄 token }, success: res { if (res.data.code 200) { wx.showToast({ title: 綁定成功 }); setTimeout(() wx.navigateBack(), 1000); } } }) } }后端解密邏輯UserController.bindPhone()PostMapping(/bind-phone) public Result bindPhone(RequestBody MapString, String params, RequestHeader(Authorization) String token) { String encryptedData params.get(encryptedData); String iv params.get(iv); String code params.get(code); // 1. 用 token 查出 openid從 Redis 取 session_key String openid JWTUtil.getOpenid(token); String sessionKey redisTemplate.opsForValue().get(login: openid); // 2. AES-128-CBC 解密微信官方 SDK 提供 WXBizDataCrypt WXBizDataCrypt crypt new WXBizDataCrypt(wechatConfig.getAppid(), sessionKey); JSONObject phoneObj crypt.decrypt(encryptedData, iv); if (phoneObj.containsKey(phoneNumber)) { String phoneNumber phoneObj.getString(phoneNumber); // 3. 更新 user 表 phone 字段 userService.updatePhone(openid, phoneNumber); return Result.success(); } else { return Result.fail(手機(jī)號(hào)解密失敗); } }注意WXBizDataCrypt類需自行實(shí)現(xiàn)微信官方 GitHub 有 Java 版核心是Cipher.getInstance(AES/CBC/PKCS5Padding)。若解密報(bào)javax.crypto.BadPaddingException: Given final block not properly padded99% 是session_key過(guò)期或encryptedData被前端二次 JSON.stringify。5. 高頻避坑指南那些讓項(xiàng)目卡在交付前夜的致命細(xì)節(jié)5.1 現(xiàn)象小程序真機(jī)預(yù)覽白屏開發(fā)者工具正常原因project.config.json中l(wèi)ibVersion低于真機(jī)微信基礎(chǔ)庫(kù)版本如設(shè)為2.20.0而用戶微信是2.29.0導(dǎo)致getPhoneNumber等新 API 不識(shí)別。解決將libVersion改為2.28.0當(dāng)前兼容性最好的版本并勾選開發(fā)者工具「詳情 → 本地設(shè)置 → 調(diào)試基礎(chǔ)庫(kù)」為2.28.0。5.2 現(xiàn)象后端insert成功但getId()返回null原因MySQL 表主鍵未設(shè)AUTO_INCREMENT或 MyBatis-Plus 實(shí)體類TableId注解漏寫type IdType.AUTO。解決執(zhí)行SHOW CREATE TABLE goods確認(rèn)id字段含AUTO_INCREMENT檢查實(shí)體類TableId(type IdType.AUTO)是否存在。5.3 現(xiàn)象curl http://localhost:8080/api/goods/list返回 404原因pom.xml中spring-boot-starter-web版本與 Spring Boot 不匹配如 Spring Boot 2.7.x 配了 3.x 的 starter導(dǎo)致RestController掃描失效。解決檢查pom.xml確保artifactIdspring-boot-starter-web/artifactId無(wú)version標(biāo)簽由 parent 統(tǒng)一管理且parent的spring-boot.version為2.7.18。5.4 現(xiàn)象微信登錄返回{errcode:40029,errmsg:invalid code}原因code有效期僅 5 分鐘且一個(gè)code只能用一次或后端請(qǐng)求微信jscode2session時(shí)appid/secret填錯(cuò)。解決打印后端日志確認(rèn)code是否被重復(fù)使用登錄 mp.weixin.qq.com 核對(duì)「開發(fā)管理 → 開發(fā)者ID」頁(yè)的 AppID 和 AppSecret。5.5 現(xiàn)象數(shù)據(jù)庫(kù)中文顯示為??但SELECT查詢正常原因JDBC 連接字符串未加characterEncodingutf8mb4如jdbc:mysql://localhost:3306/mall缺少參數(shù)。解決修改application-dev.yml中的spring.datasource.urlspring: datasource: url: jdbc:mysql://localhost:3306/mall?useUnicodetruecharacterEncodingutf8mb4serverTimezoneGMT%2B86. 進(jìn)階技巧用 MyBatis-Plus 的QueryWrapper實(shí)現(xiàn)動(dòng)態(tài)條件查詢替代手寫 SQL畢業(yè)答辯時(shí)老師常問(wèn)“如果我要查‘價(jià)格在 100~500 且?guī)齑娲笥?0 的商品’后端怎么寫”——這時(shí)候千萬(wàn)別答“寫個(gè) SQL 用WHERE price BETWEEN ? AND ? AND stock 0”而要亮出 MyBatis-Plus 的QueryWrapper體現(xiàn)工程化思維。6.1 商品列表接口的動(dòng)態(tài)查詢一行代碼搞定多條件組合GoodsController.list()方法接收page、size、minPrice、maxPrice、keyword等參數(shù)傳統(tǒng)做法是拼 SQL 字符串易 SQL 注入。用QueryWrapper則安全又清晰GetMapping(/list) public Result list( RequestParam(defaultValue 1) Integer page, RequestParam(defaultValue 10) Integer size, RequestParam(required false) BigDecimal minPrice, RequestParam(required false) BigDecimal maxPrice, RequestParam(required false) String keyword) { PageGoods goodsPage new Page(page, size); QueryWrapperGoods wrapper new QueryWrapper(); // 價(jià)格區(qū)間自動(dòng)忽略 null 值 if (minPrice ! null) wrapper.ge(price, minPrice); if (maxPrice ! null) wrapper.le(price, maxPrice); // 模糊搜索SQL LIKE if (StringUtils.isNotBlank(keyword)) { wrapper.like(name, keyword); } // 庫(kù)存大于 0上架商品 wrapper.gt(stock, 0); // 執(zhí)行查詢 IPageGoods result goodsService.page(goodsPage, wrapper); return Result.success(result); }邏輯說(shuō)明wrapper.ge(price, minPrice)生成WHERE price ?wrapper.like(name, keyword)生成WHERE name LIKE %xxx%。MyBatis-Plus 會(huì)自動(dòng)處理null參數(shù)不會(huì)生成AND price NULL這種無(wú)效 SQL。6.2 多表關(guān)聯(lián)查詢用TableNameTableField避免手寫 JOIN訂單列表需顯示商品名稱、用戶昵稱傳統(tǒng)做法是寫SELECT o.*, g.name as goods_name, u.nickname as user_nickname FROM order o LEFT JOIN goods g ON o.goods_id g.id LEFT JOIN user u ON o.user_id u.id。但 MyBatis-Plus 提供TableName映射后可用LambdaQueryWrapperselect指定字段// Order 實(shí)體類含 goodsName 和 nickname 字段 TableName(order) public class Order { TableId private Long id; TableField(goods_id) private Long goodsId; TableField(user_id) private Long userId; // 非數(shù)據(jù)庫(kù)字段用于接收關(guān)聯(lián)查詢結(jié)果 TableField(exist false) private String goodsName; TableField(exist false) private String nickname; // getter/setter... } // OrderController.listWithDetail() GetMapping(/list-detail) public Result listWithDetail(RequestParam Integer page, RequestParam Integer size) { PageOrder pageObj new Page(page, size); // 關(guān)聯(lián)查詢MyBatis-Plus 3.4 支持 QueryWrapperOrder wrapper new QueryWrapper(); wrapper.select(o.*, g.name as goods_name, u.nickname as nickname) .from(order o) .leftJoin(goods g ON o.goods_id g.id) .leftJoin(user u ON o.user_id u.id); IPageOrder result orderService.page(pageObj, wrapper); return Result.success(result); }6.3 數(shù)據(jù)庫(kù)同步技巧用mysqldump導(dǎo)出結(jié)構(gòu) 數(shù)據(jù)避免INSERT丟失自增 ID部署到生產(chǎn)環(huán)境時(shí)db/mall_init.sql只含建表語(yǔ)句沒測(cè)試數(shù)據(jù)。若用INSERT INTO goods VALUES (1,iPhone,5999.00,100)上線后新插入商品 ID 會(huì)從 1 開始導(dǎo)致沖突。正確做法是導(dǎo)出含AUTO_INCREMENT的完整表# 導(dǎo)出 mall 庫(kù)含數(shù)據(jù) 結(jié)構(gòu)保留自增起始值 mysqldump -u root -p --databases mall mall_full.sql # 生產(chǎn)環(huán)境導(dǎo)入會(huì)自動(dòng)重建 AUTO_INCREMENT mysql -u root -p mall_full.sql我的習(xí)慣是本地開發(fā)用mall_init.sql干凈建庫(kù)上線前用mysqldump導(dǎo)出一次全量備份存到docs/deploy/目錄。這樣即使客戶要求“恢復(fù)到某天數(shù)據(jù)”也能秒級(jí)還原。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取