航系統(tǒng)畢設(shè)全解析)
這次我們來看一個(gè)面向計(jì)算機(jī)畢業(yè)設(shè)計(jì)的完整全棧項(xiàng)目SpringBoot 微信小程序 AI大模型 智能校園導(dǎo)航系統(tǒng)。它不是單獨(dú)的小程序前端也不是只搭了個(gè)后端登錄接口的“空殼項(xiàng)目”而是把數(shù)據(jù)庫設(shè)計(jì)、后端接口、小程序頁面、AI 能力接入全部串起來的閉環(huán)系統(tǒng)配套還帶源碼、LW畢業(yè)設(shè)計(jì)論文文檔、PPT 和講解。先說怎么判斷這個(gè)項(xiàng)目適不適合你。如果你正在準(zhǔn)備計(jì)算機(jī)畢業(yè)設(shè)計(jì)技術(shù)棧需要覆蓋SpringBoot、微信小程序、AI大模型應(yīng)用又希望做出來的東西既實(shí)用又有“智能感”那這個(gè)題目基本是沖著這幾個(gè)關(guān)鍵詞去的。校園導(dǎo)航不是新概念但加入大模型語義解析之后用戶可以直接輸入“我想去圖書館”這樣的自然語言由后端調(diào)用大模型解析出具體目的地再配合校園地圖完成導(dǎo)航展示這就比傳統(tǒng)關(guān)鍵詞匹配的“菜鳥級(jí)導(dǎo)航”更有答辯亮點(diǎn)。本文不準(zhǔn)備只講“這個(gè)項(xiàng)目多好”而是按一套完整的本地部署與驗(yàn)證思路來拆核心能力、系統(tǒng)架構(gòu)、環(huán)境準(zhǔn)備、啟動(dòng)方式、功能測(cè)試、接口調(diào)用、AI 大模型集成方式、常見問題排查和最佳實(shí)踐?？赐昴憔湍芘袛鄡杉碌谝贿@個(gè)項(xiàng)目值不值得作為你的畢設(shè)選題第二拿到源碼之后該怎么把它跑起來并在答辯時(shí)有話可講。文章里所有命令和配置都是通用寫法實(shí)際路徑、端口、AppID 需要替換成你項(xiàng)目里的真實(shí)值。1. 核心能力速覽在動(dòng)手部署之前先把項(xiàng)目的技術(shù)畫像拉出來看一眼。下面這張表的內(nèi)容既是從項(xiàng)目標(biāo)題和常見畢設(shè)項(xiàng)目結(jié)構(gòu)推斷的能力邊界也是你驗(yàn)收源碼時(shí)必須逐項(xiàng)確認(rèn)的檢查點(diǎn)。能力項(xiàng)說明項(xiàng)目類型計(jì)算機(jī)畢業(yè)設(shè)計(jì)全棧項(xiàng)目后端 小程序端 AI能力接入后端框架SpringBoot按標(biāo)準(zhǔn) MVC 分層結(jié)構(gòu)組織前端框架微信小程序原生開發(fā)使用微信開發(fā)者工具編譯運(yùn)行AI 能力接入大模型接口實(shí)現(xiàn)自然語言目的地解析、校園問答等智能交互核心功能用戶登錄、校園地圖展示、POI 搜索、導(dǎo)航路徑規(guī)劃、AI 問路/問答數(shù)據(jù)庫MySQL涉及用戶表、地點(diǎn)信息表、導(dǎo)航記錄表等基礎(chǔ)表結(jié)構(gòu)配套材料源碼、LW論文文檔、PPT、講解視頻啟動(dòng)方式后端啟動(dòng) SpringBoot 應(yīng)用前端在微信開發(fā)者工具中導(dǎo)入項(xiàng)目是否支持 API后端天然提供 HTTP 接口供小程序端、管理端或第三方調(diào)用是否支持批量任務(wù)后端可擴(kuò)展批量導(dǎo)入校園 POI 數(shù)據(jù)AI 接口可按批量請(qǐng)求處理適合場(chǎng)景畢業(yè)設(shè)計(jì)選題、SpringBoot 小程序全棧入門、AI 應(yīng)用課程項(xiàng)目需要注意以上能力表的“來源”是項(xiàng)目標(biāo)題和常見的畢設(shè)項(xiàng)目組織方式。真正的源碼里具體實(shí)現(xiàn)了哪些接口、是否接入了真實(shí)的大模型廠商 API、地圖用的是 WebGL 還是靜態(tài)圖片都要以你拿到的項(xiàng)目文檔為準(zhǔn)。后面每個(gè)功能測(cè)試環(huán)節(jié)都要先回到源碼里確認(rèn)實(shí)現(xiàn)方式再動(dòng)手驗(yàn)證。2. 適用場(chǎng)景與使用邊界2.1 適合誰用這個(gè)項(xiàng)目最直接的受眾是計(jì)算機(jī)相關(guān)專業(yè)的大四學(xué)生尤其是選題方向偏向SpringBoot、微信小程序、AI大模型應(yīng)用開發(fā)的同學(xué)。它解決的核心問題不是“從零寫一個(gè)校園導(dǎo)航有多難”而是“怎么在有限的時(shí)間內(nèi)交付一個(gè)結(jié)構(gòu)完整、功能可演示、論文有內(nèi)容寫的系統(tǒng)”。如果你是下面這類讀者也值得拿這套項(xiàng)目當(dāng)作學(xué)習(xí)素材SpringBoot 初學(xué)者想找一個(gè)包含 Controller、Service、Mapper 分層結(jié)構(gòu)的完整后端項(xiàng)目而不是只做 CRUD 小 demo。微信小程序?qū)W習(xí)者想看看登錄流程、頁面跳轉(zhuǎn)、地圖組件、網(wǎng)絡(luò)請(qǐng)求在小程序里是怎么組織的。AI 應(yīng)用方向?qū)W生想了解大模型 API 如何被接入到傳統(tǒng)業(yè)務(wù)系統(tǒng)里而不是只能做聊天機(jī)器人。準(zhǔn)備畢設(shè)答辯的學(xué)生需要一套能講清楚“業(yè)務(wù)模塊 AI 創(chuàng)新點(diǎn) 數(shù)據(jù)庫設(shè)計(jì) 測(cè)試結(jié)果”的完整項(xiàng)目敘事。2.2 能解決什么問題傳統(tǒng)校園導(dǎo)航系統(tǒng)往往停留在“地圖展示 關(guān)鍵字匹配”的層面用戶輸入“圖書館”就搜地點(diǎn)輸入“我想自習(xí)”就無能為力。加入 AI 大模型后系統(tǒng)可以把自然語言轉(zhuǎn)換成結(jié)構(gòu)化查詢條件也能承擔(dān)一部分校園問答能力比如“校醫(yī)院幾點(diǎn)下班”“圖書館在哪棟樓”。這種“業(yè)務(wù)系統(tǒng) AI 能力”的組合正是當(dāng)前畢業(yè)設(shè)計(jì)評(píng)分時(shí)比較看重的亮點(diǎn)。從工程角度看完整的用戶——地點(diǎn)——導(dǎo)航記錄數(shù)據(jù)流也讓你在寫論文時(shí)有足夠的內(nèi)容需求分析、系統(tǒng)設(shè)計(jì)、數(shù)據(jù)庫表設(shè)計(jì)、接口設(shè)計(jì)、AI 模塊設(shè)計(jì)、系統(tǒng)測(cè)試每一章都有實(shí)際代碼和數(shù)據(jù)支撐不會(huì)出現(xiàn)“寫不出內(nèi)容只能湊字?jǐn)?shù)”的問題。2.3 使用邊界與合規(guī)提醒這里要單獨(dú)強(qiáng)調(diào)拿到任何畢設(shè)項(xiàng)目源碼后第一件事不是改代碼而是確認(rèn)使用邊界。不要照抄提交部分高校對(duì)畢業(yè)設(shè)計(jì)有查重和代碼相似度檢測(cè)。參考源碼學(xué)習(xí)結(jié)構(gòu)、理解實(shí)現(xiàn)邏輯沒問題但直接替換個(gè)人信息提交可能會(huì)被判定學(xué)術(shù)不端。最好在理解的基礎(chǔ)上重構(gòu)部分模塊并補(bǔ)充自己的功能設(shè)計(jì)。AI 接口需要授權(quán)項(xiàng)目里接大模型 API通常意味著你需要在某個(gè)平臺(tái)上申請(qǐng) API Key。不同平臺(tái)的計(jì)費(fèi)方式、數(shù)據(jù)隱私政策、調(diào)用頻率限制都不一樣論文里要寫清楚你用的是哪個(gè)平臺(tái)、什么模型、為什么選它。地圖數(shù)據(jù)有版權(quán)校園地圖、POI 坐標(biāo)、建筑圖片這些素材如果來自第三方要注意授權(quán)邊界。涉及個(gè)人信息的用戶數(shù)據(jù)在做演示時(shí)不要使用真實(shí)同學(xué)的大量敏感數(shù)據(jù)。小程序發(fā)布需合規(guī)個(gè)人主體的小程序和涉及地圖、定位、用戶信息的功能在微信公眾平臺(tái)審核時(shí)有額外要求。畢業(yè)設(shè)計(jì)階段用開發(fā)者工具和測(cè)試號(hào)即可不需要真的發(fā)布上線。3. 環(huán)境準(zhǔn)備與前置條件這套項(xiàng)目跑起來的環(huán)境不算復(fù)雜和大多數(shù)SpringBoot 小程序項(xiàng)目的部署方式一致。下面按后端、前端、數(shù)據(jù)庫三部分列出一份通用環(huán)境檢查清單。3.1 后端環(huán)境組件推薦版本說明JDK1.8 或 11具體以pom.xml中的java.version為準(zhǔn)Maven3.6 以上用于拉取項(xiàng)目和打包IDEIDEA 或 Eclipse建議直接使用 IDEA識(shí)別 SpringBoot 項(xiàng)目更順手MySQL5.7 或 8.0需要手動(dòng)創(chuàng)建數(shù)據(jù)庫并導(dǎo)入 SQL 文件Navicat / Workbench任意用于查看數(shù)據(jù)庫表結(jié)構(gòu)和初始化數(shù)據(jù)當(dāng)你拿到源碼后第一步是打開pom.xml確認(rèn)三件事spring-boot-starter-parent的版本號(hào)是 2.7.x 還是 3.x。java.version是多少Java 8 還是 17。依賴?yán)镉袥]有 MyBatis、MyBatis-Plus、MySQL 驅(qū)動(dòng)、Redis、AI SDK 等。這里特別提醒網(wǎng)上很多同學(xué)遇到“springboot版本太高”導(dǎo)致項(xiàng)目啟動(dòng)失敗的問題。原因通常是SpringBoot 3.x 要求 JDK 17 以上而本機(jī)裝的是 JDK 8或者反過來項(xiàng)目是 SpringBoot 2.7 編譯的你用 JDK 17 運(yùn)行低版本項(xiàng)目也會(huì)出現(xiàn)兼容告警。最穩(wěn)妥的方式是嚴(yán)格按照項(xiàng)目文檔里的 JDK 版本配置環(huán)境。3.2 微信小程序前端環(huán)境組件說明微信開發(fā)者工具穩(wěn)定版即可導(dǎo)入項(xiàng)目時(shí)選擇小程序項(xiàng)目AppID使用測(cè)試號(hào)或自己的小程序 AppID手機(jī)或模擬器用于驗(yàn)證頁面渲染、定位、地圖交互小程序端的技術(shù)棧通常就是微信原生語法WXML、WXSS、JS、JSON 配置。不需要額外安裝 npm 依賴除非項(xiàng)目里使用了Vant Weapp之類的 UI 組件庫。如果用了組件庫需要在app.json里做組件路徑配置并且miniprogram_npm目錄要存在。3.3 數(shù)據(jù)庫環(huán)境項(xiàng)目的.sql文件一般會(huì)放在sql/或db/目錄下。你需要?jiǎng)?chuàng)建一個(gè)數(shù)據(jù)庫字符集選擇utf8mb4。導(dǎo)入 SQL 文件生成用戶表、地點(diǎn)表、導(dǎo)航記錄表等。在application.yml里修改數(shù)據(jù)庫地址、賬號(hào)、密碼。下面是一個(gè)通用的application.yml配置模板實(shí)際字段以項(xiàng)目為準(zhǔn)server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://127.0.0.1:3306/campus_navigation?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 123456 mybatis-plus: mapper-locations: classpath*:mapper/**/*.xml configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl如果你的項(xiàng)目里還接了 Redis 或大模型 API配置里會(huì)出現(xiàn)spring.redis和自定義的ai.api-key、ai.model-name等字段。這些都需要按源碼中的application-example.yml或說明文檔來填。3.4 硬件要求這里不是圖像生成項(xiàng)目不存在“顯存不夠就跑不了”的問題。后端 SpringBoot 應(yīng)用對(duì)內(nèi)存的常規(guī)要求在 512MB 到 2GB 之間開發(fā)機(jī)基本都能滿足。唯一需要留意的是如果你在本地啟動(dòng)多個(gè)大型 IDE、MySQL、微信開發(fā)者工具內(nèi)存 8GB 的機(jī)器會(huì)比較吃力建議先關(guān)掉無關(guān)應(yīng)用再啟動(dòng)。4. 安裝部署與啟動(dòng)方式拿到源碼后推薦按照“數(shù)據(jù)庫 - 后端 - 小程序前端”的順序啟動(dòng)。這樣小程序調(diào)用后端接口時(shí)服務(wù)已經(jīng)在運(yùn)行可以直接看到效果。4.1 初始化數(shù)據(jù)庫# 登錄 MySQL mysql -u root -p # 創(chuàng)建數(shù)據(jù)庫 CREATE DATABASE IF NOT EXISTS campus_navigation DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; # 使用數(shù)據(jù)庫 USE campus_navigation; # 導(dǎo)入 SQL 文件路徑按實(shí)際存放位置調(diào)整 SOURCE D:/project/campus_navigation/sql/campus_navigation.sql;導(dǎo)入成功后執(zhí)行SHOW TABLES;你應(yīng)該能看到類似下面的表user campus_building campus_poi navigation_record ai_chat_record表名和字段名可能不同但基本的業(yè)務(wù)表結(jié)構(gòu)應(yīng)該覆蓋用戶、地點(diǎn)、導(dǎo)航記錄和 AI 交互記錄這幾類。4.2 啟動(dòng) SpringBoot 后端用 IDEA 打開后端項(xiàng)目后等待 Maven 下載依賴。這里有幾個(gè)容易卡住的地方Maven 依賴下載慢建議配置阿里云鏡像。依賴下載失敗檢查本地 Maven 倉庫權(quán)限。Lombok 版本與 JDK 不兼容會(huì)見到編譯錯(cuò)誤。依賴下載完成后修改application.yml里的數(shù)據(jù)庫賬號(hào)密碼和 AI 接口配置然后運(yùn)行啟動(dòng)類。項(xiàng)目根目錄 ├── src/main/java │ └── com/example/campusnav/CampusNavApplication.java ├── src/main/resources │ ├── application.yml │ └── mapper/*.xml └── pom.xml在 IDEA 中右鍵運(yùn)行CampusNavApplication看到類似下面的日志說明啟動(dòng)成功Tomcat started on port(s): 8080 (http) with context path Started CampusNavApplication in 5.2 seconds如果你習(xí)慣用命令行啟動(dòng)也可以先用 Maven 打包mvn clean package -DskipTests java -jar target/campus-nav-0.0.1-SNAPSHOT.jar啟動(dòng)后用瀏覽器訪問http://127.0.0.1:8080或者訪問項(xiàng)目配置的 Swagger 文檔地址如果有確認(rèn)后端接口可以訪問。4.3 導(dǎo)入微信小程序打開微信開發(fā)者工具點(diǎn)擊“導(dǎo)入項(xiàng)目”選擇小程序前端目錄。需要確認(rèn)的配置配置項(xiàng)操作AppID使用測(cè)試號(hào)或填寫你自己的 AppID后端接口地址在utils/request.js或app.js中修改 baseUrl 為http://127.0.0.1:8080不校驗(yàn)合法域名開發(fā)階段勾選“不校驗(yàn)合法域名、web-view業(yè)務(wù)域名、TLS 版本以及 HTTPS 證書”如果你在小程序里自定義了登錄彈窗或頂部導(dǎo)航欄還需要檢查app.json里的navigationStyle配置。導(dǎo)入成功后點(diǎn)擊模擬器頁面的“編譯”按鈕。小程序會(huì)向本機(jī)后端發(fā)起請(qǐng)求如果能正常拉取校園地點(diǎn)列表說明前后端已經(jīng)連通。5. 功能測(cè)試與效果驗(yàn)證項(xiàng)目跑起來之后不要急著截圖寫論文。先按下面的功能矩陣做一遍完整的驗(yàn)證確認(rèn)每個(gè)模塊都符合預(yù)期再考慮改代碼、加功能。5.1 用戶登錄與微信授權(quán)測(cè)試目的確認(rèn)小程序可以完成微信登錄流程后端能拿到用戶身份并創(chuàng)建用戶記錄。操作步驟在微信開發(fā)者工具中打開小程序。點(diǎn)擊“登錄”或“授權(quán)登錄”按鈕。觀察后端控制臺(tái)是否收到登錄請(qǐng)求。查看數(shù)據(jù)庫user表是否新增或更新了用戶記錄。預(yù)期結(jié)果登錄成功后小程序端保存用戶 token后續(xù)請(qǐng)求攜帶用戶身份。后端日志能看到用戶 openid 或 unionid 的存取過程。判斷標(biāo)準(zhǔn)退出小程序重新進(jìn)入登錄態(tài)仍然保持不需要每次都重復(fù)授權(quán)。常見失敗原因AppID配置錯(cuò)誤、后端接口地址不對(duì)、code2Session請(qǐng)求的 appid 與 secret 與項(xiàng)目不匹配。5.2 校園地圖與 POI 展示測(cè)試目的確認(rèn)地圖組件能正常顯示校園建筑和 POI 點(diǎn)位坐標(biāo)正確。操作步驟進(jìn)入小程序首頁或地圖頁面。檢查地圖是否渲染出校園范圍。點(diǎn)擊地圖上的標(biāo)記點(diǎn)查看地點(diǎn)名稱、介紹、開放時(shí)間等信息。對(duì)比地圖坐標(biāo)與實(shí)際校園位置是否一致。預(yù)期結(jié)果頁面能展示地圖標(biāo)記點(diǎn)點(diǎn)擊后有信息浮層POI 數(shù)據(jù)來自后端接口而不是寫死在小程序代碼里。判斷標(biāo)準(zhǔn)新增或修改一條 POI 數(shù)據(jù)后小程序端刷新頁面能看到變化。常見失敗原因地圖 key 未配置、坐標(biāo)系統(tǒng)不一致GCJ-02 與 WGS-84 需轉(zhuǎn)換、地圖插件在小程序后臺(tái)未添加。5.3 智能搜索與 AI 問路這是整個(gè)項(xiàng)目的核心亮點(diǎn)模塊也是答辯時(shí)最值得講的功能。測(cè)試目的驗(yàn)證大模型是否能把自然語言轉(zhuǎn)換成具體的導(dǎo)航目的地或問答結(jié)果。操作示例輸入文本期望行為“我想去圖書館”系統(tǒng)解析出目的地是“圖書館”并展示對(duì)應(yīng) POI 和導(dǎo)航按鈕“校醫(yī)院在哪”系統(tǒng)返回校醫(yī)院位置和路徑信息“今天要去交材料應(yīng)該去哪個(gè)部門”大模型根據(jù)校園知識(shí)庫給出建議可能觸發(fā)多輪對(duì)話“你好”系統(tǒng)返回歡迎語不觸發(fā)導(dǎo)航意圖操作步驟在搜索框輸入自然語言。點(diǎn)擊搜索或發(fā)送按鈕。查看返回結(jié)果是直接定位到 POI還是進(jìn)入 AI 對(duì)話。點(diǎn)擊“開始導(dǎo)航”確認(rèn)路徑規(guī)劃可以正常展示。預(yù)期結(jié)果大模型能正確識(shí)別“地點(diǎn)意圖”和“問答意圖”。地點(diǎn)意圖返回結(jié)構(gòu)化地址問答意圖返回文本答案。判斷標(biāo)準(zhǔn)連續(xù)測(cè)試 10 條以上不同表達(dá)方式的語句比如“我要去圖書館”“圖書館怎么走”“哪里能借書”至少 7 條以上被正確處理說明 AI 模塊整體可用。常見失敗原因大模型 API Key 失效、提示詞工程配置錯(cuò)誤、后端返回超時(shí)、小程序端沒有設(shè)置較長的請(qǐng)求超時(shí)時(shí)間。這里給出一個(gè)后端 AI 接口調(diào)用的通用示例實(shí)際項(xiàng)目里會(huì)根據(jù)你所接入的大模型平臺(tái)調(diào)整// 通用大模型調(diào)用示例具體依賴和類名以項(xiàng)目為準(zhǔn) public String chatWithAI(String userMessage) { String apiKey config.getApiKey(); String url config.getApiUrl(); MapString, Object requestBody new HashMap(); requestBody.put(model, config.getModelName()); requestBody.put(messages, List.of( Map.of(role, system, content, 你是一個(gè)校園導(dǎo)航助手只能回答與校園相關(guān)的問題), Map.of(role, user, content, userMessage) )); // 使用 HttpURLConnection 或 Spring RestTemplate 發(fā)起請(qǐng)求 RestTemplate restTemplate new RestTemplate(); HttpHeaders headers new HttpHeaders(); headers.setContentType(MediaType.APPLICATION_JSON); headers.setBearerAuth(apiKey); HttpEntityMapString, Object entity new HttpEntity(requestBody, headers); ResponseEntityMap response restTemplate.postForEntity(url, entity, Map.class); // 從響應(yīng)中提取生成文本字段名以平臺(tái)返回為準(zhǔn) return response.getBody().get(choices).toString(); }5.4 導(dǎo)航路徑規(guī)劃測(cè)試目的確認(rèn)選中目的地后能調(diào)用地圖路徑規(guī)劃能力并展示路線。操作步驟在 POI 詳情頁點(diǎn)擊“導(dǎo)航”或“到這里去”。進(jìn)入導(dǎo)航頁面查看起終點(diǎn)是否正確。觀察路線繪制步行路線、距離、時(shí)間是否顯示。在小程序模擬器切換不同定位點(diǎn)確認(rèn)路線會(huì)跟著變化。預(yù)期結(jié)果地圖上出現(xiàn)從當(dāng)前位置到目的地的路線折線伴隨距離和預(yù)計(jì)步行時(shí)間。判斷標(biāo)準(zhǔn)不同起終點(diǎn)組合下路線都能正常規(guī)劃。常見失敗原因地圖 SDK 路徑規(guī)劃接口需要額外開通、起點(diǎn)坐標(biāo)默認(rèn)為 0定位失敗、模擬器不支持定位需要手動(dòng)選點(diǎn)。5.5 導(dǎo)航記錄與歷史管理測(cè)試目的確認(rèn)用戶的歷史導(dǎo)航記錄能保存、查詢、刪除。操作步驟完成一次導(dǎo)航后到“記錄”或“我的”頁面查看。確認(rèn)導(dǎo)航記錄包含起終點(diǎn)、時(shí)間、狀態(tài)。刪除一條記錄刷新頁面后確認(rèn)已刪除。預(yù)期結(jié)果導(dǎo)航記錄與當(dāng)前登錄用戶綁定不同用戶看不到彼此記錄。判斷標(biāo)準(zhǔn)數(shù)據(jù)庫navigation_record表有新數(shù)據(jù)寫入且字段完整。常見失敗原因請(qǐng)求頭未攜帶用戶 token后端無法識(shí)別當(dāng)前用戶導(dǎo)致查詢?yōu)榭铡?.6 后端接口文檔測(cè)試如果項(xiàng)目集成了 Swagger 或 Knife4j可以像下面這樣直接請(qǐng)求接口驗(yàn)證數(shù)據(jù)流。# 請(qǐng)求校園地點(diǎn)列表接口地址以實(shí)際項(xiàng)目為準(zhǔn) curl -X GET http://127.0.0.1:8080/api/poi/list \ -H Content-Type: application/json# 請(qǐng)求 AI 對(duì)話接口 curl -X POST http://127.0.0.1:8080/api/ai/chat \ -H Content-Type: application/json \ -d {message: 我想去圖書館}測(cè)試時(shí)重點(diǎn)看三塊接口是否能正常返回HTTP 狀態(tài)碼是 200 還是 500。返回 JSON 結(jié)構(gòu)是否與小程序端解析邏輯一致。輸入特殊字符、超長文本時(shí)接口是否穩(wěn)定。6. 接口 API 與批量任務(wù)畢設(shè)項(xiàng)目里接口 API 的設(shè)計(jì)質(zhì)量直接影響論文的“系統(tǒng)設(shè)計(jì)”部分。一個(gè)合格的 SpringBoot 小程序項(xiàng)目接口通常按下面的風(fēng)格組織。模塊接口路徑方法說明用戶/api/user/loginPOST用戶登錄/注冊(cè)用戶/api/user/infoGET獲取用戶信息地點(diǎn)/api/poi/listGET地點(diǎn)列表分頁/關(guān)鍵字地點(diǎn)/api/poi/detail/{id}GET地點(diǎn)詳情導(dǎo)航/api/navigation/planPOST路徑規(guī)劃導(dǎo)航/api/navigation/recordGET/POST/DELETE導(dǎo)航記錄管理AI/api/ai/chatPOSTAI 對(duì)話/意圖識(shí)別實(shí)際接口路徑和參數(shù)要以源碼為準(zhǔn)上面的表格只作為組織接口文檔時(shí)的參考模板。6.1 小程序端的 HTTP 請(qǐng)求方式小程序端一般會(huì)在utils/request.js中封裝一個(gè)帶 token 的請(qǐng)求方法const request (url, method GET, data {}) { return new Promise((resolve, reject) { wx.request({ url: getApp().globalData.baseUrl url, method: method, data: data, header: { Content-Type: application/json, Authorization: wx.getStorageSync(token) }, success: (res) { if (res.statusCode 200) { resolve(res.data); } else if (res.statusCode 401) { wx.navigateTo({ url: /pages/login/login }); } else { reject(res.data); } }, fail: (err) reject(err) }); }); }; module.exports { request };在頁面里調(diào)用時(shí)就比較清爽const { request } require(../../utils/request); Page({ data: { poiList: [] }, onLoad() { this.loadPoiList(); }, async loadPoiList() { const res await request(/api/poi/list, GET); this.setData({ poiList: res.data }); } });6.2 微信登錄流程微信登錄是這類項(xiàng)目繞不開的核心流程也是答辯時(shí)老師很愛問的點(diǎn)。![流程圖說明小程序端 wx.login 獲取 code - 傳給后端 - 后端調(diào)用微信 code2Session 接口 - 返回 openid 和 session_key - 后端生成自定義 token 返回給小程序]需要注意的是這里不能用 mermaid就直接用文字流程說明小程序端調(diào)用wx.login拿到臨時(shí)code。小程序把code發(fā)送給自己的后端/api/user/login。后端用appid secret code請(qǐng)求微信接口code2Session。微信返回openid、session_key。后端根據(jù)openid查找或創(chuàng)建用戶生成自定義登錄 token。后端把 token 返回給小程序小程序存入本地存儲(chǔ)。后端核心偽代碼如下RestController RequestMapping(/api/user) public class UserController { PostMapping(/login) public Result login(RequestBody LoginRequest request) { // 1. 用 code 請(qǐng)求微信 code2Session String url https://api.weixin.qq.com/sns/jscode2session? appid appid secret secret js_code request.getCode() grant_typeauthorization_code; // 2. 發(fā)起 HTTP 請(qǐng)求解析 openid // 3. 查詢用戶如果不存在則注冊(cè) // 4. 生成 token 并返回 return Result.success(token); } }很多同學(xué)在開發(fā)時(shí)遇到“小程序獲取登錄后的微信用戶失敗”的問題常見原因包括后端code2Session請(qǐng)求失敗檢查appid和secret是否匹配。小程序端沒有把code傳到后端只傳了用戶頭像。后端返回的 openid 字段名和數(shù)據(jù)庫字段對(duì)不上。請(qǐng)求被攔截需要確認(rèn)小程序后臺(tái)的 request 合法域名配置。6.3 批量任務(wù)與數(shù)據(jù)管理畢設(shè)項(xiàng)目里“批量任務(wù)”的概念不像工業(yè)級(jí)系統(tǒng)那么重但有兩個(gè)場(chǎng)景值得做批量導(dǎo)入校園 POI 數(shù)據(jù)提供一個(gè)管理員接口接收 Excel 或 JSON 批量寫入建筑和地點(diǎn)信息避免手動(dòng)一條條插入數(shù)據(jù)庫。批量測(cè)試 AI 意圖識(shí)別準(zhǔn)備一組測(cè)試用例比如 20 條不同表述的“去圖書館”問法循環(huán)調(diào)用 AI 接口統(tǒng)計(jì)識(shí)別正確率。這個(gè)數(shù)據(jù)可以直接放進(jìn)論文的系統(tǒng)測(cè)試章節(jié)。批量測(cè)試的 Python 示例import requests import time import json # 替換成你的后端地址和測(cè)試用例 api_url http://127.0.0.1:8080/api/ai/chat test_cases [ 我想去圖書館, 圖書館怎么走, 去哪里可以借書, 我要還書應(yīng)該到哪個(gè)樓, 圖書館幾點(diǎn)關(guān)門 ] results [] for case in test_cases: try: response requests.post(api_url, json{message: case}, timeout30) data response.json() results.append({input: case, output: data}) print(f[OK] {case} - {data}) except Exception as e: results.append({input: case, error: str(e)}) print(f[FAIL] {case} - {e}) time.sleep(0.5) # 避免觸發(fā)接口限流 with open(ai_test_results.json, w, encodingutf-8) as f: json.dump(results, f, ensure_asciiFalse, indent2)批量任務(wù)的關(guān)鍵是“可觀測(cè)”。每個(gè)測(cè)試用例都要記錄輸入、輸出、耗時(shí)、是否成功這樣出了問題才能定位是 AI 模型理解不準(zhǔn)還是接口超時(shí)還是提示詞沒寫好。7. 資源占用與性能觀察雖然這不是大模型本地部署項(xiàng)目AI 能力是通過 HTTP 接口調(diào)用的不會(huì)占很大的顯存或內(nèi)存但性能觀察同樣重要。畢設(shè)答辯時(shí)如果老師問“你這個(gè)系統(tǒng)性能怎么樣”“接口慢不慢”你不能只說“挺快的”要用數(shù)據(jù)說話。7.1 后端內(nèi)存與 CPUSpringBoot 應(yīng)用啟動(dòng)后的內(nèi)存占用通常在 300MB 到 1GB 之間?？梢赃@樣觀察# Windows 上查看進(jìn)程內(nèi)存 jps -l # 查看指定進(jìn)程狀態(tài) jinfo pid實(shí)際體驗(yàn)上IDEA 里跑 SpringBoot 不會(huì)像啟動(dòng)大型機(jī)器學(xué)習(xí)任務(wù)那樣吃緊8GB 內(nèi)存的筆記本電腦完全夠用。7.2 AI 接口的響應(yīng)時(shí)間這是整個(gè)系統(tǒng)里最影響體驗(yàn)的性能瓶頸。普通數(shù)據(jù)庫查詢接口可能在 50ms 到 200ms但大模型接口的響應(yīng)時(shí)間通常會(huì)在 1 秒到 5 秒取決于你使用的是哪家平臺(tái)、什么型號(hào)的模型、輸入文本長度。如果響應(yīng)超過 10 秒小程序端用戶就會(huì)感覺到明顯的卡頓。優(yōu)化建議在小程序端把 AI 請(qǐng)求的超時(shí)時(shí)間調(diào)到 15 秒以上避免請(qǐng)求被提前中斷。后端使用異步處理不阻塞主請(qǐng)求線程。如果同一句問話頻繁出現(xiàn)可以做簡單的本地緩存命中緩存就不再調(diào)用 AI 接口。在提示詞里限制輸出長度減少 tokens 消耗和響應(yīng)時(shí)間。7.3 數(shù)據(jù)庫連接與連接池如果項(xiàng)目使用 MyBatis-Plus默認(rèn)連接池是 HikariCP。觀察數(shù)據(jù)庫連接池是否正?？梢栽赼pplication.yml中臨時(shí)打開 SQL 日志logging: level: com.example.campusnav.mapper: debug這樣每次 SQL 操作都會(huì)在控制臺(tái)打印方便確認(rèn)接口慢是不是因?yàn)?SQL 查詢問題比如缺少索引、全表掃描、N1 查詢。7.4 小程序端性能小程序端的性能觀察點(diǎn)包括地圖頁面是否卡頓連續(xù)拖動(dòng)地圖時(shí)幀率如何。頁面 onLoad 的數(shù)據(jù)請(qǐng)求是否在頁面渲染前完成。圖片資源是否過大影響加載速度。是否合理使用wx.setStorageSync做本地緩存而不是每次打開頁面都請(qǐng)求后端。8. 常見問題與排查方法下面是這套項(xiàng)目從部署到運(yùn)行最常遇到的問題按照“問題現(xiàn)象 - 可能原因 - 排查方式 - 解決方案”的順序整理。問題現(xiàn)象可能原因排查方式解決方案后端啟動(dòng)報(bào)“springboot版本太高”或版本不兼容JDK 版本與 SpringBoot 版本不匹配查看pom.xml中 java.version 和 spring-boot 版本SpringBoot 2.x 用 JDK 8/11SpringBoot 3.x 用 JDK 17Maven 依賴下載失敗或下載慢網(wǎng)絡(luò)問題、鏡像未配置查看 IDEA 日志或 Maven 日志配置阿里云鏡像清理本地 .m2 倉庫啟動(dòng)后頁面打不開端口被占用或服務(wù)未啟動(dòng)檢查日志和端口占用更換端口或重啟服務(wù)數(shù)據(jù)庫連接失敗賬號(hào)密碼錯(cuò)誤、數(shù)據(jù)庫未創(chuàng)建檢查application.yml與 MySQL 狀態(tài)確認(rèn)數(shù)據(jù)庫已創(chuàng)建賬號(hào)密碼正確小程序請(qǐng)求接口失敗IP 或端口配置錯(cuò)誤查看小程序控制臺(tái) Network 面板將 baseUrl 改為本機(jī)實(shí)際 IP關(guān)閉防火墻小程序開發(fā)工具提示“不在以下 request 合法域名列表中”未配置合法域名或未勾選不校驗(yàn)檢查小程序后臺(tái)配置開發(fā)階段勾選“不校驗(yàn)合法域名”微信登錄后獲取不到用戶信息code2Session 請(qǐng)求失敗或 AppID 錯(cuò)誤查看后端日志中微信接口返回核對(duì) AppID、secret檢查 code 是否正確登錄提示“獲取登錄后的微信用戶失敗:wx1cb4398e1413dce7”或類似報(bào)錯(cuò)微信接口返回錯(cuò)誤碼AppID 不匹配或 code 已過期把微信返回的 errcode 和 errmsg 打出來根據(jù)錯(cuò)誤碼查詢微信官方文檔確認(rèn) code 只能使用一次地圖不顯示地圖 key 未配置或組件參數(shù)錯(cuò)誤查看小程序控制臺(tái)地圖組件報(bào)錯(cuò)確認(rèn)地圖 key 已申請(qǐng)并填入AI 接口返回超時(shí)大模型平臺(tái)響應(yīng)慢或后端超時(shí)時(shí)間太短用 curl 直接測(cè)試 AI 接口耗時(shí)增加超時(shí)時(shí)間使用異步調(diào)用頁面出現(xiàn) 401 未授權(quán)token 缺失或過期查看瀏覽器/小程序請(qǐng)求頭重新登錄獲取 token確保請(qǐng)求頭攜帶 token修改小程序代碼后頁面無變化未重新編譯或緩存點(diǎn)擊微信開發(fā)者工具“編譯”按鈕清除緩存后重新編譯批量測(cè)試 AI 時(shí)接口頻繁失敗觸發(fā)平臺(tái)限流查看響應(yīng)中的限流提示在測(cè)試腳本中增加 sleep 間隔降低并發(fā)8.1 關(guān)于“springboot版本太高”的細(xì)節(jié)在 SpringBoot 小程序的畢設(shè)項(xiàng)目里這個(gè)問題出現(xiàn)頻率極高。很多同學(xué)從網(wǎng)上下載項(xiàng)目后用 IDEA 最新版打開默認(rèn)使用 JDK 17 甚至 JDK 21而項(xiàng)目本身是 SpringBoot 2.3 或 2.7 寫的結(jié)果啟動(dòng)時(shí)報(bào)錯(cuò)。處理思路是先在pom.xml里看到parent中的版本號(hào)。如果版本號(hào)是2.x去 Project Structure 里把 Project SDK 改為 JDK 8 或 JDK 11。如果版本號(hào)是3.x再用 JDK 17 或更高版本運(yùn)行。不要“為了跑通而升級(jí) SpringBoot 版本”老項(xiàng)目升級(jí)到新版本可能引發(fā)更多兼容問題。8.2 微信小程序登錄與用戶信息獲取問題網(wǎng)絡(luò)熱詞里面反復(fù)出現(xiàn)“小程序獲取登錄后的微信用戶失敗”做畢設(shè)的時(shí)候遇到這類問題不要慌。微信官方對(duì)用戶信息的獲取限制越來越嚴(yán)格不能再像早期那樣直接拿wx.getUserInfo獲取頭像昵稱。現(xiàn)在的標(biāo)準(zhǔn)流程是用wx.login獲取code后端換取openid實(shí)現(xiàn)賬號(hào)體系。頭像昵稱使用button組件的open-typechooseAvatar和nickname輸入框來獲取。不要在小程序端直接調(diào)用wx.getUserProfile來存用戶信息這個(gè)接口已經(jīng)逐步收緊。如果你的項(xiàng)目里登錄報(bào)錯(cuò)把后端日志里微信接口返回的errcode和errmsg貼到微信官方文檔查詢通常能快速定位而不是到處猜原因。8.3 小程序跳轉(zhuǎn)與定位相關(guān)的問題如果項(xiàng)目里需要從一個(gè)校園小程序跳到另一個(gè)小程序需要在微信公眾平臺(tái)配置“跳轉(zhuǎn)小程序列表”并且目標(biāo)小程序的 AppID 要事先聲明。這和網(wǎng)絡(luò)熱詞中提到的“小程序a跳轉(zhuǎn)小程序b”場(chǎng)景一致。定位方面小程序可以通過wx.getLocation獲取經(jīng)緯度但要注意這個(gè)接口需要用戶授權(quán)并且在 app.json 中聲明requiredPrivateInfos。如果用 H5 頁面內(nèi)嵌在小程序里H5 調(diào)用定位會(huì)受限通常需要小程序原生頁面先拿到坐標(biāo)再傳給 web-view。9. 最佳實(shí)踐與使用建議9.1 先跑通再改代碼拿到源碼后第一輪的目標(biāo)是“復(fù)現(xiàn)”不是“改造”。按默認(rèn)配置把項(xiàng)目跑起來走一遍登錄、搜索、導(dǎo)航、記錄這些核心流程確認(rèn)每個(gè)模塊都能工作再思考要改進(jìn)哪個(gè)部分。很多同學(xué)一上來就改頁面樣式、加功能結(jié)果連環(huán)境都沒配好最后花了很多時(shí)間在“跑不起來”上。9.2 保留一套最小可運(yùn)行配置在你的項(xiàng)目目錄里建議保留一份application-example.yml把敏感信息用占位符代替server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/campus_navigation username: your_db_username password: your_db_password ai: api-key: your_api_key_here model-name: your_model_name這樣無論換電腦還是交給導(dǎo)師驗(yàn)收都能快速恢復(fù)環(huán)境不用每次憑記憶配配置。9.3 分目錄管理源碼、文檔和素材推薦按照下面的目錄結(jié)構(gòu)管理整個(gè)項(xiàng)目campus-navigation-graduation/ ├── code-backend/ # SpringBoot 后端源碼 ├── code-miniprogram/ # 微信小程序前端源碼 ├── sql/ # 數(shù)據(jù)庫初始化腳本 ├── docs/ │ ├── 開題報(bào)告.md │ ├── 論文大綱.md │ ├── 答辯PPT/ # PPT 源文件和導(dǎo)出文件 │ └── 演示錄制/ # 功能演示視頻 ├── assets/ │ ├── 圖片/ # 截圖、功能截圖 │ └── 測(cè)試數(shù)據(jù)/ # POI 批量導(dǎo)入數(shù)據(jù)、AI測(cè)試用例 └── README.md特別是 “AI 測(cè)試數(shù)據(jù)” 目錄里面的批量測(cè)試用例和結(jié)果記錄在寫論文“系統(tǒng)測(cè)試”章節(jié)時(shí)很好用。9.4 論文寫作與答辯建議論文里的系統(tǒng)設(shè)計(jì)部分要配三張核心圖系統(tǒng)架構(gòu)圖、功能模塊圖、數(shù)據(jù)庫ER圖。寫 AI 模塊時(shí)不要只說“調(diào)了某個(gè)大模型的接口”要把以下幾點(diǎn)寫清楚為什么選這個(gè)模型對(duì)比兩三個(gè)候選模型的優(yōu)缺點(diǎn)從響應(yīng)速度、中文能力、成本、數(shù)據(jù)隱私角度寫。提示詞怎么設(shè)計(jì)系統(tǒng)提示詞如何約束模型只回答校園相關(guān)問題如何區(qū)分地點(diǎn)意圖和問答意圖。異常怎么處理AI 接口超時(shí)怎么辦、返回結(jié)果不是預(yù)期格式怎么辦。效果怎么評(píng)估準(zhǔn)備測(cè)試集統(tǒng)計(jì)真實(shí)準(zhǔn)確率而不是只截圖一個(gè)成功的對(duì)話。這些內(nèi)容是論文的加分項(xiàng)也是答辯時(shí)展示你真正理解項(xiàng)目的證據(jù)。9.5 安全與合規(guī)使用建議不要把自己的大模型 API Key 提交到公開倉庫使用環(huán)境變量或配置中心管理。用戶手機(jī)號(hào)、真實(shí)姓名、學(xué)號(hào)等敏感信息要進(jìn)行加密存儲(chǔ)。畢設(shè)項(xiàng)目也要建立最小權(quán)限原則。AI 生成內(nèi)容必須包含免責(zé)提示僅作為校園信息參考不替代官方通知。如果使用真實(shí)校園地圖和建筑照片確認(rèn)來源和授權(quán)論文致謝或附錄中注明素材來源。10. 總結(jié)與下一步這個(gè)項(xiàng)目的核心價(jià)值不在導(dǎo)航算法有多深而在于完整展示了一個(gè)“傳統(tǒng)業(yè)務(wù)系統(tǒng) AI 能力”的典型融合方式。拿到源碼后最先要做的不是贊嘆代碼量而是按數(shù)據(jù)庫初始化、后端啟動(dòng)、小程序?qū)?、功能走查的順序把整條鏈路跑通。跑通之后把“AI 問路”這個(gè)模塊的測(cè)試數(shù)據(jù)整理出來它就是論文系統(tǒng)測(cè)試章節(jié)里最有說服力的素材。最容易踩的坑集中在三處SpringBoot 版本與 JDK 不匹配導(dǎo)致啟動(dòng)失敗、小程序登錄流程中 appid 與 code2Session 配置錯(cuò)誤、AI 接口的網(wǎng)絡(luò)調(diào)用超時(shí)。這三個(gè)問題預(yù)先排查能省下大量時(shí)間。如果時(shí)間充裕后續(xù)可以考慮往這幾個(gè)方向擴(kuò)展增加室內(nèi)導(dǎo)航和樓層定位把校園 POI 做成后臺(tái)管理系統(tǒng)可維護(hù)的版本加入導(dǎo)航足跡分析和常去地點(diǎn)推薦或者接入校園服務(wù)賬號(hào)的訂閱消息推送。這些方向都能成為論文的“不足與展望”也能讓項(xiàng)目在答辯時(shí)不止停留在演示層面。建議收藏備用按文中的驗(yàn)證流程走一遍再?zèng)Q定下一步怎么改。 SpringBoot+微信小程序+AI大模型智能校園導(dǎo)航系統(tǒng)畢設(shè)全解析
這次我們來看一個(gè)面向計(jì)算機(jī)畢業(yè)設(shè)計(jì)的完整全棧項(xiàng)目SpringBoot 微信小程序 AI大模型 智能校園導(dǎo)航系統(tǒng)。它不是單獨(dú)的小程序前端也不是只搭了個(gè)后端登錄接口的“空殼項(xiàng)目”而是把數(shù)據(jù)庫設(shè)計(jì)、后端接口、小程序頁面、AI 能力接入全部串起來的閉環(huán)系統(tǒng)配套還帶源碼、LW畢業(yè)設(shè)計(jì)論文文檔、PPT 和講解。先說怎么判斷這個(gè)項(xiàng)目適不適合你。如果你正在準(zhǔn)備計(jì)算機(jī)畢業(yè)設(shè)計(jì)技術(shù)棧需要覆蓋SpringBoot、微信小程序、AI大模型應(yīng)用又希望做出來的東西既實(shí)用又有“智能感”那這個(gè)題目基本是沖著這幾個(gè)關(guān)鍵詞去的。校園導(dǎo)航不是新概念但加入大模型語義解析之后用戶可以直接輸入“我想去圖書館”這樣的自然語言由后端調(diào)用大模型解析出具體目的地再配合校園地圖完成導(dǎo)航展示這就比傳統(tǒng)關(guān)鍵詞匹配的“菜鳥級(jí)導(dǎo)航”更有答辯亮點(diǎn)。本文不準(zhǔn)備只講“這個(gè)項(xiàng)目多好”而是按一套完整的本地部署與驗(yàn)證思路來拆核心能力、系統(tǒng)架構(gòu)、環(huán)境準(zhǔn)備、啟動(dòng)方式、功能測(cè)試、接口調(diào)用、AI 大模型集成方式、常見問題排查和最佳實(shí)踐?？赐昴憔湍芘袛鄡杉碌谝贿@個(gè)項(xiàng)目值不值得作為你的畢設(shè)選題第二拿到源碼之后該怎么把它跑起來并在答辯時(shí)有話可講。文章里所有命令和配置都是通用寫法實(shí)際路徑、端口、AppID 需要替換成你項(xiàng)目里的真實(shí)值。1. 核心能力速覽在動(dòng)手部署之前先把項(xiàng)目的技術(shù)畫像拉出來看一眼。下面這張表的內(nèi)容既是從項(xiàng)目標(biāo)題和常見畢設(shè)項(xiàng)目結(jié)構(gòu)推斷的能力邊界也是你驗(yàn)收源碼時(shí)必須逐項(xiàng)確認(rèn)的檢查點(diǎn)。能力項(xiàng)說明項(xiàng)目類型計(jì)算機(jī)畢業(yè)設(shè)計(jì)全棧項(xiàng)目后端 小程序端 AI能力接入后端框架SpringBoot按標(biāo)準(zhǔn) MVC 分層結(jié)構(gòu)組織前端框架微信小程序原生開發(fā)使用微信開發(fā)者工具編譯運(yùn)行AI 能力接入大模型接口實(shí)現(xiàn)自然語言目的地解析、校園問答等智能交互核心功能用戶登錄、校園地圖展示、POI 搜索、導(dǎo)航路徑規(guī)劃、AI 問路/問答數(shù)據(jù)庫MySQL涉及用戶表、地點(diǎn)信息表、導(dǎo)航記錄表等基礎(chǔ)表結(jié)構(gòu)配套材料源碼、LW論文文檔、PPT、講解視頻啟動(dòng)方式后端啟動(dòng) SpringBoot 應(yīng)用前端在微信開發(fā)者工具中導(dǎo)入項(xiàng)目是否支持 API后端天然提供 HTTP 接口供小程序端、管理端或第三方調(diào)用是否支持批量任務(wù)后端可擴(kuò)展批量導(dǎo)入校園 POI 數(shù)據(jù)AI 接口可按批量請(qǐng)求處理適合場(chǎng)景畢業(yè)設(shè)計(jì)選題、SpringBoot 小程序全棧入門、AI 應(yīng)用課程項(xiàng)目需要注意以上能力表的“來源”是項(xiàng)目標(biāo)題和常見的畢設(shè)項(xiàng)目組織方式。真正的源碼里具體實(shí)現(xiàn)了哪些接口、是否接入了真實(shí)的大模型廠商 API、地圖用的是 WebGL 還是靜態(tài)圖片都要以你拿到的項(xiàng)目文檔為準(zhǔn)。后面每個(gè)功能測(cè)試環(huán)節(jié)都要先回到源碼里確認(rèn)實(shí)現(xiàn)方式再動(dòng)手驗(yàn)證。2. 適用場(chǎng)景與使用邊界2.1 適合誰用這個(gè)項(xiàng)目最直接的受眾是計(jì)算機(jī)相關(guān)專業(yè)的大四學(xué)生尤其是選題方向偏向SpringBoot、微信小程序、AI大模型應(yīng)用開發(fā)的同學(xué)。它解決的核心問題不是“從零寫一個(gè)校園導(dǎo)航有多難”而是“怎么在有限的時(shí)間內(nèi)交付一個(gè)結(jié)構(gòu)完整、功能可演示、論文有內(nèi)容寫的系統(tǒng)”。如果你是下面這類讀者也值得拿這套項(xiàng)目當(dāng)作學(xué)習(xí)素材SpringBoot 初學(xué)者想找一個(gè)包含 Controller、Service、Mapper 分層結(jié)構(gòu)的完整后端項(xiàng)目而不是只做 CRUD 小 demo。微信小程序?qū)W習(xí)者想看看登錄流程、頁面跳轉(zhuǎn)、地圖組件、網(wǎng)絡(luò)請(qǐng)求在小程序里是怎么組織的。AI 應(yīng)用方向?qū)W生想了解大模型 API 如何被接入到傳統(tǒng)業(yè)務(wù)系統(tǒng)里而不是只能做聊天機(jī)器人。準(zhǔn)備畢設(shè)答辯的學(xué)生需要一套能講清楚“業(yè)務(wù)模塊 AI 創(chuàng)新點(diǎn) 數(shù)據(jù)庫設(shè)計(jì) 測(cè)試結(jié)果”的完整項(xiàng)目敘事。2.2 能解決什么問題傳統(tǒng)校園導(dǎo)航系統(tǒng)往往停留在“地圖展示 關(guān)鍵字匹配”的層面用戶輸入“圖書館”就搜地點(diǎn)輸入“我想自習(xí)”就無能為力。加入 AI 大模型后系統(tǒng)可以把自然語言轉(zhuǎn)換成結(jié)構(gòu)化查詢條件也能承擔(dān)一部分校園問答能力比如“校醫(yī)院幾點(diǎn)下班”“圖書館在哪棟樓”。這種“業(yè)務(wù)系統(tǒng) AI 能力”的組合正是當(dāng)前畢業(yè)設(shè)計(jì)評(píng)分時(shí)比較看重的亮點(diǎn)。從工程角度看完整的用戶——地點(diǎn)——導(dǎo)航記錄數(shù)據(jù)流也讓你在寫論文時(shí)有足夠的內(nèi)容需求分析、系統(tǒng)設(shè)計(jì)、數(shù)據(jù)庫表設(shè)計(jì)、接口設(shè)計(jì)、AI 模塊設(shè)計(jì)、系統(tǒng)測(cè)試每一章都有實(shí)際代碼和數(shù)據(jù)支撐不會(huì)出現(xiàn)“寫不出內(nèi)容只能湊字?jǐn)?shù)”的問題。2.3 使用邊界與合規(guī)提醒這里要單獨(dú)強(qiáng)調(diào)拿到任何畢設(shè)項(xiàng)目源碼后第一件事不是改代碼而是確認(rèn)使用邊界。不要照抄提交部分高校對(duì)畢業(yè)設(shè)計(jì)有查重和代碼相似度檢測(cè)。參考源碼學(xué)習(xí)結(jié)構(gòu)、理解實(shí)現(xiàn)邏輯沒問題但直接替換個(gè)人信息提交可能會(huì)被判定學(xué)術(shù)不端。最好在理解的基礎(chǔ)上重構(gòu)部分模塊并補(bǔ)充自己的功能設(shè)計(jì)。AI 接口需要授權(quán)項(xiàng)目里接大模型 API通常意味著你需要在某個(gè)平臺(tái)上申請(qǐng) API Key。不同平臺(tái)的計(jì)費(fèi)方式、數(shù)據(jù)隱私政策、調(diào)用頻率限制都不一樣論文里要寫清楚你用的是哪個(gè)平臺(tái)、什么模型、為什么選它。地圖數(shù)據(jù)有版權(quán)校園地圖、POI 坐標(biāo)、建筑圖片這些素材如果來自第三方要注意授權(quán)邊界。涉及個(gè)人信息的用戶數(shù)據(jù)在做演示時(shí)不要使用真實(shí)同學(xué)的大量敏感數(shù)據(jù)。小程序發(fā)布需合規(guī)個(gè)人主體的小程序和涉及地圖、定位、用戶信息的功能在微信公眾平臺(tái)審核時(shí)有額外要求。畢業(yè)設(shè)計(jì)階段用開發(fā)者工具和測(cè)試號(hào)即可不需要真的發(fā)布上線。3. 環(huán)境準(zhǔn)備與前置條件這套項(xiàng)目跑起來的環(huán)境不算復(fù)雜和大多數(shù)SpringBoot 小程序項(xiàng)目的部署方式一致。下面按后端、前端、數(shù)據(jù)庫三部分列出一份通用環(huán)境檢查清單。3.1 后端環(huán)境組件推薦版本說明JDK1.8 或 11具體以pom.xml中的java.version為準(zhǔn)Maven3.6 以上用于拉取項(xiàng)目和打包IDEIDEA 或 Eclipse建議直接使用 IDEA識(shí)別 SpringBoot 項(xiàng)目更順手MySQL5.7 或 8.0需要手動(dòng)創(chuàng)建數(shù)據(jù)庫并導(dǎo)入 SQL 文件Navicat / Workbench任意用于查看數(shù)據(jù)庫表結(jié)構(gòu)和初始化數(shù)據(jù)當(dāng)你拿到源碼后第一步是打開pom.xml確認(rèn)三件事spring-boot-starter-parent的版本號(hào)是 2.7.x 還是 3.x。java.version是多少Java 8 還是 17。依賴?yán)镉袥]有 MyBatis、MyBatis-Plus、MySQL 驅(qū)動(dòng)、Redis、AI SDK 等。這里特別提醒網(wǎng)上很多同學(xué)遇到“springboot版本太高”導(dǎo)致項(xiàng)目啟動(dòng)失敗的問題。原因通常是SpringBoot 3.x 要求 JDK 17 以上而本機(jī)裝的是 JDK 8或者反過來項(xiàng)目是 SpringBoot 2.7 編譯的你用 JDK 17 運(yùn)行低版本項(xiàng)目也會(huì)出現(xiàn)兼容告警。最穩(wěn)妥的方式是嚴(yán)格按照項(xiàng)目文檔里的 JDK 版本配置環(huán)境。3.2 微信小程序前端環(huán)境組件說明微信開發(fā)者工具穩(wěn)定版即可導(dǎo)入項(xiàng)目時(shí)選擇小程序項(xiàng)目AppID使用測(cè)試號(hào)或自己的小程序 AppID手機(jī)或模擬器用于驗(yàn)證頁面渲染、定位、地圖交互小程序端的技術(shù)棧通常就是微信原生語法WXML、WXSS、JS、JSON 配置。不需要額外安裝 npm 依賴除非項(xiàng)目里使用了Vant Weapp之類的 UI 組件庫。如果用了組件庫需要在app.json里做組件路徑配置并且miniprogram_npm目錄要存在。3.3 數(shù)據(jù)庫環(huán)境項(xiàng)目的.sql文件一般會(huì)放在sql/或db/目錄下。你需要?jiǎng)?chuàng)建一個(gè)數(shù)據(jù)庫字符集選擇utf8mb4。導(dǎo)入 SQL 文件生成用戶表、地點(diǎn)表、導(dǎo)航記錄表等。在application.yml里修改數(shù)據(jù)庫地址、賬號(hào)、密碼。下面是一個(gè)通用的application.yml配置模板實(shí)際字段以項(xiàng)目為準(zhǔn)server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://127.0.0.1:3306/campus_navigation?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 123456 mybatis-plus: mapper-locations: classpath*:mapper/**/*.xml configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl如果你的項(xiàng)目里還接了 Redis 或大模型 API配置里會(huì)出現(xiàn)spring.redis和自定義的ai.api-key、ai.model-name等字段。這些都需要按源碼中的application-example.yml或說明文檔來填。3.4 硬件要求這里不是圖像生成項(xiàng)目不存在“顯存不夠就跑不了”的問題。后端 SpringBoot 應(yīng)用對(duì)內(nèi)存的常規(guī)要求在 512MB 到 2GB 之間開發(fā)機(jī)基本都能滿足。唯一需要留意的是如果你在本地啟動(dòng)多個(gè)大型 IDE、MySQL、微信開發(fā)者工具內(nèi)存 8GB 的機(jī)器會(huì)比較吃力建議先關(guān)掉無關(guān)應(yīng)用再啟動(dòng)。4. 安裝部署與啟動(dòng)方式拿到源碼后推薦按照“數(shù)據(jù)庫 - 后端 - 小程序前端”的順序啟動(dòng)。這樣小程序調(diào)用后端接口時(shí)服務(wù)已經(jīng)在運(yùn)行可以直接看到效果。4.1 初始化數(shù)據(jù)庫# 登錄 MySQL mysql -u root -p # 創(chuàng)建數(shù)據(jù)庫 CREATE DATABASE IF NOT EXISTS campus_navigation DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; # 使用數(shù)據(jù)庫 USE campus_navigation; # 導(dǎo)入 SQL 文件路徑按實(shí)際存放位置調(diào)整 SOURCE D:/project/campus_navigation/sql/campus_navigation.sql;導(dǎo)入成功后執(zhí)行SHOW TABLES;你應(yīng)該能看到類似下面的表user campus_building campus_poi navigation_record ai_chat_record表名和字段名可能不同但基本的業(yè)務(wù)表結(jié)構(gòu)應(yīng)該覆蓋用戶、地點(diǎn)、導(dǎo)航記錄和 AI 交互記錄這幾類。4.2 啟動(dòng) SpringBoot 后端用 IDEA 打開后端項(xiàng)目后等待 Maven 下載依賴。這里有幾個(gè)容易卡住的地方Maven 依賴下載慢建議配置阿里云鏡像。依賴下載失敗檢查本地 Maven 倉庫權(quán)限。Lombok 版本與 JDK 不兼容會(huì)見到編譯錯(cuò)誤。依賴下載完成后修改application.yml里的數(shù)據(jù)庫賬號(hào)密碼和 AI 接口配置然后運(yùn)行啟動(dòng)類。項(xiàng)目根目錄 ├── src/main/java │ └── com/example/campusnav/CampusNavApplication.java ├── src/main/resources │ ├── application.yml │ └── mapper/*.xml └── pom.xml在 IDEA 中右鍵運(yùn)行CampusNavApplication看到類似下面的日志說明啟動(dòng)成功Tomcat started on port(s): 8080 (http) with context path Started CampusNavApplication in 5.2 seconds如果你習(xí)慣用命令行啟動(dòng)也可以先用 Maven 打包mvn clean package -DskipTests java -jar target/campus-nav-0.0.1-SNAPSHOT.jar啟動(dòng)后用瀏覽器訪問http://127.0.0.1:8080或者訪問項(xiàng)目配置的 Swagger 文檔地址如果有確認(rèn)后端接口可以訪問。4.3 導(dǎo)入微信小程序打開微信開發(fā)者工具點(diǎn)擊“導(dǎo)入項(xiàng)目”選擇小程序前端目錄。需要確認(rèn)的配置配置項(xiàng)操作AppID使用測(cè)試號(hào)或填寫你自己的 AppID后端接口地址在utils/request.js或app.js中修改 baseUrl 為http://127.0.0.1:8080不校驗(yàn)合法域名開發(fā)階段勾選“不校驗(yàn)合法域名、web-view業(yè)務(wù)域名、TLS 版本以及 HTTPS 證書”如果你在小程序里自定義了登錄彈窗或頂部導(dǎo)航欄還需要檢查app.json里的navigationStyle配置。導(dǎo)入成功后點(diǎn)擊模擬器頁面的“編譯”按鈕。小程序會(huì)向本機(jī)后端發(fā)起請(qǐng)求如果能正常拉取校園地點(diǎn)列表說明前后端已經(jīng)連通。5. 功能測(cè)試與效果驗(yàn)證項(xiàng)目跑起來之后不要急著截圖寫論文。先按下面的功能矩陣做一遍完整的驗(yàn)證確認(rèn)每個(gè)模塊都符合預(yù)期再考慮改代碼、加功能。5.1 用戶登錄與微信授權(quán)測(cè)試目的確認(rèn)小程序可以完成微信登錄流程后端能拿到用戶身份并創(chuàng)建用戶記錄。操作步驟在微信開發(fā)者工具中打開小程序。點(diǎn)擊“登錄”或“授權(quán)登錄”按鈕。觀察后端控制臺(tái)是否收到登錄請(qǐng)求。查看數(shù)據(jù)庫user表是否新增或更新了用戶記錄。預(yù)期結(jié)果登錄成功后小程序端保存用戶 token后續(xù)請(qǐng)求攜帶用戶身份。后端日志能看到用戶 openid 或 unionid 的存取過程。判斷標(biāo)準(zhǔn)退出小程序重新進(jìn)入登錄態(tài)仍然保持不需要每次都重復(fù)授權(quán)。常見失敗原因AppID配置錯(cuò)誤、后端接口地址不對(duì)、code2Session請(qǐng)求的 appid 與 secret 與項(xiàng)目不匹配。5.2 校園地圖與 POI 展示測(cè)試目的確認(rèn)地圖組件能正常顯示校園建筑和 POI 點(diǎn)位坐標(biāo)正確。操作步驟進(jìn)入小程序首頁或地圖頁面。檢查地圖是否渲染出校園范圍。點(diǎn)擊地圖上的標(biāo)記點(diǎn)查看地點(diǎn)名稱、介紹、開放時(shí)間等信息。對(duì)比地圖坐標(biāo)與實(shí)際校園位置是否一致。預(yù)期結(jié)果頁面能展示地圖標(biāo)記點(diǎn)點(diǎn)擊后有信息浮層POI 數(shù)據(jù)來自后端接口而不是寫死在小程序代碼里。判斷標(biāo)準(zhǔn)新增或修改一條 POI 數(shù)據(jù)后小程序端刷新頁面能看到變化。常見失敗原因地圖 key 未配置、坐標(biāo)系統(tǒng)不一致GCJ-02 與 WGS-84 需轉(zhuǎn)換、地圖插件在小程序后臺(tái)未添加。5.3 智能搜索與 AI 問路這是整個(gè)項(xiàng)目的核心亮點(diǎn)模塊也是答辯時(shí)最值得講的功能。測(cè)試目的驗(yàn)證大模型是否能把自然語言轉(zhuǎn)換成具體的導(dǎo)航目的地或問答結(jié)果。操作示例輸入文本期望行為“我想去圖書館”系統(tǒng)解析出目的地是“圖書館”并展示對(duì)應(yīng) POI 和導(dǎo)航按鈕“校醫(yī)院在哪”系統(tǒng)返回校醫(yī)院位置和路徑信息“今天要去交材料應(yīng)該去哪個(gè)部門”大模型根據(jù)校園知識(shí)庫給出建議可能觸發(fā)多輪對(duì)話“你好”系統(tǒng)返回歡迎語不觸發(fā)導(dǎo)航意圖操作步驟在搜索框輸入自然語言。點(diǎn)擊搜索或發(fā)送按鈕。查看返回結(jié)果是直接定位到 POI還是進(jìn)入 AI 對(duì)話。點(diǎn)擊“開始導(dǎo)航”確認(rèn)路徑規(guī)劃可以正常展示。預(yù)期結(jié)果大模型能正確識(shí)別“地點(diǎn)意圖”和“問答意圖”。地點(diǎn)意圖返回結(jié)構(gòu)化地址問答意圖返回文本答案。判斷標(biāo)準(zhǔn)連續(xù)測(cè)試 10 條以上不同表達(dá)方式的語句比如“我要去圖書館”“圖書館怎么走”“哪里能借書”至少 7 條以上被正確處理說明 AI 模塊整體可用。常見失敗原因大模型 API Key 失效、提示詞工程配置錯(cuò)誤、后端返回超時(shí)、小程序端沒有設(shè)置較長的請(qǐng)求超時(shí)時(shí)間。這里給出一個(gè)后端 AI 接口調(diào)用的通用示例實(shí)際項(xiàng)目里會(huì)根據(jù)你所接入的大模型平臺(tái)調(diào)整// 通用大模型調(diào)用示例具體依賴和類名以項(xiàng)目為準(zhǔn) public String chatWithAI(String userMessage) { String apiKey config.getApiKey(); String url config.getApiUrl(); MapString, Object requestBody new HashMap(); requestBody.put(model, config.getModelName()); requestBody.put(messages, List.of( Map.of(role, system, content, 你是一個(gè)校園導(dǎo)航助手只能回答與校園相關(guān)的問題), Map.of(role, user, content, userMessage) )); // 使用 HttpURLConnection 或 Spring RestTemplate 發(fā)起請(qǐng)求 RestTemplate restTemplate new RestTemplate(); HttpHeaders headers new HttpHeaders(); headers.setContentType(MediaType.APPLICATION_JSON); headers.setBearerAuth(apiKey); HttpEntityMapString, Object entity new HttpEntity(requestBody, headers); ResponseEntityMap response restTemplate.postForEntity(url, entity, Map.class); // 從響應(yīng)中提取生成文本字段名以平臺(tái)返回為準(zhǔn) return response.getBody().get(choices).toString(); }5.4 導(dǎo)航路徑規(guī)劃測(cè)試目的確認(rèn)選中目的地后能調(diào)用地圖路徑規(guī)劃能力并展示路線。操作步驟在 POI 詳情頁點(diǎn)擊“導(dǎo)航”或“到這里去”。進(jìn)入導(dǎo)航頁面查看起終點(diǎn)是否正確。觀察路線繪制步行路線、距離、時(shí)間是否顯示。在小程序模擬器切換不同定位點(diǎn)確認(rèn)路線會(huì)跟著變化。預(yù)期結(jié)果地圖上出現(xiàn)從當(dāng)前位置到目的地的路線折線伴隨距離和預(yù)計(jì)步行時(shí)間。判斷標(biāo)準(zhǔn)不同起終點(diǎn)組合下路線都能正常規(guī)劃。常見失敗原因地圖 SDK 路徑規(guī)劃接口需要額外開通、起點(diǎn)坐標(biāo)默認(rèn)為 0定位失敗、模擬器不支持定位需要手動(dòng)選點(diǎn)。5.5 導(dǎo)航記錄與歷史管理測(cè)試目的確認(rèn)用戶的歷史導(dǎo)航記錄能保存、查詢、刪除。操作步驟完成一次導(dǎo)航后到“記錄”或“我的”頁面查看。確認(rèn)導(dǎo)航記錄包含起終點(diǎn)、時(shí)間、狀態(tài)。刪除一條記錄刷新頁面后確認(rèn)已刪除。預(yù)期結(jié)果導(dǎo)航記錄與當(dāng)前登錄用戶綁定不同用戶看不到彼此記錄。判斷標(biāo)準(zhǔn)數(shù)據(jù)庫navigation_record表有新數(shù)據(jù)寫入且字段完整。常見失敗原因請(qǐng)求頭未攜帶用戶 token后端無法識(shí)別當(dāng)前用戶導(dǎo)致查詢?yōu)榭铡?.6 后端接口文檔測(cè)試如果項(xiàng)目集成了 Swagger 或 Knife4j可以像下面這樣直接請(qǐng)求接口驗(yàn)證數(shù)據(jù)流。# 請(qǐng)求校園地點(diǎn)列表接口地址以實(shí)際項(xiàng)目為準(zhǔn) curl -X GET http://127.0.0.1:8080/api/poi/list \ -H Content-Type: application/json# 請(qǐng)求 AI 對(duì)話接口 curl -X POST http://127.0.0.1:8080/api/ai/chat \ -H Content-Type: application/json \ -d {message: 我想去圖書館}測(cè)試時(shí)重點(diǎn)看三塊接口是否能正常返回HTTP 狀態(tài)碼是 200 還是 500。返回 JSON 結(jié)構(gòu)是否與小程序端解析邏輯一致。輸入特殊字符、超長文本時(shí)接口是否穩(wěn)定。6. 接口 API 與批量任務(wù)畢設(shè)項(xiàng)目里接口 API 的設(shè)計(jì)質(zhì)量直接影響論文的“系統(tǒng)設(shè)計(jì)”部分。一個(gè)合格的 SpringBoot 小程序項(xiàng)目接口通常按下面的風(fēng)格組織。模塊接口路徑方法說明用戶/api/user/loginPOST用戶登錄/注冊(cè)用戶/api/user/infoGET獲取用戶信息地點(diǎn)/api/poi/listGET地點(diǎn)列表分頁/關(guān)鍵字地點(diǎn)/api/poi/detail/{id}GET地點(diǎn)詳情導(dǎo)航/api/navigation/planPOST路徑規(guī)劃導(dǎo)航/api/navigation/recordGET/POST/DELETE導(dǎo)航記錄管理AI/api/ai/chatPOSTAI 對(duì)話/意圖識(shí)別實(shí)際接口路徑和參數(shù)要以源碼為準(zhǔn)上面的表格只作為組織接口文檔時(shí)的參考模板。6.1 小程序端的 HTTP 請(qǐng)求方式小程序端一般會(huì)在utils/request.js中封裝一個(gè)帶 token 的請(qǐng)求方法const request (url, method GET, data {}) { return new Promise((resolve, reject) { wx.request({ url: getApp().globalData.baseUrl url, method: method, data: data, header: { Content-Type: application/json, Authorization: wx.getStorageSync(token) }, success: (res) { if (res.statusCode 200) { resolve(res.data); } else if (res.statusCode 401) { wx.navigateTo({ url: /pages/login/login }); } else { reject(res.data); } }, fail: (err) reject(err) }); }); }; module.exports { request };在頁面里調(diào)用時(shí)就比較清爽const { request } require(../../utils/request); Page({ data: { poiList: [] }, onLoad() { this.loadPoiList(); }, async loadPoiList() { const res await request(/api/poi/list, GET); this.setData({ poiList: res.data }); } });6.2 微信登錄流程微信登錄是這類項(xiàng)目繞不開的核心流程也是答辯時(shí)老師很愛問的點(diǎn)。![流程圖說明小程序端 wx.login 獲取 code - 傳給后端 - 后端調(diào)用微信 code2Session 接口 - 返回 openid 和 session_key - 后端生成自定義 token 返回給小程序]需要注意的是這里不能用 mermaid就直接用文字流程說明小程序端調(diào)用wx.login拿到臨時(shí)code。小程序把code發(fā)送給自己的后端/api/user/login。后端用appid secret code請(qǐng)求微信接口code2Session。微信返回openid、session_key。后端根據(jù)openid查找或創(chuàng)建用戶生成自定義登錄 token。后端把 token 返回給小程序小程序存入本地存儲(chǔ)。后端核心偽代碼如下RestController RequestMapping(/api/user) public class UserController { PostMapping(/login) public Result login(RequestBody LoginRequest request) { // 1. 用 code 請(qǐng)求微信 code2Session String url https://api.weixin.qq.com/sns/jscode2session? appid appid secret secret js_code request.getCode() grant_typeauthorization_code; // 2. 發(fā)起 HTTP 請(qǐng)求解析 openid // 3. 查詢用戶如果不存在則注冊(cè) // 4. 生成 token 并返回 return Result.success(token); } }很多同學(xué)在開發(fā)時(shí)遇到“小程序獲取登錄后的微信用戶失敗”的問題常見原因包括后端code2Session請(qǐng)求失敗檢查appid和secret是否匹配。小程序端沒有把code傳到后端只傳了用戶頭像。后端返回的 openid 字段名和數(shù)據(jù)庫字段對(duì)不上。請(qǐng)求被攔截需要確認(rèn)小程序后臺(tái)的 request 合法域名配置。6.3 批量任務(wù)與數(shù)據(jù)管理畢設(shè)項(xiàng)目里“批量任務(wù)”的概念不像工業(yè)級(jí)系統(tǒng)那么重但有兩個(gè)場(chǎng)景值得做批量導(dǎo)入校園 POI 數(shù)據(jù)提供一個(gè)管理員接口接收 Excel 或 JSON 批量寫入建筑和地點(diǎn)信息避免手動(dòng)一條條插入數(shù)據(jù)庫。批量測(cè)試 AI 意圖識(shí)別準(zhǔn)備一組測(cè)試用例比如 20 條不同表述的“去圖書館”問法循環(huán)調(diào)用 AI 接口統(tǒng)計(jì)識(shí)別正確率。這個(gè)數(shù)據(jù)可以直接放進(jìn)論文的系統(tǒng)測(cè)試章節(jié)。批量測(cè)試的 Python 示例import requests import time import json # 替換成你的后端地址和測(cè)試用例 api_url http://127.0.0.1:8080/api/ai/chat test_cases [ 我想去圖書館, 圖書館怎么走, 去哪里可以借書, 我要還書應(yīng)該到哪個(gè)樓, 圖書館幾點(diǎn)關(guān)門 ] results [] for case in test_cases: try: response requests.post(api_url, json{message: case}, timeout30) data response.json() results.append({input: case, output: data}) print(f[OK] {case} - {data}) except Exception as e: results.append({input: case, error: str(e)}) print(f[FAIL] {case} - {e}) time.sleep(0.5) # 避免觸發(fā)接口限流 with open(ai_test_results.json, w, encodingutf-8) as f: json.dump(results, f, ensure_asciiFalse, indent2)批量任務(wù)的關(guān)鍵是“可觀測(cè)”。每個(gè)測(cè)試用例都要記錄輸入、輸出、耗時(shí)、是否成功這樣出了問題才能定位是 AI 模型理解不準(zhǔn)還是接口超時(shí)還是提示詞沒寫好。7. 資源占用與性能觀察雖然這不是大模型本地部署項(xiàng)目AI 能力是通過 HTTP 接口調(diào)用的不會(huì)占很大的顯存或內(nèi)存但性能觀察同樣重要。畢設(shè)答辯時(shí)如果老師問“你這個(gè)系統(tǒng)性能怎么樣”“接口慢不慢”你不能只說“挺快的”要用數(shù)據(jù)說話。7.1 后端內(nèi)存與 CPUSpringBoot 應(yīng)用啟動(dòng)后的內(nèi)存占用通常在 300MB 到 1GB 之間?？梢赃@樣觀察# Windows 上查看進(jìn)程內(nèi)存 jps -l # 查看指定進(jìn)程狀態(tài) jinfo pid實(shí)際體驗(yàn)上IDEA 里跑 SpringBoot 不會(huì)像啟動(dòng)大型機(jī)器學(xué)習(xí)任務(wù)那樣吃緊8GB 內(nèi)存的筆記本電腦完全夠用。7.2 AI 接口的響應(yīng)時(shí)間這是整個(gè)系統(tǒng)里最影響體驗(yàn)的性能瓶頸。普通數(shù)據(jù)庫查詢接口可能在 50ms 到 200ms但大模型接口的響應(yīng)時(shí)間通常會(huì)在 1 秒到 5 秒取決于你使用的是哪家平臺(tái)、什么型號(hào)的模型、輸入文本長度。如果響應(yīng)超過 10 秒小程序端用戶就會(huì)感覺到明顯的卡頓。優(yōu)化建議在小程序端把 AI 請(qǐng)求的超時(shí)時(shí)間調(diào)到 15 秒以上避免請(qǐng)求被提前中斷。后端使用異步處理不阻塞主請(qǐng)求線程。如果同一句問話頻繁出現(xiàn)可以做簡單的本地緩存命中緩存就不再調(diào)用 AI 接口。在提示詞里限制輸出長度減少 tokens 消耗和響應(yīng)時(shí)間。7.3 數(shù)據(jù)庫連接與連接池如果項(xiàng)目使用 MyBatis-Plus默認(rèn)連接池是 HikariCP。觀察數(shù)據(jù)庫連接池是否正?？梢栽赼pplication.yml中臨時(shí)打開 SQL 日志logging: level: com.example.campusnav.mapper: debug這樣每次 SQL 操作都會(huì)在控制臺(tái)打印方便確認(rèn)接口慢是不是因?yàn)?SQL 查詢問題比如缺少索引、全表掃描、N1 查詢。7.4 小程序端性能小程序端的性能觀察點(diǎn)包括地圖頁面是否卡頓連續(xù)拖動(dòng)地圖時(shí)幀率如何。頁面 onLoad 的數(shù)據(jù)請(qǐng)求是否在頁面渲染前完成。圖片資源是否過大影響加載速度。是否合理使用wx.setStorageSync做本地緩存而不是每次打開頁面都請(qǐng)求后端。8. 常見問題與排查方法下面是這套項(xiàng)目從部署到運(yùn)行最常遇到的問題按照“問題現(xiàn)象 - 可能原因 - 排查方式 - 解決方案”的順序整理。問題現(xiàn)象可能原因排查方式解決方案后端啟動(dòng)報(bào)“springboot版本太高”或版本不兼容JDK 版本與 SpringBoot 版本不匹配查看pom.xml中 java.version 和 spring-boot 版本SpringBoot 2.x 用 JDK 8/11SpringBoot 3.x 用 JDK 17Maven 依賴下載失敗或下載慢網(wǎng)絡(luò)問題、鏡像未配置查看 IDEA 日志或 Maven 日志配置阿里云鏡像清理本地 .m2 倉庫啟動(dòng)后頁面打不開端口被占用或服務(wù)未啟動(dòng)檢查日志和端口占用更換端口或重啟服務(wù)數(shù)據(jù)庫連接失敗賬號(hào)密碼錯(cuò)誤、數(shù)據(jù)庫未創(chuàng)建檢查application.yml與 MySQL 狀態(tài)確認(rèn)數(shù)據(jù)庫已創(chuàng)建賬號(hào)密碼正確小程序請(qǐng)求接口失敗IP 或端口配置錯(cuò)誤查看小程序控制臺(tái) Network 面板將 baseUrl 改為本機(jī)實(shí)際 IP關(guān)閉防火墻小程序開發(fā)工具提示“不在以下 request 合法域名列表中”未配置合法域名或未勾選不校驗(yàn)檢查小程序后臺(tái)配置開發(fā)階段勾選“不校驗(yàn)合法域名”微信登錄后獲取不到用戶信息code2Session 請(qǐng)求失敗或 AppID 錯(cuò)誤查看后端日志中微信接口返回核對(duì) AppID、secret檢查 code 是否正確登錄提示“獲取登錄后的微信用戶失敗:wx1cb4398e1413dce7”或類似報(bào)錯(cuò)微信接口返回錯(cuò)誤碼AppID 不匹配或 code 已過期把微信返回的 errcode 和 errmsg 打出來根據(jù)錯(cuò)誤碼查詢微信官方文檔確認(rèn) code 只能使用一次地圖不顯示地圖 key 未配置或組件參數(shù)錯(cuò)誤查看小程序控制臺(tái)地圖組件報(bào)錯(cuò)確認(rèn)地圖 key 已申請(qǐng)并填入AI 接口返回超時(shí)大模型平臺(tái)響應(yīng)慢或后端超時(shí)時(shí)間太短用 curl 直接測(cè)試 AI 接口耗時(shí)增加超時(shí)時(shí)間使用異步調(diào)用頁面出現(xiàn) 401 未授權(quán)token 缺失或過期查看瀏覽器/小程序請(qǐng)求頭重新登錄獲取 token確保請(qǐng)求頭攜帶 token修改小程序代碼后頁面無變化未重新編譯或緩存點(diǎn)擊微信開發(fā)者工具“編譯”按鈕清除緩存后重新編譯批量測(cè)試 AI 時(shí)接口頻繁失敗觸發(fā)平臺(tái)限流查看響應(yīng)中的限流提示在測(cè)試腳本中增加 sleep 間隔降低并發(fā)8.1 關(guān)于“springboot版本太高”的細(xì)節(jié)在 SpringBoot 小程序的畢設(shè)項(xiàng)目里這個(gè)問題出現(xiàn)頻率極高。很多同學(xué)從網(wǎng)上下載項(xiàng)目后用 IDEA 最新版打開默認(rèn)使用 JDK 17 甚至 JDK 21而項(xiàng)目本身是 SpringBoot 2.3 或 2.7 寫的結(jié)果啟動(dòng)時(shí)報(bào)錯(cuò)。處理思路是先在pom.xml里看到parent中的版本號(hào)。如果版本號(hào)是2.x去 Project Structure 里把 Project SDK 改為 JDK 8 或 JDK 11。如果版本號(hào)是3.x再用 JDK 17 或更高版本運(yùn)行。不要“為了跑通而升級(jí) SpringBoot 版本”老項(xiàng)目升級(jí)到新版本可能引發(fā)更多兼容問題。8.2 微信小程序登錄與用戶信息獲取問題網(wǎng)絡(luò)熱詞里面反復(fù)出現(xiàn)“小程序獲取登錄后的微信用戶失敗”做畢設(shè)的時(shí)候遇到這類問題不要慌。微信官方對(duì)用戶信息的獲取限制越來越嚴(yán)格不能再像早期那樣直接拿wx.getUserInfo獲取頭像昵稱。現(xiàn)在的標(biāo)準(zhǔn)流程是用wx.login獲取code后端換取openid實(shí)現(xiàn)賬號(hào)體系。頭像昵稱使用button組件的open-typechooseAvatar和nickname輸入框來獲取。不要在小程序端直接調(diào)用wx.getUserProfile來存用戶信息這個(gè)接口已經(jīng)逐步收緊。如果你的項(xiàng)目里登錄報(bào)錯(cuò)把后端日志里微信接口返回的errcode和errmsg貼到微信官方文檔查詢通常能快速定位而不是到處猜原因。8.3 小程序跳轉(zhuǎn)與定位相關(guān)的問題如果項(xiàng)目里需要從一個(gè)校園小程序跳到另一個(gè)小程序需要在微信公眾平臺(tái)配置“跳轉(zhuǎn)小程序列表”并且目標(biāo)小程序的 AppID 要事先聲明。這和網(wǎng)絡(luò)熱詞中提到的“小程序a跳轉(zhuǎn)小程序b”場(chǎng)景一致。定位方面小程序可以通過wx.getLocation獲取經(jīng)緯度但要注意這個(gè)接口需要用戶授權(quán)并且在 app.json 中聲明requiredPrivateInfos。如果用 H5 頁面內(nèi)嵌在小程序里H5 調(diào)用定位會(huì)受限通常需要小程序原生頁面先拿到坐標(biāo)再傳給 web-view。9. 最佳實(shí)踐與使用建議9.1 先跑通再改代碼拿到源碼后第一輪的目標(biāo)是“復(fù)現(xiàn)”不是“改造”。按默認(rèn)配置把項(xiàng)目跑起來走一遍登錄、搜索、導(dǎo)航、記錄這些核心流程確認(rèn)每個(gè)模塊都能工作再思考要改進(jìn)哪個(gè)部分。很多同學(xué)一上來就改頁面樣式、加功能結(jié)果連環(huán)境都沒配好最后花了很多時(shí)間在“跑不起來”上。9.2 保留一套最小可運(yùn)行配置在你的項(xiàng)目目錄里建議保留一份application-example.yml把敏感信息用占位符代替server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/campus_navigation username: your_db_username password: your_db_password ai: api-key: your_api_key_here model-name: your_model_name這樣無論換電腦還是交給導(dǎo)師驗(yàn)收都能快速恢復(fù)環(huán)境不用每次憑記憶配配置。9.3 分目錄管理源碼、文檔和素材推薦按照下面的目錄結(jié)構(gòu)管理整個(gè)項(xiàng)目campus-navigation-graduation/ ├── code-backend/ # SpringBoot 后端源碼 ├── code-miniprogram/ # 微信小程序前端源碼 ├── sql/ # 數(shù)據(jù)庫初始化腳本 ├── docs/ │ ├── 開題報(bào)告.md │ ├── 論文大綱.md │ ├── 答辯PPT/ # PPT 源文件和導(dǎo)出文件 │ └── 演示錄制/ # 功能演示視頻 ├── assets/ │ ├── 圖片/ # 截圖、功能截圖 │ └── 測(cè)試數(shù)據(jù)/ # POI 批量導(dǎo)入數(shù)據(jù)、AI測(cè)試用例 └── README.md特別是 “AI 測(cè)試數(shù)據(jù)” 目錄里面的批量測(cè)試用例和結(jié)果記錄在寫論文“系統(tǒng)測(cè)試”章節(jié)時(shí)很好用。9.4 論文寫作與答辯建議論文里的系統(tǒng)設(shè)計(jì)部分要配三張核心圖系統(tǒng)架構(gòu)圖、功能模塊圖、數(shù)據(jù)庫ER圖。寫 AI 模塊時(shí)不要只說“調(diào)了某個(gè)大模型的接口”要把以下幾點(diǎn)寫清楚為什么選這個(gè)模型對(duì)比兩三個(gè)候選模型的優(yōu)缺點(diǎn)從響應(yīng)速度、中文能力、成本、數(shù)據(jù)隱私角度寫。提示詞怎么設(shè)計(jì)系統(tǒng)提示詞如何約束模型只回答校園相關(guān)問題如何區(qū)分地點(diǎn)意圖和問答意圖。異常怎么處理AI 接口超時(shí)怎么辦、返回結(jié)果不是預(yù)期格式怎么辦。效果怎么評(píng)估準(zhǔn)備測(cè)試集統(tǒng)計(jì)真實(shí)準(zhǔn)確率而不是只截圖一個(gè)成功的對(duì)話。這些內(nèi)容是論文的加分項(xiàng)也是答辯時(shí)展示你真正理解項(xiàng)目的證據(jù)。9.5 安全與合規(guī)使用建議不要把自己的大模型 API Key 提交到公開倉庫使用環(huán)境變量或配置中心管理。用戶手機(jī)號(hào)、真實(shí)姓名、學(xué)號(hào)等敏感信息要進(jìn)行加密存儲(chǔ)。畢設(shè)項(xiàng)目也要建立最小權(quán)限原則。AI 生成內(nèi)容必須包含免責(zé)提示僅作為校園信息參考不替代官方通知。如果使用真實(shí)校園地圖和建筑照片確認(rèn)來源和授權(quán)論文致謝或附錄中注明素材來源。10. 總結(jié)與下一步這個(gè)項(xiàng)目的核心價(jià)值不在導(dǎo)航算法有多深而在于完整展示了一個(gè)“傳統(tǒng)業(yè)務(wù)系統(tǒng) AI 能力”的典型融合方式。拿到源碼后最先要做的不是贊嘆代碼量而是按數(shù)據(jù)庫初始化、后端啟動(dòng)、小程序?qū)?、功能走查的順序把整條鏈路跑通。跑通之后把“AI 問路”這個(gè)模塊的測(cè)試數(shù)據(jù)整理出來它就是論文系統(tǒng)測(cè)試章節(jié)里最有說服力的素材。最容易踩的坑集中在三處SpringBoot 版本與 JDK 不匹配導(dǎo)致啟動(dòng)失敗、小程序登錄流程中 appid 與 code2Session 配置錯(cuò)誤、AI 接口的網(wǎng)絡(luò)調(diào)用超時(shí)。這三個(gè)問題預(yù)先排查能省下大量時(shí)間。如果時(shí)間充裕后續(xù)可以考慮往這幾個(gè)方向擴(kuò)展增加室內(nèi)導(dǎo)航和樓層定位把校園 POI 做成后臺(tái)管理系統(tǒng)可維護(hù)的版本加入導(dǎo)航足跡分析和常去地點(diǎn)推薦或者接入校園服務(wù)賬號(hào)的訂閱消息推送。這些方向都能成為論文的“不足與展望”也能讓項(xiàng)目在答辯時(shí)不止停留在演示層面。建議收藏備用按文中的驗(yàn)證流程走一遍再?zèng)Q定下一步怎么改。