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