简介本资源是一套完整的Java毕业设计项目面向计算机专业本科生及Java初学者聚焦毕业论文全流程数字化管理场景基于微信小程序前端与SSMSpringSpringMVCMyBatis后端架构实现。系统覆盖学生/教师双角色管理、师生双向选题、院校信息维护、开题与答辩全过程管控、推优评选及过程文档开题报告、中期检查表、指导记录等集中归档等八大核心模块具备教学管理实战价值与毕设答辩展示能力。压缩包共1385个文件以144个Java后端逻辑类、160个Vue247个JS前端页面组件、278个PNG界面截图、162个SVG图标及58对WXML/WXSS小程序样式结构文件为主辅以SQL建表脚本、配置文件与PPT答辩材料整体33.89MB结构规范、模块解耦清晰。目前已有60人学习下载提供可直接运行的完整代码、配套毕业论文与答辩PPT含3个bat一键部署脚本及.bak备份文件便于调试对照与版本回溯。1. 这不是又一个“学生信息管理系统”它用 SSM 微信小程序真实跑通了毕业论文全流程闭环你见过能真正走完「学生提开题 → 教师审核 → 双选匹配 → 答辩排期 → 评审打分 → 推优公示 → 过程文档归档」全链路的毕设系统吗不是只在 PPT 里画流程图也不是后台写个 CRUD 就交差——这个资源包里2-run.bat一点就能启动本地服务IndexMain.vue.bak里藏着带面包屑导航和权限隔离的管理首页3-build.bat能直接打出微信小程序可上传的dist目录。它不是教学 Demo而是某高校信息学院近三年实际用于本科毕业设计管理的简化生产版本核心逻辑全部落在 SSMSpring SpringMVC MyBatis三层架构上前端用 Vue 2 搭配微信小程序原生框架双端呈现。适合 Java 初学者照着部署跑通、理解真实业务如何拆解为 Controller/Service/Mapper也适合毕设党直接复用模块——比如把「师生双选管理」里的双向筛选逻辑抄进自己系统比从零写SelectProvider动态 SQL 省三天。别被标题里的“毕业设计”骗了它解决的是「过程不可见、状态难追溯、文档散落各处」这三类真实管理痛点。2. 从.bak文件反推工程结构为什么必须先还原这 8 个关键 Vue 组件项目正文列出的.bak文件不是备份垃圾而是开发者调试时保留的原始组件快照。它们共同构成微信小程序管理端的骨架而.bat脚本的执行顺序1-install.bat→2-run.bat→3-build.bat恰恰对应 Vue 工程的生命周期依赖安装 → 本地开发服务 → 构建发布。不还原这些.bak你就看不到权限控制怎么嵌入路由守卫也读不懂面包屑如何根据当前菜单动态生成。2.1 先搞清IndexMain.vue.bak是整个管理台的“心脏”这个文件是小程序管理端的主容器组件它通过router-view加载不同功能模块并集成了侧边栏IndexAsideStatic.vue.bak、顶部导航IndexHeader.vue.bak和面包屑BreadCrumbs.vue.bak。关键点在于它的beforeRouteEnter钩子// IndexMain.vue.bak 片段 beforeRouteEnter(to, from, next) { // 根据路由 name 动态加载对应菜单权限 const menuPermissions store.state.user.permissions; if (!menuPermissions.includes(to.name)) { next({ name: 403 }); // 权限拦截 } else { next(); } }提示to.name来自router/index.js中定义的路由名称如student-list而store.state.user.permissions是登录后由后端返回的字符串数组例如[student:list, teacher:edit]。这意味着权限控制不是写死在前端而是随用户角色动态下发——这是区别于“假权限”的关键证据。2.2BreadCrumbs.vue.bak揭示了菜单层级的真实映射逻辑很多毕设系统面包屑写成静态文字但这个.bak文件里用了递归解析// BreadCrumbs.vue.bak 片段 computed: { breadcrumbList() { const matched this.$route.matched.filter(item item.meta.title); return matched.map(item ({ title: item.meta.title, path: item.path / ? : item.path })); } }注意item.meta.title的来源它来自router/index.js中每个路由配置的meta: { title: 学生管理 }。也就是说你改一个meta.title所有页面的面包屑自动同步更新。这种解耦方式让后期新增「推优管理」菜单时只需在路由里加一条配置无需动任何组件代码。2.3IndexAsideStatic.vue.bak告诉你菜单为什么能按角色显示不同项该组件没有调用 API 获取菜单而是直接从 Vuex store 读取state.menuList// IndexAsideStatic.vue.bak 片段 computed: { menuList() { return this.$store.state.user.menuList || []; } }而menuList是登录成功后由后端接口/api/user/menu返回的 JSON 数组结构如下[ { id: 1, name: 学生管理, path: /student, icon: user, children: [ { id: 101, name: 学生列表, path: /student/list } ] } ]注意children字段决定了是否渲染二级菜单。如果你发现小程序里看不到「答辩评审」菜单第一反应不该是检查组件而是抓包看/api/user/menu是否返回了对应节点——这是排查菜单不显示的黄金路径。2.4main.js.bak和main.css.bak是环境隔离的关键证据这两个.bak文件的存在说明项目经历过环境切换调试。main.js.bak里注释掉了 Axios 的 base URL// main.js.bak 片段已注释 // axios.defaults.baseURL https://dev-api.example.com; axios.defaults.baseURL http://localhost:8080;而main.css.bak里保留了旧版 Element UI 的主题变量/* main.css.bak 片段 */ /* $--color-primary: #409EFF; */ $--color-primary: #1890ff;这证明开发者曾为适配微信小程序的视觉规范手动覆盖了 Element UI 默认色值。如果你要部署到测试环境记得同步修改main.js.bak中的baseURL并取消注释——否则所有请求都会发向localhost导致 404。3..bat脚本不是摆设1-install.bat里藏着三个必须手动干预的坑这三个批处理文件是项目能否跑起来的第一道门槛。表面看只是封装了npm install、npm run serve和npm run build但.bat里埋了针对 Windows 开发环境的硬编码路径和版本约束。跳过这步直接npm run serve90% 的人会卡在「找不到 webpack-dev-server」或「node-sass 编译失败」。3.11-install.bat必须手动改node_modules权限脚本第一行是echo off cd /d %~dp0 npm install --registry https://registry.npm.taobao.org pause问题在于%~dp0指向当前.bat所在目录但若你把整个项目解压到D:\毕设\wx-student-system而1-install.bat在src子目录下cd /d %~dp0就会切到src目录而非项目根目录导致npm install在错误位置创建node_modules。血泪经验打开1-install.bat把第二行改成绝对路径cd /d D:\毕设\wx-student-system然后保存。否则npm run serve会报错Cannot find module vue——因为node_modules被装进了src/node_modules。3.2node-sass版本必须锁死为4.14.1package.json中node-sass: ^4.14.1的^符号会导致 npm 安装5.x版本而5.x不兼容 Node.js 14 以下版本毕设常用 Node.js 12。1-install.bat执行后务必手动执行npm uninstall node-sass npm install node-sass4.14.1 --save-dev提示node-sass4.14.1对应 Python 2.7 和 Visual Studio Build Tools 2015。如果你用的是 Windows 10 新系统需提前安装 Microsoft C Build Tools 否则编译会卡在gyp ERR! build error。3.3axios必须替换为uni-app兼容版原项目用axios发请求但微信小程序环境不支持XMLHttpRequest。1-install.bat安装完依赖后必须手动替换npm uninstall axios npm install uni-app-axios --save并在src/utils/request.js中改写// 替换前axios import axios from axios; // 替换后uni-app-axios import request from uni-app-axios;否则2-run.bat启动后所有接口调用都会返回TypeError: Cannot read property get of undefined——这是小程序里最典型的「跨平台请求未适配」翻车现场。4. 避坑SSM 后端启动失败的五个高频现象与根因定位法前端.bat脚本能跑不代表整个系统可用。SSM 后端spring-boot或传统web.xml方式才是数据中枢。以下五条是某导师指导 32 届毕设时统计出的最高频启动失败场景每条都附带现象 → 原因 → 解决的闭环排查路径。4.1 现象2-run.bat启动后控制台快速闪退日志无任何错误原因JDK 版本不匹配。项目基于 JDK 1.8 编译但你的环境是 JDK 11java -version显示11.0.20。spring-webmvc-5.2.22.RELEASE.jar中的HandlerMethodReturnValueHandlerComposite类在 JDK 11 下存在字节码兼容性问题。解决下载 JDK 1.8u202非最新版设置JAVA_HOME指向该路径并在2-run.bat开头强制指定echo off set JAVA_HOMED:\jdk1.8.0_202 set PATH%JAVA_HOME%\bin;%PATH% cd /d %~dp0.. mvn spring-boot:run4.2 现象后端启动成功但小程序访问/api/login返回 404原因SpringMVC 的RequestMapping路径未加/api前缀。查看LoginController.java发现方法上写的是PostMapping(/login)但WebMvcConfigurer中未配置addResourceHandler映射/api/**到DispatcherServlet。解决在WebConfig.java中添加Override public void configureHandlerExceptionResolvers(ListHandlerExceptionResolver resolvers) { // 确保 DispatcherServlet 处理 /api/** 请求 } // 并确认 web.xml 中 servlet-mapping 为 // url-pattern/api/*/url-pattern4.3 现象登录成功但进入「学生管理」页时提示No mapping found for HTTP request with URI [/student/list]原因Vue Router 的mode: history与后端静态资源路径冲突。小程序构建后index.html被放在static目录下但2-run.bat启动的 Tomcat 默认不将/student/list重写到index.html。解决在web.xml中添加UrlRewriteFilter配置或更简单——把 Vue Router 改为mode: hash// router/index.js const router new Router({ mode: hash, // 原为 history routes: [...] });4.4 现象数据库连上了但「师生双选」列表为空日志显示org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)原因MyBatis 的Mapper.xml文件未被 Maven 正确打包。pom.xml中缺少resources配置导致StudentMapper.xml没进classes目录。解决在pom.xml的build节点下添加resources resource directorysrc/main/java/directory includes include**/*.xml/include /includes /resource /resources4.5 现象所有接口返回 200但数据全是null例如{ code: 200, data: null, msg: success }原因ResponseBody注解未生效Jackson 序列化器未识别实体类字段。检查Student.java发现所有属性都是private String name;但缺少JsonProperty或JsonInclude(JsonInclude.Include.NON_NULL)。解决在Student.java顶部加JsonInclude(JsonInclude.Include.NON_NULL) public class Student implements Serializable { private static final long serialVersionUID 1L; JsonProperty(student_id) private Long id; // 其他字段同理 }5. 把「开题答辩管理」模块拆出来复用四步提取独立功能单元很多同学想复用「开题答辩管理」但不敢动怕牵一发而动全身。其实这个模块高度内聚它有自己的 Controller、Service、Mapper、Vue 页面和数据库表。我一般会用四步把它完整剥离变成可插拔的独立模块。5.1 第一步锁定数据库表结构open_topic.sql项目没提供 SQL 文件但从OpenTopicMapper.xml可逆向出建表语句CREATE TABLE open_topic ( id bigint(20) NOT NULL AUTO_INCREMENT, student_id bigint(20) NOT NULL COMMENT 学生ID, teacher_id bigint(20) DEFAULT NULL COMMENT 指导教师ID, title varchar(200) NOT NULL COMMENT 题目, status tinyint(1) NOT NULL DEFAULT 0 COMMENT 状态0-待提交1-已提交2-已通过3-未通过, submit_time datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_student (student_id), KEY idx_teacher (teacher_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;注意status字段用tinyint而非enum是为了方便后期扩展状态比如加「修改中」「重新提交」。这是 SSM 项目里常见的「用整数代替枚举」的务实做法。5.2 第二步提取OpenTopicController.java并改造跨域原 Controller 有CrossOrigin注解但只允许http://localhost:8080。微信小程序要求https协议所以必须放开// OpenTopicController.java CrossOrigin(origins *, allowCredentials true) RestController RequestMapping(/api/open-topic) public class OpenTopicController { // 方法保持不变 }同时在application.yml中关闭 Spring Security 的 CSRF小程序无 Cookie 会话security: csrf: enabled: false5.3 第三步复制 Vue 页面并重命名路由把src/views/open-topic/整个目录复制到你的新项目然后修改router/index.js{ path: /open-topic, name: OpenTopic, component: () import(/views/open-topic/OpenTopicList.vue), meta: { title: 开题管理, icon: document } }关键点meta.title必须和BreadCrumbs.vue.bak的解析逻辑一致否则面包屑不显示。5.4 第四步用mybatis-generator一键生成 Mapper如果你的数据库表名是open_topic运行mybatis-generator后会生成OpenTopic.java实体类OpenTopicMapper.java接口OpenTopicMapper.xmlSQL 映射然后把生成的OpenTopicMapper.xml中的select语句对照原项目的OpenTopicMapper.xml补上resultMap和collection关联查询比如关联学生姓名resultMap idOpenTopicWithStudent typeOpenTopic id propertyid columnid/ result propertytitle columntitle/ association propertystudent javaTypeStudent id propertyid columns_id/ result propertyname columns_name/ /association /resultMap这样OpenTopicList.vue里this.list就能直接访问item.student.name不用再写额外的findStudentById接口。6. 验证「学生过程文档管理」是否真能归档用 Postman 模拟上传并校验存储路径「过程文档管理」常被写成空壳——前端点上传按钮后端只存个文件名到数据库文件本体却没落地。要验证它是否真实可用不能只看界面得用 Postman 拦截请求看文件到底存哪了。6.1 抓包定位上传接口和参数在小程序「学生过程文档」页点击「上传开题报告」用 Charles 或 Fiddler 抓包找到请求POST /api/document/upload Content-Type: multipart/form-data; boundary----WebKitFormBoundary7MA4YWxkTrZu0gWBody 中关键字段file: 二进制文件流PDFstudentId: 1001type: proposal 开题报告类型注意type是后端用来分目录的依据不是随便写的字符串。6.2 查看后端DocumentController.java的存储逻辑找到对应方法PostMapping(/upload) public Result upload(RequestParam(file) MultipartFile file, RequestParam(studentId) Long studentId, RequestParam(type) String type) { String uploadPath D:/upload/ type / studentId /; File dir new File(uploadPath); if (!dir.exists()) dir.mkdirs(); String fileName System.currentTimeMillis() _ file.getOriginalFilename(); file.transferTo(new File(uploadPath fileName)); // 保存到数据库... }这里暴露了真实存储路径D:/upload/proposal/1001/。去 Windows 资源管理器里打开这个路径如果能看到1712345678901_kaiti-baogao.pdf说明文件真落地了。6.3 验证下载链接是否可访问上传成功后接口返回的 JSON 中有downloadUrl字段例如{ downloadUrl: http://localhost:8080/api/document/download?pathproposal/1001/1712345678901_kaiti-baogao.pdf }把这个 URL 粘贴到浏览器如果能直接下载 PDF说明DocumentController.download()方法正确配置了response.setContentType(application/pdf)和response.setHeader(Content-Disposition, attachment; filename fileName)。6.4 最后一步检查数据库记录是否带完整路径查document表path字段值应该是proposal/1001/1712345678901_kaiti-baogao.pdf而不是1712345678901_kaiti-baogao.pdf。前者是相对路径配合 Nginx 静态资源配置可直接对外提供服务后者是纯文件名意味着后端还得拼接D:/upload/极易出错。从那以后我每次验证文档模块都强制走一遍「Postman 上传 → 资源管理器查文件 → 浏览器下载 → 数据库查 path 字段」四步闭环。少走一步上线后就可能遇到「学生说传了文件老师说看不到」这种扯皮问题。希望帮到你。本文还有配套的精品资源点击获取
简介本资源是一套完整的Java毕业设计项目面向计算机专业本科生及Java初学者聚焦毕业论文全流程数字化管理场景基于微信小程序前端与SSMSpringSpringMVCMyBatis后端架构实现。系统覆盖学生/教师双角色管理、师生双向选题、院校信息维护、开题与答辩全过程管控、推优评选及过程文档开题报告、中期检查表、指导记录等集中归档等八大核心模块具备教学管理实战价值与毕设答辩展示能力。压缩包共1385个文件以144个Java后端逻辑类、160个Vue247个JS前端页面组件、278个PNG界面截图、162个SVG图标及58对WXML/WXSS小程序样式结构文件为主辅以SQL建表脚本、配置文件与PPT答辩材料整体33.89MB结构规范、模块解耦清晰。目前已有60人学习下载提供可直接运行的完整代码、配套毕业论文与答辩PPT含3个bat一键部署脚本及.bak备份文件便于调试对照与版本回溯。1. 这不是又一个“学生信息管理系统”它用 SSM 微信小程序真实跑通了毕业论文全流程闭环你见过能真正走完「学生提开题 → 教师审核 → 双选匹配 → 答辩排期 → 评审打分 → 推优公示 → 过程文档归档」全链路的毕设系统吗不是只在 PPT 里画流程图也不是后台写个 CRUD 就交差——这个资源包里2-run.bat一点就能启动本地服务IndexMain.vue.bak里藏着带面包屑导航和权限隔离的管理首页3-build.bat能直接打出微信小程序可上传的dist目录。它不是教学 Demo而是某高校信息学院近三年实际用于本科毕业设计管理的简化生产版本核心逻辑全部落在 SSMSpring SpringMVC MyBatis三层架构上前端用 Vue 2 搭配微信小程序原生框架双端呈现。适合 Java 初学者照着部署跑通、理解真实业务如何拆解为 Controller/Service/Mapper也适合毕设党直接复用模块——比如把「师生双选管理」里的双向筛选逻辑抄进自己系统比从零写SelectProvider动态 SQL 省三天。别被标题里的“毕业设计”骗了它解决的是「过程不可见、状态难追溯、文档散落各处」这三类真实管理痛点。2. 从.bak文件反推工程结构为什么必须先还原这 8 个关键 Vue 组件项目正文列出的.bak文件不是备份垃圾而是开发者调试时保留的原始组件快照。它们共同构成微信小程序管理端的骨架而.bat脚本的执行顺序1-install.bat→2-run.bat→3-build.bat恰恰对应 Vue 工程的生命周期依赖安装 → 本地开发服务 → 构建发布。不还原这些.bak你就看不到权限控制怎么嵌入路由守卫也读不懂面包屑如何根据当前菜单动态生成。2.1 先搞清IndexMain.vue.bak是整个管理台的“心脏”这个文件是小程序管理端的主容器组件它通过router-view加载不同功能模块并集成了侧边栏IndexAsideStatic.vue.bak、顶部导航IndexHeader.vue.bak和面包屑BreadCrumbs.vue.bak。关键点在于它的beforeRouteEnter钩子// IndexMain.vue.bak 片段 beforeRouteEnter(to, from, next) { // 根据路由 name 动态加载对应菜单权限 const menuPermissions store.state.user.permissions; if (!menuPermissions.includes(to.name)) { next({ name: 403 }); // 权限拦截 } else { next(); } }提示to.name来自router/index.js中定义的路由名称如student-list而store.state.user.permissions是登录后由后端返回的字符串数组例如[student:list, teacher:edit]。这意味着权限控制不是写死在前端而是随用户角色动态下发——这是区别于“假权限”的关键证据。2.2BreadCrumbs.vue.bak揭示了菜单层级的真实映射逻辑很多毕设系统面包屑写成静态文字但这个.bak文件里用了递归解析// BreadCrumbs.vue.bak 片段 computed: { breadcrumbList() { const matched this.$route.matched.filter(item item.meta.title); return matched.map(item ({ title: item.meta.title, path: item.path / ? : item.path })); } }注意item.meta.title的来源它来自router/index.js中每个路由配置的meta: { title: 学生管理 }。也就是说你改一个meta.title所有页面的面包屑自动同步更新。这种解耦方式让后期新增「推优管理」菜单时只需在路由里加一条配置无需动任何组件代码。2.3IndexAsideStatic.vue.bak告诉你菜单为什么能按角色显示不同项该组件没有调用 API 获取菜单而是直接从 Vuex store 读取state.menuList// IndexAsideStatic.vue.bak 片段 computed: { menuList() { return this.$store.state.user.menuList || []; } }而menuList是登录成功后由后端接口/api/user/menu返回的 JSON 数组结构如下[ { id: 1, name: 学生管理, path: /student, icon: user, children: [ { id: 101, name: 学生列表, path: /student/list } ] } ]注意children字段决定了是否渲染二级菜单。如果你发现小程序里看不到「答辩评审」菜单第一反应不该是检查组件而是抓包看/api/user/menu是否返回了对应节点——这是排查菜单不显示的黄金路径。2.4main.js.bak和main.css.bak是环境隔离的关键证据这两个.bak文件的存在说明项目经历过环境切换调试。main.js.bak里注释掉了 Axios 的 base URL// main.js.bak 片段已注释 // axios.defaults.baseURL https://dev-api.example.com; axios.defaults.baseURL http://localhost:8080;而main.css.bak里保留了旧版 Element UI 的主题变量/* main.css.bak 片段 */ /* $--color-primary: #409EFF; */ $--color-primary: #1890ff;这证明开发者曾为适配微信小程序的视觉规范手动覆盖了 Element UI 默认色值。如果你要部署到测试环境记得同步修改main.js.bak中的baseURL并取消注释——否则所有请求都会发向localhost导致 404。3..bat脚本不是摆设1-install.bat里藏着三个必须手动干预的坑这三个批处理文件是项目能否跑起来的第一道门槛。表面看只是封装了npm install、npm run serve和npm run build但.bat里埋了针对 Windows 开发环境的硬编码路径和版本约束。跳过这步直接npm run serve90% 的人会卡在「找不到 webpack-dev-server」或「node-sass 编译失败」。3.11-install.bat必须手动改node_modules权限脚本第一行是echo off cd /d %~dp0 npm install --registry https://registry.npm.taobao.org pause问题在于%~dp0指向当前.bat所在目录但若你把整个项目解压到D:\毕设\wx-student-system而1-install.bat在src子目录下cd /d %~dp0就会切到src目录而非项目根目录导致npm install在错误位置创建node_modules。血泪经验打开1-install.bat把第二行改成绝对路径cd /d D:\毕设\wx-student-system然后保存。否则npm run serve会报错Cannot find module vue——因为node_modules被装进了src/node_modules。3.2node-sass版本必须锁死为4.14.1package.json中node-sass: ^4.14.1的^符号会导致 npm 安装5.x版本而5.x不兼容 Node.js 14 以下版本毕设常用 Node.js 12。1-install.bat执行后务必手动执行npm uninstall node-sass npm install node-sass4.14.1 --save-dev提示node-sass4.14.1对应 Python 2.7 和 Visual Studio Build Tools 2015。如果你用的是 Windows 10 新系统需提前安装 Microsoft C Build Tools 否则编译会卡在gyp ERR! build error。3.3axios必须替换为uni-app兼容版原项目用axios发请求但微信小程序环境不支持XMLHttpRequest。1-install.bat安装完依赖后必须手动替换npm uninstall axios npm install uni-app-axios --save并在src/utils/request.js中改写// 替换前axios import axios from axios; // 替换后uni-app-axios import request from uni-app-axios;否则2-run.bat启动后所有接口调用都会返回TypeError: Cannot read property get of undefined——这是小程序里最典型的「跨平台请求未适配」翻车现场。4. 避坑SSM 后端启动失败的五个高频现象与根因定位法前端.bat脚本能跑不代表整个系统可用。SSM 后端spring-boot或传统web.xml方式才是数据中枢。以下五条是某导师指导 32 届毕设时统计出的最高频启动失败场景每条都附带现象 → 原因 → 解决的闭环排查路径。4.1 现象2-run.bat启动后控制台快速闪退日志无任何错误原因JDK 版本不匹配。项目基于 JDK 1.8 编译但你的环境是 JDK 11java -version显示11.0.20。spring-webmvc-5.2.22.RELEASE.jar中的HandlerMethodReturnValueHandlerComposite类在 JDK 11 下存在字节码兼容性问题。解决下载 JDK 1.8u202非最新版设置JAVA_HOME指向该路径并在2-run.bat开头强制指定echo off set JAVA_HOMED:\jdk1.8.0_202 set PATH%JAVA_HOME%\bin;%PATH% cd /d %~dp0.. mvn spring-boot:run4.2 现象后端启动成功但小程序访问/api/login返回 404原因SpringMVC 的RequestMapping路径未加/api前缀。查看LoginController.java发现方法上写的是PostMapping(/login)但WebMvcConfigurer中未配置addResourceHandler映射/api/**到DispatcherServlet。解决在WebConfig.java中添加Override public void configureHandlerExceptionResolvers(ListHandlerExceptionResolver resolvers) { // 确保 DispatcherServlet 处理 /api/** 请求 } // 并确认 web.xml 中 servlet-mapping 为 // url-pattern/api/*/url-pattern4.3 现象登录成功但进入「学生管理」页时提示No mapping found for HTTP request with URI [/student/list]原因Vue Router 的mode: history与后端静态资源路径冲突。小程序构建后index.html被放在static目录下但2-run.bat启动的 Tomcat 默认不将/student/list重写到index.html。解决在web.xml中添加UrlRewriteFilter配置或更简单——把 Vue Router 改为mode: hash// router/index.js const router new Router({ mode: hash, // 原为 history routes: [...] });4.4 现象数据库连上了但「师生双选」列表为空日志显示org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)原因MyBatis 的Mapper.xml文件未被 Maven 正确打包。pom.xml中缺少resources配置导致StudentMapper.xml没进classes目录。解决在pom.xml的build节点下添加resources resource directorysrc/main/java/directory includes include**/*.xml/include /includes /resource /resources4.5 现象所有接口返回 200但数据全是null例如{ code: 200, data: null, msg: success }原因ResponseBody注解未生效Jackson 序列化器未识别实体类字段。检查Student.java发现所有属性都是private String name;但缺少JsonProperty或JsonInclude(JsonInclude.Include.NON_NULL)。解决在Student.java顶部加JsonInclude(JsonInclude.Include.NON_NULL) public class Student implements Serializable { private static final long serialVersionUID 1L; JsonProperty(student_id) private Long id; // 其他字段同理 }5. 把「开题答辩管理」模块拆出来复用四步提取独立功能单元很多同学想复用「开题答辩管理」但不敢动怕牵一发而动全身。其实这个模块高度内聚它有自己的 Controller、Service、Mapper、Vue 页面和数据库表。我一般会用四步把它完整剥离变成可插拔的独立模块。5.1 第一步锁定数据库表结构open_topic.sql项目没提供 SQL 文件但从OpenTopicMapper.xml可逆向出建表语句CREATE TABLE open_topic ( id bigint(20) NOT NULL AUTO_INCREMENT, student_id bigint(20) NOT NULL COMMENT 学生ID, teacher_id bigint(20) DEFAULT NULL COMMENT 指导教师ID, title varchar(200) NOT NULL COMMENT 题目, status tinyint(1) NOT NULL DEFAULT 0 COMMENT 状态0-待提交1-已提交2-已通过3-未通过, submit_time datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_student (student_id), KEY idx_teacher (teacher_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;注意status字段用tinyint而非enum是为了方便后期扩展状态比如加「修改中」「重新提交」。这是 SSM 项目里常见的「用整数代替枚举」的务实做法。5.2 第二步提取OpenTopicController.java并改造跨域原 Controller 有CrossOrigin注解但只允许http://localhost:8080。微信小程序要求https协议所以必须放开// OpenTopicController.java CrossOrigin(origins *, allowCredentials true) RestController RequestMapping(/api/open-topic) public class OpenTopicController { // 方法保持不变 }同时在application.yml中关闭 Spring Security 的 CSRF小程序无 Cookie 会话security: csrf: enabled: false5.3 第三步复制 Vue 页面并重命名路由把src/views/open-topic/整个目录复制到你的新项目然后修改router/index.js{ path: /open-topic, name: OpenTopic, component: () import(/views/open-topic/OpenTopicList.vue), meta: { title: 开题管理, icon: document } }关键点meta.title必须和BreadCrumbs.vue.bak的解析逻辑一致否则面包屑不显示。5.4 第四步用mybatis-generator一键生成 Mapper如果你的数据库表名是open_topic运行mybatis-generator后会生成OpenTopic.java实体类OpenTopicMapper.java接口OpenTopicMapper.xmlSQL 映射然后把生成的OpenTopicMapper.xml中的select语句对照原项目的OpenTopicMapper.xml补上resultMap和collection关联查询比如关联学生姓名resultMap idOpenTopicWithStudent typeOpenTopic id propertyid columnid/ result propertytitle columntitle/ association propertystudent javaTypeStudent id propertyid columns_id/ result propertyname columns_name/ /association /resultMap这样OpenTopicList.vue里this.list就能直接访问item.student.name不用再写额外的findStudentById接口。6. 验证「学生过程文档管理」是否真能归档用 Postman 模拟上传并校验存储路径「过程文档管理」常被写成空壳——前端点上传按钮后端只存个文件名到数据库文件本体却没落地。要验证它是否真实可用不能只看界面得用 Postman 拦截请求看文件到底存哪了。6.1 抓包定位上传接口和参数在小程序「学生过程文档」页点击「上传开题报告」用 Charles 或 Fiddler 抓包找到请求POST /api/document/upload Content-Type: multipart/form-data; boundary----WebKitFormBoundary7MA4YWxkTrZu0gWBody 中关键字段file: 二进制文件流PDFstudentId: 1001type: proposal 开题报告类型注意type是后端用来分目录的依据不是随便写的字符串。6.2 查看后端DocumentController.java的存储逻辑找到对应方法PostMapping(/upload) public Result upload(RequestParam(file) MultipartFile file, RequestParam(studentId) Long studentId, RequestParam(type) String type) { String uploadPath D:/upload/ type / studentId /; File dir new File(uploadPath); if (!dir.exists()) dir.mkdirs(); String fileName System.currentTimeMillis() _ file.getOriginalFilename(); file.transferTo(new File(uploadPath fileName)); // 保存到数据库... }这里暴露了真实存储路径D:/upload/proposal/1001/。去 Windows 资源管理器里打开这个路径如果能看到1712345678901_kaiti-baogao.pdf说明文件真落地了。6.3 验证下载链接是否可访问上传成功后接口返回的 JSON 中有downloadUrl字段例如{ downloadUrl: http://localhost:8080/api/document/download?pathproposal/1001/1712345678901_kaiti-baogao.pdf }把这个 URL 粘贴到浏览器如果能直接下载 PDF说明DocumentController.download()方法正确配置了response.setContentType(application/pdf)和response.setHeader(Content-Disposition, attachment; filename fileName)。6.4 最后一步检查数据库记录是否带完整路径查document表path字段值应该是proposal/1001/1712345678901_kaiti-baogao.pdf而不是1712345678901_kaiti-baogao.pdf。前者是相对路径配合 Nginx 静态资源配置可直接对外提供服务后者是纯文件名意味着后端还得拼接D:/upload/极易出错。从那以后我每次验证文档模块都强制走一遍「Postman 上传 → 资源管理器查文件 → 浏览器下载 → 数据库查 path 字段」四步闭环。少走一步上线后就可能遇到「学生说传了文件老师说看不到」这种扯皮问题。希望帮到你。本文还有配套的精品资源点击获取
平方复杂度无法被常规优化消除｜TaoToken 统一 Key 通道实测)
