SpringBoot+微信小程序+AI大模型智能校园导航系统毕设全解析

这次我们来看一个面向计算机毕业设计的完整全栈项目SpringBoot 微信小程序 AI大模型 智能校园导航系统。它不是单独的小程序前端也不是只搭了个后端登录接口的“空壳项目”而是把数据库设计、后端接口、小程序页面、AI 能力接入全部串起来的闭环系统配套还带源码、LW毕业设计论文文档、PPT 和讲解。先说怎么判断这个项目适不适合你。如果你正在准备计算机毕业设计技术栈需要覆盖SpringBoot、微信小程序、AI大模型应用又希望做出来的东西既实用又有“智能感”那这个题目基本是冲着这几个关键词去的。校园导航不是新概念但加入大模型语义解析之后用户可以直接输入“我想去图书馆”这样的自然语言由后端调用大模型解析出具体目的地再配合校园地图完成导航展示这就比传统关键词匹配的“菜鸟级导航”更有答辩亮点。本文不准备只讲“这个项目多好”而是按一套完整的本地部署与验证思路来拆核心能力、系统架构、环境准备、启动方式、功能测试、接口调用、AI 大模型集成方式、常见问题排查和最佳实践。看完你就能判断两件事第一这个项目值不值得作为你的毕设选题第二拿到源码之后该怎么把它跑起来并在答辩时有话可讲。文章里所有命令和配置都是通用写法实际路径、端口、AppID 需要替换成你项目里的真实值。1. 核心能力速览在动手部署之前先把项目的技术画像拉出来看一眼。下面这张表的内容既是从项目标题和常见毕设项目结构推断的能力边界也是你验收源码时必须逐项确认的检查点。能力项说明项目类型计算机毕业设计全栈项目后端 小程序端 AI能力接入后端框架SpringBoot按标准 MVC 分层结构组织前端框架微信小程序原生开发使用微信开发者工具编译运行AI 能力接入大模型接口实现自然语言目的地解析、校园问答等智能交互核心功能用户登录、校园地图展示、POI 搜索、导航路径规划、AI 问路/问答数据库MySQL涉及用户表、地点信息表、导航记录表等基础表结构配套材料源码、LW论文文档、PPT、讲解视频启动方式后端启动 SpringBoot 应用前端在微信开发者工具中导入项目是否支持 API后端天然提供 HTTP 接口供小程序端、管理端或第三方调用是否支持批量任务后端可扩展批量导入校园 POI 数据AI 接口可按批量请求处理适合场景毕业设计选题、SpringBoot 小程序全栈入门、AI 应用课程项目需要注意以上能力表的“来源”是项目标题和常见的毕设项目组织方式。真正的源码里具体实现了哪些接口、是否接入了真实的大模型厂商 API、地图用的是 WebGL 还是静态图片都要以你拿到的项目文档为准。后面每个功能测试环节都要先回到源码里确认实现方式再动手验证。2. 适用场景与使用边界2.1 适合谁用这个项目最直接的受众是计算机相关专业的大四学生尤其是选题方向偏向SpringBoot、微信小程序、AI大模型应用开发的同学。它解决的核心问题不是“从零写一个校园导航有多难”而是“怎么在有限的时间内交付一个结构完整、功能可演示、论文有内容写的系统”。如果你是下面这类读者也值得拿这套项目当作学习素材SpringBoot 初学者想找一个包含 Controller、Service、Mapper 分层结构的完整后端项目而不是只做 CRUD 小 demo。微信小程序学习者想看看登录流程、页面跳转、地图组件、网络请求在小程序里是怎么组织的。AI 应用方向学生想了解大模型 API 如何被接入到传统业务系统里而不是只能做聊天机器人。准备毕设答辩的学生需要一套能讲清楚“业务模块 AI 创新点 数据库设计 测试结果”的完整项目叙事。2.2 能解决什么问题传统校园导航系统往往停留在“地图展示 关键字匹配”的层面用户输入“图书馆”就搜地点输入“我想自习”就无能为力。加入 AI 大模型后系统可以把自然语言转换成结构化查询条件也能承担一部分校园问答能力比如“校医院几点下班”“图书馆在哪栋楼”。这种“业务系统 AI 能力”的组合正是当前毕业设计评分时比较看重的亮点。从工程角度看完整的用户——地点——导航记录数据流也让你在写论文时有足够的内容需求分析、系统设计、数据库表设计、接口设计、AI 模块设计、系统测试每一章都有实际代码和数据支撑不会出现“写不出内容只能凑字数”的问题。2.3 使用边界与合规提醒这里要单独强调拿到任何毕设项目源码后第一件事不是改代码而是确认使用边界。不要照抄提交部分高校对毕业设计有查重和代码相似度检测。参考源码学习结构、理解实现逻辑没问题但直接替换个人信息提交可能会被判定学术不端。最好在理解的基础上重构部分模块并补充自己的功能设计。AI 接口需要授权项目里接大模型 API通常意味着你需要在某个平台上申请 API Key。不同平台的计费方式、数据隐私政策、调用频率限制都不一样论文里要写清楚你用的是哪个平台、什么模型、为什么选它。地图数据有版权校园地图、POI 坐标、建筑图片这些素材如果来自第三方要注意授权边界。涉及个人信息的用户数据在做演示时不要使用真实同学的大量敏感数据。小程序发布需合规个人主体的小程序和涉及地图、定位、用户信息的功能在微信公众平台审核时有额外要求。毕业设计阶段用开发者工具和测试号即可不需要真的发布上线。3. 环境准备与前置条件这套项目跑起来的环境不算复杂和大多数SpringBoot 小程序项目的部署方式一致。下面按后端、前端、数据库三部分列出一份通用环境检查清单。3.1 后端环境组件推荐版本说明JDK1.8 或 11具体以pom.xml中的java.version为准Maven3.6 以上用于拉取项目和打包IDEIDEA 或 Eclipse建议直接使用 IDEA识别 SpringBoot 项目更顺手MySQL5.7 或 8.0需要手动创建数据库并导入 SQL 文件Navicat / Workbench任意用于查看数据库表结构和初始化数据当你拿到源码后第一步是打开pom.xml确认三件事spring-boot-starter-parent的版本号是 2.7.x 还是 3.x。java.version是多少Java 8 还是 17。依赖里有没有 MyBatis、MyBatis-Plus、MySQL 驱动、Redis、AI SDK 等。这里特别提醒网上很多同学遇到“springboot版本太高”导致项目启动失败的问题。原因通常是SpringBoot 3.x 要求 JDK 17 以上而本机装的是 JDK 8或者反过来项目是 SpringBoot 2.7 编译的你用 JDK 17 运行低版本项目也会出现兼容告警。最稳妥的方式是严格按照项目文档里的 JDK 版本配置环境。3.2 微信小程序前端环境组件说明微信开发者工具稳定版即可导入项目时选择小程序项目AppID使用测试号或自己的小程序 AppID手机或模拟器用于验证页面渲染、定位、地图交互小程序端的技术栈通常就是微信原生语法WXML、WXSS、JS、JSON 配置。不需要额外安装 npm 依赖除非项目里使用了Vant Weapp之类的 UI 组件库。如果用了组件库需要在app.json里做组件路径配置并且miniprogram_npm目录要存在。3.3 数据库环境项目的.sql文件一般会放在sql/或db/目录下。你需要创建一个数据库字符集选择utf8mb4。导入 SQL 文件生成用户表、地点表、导航记录表等。在application.yml里修改数据库地址、账号、密码。下面是一个通用的application.yml配置模板实际字段以项目为准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配置里会出现spring.redis和自定义的ai.api-key、ai.model-name等字段。这些都需要按源码中的application-example.yml或说明文档来填。3.4 硬件要求这里不是图像生成项目不存在“显存不够就跑不了”的问题。后端 SpringBoot 应用对内存的常规要求在 512MB 到 2GB 之间开发机基本都能满足。唯一需要留意的是如果你在本地启动多个大型 IDE、MySQL、微信开发者工具内存 8GB 的机器会比较吃力建议先关掉无关应用再启动。4. 安装部署与启动方式拿到源码后推荐按照“数据库 - 后端 - 小程序前端”的顺序启动。这样小程序调用后端接口时服务已经在运行可以直接看到效果。4.1 初始化数据库# 登录 MySQL mysql -u root -p # 创建数据库 CREATE DATABASE IF NOT EXISTS campus_navigation DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; # 使用数据库 USE campus_navigation; # 导入 SQL 文件路径按实际存放位置调整 SOURCE D:/project/campus_navigation/sql/campus_navigation.sql;导入成功后执行SHOW TABLES;你应该能看到类似下面的表user campus_building campus_poi navigation_record ai_chat_record表名和字段名可能不同但基本的业务表结构应该覆盖用户、地点、导航记录和 AI 交互记录这几类。4.2 启动 SpringBoot 后端用 IDEA 打开后端项目后等待 Maven 下载依赖。这里有几个容易卡住的地方Maven 依赖下载慢建议配置阿里云镜像。依赖下载失败检查本地 Maven 仓库权限。Lombok 版本与 JDK 不兼容会见到编译错误。依赖下载完成后修改application.yml里的数据库账号密码和 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如果你习惯用命令行启动也可以先用 Maven 打包mvn clean package -DskipTests java -jar target/campus-nav-0.0.1-SNAPSHOT.jar启动后用浏览器访问http://127.0.0.1:8080或者访问项目配置的 Swagger 文档地址如果有确认后端接口可以访问。4.3 导入微信小程序打开微信开发者工具点击“导入项目”选择小程序前端目录。需要确认的配置配置项操作AppID使用测试号或填写你自己的 AppID后端接口地址在utils/request.js或app.js中修改 baseUrl 为http://127.0.0.1:8080不校验合法域名开发阶段勾选“不校验合法域名、web-view业务域名、TLS 版本以及 HTTPS 证书”如果你在小程序里自定义了登录弹窗或顶部导航栏还需要检查app.json里的navigationStyle配置。导入成功后点击模拟器页面的“编译”按钮。小程序会向本机后端发起请求如果能正常拉取校园地点列表说明前后端已经连通。5. 功能测试与效果验证项目跑起来之后不要急着截图写论文。先按下面的功能矩阵做一遍完整的验证确认每个模块都符合预期再考虑改代码、加功能。5.1 用户登录与微信授权测试目的确认小程序可以完成微信登录流程后端能拿到用户身份并创建用户记录。操作步骤在微信开发者工具中打开小程序。点击“登录”或“授权登录”按钮。观察后端控制台是否收到登录请求。查看数据库user表是否新增或更新了用户记录。预期结果登录成功后小程序端保存用户 token后续请求携带用户身份。后端日志能看到用户 openid 或 unionid 的存取过程。判断标准退出小程序重新进入登录态仍然保持不需要每次都重复授权。常见失败原因AppID配置错误、后端接口地址不对、code2Session请求的 appid 与 secret 与项目不匹配。5.2 校园地图与 POI 展示测试目的确认地图组件能正常显示校园建筑和 POI 点位坐标正确。操作步骤进入小程序首页或地图页面。检查地图是否渲染出校园范围。点击地图上的标记点查看地点名称、介绍、开放时间等信息。对比地图坐标与实际校园位置是否一致。预期结果页面能展示地图标记点点击后有信息浮层POI 数据来自后端接口而不是写死在小程序代码里。判断标准新增或修改一条 POI 数据后小程序端刷新页面能看到变化。常见失败原因地图 key 未配置、坐标系统不一致GCJ-02 与 WGS-84 需转换、地图插件在小程序后台未添加。5.3 智能搜索与 AI 问路这是整个项目的核心亮点模块也是答辩时最值得讲的功能。测试目的验证大模型是否能把自然语言转换成具体的导航目的地或问答结果。操作示例输入文本期望行为“我想去图书馆”系统解析出目的地是“图书馆”并展示对应 POI 和导航按钮“校医院在哪”系统返回校医院位置和路径信息“今天要去交材料应该去哪个部门”大模型根据校园知识库给出建议可能触发多轮对话“你好”系统返回欢迎语不触发导航意图操作步骤在搜索框输入自然语言。点击搜索或发送按钮。查看返回结果是直接定位到 POI还是进入 AI 对话。点击“开始导航”确认路径规划可以正常展示。预期结果大模型能正确识别“地点意图”和“问答意图”。地点意图返回结构化地址问答意图返回文本答案。判断标准连续测试 10 条以上不同表达方式的语句比如“我要去图书馆”“图书馆怎么走”“哪里能借书”至少 7 条以上被正确处理说明 AI 模块整体可用。常见失败原因大模型 API Key 失效、提示词工程配置错误、后端返回超时、小程序端没有设置较长的请求超时时间。这里给出一个后端 AI 接口调用的通用示例实际项目里会根据你所接入的大模型平台调整// 通用大模型调用示例具体依赖和类名以项目为准 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, 你是一个校园导航助手只能回答与校园相关的问题), Map.of(role, user, content, userMessage) )); // 使用 HttpURLConnection 或 Spring RestTemplate 发起请求 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); // 从响应中提取生成文本字段名以平台返回为准 return response.getBody().get(choices).toString(); }5.4 导航路径规划测试目的确认选中目的地后能调用地图路径规划能力并展示路线。操作步骤在 POI 详情页点击“导航”或“到这里去”。进入导航页面查看起终点是否正确。观察路线绘制步行路线、距离、时间是否显示。在小程序模拟器切换不同定位点确认路线会跟着变化。预期结果地图上出现从当前位置到目的地的路线折线伴随距离和预计步行时间。判断标准不同起终点组合下路线都能正常规划。常见失败原因地图 SDK 路径规划接口需要额外开通、起点坐标默认为 0定位失败、模拟器不支持定位需要手动选点。5.5 导航记录与历史管理测试目的确认用户的历史导航记录能保存、查询、删除。操作步骤完成一次导航后到“记录”或“我的”页面查看。确认导航记录包含起终点、时间、状态。删除一条记录刷新页面后确认已删除。预期结果导航记录与当前登录用户绑定不同用户看不到彼此记录。判断标准数据库navigation_record表有新数据写入且字段完整。常见失败原因请求头未携带用户 token后端无法识别当前用户导致查询为空。5.6 后端接口文档测试如果项目集成了 Swagger 或 Knife4j可以像下面这样直接请求接口验证数据流。# 请求校园地点列表接口地址以实际项目为准 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 状态码是 200 还是 500。返回 JSON 结构是否与小程序端解析逻辑一致。输入特殊字符、超长文本时接口是否稳定。6. 接口 API 与批量任务毕设项目里接口 API 的设计质量直接影响论文的“系统设计”部分。一个合格的 SpringBoot 小程序项目接口通常按下面的风格组织。模块接口路径方法说明用户/api/user/loginPOST用户登录/注册用户/api/user/infoGET获取用户信息地点/api/poi/listGET地点列表分页/关键字地点/api/poi/detail/{id}GET地点详情导航/api/navigation/planPOST路径规划导航/api/navigation/recordGET/POST/DELETE导航记录管理AI/api/ai/chatPOSTAI 对话/意图识别实际接口路径和参数要以源码为准上面的表格只作为组织接口文档时的参考模板。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 };在页面里调用时就比较清爽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 - 传给后端 - 后端调用微信 code2Session 接口 - 返回 openid 和 session_key - 后端生成自定义 token 返回给小程序]需要注意的是这里不能用 mermaid就直接用文字流程说明小程序端调用wx.login拿到临时code。小程序把code发送给自己的后端/api/user/login。后端用appid secret code请求微信接口code2Session。微信返回openid、session_key。后端根据openid查找或创建用户生成自定义登录 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. 发起 HTTP 请求解析 openid // 3. 查询用户如果不存在则注册 // 4. 生成 token 并返回 return Result.success(token); } }很多同学在开发时遇到“小程序获取登录后的微信用户失败”的问题常见原因包括后端code2Session请求失败检查appid和secret是否匹配。小程序端没有把code传到后端只传了用户头像。后端返回的 openid 字段名和数据库字段对不上。请求被拦截需要确认小程序后台的 request 合法域名配置。6.3 批量任务与数据管理毕设项目里“批量任务”的概念不像工业级系统那么重但有两个场景值得做批量导入校园 POI 数据提供一个管理员接口接收 Excel 或 JSON 批量写入建筑和地点信息避免手动一条条插入数据库。批量测试 AI 意图识别准备一组测试用例比如 20 条不同表述的“去图书馆”问法循环调用 AI 接口统计识别正确率。这个数据可以直接放进论文的系统测试章节。批量测试的 Python 示例import requests import time import json # 替换成你的后端地址和测试用例 api_url http://127.0.0.1:8080/api/ai/chat test_cases [ 我想去图书馆, 图书馆怎么走, 去哪里可以借书, 我要还书应该到哪个楼, 图书馆几点关门 ] 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) # 避免触发接口限流 with open(ai_test_results.json, w, encodingutf-8) as f: json.dump(results, f, ensure_asciiFalse, indent2)批量任务的关键是“可观测”。每个测试用例都要记录输入、输出、耗时、是否成功这样出了问题才能定位是 AI 模型理解不准还是接口超时还是提示词没写好。7. 资源占用与性能观察虽然这不是大模型本地部署项目AI 能力是通过 HTTP 接口调用的不会占很大的显存或内存但性能观察同样重要。毕设答辩时如果老师问“你这个系统性能怎么样”“接口慢不慢”你不能只说“挺快的”要用数据说话。7.1 后端内存与 CPUSpringBoot 应用启动后的内存占用通常在 300MB 到 1GB 之间。可以这样观察# Windows 上查看进程内存 jps -l # 查看指定进程状态 jinfo pid实际体验上IDEA 里跑 SpringBoot 不会像启动大型机器学习任务那样吃紧8GB 内存的笔记本电脑完全够用。7.2 AI 接口的响应时间这是整个系统里最影响体验的性能瓶颈。普通数据库查询接口可能在 50ms 到 200ms但大模型接口的响应时间通常会在 1 秒到 5 秒取决于你使用的是哪家平台、什么型号的模型、输入文本长度。如果响应超过 10 秒小程序端用户就会感觉到明显的卡顿。优化建议在小程序端把 AI 请求的超时时间调到 15 秒以上避免请求被提前中断。后端使用异步处理不阻塞主请求线程。如果同一句问话频繁出现可以做简单的本地缓存命中缓存就不再调用 AI 接口。在提示词里限制输出长度减少 tokens 消耗和响应时间。7.3 数据库连接与连接池如果项目使用 MyBatis-Plus默认连接池是 HikariCP。观察数据库连接池是否正常可以在application.yml中临时打开 SQL 日志logging: level: com.example.campusnav.mapper: debug这样每次 SQL 操作都会在控制台打印方便确认接口慢是不是因为 SQL 查询问题比如缺少索引、全表扫描、N1 查询。7.4 小程序端性能小程序端的性能观察点包括地图页面是否卡顿连续拖动地图时帧率如何。页面 onLoad 的数据请求是否在页面渲染前完成。图片资源是否过大影响加载速度。是否合理使用wx.setStorageSync做本地缓存而不是每次打开页面都请求后端。8. 常见问题与排查方法下面是这套项目从部署到运行最常遇到的问题按照“问题现象 - 可能原因 - 排查方式 - 解决方案”的顺序整理。问题现象可能原因排查方式解决方案后端启动报“springboot版本太高”或版本不兼容JDK 版本与 SpringBoot 版本不匹配查看pom.xml中 java.version 和 spring-boot 版本SpringBoot 2.x 用 JDK 8/11SpringBoot 3.x 用 JDK 17Maven 依赖下载失败或下载慢网络问题、镜像未配置查看 IDEA 日志或 Maven 日志配置阿里云镜像清理本地 .m2 仓库启动后页面打不开端口被占用或服务未启动检查日志和端口占用更换端口或重启服务数据库连接失败账号密码错误、数据库未创建检查application.yml与 MySQL 状态确认数据库已创建账号密码正确小程序请求接口失败IP 或端口配置错误查看小程序控制台 Network 面板将 baseUrl 改为本机实际 IP关闭防火墙小程序开发工具提示“不在以下 request 合法域名列表中”未配置合法域名或未勾选不校验检查小程序后台配置开发阶段勾选“不校验合法域名”微信登录后获取不到用户信息code2Session 请求失败或 AppID 错误查看后端日志中微信接口返回核对 AppID、secret检查 code 是否正确登录提示“获取登录后的微信用户失败:wx1cb4398e1413dce7”或类似报错微信接口返回错误码AppID 不匹配或 code 已过期把微信返回的 errcode 和 errmsg 打出来根据错误码查询微信官方文档确认 code 只能使用一次地图不显示地图 key 未配置或组件参数错误查看小程序控制台地图组件报错确认地图 key 已申请并填入AI 接口返回超时大模型平台响应慢或后端超时时间太短用 curl 直接测试 AI 接口耗时增加超时时间使用异步调用页面出现 401 未授权token 缺失或过期查看浏览器/小程序请求头重新登录获取 token确保请求头携带 token修改小程序代码后页面无变化未重新编译或缓存点击微信开发者工具“编译”按钮清除缓存后重新编译批量测试 AI 时接口频繁失败触发平台限流查看响应中的限流提示在测试脚本中增加 sleep 间隔降低并发8.1 关于“springboot版本太高”的细节在 SpringBoot 小程序的毕设项目里这个问题出现频率极高。很多同学从网上下载项目后用 IDEA 最新版打开默认使用 JDK 17 甚至 JDK 21而项目本身是 SpringBoot 2.3 或 2.7 写的结果启动时报错。处理思路是先在pom.xml里看到parent中的版本号。如果版本号是2.x去 Project Structure 里把 Project SDK 改为 JDK 8 或 JDK 11。如果版本号是3.x再用 JDK 17 或更高版本运行。不要“为了跑通而升级 SpringBoot 版本”老项目升级到新版本可能引发更多兼容问题。8.2 微信小程序登录与用户信息获取问题网络热词里面反复出现“小程序获取登录后的微信用户失败”做毕设的时候遇到这类问题不要慌。微信官方对用户信息的获取限制越来越严格不能再像早期那样直接拿wx.getUserInfo获取头像昵称。现在的标准流程是用wx.login获取code后端换取openid实现账号体系。头像昵称使用button组件的open-typechooseAvatar和nickname输入框来获取。不要在小程序端直接调用wx.getUserProfile来存用户信息这个接口已经逐步收紧。如果你的项目里登录报错把后端日志里微信接口返回的errcode和errmsg贴到微信官方文档查询通常能快速定位而不是到处猜原因。8.3 小程序跳转与定位相关的问题如果项目里需要从一个校园小程序跳到另一个小程序需要在微信公众平台配置“跳转小程序列表”并且目标小程序的 AppID 要事先声明。这和网络热词中提到的“小程序a跳转小程序b”场景一致。定位方面小程序可以通过wx.getLocation获取经纬度但要注意这个接口需要用户授权并且在 app.json 中声明requiredPrivateInfos。如果用 H5 页面内嵌在小程序里H5 调用定位会受限通常需要小程序原生页面先拿到坐标再传给 web-view。9. 最佳实践与使用建议9.1 先跑通再改代码拿到源码后第一轮的目标是“复现”不是“改造”。按默认配置把项目跑起来走一遍登录、搜索、导航、记录这些核心流程确认每个模块都能工作再思考要改进哪个部分。很多同学一上来就改页面样式、加功能结果连环境都没配好最后花了很多时间在“跑不起来”上。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这样无论换电脑还是交给导师验收都能快速恢复环境不用每次凭记忆配配置。9.3 分目录管理源码、文档和素材推荐按照下面的目录结构管理整个项目campus-navigation-graduation/ ├── code-backend/ # SpringBoot 后端源码 ├── code-miniprogram/ # 微信小程序前端源码 ├── sql/ # 数据库初始化脚本 ├── docs/ │ ├── 开题报告.md │ ├── 论文大纲.md │ ├── 答辩PPT/ # PPT 源文件和导出文件 │ └── 演示录制/ # 功能演示视频 ├── assets/ │ ├── 图片/ # 截图、功能截图 │ └── 测试数据/ # POI 批量导入数据、AI测试用例 └── README.md特别是 “AI 测试数据” 目录里面的批量测试用例和结果记录在写论文“系统测试”章节时很好用。9.4 论文写作与答辩建议论文里的系统设计部分要配三张核心图系统架构图、功能模块图、数据库ER图。写 AI 模块时不要只说“调了某个大模型的接口”要把以下几点写清楚为什么选这个模型对比两三个候选模型的优缺点从响应速度、中文能力、成本、数据隐私角度写。提示词怎么设计系统提示词如何约束模型只回答校园相关问题如何区分地点意图和问答意图。异常怎么处理AI 接口超时怎么办、返回结果不是预期格式怎么办。效果怎么评估准备测试集统计真实准确率而不是只截图一个成功的对话。这些内容是论文的加分项也是答辩时展示你真正理解项目的证据。9.5 安全与合规使用建议不要把自己的大模型 API Key 提交到公开仓库使用环境变量或配置中心管理。用户手机号、真实姓名、学号等敏感信息要进行加密存储。毕设项目也要建立最小权限原则。AI 生成内容必须包含免责提示仅作为校园信息参考不替代官方通知。如果使用真实校园地图和建筑照片确认来源和授权论文致谢或附录中注明素材来源。10. 总结与下一步这个项目的核心价值不在导航算法有多深而在于完整展示了一个“传统业务系统 AI 能力”的典型融合方式。拿到源码后最先要做的不是赞叹代码量而是按数据库初始化、后端启动、小程序导入、功能走查的顺序把整条链路跑通。跑通之后把“AI 问路”这个模块的测试数据整理出来它就是论文系统测试章节里最有说服力的素材。最容易踩的坑集中在三处SpringBoot 版本与 JDK 不匹配导致启动失败、小程序登录流程中 appid 与 code2Session 配置错误、AI 接口的网络调用超时。这三个问题预先排查能省下大量时间。如果时间充裕后续可以考虑往这几个方向扩展增加室内导航和楼层定位把校园 POI 做成后台管理系统可维护的版本加入导航足迹分析和常去地点推荐或者接入校园服务账号的订阅消息推送。这些方向都能成为论文的“不足与展望”也能让项目在答辩时不止停留在演示层面。建议收藏备用按文中的验证流程走一遍再决定下一步怎么改。