簡介面向畢業(yè)設(shè)計場景的精準扶貧數(shù)據(jù)收集小程序完整項目包以微信小程序為前端、Java為后端實現(xiàn)貧困對象精準畫像、幫扶記錄管理、政策新聞?wù)故镜群诵臉I(yè)務(wù)覆蓋“互聯(lián)網(wǎng)精準扶貧”的典型需求適合計算機相關(guān)專業(yè)學生用于課程設(shè)計或畢設(shè)二次開發(fā)。壓縮包共含503個文件主要有Java源碼、class編譯文件、jar依賴庫小程序端的wxml、wxss、js、json頁面與組件以及jpg/png圖片、gif動圖、SQL數(shù)據(jù)庫腳本、docx設(shè)計文檔、pptx答辯PPT、mp4操作演示視頻等另有少量html、properties等輔助預覽與配置資源整體大小約106.62MB目錄層次清晰便于按前后端和資源類型檢索。目前已有229人學習下載。項目在代碼層面提供了DateUtil、StringUtil、ExportExcel等工具類ApiController、PkryController、BfjlController、BfsrController、ArticleController等業(yè)務(wù)控制器以及BaseDAO數(shù)據(jù)訪問層能夠直觀展現(xiàn)微信小程序調(diào)用Java接口完成扶貧數(shù)據(jù)錄入、查詢、統(tǒng)計與導出的完整鏈路配合可導入的SQL數(shù)據(jù)庫和演示視頻可顯著降低環(huán)境搭建與成果展示門檻是一套可直接參考的畢業(yè)設(shè)計實現(xiàn)方案。1. 為什么這個「被做爛了」的畢業(yè)設(shè)計反而值得從頭寫一遍“基于微信小程序的精準扶貧數(shù)據(jù)收集小程序平臺”——這個題目在校內(nèi)畢設(shè)選題里出現(xiàn)頻率極高同學之間互相傳的往往是同一個 zipjava 后端 微信小程序 數(shù)據(jù)庫 演示視頻。聽起來像被做爛了但正因為做的人多坑早就被踩平了。這個平臺本質(zhì)上是一個數(shù)據(jù)收集系統(tǒng)走訪人員在小程序里錄入幫扶對象基本信息、入戶走訪記錄和幫扶措施隨手拍照留證數(shù)據(jù)通過 Java 接口落到數(shù)據(jù)庫后臺按戶查臺賬。適合正在選題、或者手里有一個跑不起來的源碼包的同學。這篇筆記按我實際搭過的方案講把架構(gòu)、表結(jié)構(gòu)、核心代碼、聯(lián)調(diào)翻車點和演示視頻錄制技巧一次說清。2. 先畫數(shù)據(jù)流再寫代碼小程序、Java 接口層和數(shù)據(jù)表怎么分工2.1 數(shù)據(jù)收集場景的三種角色和一條數(shù)據(jù)流先把最容易被忽略的事說清楚這個題目叫“數(shù)據(jù)收集平臺”核心不是管理后臺多花哨而是「小程序端把數(shù)據(jù)收上來」這一條鏈路。業(yè)務(wù)上通常有三類角色管理員負責建賬號和維護基礎(chǔ)數(shù)據(jù)走訪人員拿著手機入戶填表、拍照、提交后臺管理人員查臺賬、看走訪覆蓋情況。絕大部分畢設(shè)做的是后兩種角色管理員用 Web 頁面實現(xiàn)其實就夠用了。數(shù)據(jù)流一條線就能說清走訪人員打開小程序 → 選擇幫扶對象或新建對象 → 填寫走訪表單、拍現(xiàn)場照片 → 小程序把圖片先上傳拿到 URL → 表單數(shù)據(jù)和圖片 URL 一起提交到 Java 接口 → 接口用事務(wù)把主表和明細表一起寫入 MySQL → 后臺管理系統(tǒng)按戶查出來。這條鏈路里最值得花時間的是中間兩環(huán)圖片上傳的時序以及主表和明細表的一致性。這兩處也是答辯時老師最喜歡追問的地方。如果你手里已經(jīng)有源碼包先別急著改頁面把這條數(shù)據(jù)流在后端代碼里走通后面所有問題都好排查。2.2 后端用 Java 而不是 Node/PHP 的理由給畢業(yè)設(shè)計答辯留余地選題雖然是小程序但難度主要在 Java 后端。常見做法是用 Spring Boot MyBatis-Plus MySQL這也是課程設(shè)計和畢設(shè)源碼包里最常見的組合。答辯時一定會被問“為什么選 Java 不用 Node/PHP”不能只回一句“學校教的”要有幾句話能接住。能想到的實在理由有三條。第一類型約束走訪數(shù)據(jù)里身份證號、手機號、金額、日期都是強類型字段Java 的實體類和 DTO 可以在編譯期擋住一部分臟數(shù)據(jù)PHP/JS 這類弱類型語言要到運行期才發(fā)現(xiàn)問題。第二事務(wù)成熟度提交走訪記錄要同時寫幫扶對象表、走訪記錄表、圖片表Spring 的 Transactional 聲明式事務(wù)比手寫回滾可靠。第三部署簡單一個 Spring Boot 的 fat jar 扔到服務(wù)器上就能跑和前端同學聯(lián)調(diào)時最省事。對比一下常見選型給要做技術(shù)選型答辯的同學做個參考技術(shù)棧優(yōu)點明顯的坑Spring Boot MyBatis-Plus MySQL資料多、答辯好講、事務(wù)可靠JDK 版本和 Spring Boot 版本要匹配SSMSpring SpringMVC MyBatis老項目多網(wǎng)上源碼多配置繁瑣XML 寫起來痛苦微信原生小程序 uniapp 開發(fā)原生上手快uniapp 能一稿多端原生代碼沒法復用打包成 Android/iOS 和鴻蒙時兼容性要額外處理Node.js Express輕量、寫起來快事務(wù)和類型約束弱答辯容易被追問小程序端建議用原生因為這個畢設(shè)只需要跑微信一個端沒必要上 uniapp 多端。如果老師問“為什么不用 uniapp 開發(fā)”可以回答題目只要求微信小程序原生 API 更直接調(diào)試時小程序開發(fā)者工具的支持也最好。這個說法通常能過關(guān)。2.3 數(shù)據(jù)庫表設(shè)計幫扶對象主表、走訪記錄表、幫扶措施表的關(guān)聯(lián)數(shù)據(jù)收集平臺的表結(jié)構(gòu)比電商、聊天類小程序簡單但有一個特別容易犯的錯把所有字段塞進一張大表。不少源碼包就是一張 resident 表搞定走訪次數(shù)多的戶同一戶信息被重復錄了好幾遍臺賬對不上。正確做法是拆成主表和流水表。至少要有這幾張基礎(chǔ)表用戶表sys_user、幫扶對象主表resident、走訪記錄表visit_record、幫扶措施表help_item以及一張圖片附件表attachment。下面是核心建表 SQL按 MySQL 8 寫-- 幫扶對象主表一個幫扶對象一條記錄 CREATE TABLE resident ( id BIGINT NOT NULL AUTO_INCREMENT COMMENT 主鍵, name VARCHAR(30) NOT NULL COMMENT 姓名, id_card VARCHAR(18) NOT NULL COMMENT 身份證號, phone VARCHAR(11) DEFAULT NULL COMMENT 手機號, family_addr VARCHAR(200) DEFAULT NULL COMMENT 家庭地址, household_type VARCHAR(20) DEFAULT NULL COMMENT 戶類型, status TINYINT NOT NULL DEFAULT 1 COMMENT 狀態(tài)1正常 0歸檔, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_id_card (id_card) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT幫扶對象主表; -- 走訪記錄表每次入戶一條流水 CREATE TABLE visit_record ( id BIGINT NOT NULL AUTO_INCREMENT COMMENT 主鍵, resident_id BIGINT NOT NULL COMMENT 關(guān)聯(lián)對象主鍵, visitor_id BIGINT NOT NULL COMMENT 走訪人用戶ID, visit_date DATE NOT NULL COMMENT 走訪日期, income_amt DECIMAL(10,2) DEFAULT NULL COMMENT 家庭月收入, live_status VARCHAR(255) DEFAULT NULL COMMENT 生活狀況描述, remark VARCHAR(500) DEFAULT NULL COMMENT 備注, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_resident (resident_id), KEY idx_visit_date (visit_date) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT走訪記錄表; -- 幫扶措施表走訪后要落實的具體措施 CREATE TABLE help_item ( id BIGINT NOT NULL AUTO_INCREMENT COMMENT 主鍵, visit_id BIGINT NOT NULL COMMENT 關(guān)聯(lián)走訪記錄, item_name VARCHAR(100) NOT NULL COMMENT 措施名稱, item_detail VARCHAR(500) DEFAULT NULL COMMENT 措施內(nèi)容, finish_flag TINYINT NOT NULL DEFAULT 0 COMMENT 完成標記 0未完成 1已完成, PRIMARY KEY (id), KEY idx_visit (visit_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT幫扶措施表;三個關(guān)鍵點說明一下。第一id_card 用 varchar(18) 而不是數(shù)值類型身份證超過 19 位精度會崩這是個經(jīng)典坑后文還會展開。第二visit_record 的 resident_id 建了索引因為后臺最常見的查詢是“某個幫扶對象的所有走訪記錄”。第三income_amt 用 DECIMAL(10,2)金額字段絕不能用 float/Double二進制浮點存金額會有精度誤差答辯老師看到 DECIMAL 反而會加分。圖片附件表比較簡單字段就是 id、visit_id、file_url、create_time一個走訪記錄對應多張圖片。關(guān)聯(lián)關(guān)系resident 1—N visit_recordvisit_record 1—N help_itemvisit_record 1—N attachment。這套結(jié)構(gòu)對畢設(shè)夠用了。如果手里源碼包是單表存儲建議花半天自己拆一下這是答辯時實打?qū)嵉牧咙c。3. 小程序端把「收集」做順表單校驗、圖片上傳和離線草稿小程序端是整個平臺的排面演示視頻里八成鏡頭都在拍它。這一章不講頁面布局只講三個直接影響數(shù)據(jù)質(zhì)量的功能點表單校驗、圖片證據(jù)上傳、離線草稿箱。3.1 入戶走訪表單的組件選型與校驗邏輯走訪表單字段不少但涉及文本、日期、單選、金額、多行文本。微信小程序沒有 HTML form 那種自動提交機制每個字段都要自己綁定 value 和事件。常見做法是姓名、手機號、身份證號用 input分別配 typetext、number、idcard戶類型、生活狀況等枚舉字段用 radio-group 做單選框避免手輸造成的臟數(shù)據(jù)家庭月收入這種數(shù)值字段用 input typedigit保證只能輸入數(shù)字和小數(shù)點備注用 textarea。校驗建議在提交函數(shù)里統(tǒng)一做而不是每個 input 的 blur 事件里各寫一套。模糊校驗容易出現(xiàn)“邊輸邊報錯”的干擾體驗統(tǒng)一校驗還可以把錯誤信息集中起來一次提示。參考邏輯// pages/visit/visit.js 提交前的統(tǒng)一校驗 function validateForm(form) { const errors []; if (!form.name) errors.push(姓名不能為空); if (!/^\d{17}[\dXx]$/.test(form.idCard)) errors.push(身份證號格式不正確); if (form.phone !/^1[3-9]\d{9}$/.test(form.phone)) errors.push(手機號格式不正確); if (form.income !/^\d(\.\d{1,2})?$/.test(form.income)) errors.push(金額最多兩位小數(shù)); return errors; }核心校驗就三條身份證號 18 位且末位允許 X手機號以 1[3-9] 開頭共 11 位金額最多兩位小數(shù)。正則放在一起的好處是演示時故意輸錯錯誤提示清晰老師會認為你考慮了數(shù)據(jù)質(zhì)量。小程序端有“掃描身份證自動識別”的方案但不是題目必需不做不影響完成度先把手輸校驗做扎實更穩(wěn)。3.2 圖片證據(jù)采集chooseMedia 的坑與上傳時序走訪記錄配現(xiàn)場照片這是“數(shù)據(jù)收集平臺”區(qū)別于普通表單的核心。圖片功能有兩個容易翻車的地方API 版本用錯以及圖片和表單提交的時序錯誤。取圖接口現(xiàn)在用 wx.chooseMedia老項目里的 wx.chooseImage 在基礎(chǔ)庫較新時已經(jīng)不建議使用。chooseMedia 常用參數(shù)wx.chooseMedia({ count: 3, // 最多選3張 mediaType: [image], // 只允許圖片不需要視頻 sourceType: [camera, album], // 拍照或相冊都允許 sizeType: [compressed], // 取壓縮圖原圖上傳容易被網(wǎng)絡(luò)卡死 success: (res) { const files res.tempFiles.map(f f.tempFilePath); this.setData({ images: files }); } });sizeType 選 compressed 是關(guān)鍵。在校內(nèi)用 Wi-Fi 傳大圖看不出問題真機在鄉(xiāng)鎮(zhèn)網(wǎng)絡(luò)差的時候原圖上傳直接卡死。如果小程序基礎(chǔ)庫版本偏低沒有 chooseMedia需要降級到 wx.chooseImage兩個接口的 success 返回結(jié)構(gòu)不同做兼容時注意 tempFiles 的字段差異。圖片和表單的提交順序建議先傳圖片、后交表單。用戶點“提交”后小程序先把選中的圖片逐張傳給 Java 的 /api/file/upload拿到服務(wù)器返回的 URL 列表再把 URL 拼到表單里一起提交。這樣做的好處是走訪記錄主表和圖片附件在同一個事務(wù)里寫入不會出現(xiàn)“記錄存了但圖片丟了一半”。// 先逐張上傳圖片拿到 URL 列表后再提交表單 function uploadImages(tempFiles) { const tasks tempFiles.map((file) { return new Promise((resolve, reject) { wx.uploadFile({ url: app.globalData.baseUrl /api/file/upload, filePath: file.tempFilePath, // chooseMedia 拿到的臨時路徑 name: file, // 后端接收的字段名必須和Controller參數(shù)一致 success: (res) { const resp JSON.parse(res.data); if (resp.code 0) resolve(resp.data.url); else reject(new Error(上傳失敗 resp.message)); }, fail: reject }); }); }); return Promise.all(tasks); // 全部成功才繼續(xù)模擬先圖后主 }注意uploadFile 的 name 參數(shù)必須和后端 RequestParam(file) 的參數(shù)名一致否則后端拿到空文件。Promise.all 是“一張失敗整體失敗”的語義正好符合“證據(jù)必須齊”的業(yè)務(wù)要求。3.3 離線草稿箱沒信號時數(shù)據(jù)不丟的實現(xiàn)入戶走訪經(jīng)常在鄉(xiāng)鎮(zhèn)和村里信號差是常態(tài)。這個題目最值得加分的設(shè)計就是本地草稿箱沒網(wǎng)絡(luò)時不阻塞錄入等有網(wǎng)再提交。實現(xiàn)不復雜用小程序本地存儲接口就能完成。// 保存草稿把整份表單塞進本地緩存 function saveDraft(key, formData) { // wx.setStorageSync 是同步接口數(shù)據(jù)量小寫完后立刻可讀 wx.setStorageSync(draft_${key}, { data: formData, savedAt: Date.now() // 記錄保存時間方便后面做過期清理 }); } // 提交時先檢測網(wǎng)絡(luò)類型無網(wǎng)則落草稿箱 function ensureNetwork() { return new Promise((resolve) { wx.getNetworkType({ success: (res) resolve(res.networkType ! none), fail: () resolve(false) }); }); }草稿箱業(yè)務(wù)邏輯就三件事提交前檢測網(wǎng)絡(luò)沒網(wǎng)就寫緩存并提示“已存為草稿”有網(wǎng)時把草稿列表逐條提交成功后刪除對應緩存設(shè)置緩存時間7 天以上的草稿標記過期提示補錄。這個功能答辯時很好講一句“針對走訪場景的網(wǎng)絡(luò)不可用做了離線兜底”就值回票價。在微信小程序項目實例里能把離線草稿做成閉環(huán)的不多多數(shù)只是寫死了一個 setStorageSync看到本地緩存就結(jié)束了。4. Java 后端從零搭到能跑依賴、接口和數(shù)據(jù)庫落地后端是評閱老師真正會看代碼的部分。這一章按“骨架 → 接口 → 數(shù)據(jù)落地”三步走每一步都給可以直接抄的配置和代碼。4.1 Spring Boot 項目骨架與依賴選型老一點的畢設(shè)源碼包經(jīng)常是 SSM 項目要配一堆 XML跑起來很折騰。如果從零寫直接用 Spring Boot 更省事。注意版本配對JDK 8 配 Spring Boot 2.xJDK 17 配 Spring Boot 3.x。很多源碼包跑不起來的第一個原因就是裝了新 JDK 跑舊項目先記住一句話先看 pom.xml 里 spring-boot-starter-parent 的版本再決定裝哪個 JDK。pom.xml 核心依賴如下parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.18/version relativePath/ /parent dependencies !-- Web 接口層 -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency !-- ORM 框架MyBatis-Plus 省去手寫大量單表 CRUD -- dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.3.1/version /dependency !-- MySQL 驅(qū)動8.x 驅(qū)動類名和 5.x 不同 -- dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version8.0.33/version /dependency !-- 默認連接池 HikariCPSpring Boot 2.x 內(nèi)置 -- dependency groupIdcom.zaxxer/groupId artifactIdHikariCP/artifactId /dependency !-- Lombok 減少實體類樣板代碼 -- dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency /dependencies幾個選擇說下原因。MyBatis-Plus 是畢設(shè)標配它把單表 CRUD 的 SQL 省了分頁插件也成熟答辯時可以少背很多 XMLHikariCP 是 Spring Boot 默認連接池不需要額外引入 Druid除非老師點名要看監(jiān)控頁面Lombok 必須裝 IDE 插件否則代碼里瘋狂報錯這點容易被忽略。4.2 三個核心接口的設(shè)計登錄鑒權(quán)、提交走訪數(shù)據(jù)、圖片上傳后端接口不要貪多把三個做扎實就夠登錄鑒權(quán)、提交走訪數(shù)據(jù)、圖片上傳。接口方法路徑說明登錄POST/api/user/login賬號密碼登錄返回 token提交走訪數(shù)據(jù)POST/api/visit/submit主表明細表圖片URL一次提交圖片上傳POST/api/file/upload單圖上傳返回 URL登錄鑒權(quán)畢設(shè)階段用簡單 Token 就可以不需要引入 Spring Security 全家桶。提交走訪數(shù)據(jù)是一個典型事務(wù)場景核心 Service 代碼Service public class VisitService { Resource private VisitRecordMapper visitRecordMapper; Resource private HelpItemMapper helpItemMapper; Resource private AttachmentMapper attachmentMapper; /** * 提交走訪數(shù)據(jù)主表 措施明細 圖片地址要么全成功要么全回滾。 */ Transactional(rollbackFor Exception.class) public Long submitVisit(VisitSubmitDTO dto) { // 1. 插入走訪主表 VisitRecord record new VisitRecord(); record.setResidentId(dto.getResidentId()); record.setVisitorId(dto.getVisitorId()); record.setVisitDate(dto.getVisitDate()); record.setIncomeAmt(dto.getIncomeAmt()); record.setLiveStatus(dto.getLiveStatus()); record.setRemark(dto.getRemark()); visitRecordMapper.insert(record); // 2. 批量插入幫扶措施一對多 if (CollectionUtils.isNotEmpty(dto.getHelpItems())) { for (HelpItemDTO item : dto.getHelpItems()) { HelpItem entity new HelpItem(); entity.setVisitId(record.getId()); entity.setItemName(item.getItemName()); entity.setItemDetail(item.getItemDetail()); entity.setFinishFlag(0); helpItemMapper.insert(entity); } } // 3. 批量插入圖片附件URL 是小程序先上傳拿到的 if (CollectionUtils.isNotEmpty(dto.getImageUrls())) { for (String url : dto.getImageUrls()) { Attachment att new Attachment(); att.setVisitId(record.getId()); att.setFileUrl(url); attachmentMapper.insert(att); } } return record.getId(); } }這個方法的邏輯分三步先插主表拿到自增主鍵再依次插措施表和附件表。關(guān)鍵在 Transactional(rollbackFor Exception.class)它保證任何一步拋異常前面的插入全部回滾。這就是 Java 后端最有說頭的地方數(shù)據(jù)一致性靠事務(wù)而不是靠代碼里 if-else 兜底。面試常問的“Java 怎么保證數(shù)據(jù)一致性”在這個接口上就能答出實際案例。4.3 數(shù)據(jù)庫連接池與事務(wù)批量保存走訪明細連接池參數(shù)直接決定演示時會不會出現(xiàn)“幾個人同時提交就卡死”。application.yml 里 HikariCP 常用配置spring: datasource: url: jdbc:mysql://localhost:3306/poverty_data?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver hikari: maximum-pool-size: 10 minimum-idle: 2 connection-timeout: 30000 idle-timeout: 600000參數(shù)說明maximum-pool-size 設(shè) 10 夠畢設(shè)場景太小了演示時連自己在內(nèi)幾個賬號同時提交會排隊connection-timeout 30 秒超過就報錯而不是無限等serverTimezoneAsia/Shanghai 必須加否則 MySQL 8 默認時區(qū)會給時間字段帶來 8 小時偏差。MySQL 8 的驅(qū)動類名是 com.mysql.cj.jdbc.Driver老項目里的 com.mysql.jdbc.Driver 在新驅(qū)動下會直接報錯這也是源碼包常見翻車點。5. 聯(lián)調(diào)和答辯前避坑畢業(yè)設(shè)計最常見的 6 個翻車點這一章全是實際跑畢設(shè)踩過的坑每條按“現(xiàn)象 → 原因 → 解決”寫可以直接對照排查。5.1 真機預覽時 request 域名校驗失敗現(xiàn)象小程序開發(fā)者工具里接口調(diào)得好好的掃碼真機預覽所有請求全部失敗報 url not in domain list。原因微信小程序?qū)?request 合法域名校驗很嚴格開發(fā)者工具勾了“不校驗合法域名”能跑真機上這個選項無效域名必須是備案過的 HTTPS。很多畢設(shè)源碼包接口地址寫的是 localhost 或局域網(wǎng) IP真機上必掛。解決只做校內(nèi)答辯演示的話常見做法是把后端部署到一臺有公網(wǎng) HTTPS 域名的服務(wù)器在小程序后臺的“開發(fā)管理-開發(fā)設(shè)置”里把 request 合法域名配上。實在沒有域名可以用真機調(diào)試模式配合開發(fā)者工具臨時繞過但只限開發(fā)者本人正式演示有風險。更省事的方案直接用開發(fā)者工具錄演示視頻答辯時說明這是本地開發(fā)環(huán)境很多學校是接受的。5.2 圖片上傳成功但拿不到服務(wù)器返回的 URL現(xiàn)象wx.uploadFile 返回了 200但 res.data 怎么拿都不是對象取 url 一直是 undefined。原因uploadFile 的返回 data 是字符串而不是 JSON 對象教程直接寫 res.data.url字符串上取屬性自然是 undefined。這是后端封裝成 {code, message, data} 結(jié)構(gòu)時最經(jīng)典的配對失誤。解決拿到返回先 JSON.parse 再取字段const resp JSON.parse(res.data); if (resp.code 0) { const url resp.data.url; // 現(xiàn)在才是真正的文件URL }另外注意后端返回的 URL 要能被小程序訪問。如果返回的是 “upload/images/xxx.jpg” 這種相對路徑小程序 image 組件解析不出完整 http 地址后端要拼上域名前綴再返回。5.3 身份證號、手機號字段精度丟失現(xiàn)象數(shù)據(jù)庫里身份證號變成科學計數(shù)法或者手機號末位變成 0。原因建表時把 id_card 和 phone 建成了數(shù)值類型Java 里用 Long 接收身份證。身份證 18 位超過安全精度范圍手機號 11 位如果走了 Excel 導入單元格格式會把長數(shù)字轉(zhuǎn)成科學計數(shù)法。演示時這類問題特別容易被老師當場指出來。解決數(shù)據(jù)庫一律用 varchar 存Java 實體類用 String。順帶檢查一下 MyBatis-Plus 實體類字段類型類型寫錯時插入階段就可能報錯算運氣好運氣不好就是靜默丟精度查臺賬怎么都對不上。5.4 MySQL 時區(qū)導致時間差 8 小時現(xiàn)象小程序提交的走訪日期顯示正常create_time 比北京時間慢了 8 個小時。原因MySQL 8 默認時區(qū)是 UTCJDBC 連接串沒帶時區(qū)參數(shù)時驅(qū)動按服務(wù)器時區(qū)解釋時間戳。本地開發(fā)機器系統(tǒng)時區(qū)如果是 Asia/Shanghai插入和查詢各差 8 小時看起來像“時間穿越”。解決JDBC URL 上加 serverTimezoneAsia/Shanghai同時確認 MySQL 服務(wù)端時區(qū)SHOW VARIABLES LIKE %time_zone%; 如果 Global time zone 是 SYSTEM執(zhí)行 SET GLOBAL time_zone 08:00;。Java 實體類的 create_time 建議用 LocalDateTime默認映射行為更可控。5.5 演示視頻里最常見的翻車冷啟動查不到數(shù)據(jù)現(xiàn)象錄演示視頻時小程序白屏轉(zhuǎn)圈接口超時后臺臺賬列表是空的。原因后端沒啟動、數(shù)據(jù)庫沒導入、或者小程序里配置的 baseURL 指向了已失效的地址。很多源碼包把接口地址寫死在某臺臨時服務(wù)器上作者把服務(wù)器一關(guān)代碼就變廢包。演示前一天還正常答辯當天掛多半是環(huán)境沒起全。解決錄視頻前走一遍檢查清單。第一步確認 MySQL 服務(wù)在跑root 能連上。第二步啟動后端看控制臺有沒有數(shù)據(jù)源報錯。第三步小程序開發(fā)者工具里確認 baseURL 指向本機局域網(wǎng) IP真機調(diào)試時手機和電腦要在同一網(wǎng)絡(luò)。第四步隨便提一條測試數(shù)據(jù)去數(shù)據(jù)庫 SELECT 一下確認物理落庫后再開錄。這四步花五分鐘能避開九成演示翻車。5.6 源碼包里的數(shù)據(jù)庫腳本導入失敗現(xiàn)象拿到一個 zip 源碼包導入 .sql 時直接報錯或者后端啟動提示連接被拒絕。原因三個常見來源。一是 SQL 文件是高版本 MySQL 導出的本地版本低遇到新字符集或約束語法直接報錯二是腳本里寫了 USE 某個自定義庫名本地沒有這個庫三是 MySQL 8 默認認證插件和舊驅(qū)動不兼容。解決先看 SQL 文件開頭手動建好同名數(shù)據(jù)庫再導入。導入報錯時用文本編輯器打開定位到第一條報錯語句刪掉不兼容的語法再試。驅(qū)動版本低于 8.0 就把項目換成 mysql-connector-java 8.x。密碼認證問題可以執(zhí)行 ALTER USER rootlocalhost IDENTIFIED WITH mysql_native_password BY 你的密碼; 再用舊驅(qū)動連。字符集記得統(tǒng)一 utf8mb4避免中文亂碼和數(shù)據(jù)導入半截。6. 演示視頻的錄制腳本從「能跑」到「像樣」的三個技巧畢設(shè) zip 里如果演示視頻是隨手錄的印象分會打折。錄制前先寫腳本按“登錄 → 走訪填單 → 圖片上傳 → 后臺臺賬”四段串每段留兩秒停頓方便剪輯。技巧一數(shù)據(jù)要預置。演示時最忌諱從空庫開始錄每條表單要填十幾個字段老師在旁邊等著一緊張就填錯。預先在數(shù)據(jù)庫里插入幾戶幫扶對象走訪記錄也留幾條視頻里演示的是“新增一條走訪記錄”而不是“從零開始錄入一個對象”。這一步看起來小錄出來的節(jié)奏完全不同。技巧二錄屏時把證據(jù)鏈錄進去。小程序端錄制時旁邊開一個小窗顯示后端日志或者錄完小程序立刻切到 Navicat 查詢新插入的記錄。這樣做能向老師證明數(shù)據(jù)真的落庫了不是前端假數(shù)據(jù)。不用多復雜Navicat 查詢結(jié)果窗口往屏幕右下角一放錄進去十秒就夠。截圖放進論文文檔也是同一個素材一舉兩得。技巧三給演示視頻加關(guān)鍵停頓和簡單字幕。老師可能靜音看視頻把操作步驟和關(guān)鍵提示做成字幕壓在底部填了什么字段、為什么這樣校驗、上傳成功后 URL 返回到哪里。字幕不用多每段一句控制節(jié)奏。我用過的笨辦法是后期在剪映里加放大特效突出表單校驗彈窗讓老師看清彈窗內(nèi)容和觸發(fā)時機。如果視頻里必須展示真機預覽先把 5.1 里的域名問題解決否則真機上接口不通整段視頻都是廢的。我個人的習慣是開發(fā)者工具錄主流程真機錄一個十秒的操作特寫兩段拼起來。當年我答辯時因為視頻里校驗彈窗一閃而過被追問“這個校驗到底怎么觸發(fā)的”現(xiàn)場又重新演示才講清。從那以后我錄視頻都會在關(guān)鍵彈窗處停兩秒再繼續(xù)操作。這個教訓寫在這里希望幫到你。本文還有配套的精品資源點擊獲取