简介一套基于微信小程序的学生签到系统毕业设计源码包面向高校计算机相关专业毕业设计、课程设计及小程序开发入门者。系统分为管理员、教师、学生三个角色覆盖班课签到、学生签到、请假审批、销假管理等完整业务闭环管理员可在后台维护学生、教师及各类签到数据教师可发布签到、管理班课、审批请假并查看学生签到学生则可加入班课、查看签到、提交请假并完成销假。包体内共1088个文件以Java后端、Vue/JS前端、WXML/WXSS小程序页面、PNG/SVG静态资源及SQL数据库脚本为主体整体约18.8MB另附部署脚本与说明文档便于快速搭建运行环境。目前已有93人浏览学习。整套代码前后端分层清晰数据库设计完整并给出JDK1.8、MySQL5.7、Tomcat7、Maven3.3等环境配置可作为毕业设计答辩演示或小程序开发练手的直接参考资料。1. 学生签到系统毕设源码先搞清楚这份 zip 里有什么、能不能跑第一次拿到这份【微信小程序毕业设计】学生签到系统设计与实现源码java小程序mysqlLW.zip 时先别急着解压。这是一套典型的毕设三件套微信小程序做前端、Java 写后端接口、MySQL 存数据再加一份 LW 论文文档。它解决的是学生考勤这个刚需场景——老师发起签到、学生定位打卡、后台按课程统计出勤。想快速交付毕设的同学可以直接在上面改字段换皮想搭考勤原型的开发者也能把签到逻辑抽出来复用。全文按我平时落地的顺序走先拆包核对环境再建库启动然后跑通签到流程最后把答辩前踩过的坑和改造思路一次性讲清楚。2. 从 zip 到能运行拆包、建库、启动 Java 后端2.1 先看目录结构前后端与论文文档的常见布局拿到压缩包第一件事不是看代码而是看顶层目录。毕设源码包常见布局是backend或server、java放 Spring Boot 工程miniprogram或pages放微信小程序前端database或根目录下的.sql文件是初始化脚本LW文件夹里是论文 Word 文档和答辩 PPT。先花十分钟把 README 读一遍很多包即使写了 README 也写得非常潦草甚至没有版本说明所以我的习惯是按下面的清单核对缺什么补什么JDK 版本项目是 1.8 还是 11、17看pom.xml里java.version最准。构建工具Maven 还是 Gradle毕设九成是 Maven用 IDEA 打开pom.xml让它自己拉依赖。数据库版本脚本里有ENGINEInnoDB不代表 5.7 和 8.0 都能直接用重点看有没有utf8mb4、CURRENT_TIMESTAMP这类兼容性字段。前端目录里有没有node_modules有说明作者直接放了依赖没有就正常小程序端用微信开发者工具编译时会自动处理。LW 论文的章节重点看“系统设计”“数据库设计”“核心代码实现”三章答辩时评委大概率照着这些章节问。版本对不上是毕设翻车的第一大来源。我见过好几次包里的pom.xml写着 Java 8但 LW 论文截图里是 Java 11 的启动日志答辩时被当场抓包。所以拿到包先统一版本再往下走。2.2 建库建表签到系统的三张核心表签到系统不管前端怎么变后端永远绕不开三张表用户表、课程表、签到记录表。用户表区分学生和教师角色课程表维护每次签到对应的课程上下文签到记录表存每一次打卡行为。毕设的进阶版还会加一张选课表用来限制“这门课只有选课学生能签”。但多数基础版就三张表这里给出一个我常用的建表脚本字段命名和 LW 里的 E-R 图保持一致会省很多事CREATE DATABASE IF NOT EXISTS sign_system DEFAULT CHARACTER SET utf8mb4; USE sign_system; -- 用户表学生/老师共用用 role 字段区分 CREATE TABLE t_user ( id INT NOT NULL AUTO_INCREMENT, openid VARCHAR(64) NOT NULL COMMENT 微信小程序登录后的 openid, username VARCHAR(32) DEFAULT COMMENT 姓名, student_no VARCHAR(20) DEFAULT COMMENT 学号, phone VARCHAR(20) DEFAULT COMMENT 手机号, role TINYINT DEFAULT 0 COMMENT 0学生 1教师, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_openid (openid) ) ENGINEInnoDB COMMENT用户表; -- 课程表签到任务依附于课程 CREATE TABLE t_course ( id INT NOT NULL AUTO_INCREMENT, course_name VARCHAR(64) NOT NULL COMMENT 课程名称, teacher_id INT NOT NULL COMMENT t_user.id, latitude DECIMAL(10,6) DEFAULT NULL COMMENT 签到允许的纬度, longitude DECIMAL(10,6) DEFAULT NULL COMMENT 签到允许的经度, radius INT DEFAULT 200 COMMENT 允许签到半径单位米, start_time DATETIME DEFAULT NULL COMMENT 签到开始时间, end_time DATETIME DEFAULT NULL COMMENT 签到截止时间, PRIMARY KEY (id) ) ENGINEInnoDB COMMENT课程表; -- 签到记录表一次签到一行 CREATE TABLE t_sign_record ( id INT NOT NULL AUTO_INCREMENT, course_id INT NOT NULL COMMENT 课程id, user_id INT NOT NULL COMMENT 用户id, sign_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT 签到时间, latitude DECIMAL(10,6) DEFAULT NULL COMMENT 签到时的纬度, longitude DECIMAL(10,6) DEFAULT NULL COMMENT 签到时的经度, status TINYINT DEFAULT 1 COMMENT 1正常 0异常, PRIMARY KEY (id), UNIQUE KEY uk_course_user_date (course_id, user_id, sign_time) ) ENGINEInnoDB COMMENT签到记录表;参数上有个容易踩坑的地方DECIMAL(10,6)存经纬度足够了吗足够。微信wx.getLocation返回的经纬度精度是小数点后 6 位约等于 0.1 米再高就是噪声。radius字段我习惯同时存在课程表里因为不同课程对签到范围要求不一样——机房课 50 米操场课 300 米写死在代码里换课就要改代码。uk_course_user_date这个唯一索引是防重复签到的最粗防线但注意sign_time带时分秒同一天不同时间再签一次是插不进去的真正“按天防重复”的逻辑要在代码里做索引只防同一瞬间的并发重复。2.3 启动 Java 后端application.yml 里四个容易翻车的配置项Spring Boot 项目启动前先把application.yml过一遍。毕设后端最常见的组合是 Spring Boot MyBatis配置文件里真正决定能不能跑起来的就四个东西端口、数据源、MyBatis 映射路径、微信小程序配置。以一个多环境写法为例server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/sign_system?useUnicodetruecharacterEncodingutf8mb4useSSLfalseserverTimezoneAsia/ShanghaiallowPublicKeyRetrievaltrue username: root password: 123456 # 如果用的是 MySQL 5.7驱动可以换回 com.mysql.jdbc.Driver但 cj 驱动向下兼容 mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.example.sign.entity configuration: map-underscore-to-camel-case: true wechat: appid: wx你的appid secret: 你的secret # 这个配置不是 Spring 标准项是项目里自定义的注意读代码里的 ConfigurationProperties四个坑按频次排序第一serverTimezoneAsia/Shanghai不写MySQL 8 会报时区错误Java 8 以下还会出现日期差 8 小时。第二useSSLfalse不写新版 MySQL 驱动默认开 SSL本地连不上还疯狂报 TLS 握手失败。第三allowPublicKeyRetrievaltrue是 MySQL 8 非 SSL 连接的专属设置不加上去启动时直接报Public Key Retrieval is not allowed如果是 MySQL 5.7 写这个参数也没事。第四map-underscore-to-camel-case必须显式打开否则student_no映射不到studentNo字段查询结果全是 null这个报错隐蔽到很多时候要一行行打日志才能发现。如果你还没装 MySQL先按常规的 mysql 安装教程把 5.7 或 8.0 装好再执行 2.2 的建表脚本。然后回到项目根目录IDEA 里执行mvn clean package -DskipTests java -jar target/sign-system-0.0.1-SNAPSHOT.jar如果不想打包直接mvn spring-boot:run也行。启动日志里看到Started Application in x.xxx seconds就算成功。打开浏览器访问http://localhost:8080/swagger-ui.html有 Swagger 的话或直接访问你自己写的一个测试接口确认后端活了再动小程序端。2.4 小程序端导入AppID、合法域名与顶部导航栏高度后端启动后打开微信开发者工具导入miniprogram目录。这一步有三件事容易卡住AppID 选择、合法域名配置、自定义导航栏高度计算。个人开发者在没有企业认证的情况下做毕设直接用测试号也能跑只是wx.login拿到的 openid 是测试环境的真机预览时部分接口受限。有自己注册的小程序账号就填自己的 AppID正式一点。合法域名是新手最容易忽略的坑。开发者工具里勾选“不校验合法域名”确实能在本地跑通但一到真机预览所有wx.request全部报url not in domain list。这是因为微信限制小程序的请求域名必须是 HTTPS 且在小程序后台配置过。毕设阶段解决方式有三种后端本地用http://localhost:8080配合开发者工具的不校验选项或者用内网穿透把本机端口映射成 HTTPS 域名最省事的办法是后端部署到云服务器配上 HTTPS 证书。注意个人主体小程序不支持配置本地 IP 域名只能走测试号或企业主体。自定义导航栏是微信小程序顶部导航栏的经典问题。默认导航栏没办法改背景色到想要的效果很多毕设会改成自定义导航栏但自定义之后页面顶部多出来的安全区域是多少我一般这样算// 在自定义导航栏的页面里获取顶部高度 const windowInfo wx.getWindowInfo() const menuRect wx.getMenuBoundingClientRect() Page({ data: { navHeight: 0 }, onLoad() { // 导航栏高度 状态栏高度 胶囊按钮高度 上下间距 const navHeight windowInfo.statusBarHeight menuRect.height (menuRect.top - windowInfo.statusBarHeight) * 2 this.setData({ navHeight }) } })wx.getWindowInfo是基础库 2.20.1 以后推荐的 API替代了老的wx.getSystemInfoSync。menuRect.top - windowInfo.statusBarHeight算的是胶囊按钮距离状态栏底部的高度差乘以 2 是因为胶囊上下间距对称。这套公式在 iPhone 和 Android 上表现一致比写死 64px 靠谱得多。拿到高度后页面的padding-top或height直接用navHeight变量不同机型就不会出现顶部遮挡。3. 把签到流程跑通登录、定位打卡与后端接口对接3.1 微信登录wx.login 换 openid获取手机号的现实选择签到系统的第一个接口永远是登录。小程序端wx.login只能拿到一个临时 code后端拿这个 code 去微信服务器换 openid 和 session_key。这段逻辑在毕业设计里几乎是模板代码但每个学生都会在这里卡一次因为wx.login的 code 只能用一次而且后端请求微信接口有超时和频控。我常用的 Java 实现是这样的// 登录接口小程序传 code后端换 openid RestController RequestMapping(/api/auth) public class AuthController { Resource private RestTemplate restTemplate; Value(${wechat.appid}) private String appid; Value(${wechat.secret}) private String secret; PostMapping(/login) public Result login(RequestBody LoginRequest req) { // 1. code 换 openid String url https://api.weixin.qq.com/sns/jscode2session?appid appid secret secret js_code req.getCode() grant_typeauthorization_code; MapString, Object resp restTemplate.getForObject(url, Map.class); if (resp null || resp.get(errcode) ! null) { // 常见code 过期5分钟、重复使用、appid 和 secret 不匹配 return Result.error(微信登录失败 resp); } String openid (String) resp.get(openid); // 2. 查库没有就新插入 User user userMapper.selectByOpenid(openid); if (user null) { user new User(); user.setOpenid(openid); user.setRole(0); // 默认学生 userMapper.insert(user); } // 3. 生成自己的 token后续接口带这个 token String token UUID.randomUUID().toString().replace(-, ); redisUtil.set(token, user.getId(), 7 * 24 * 60 * 60); // 单位秒 return Result.ok().put(token, token).put(userId, user.getId()); } }三个参数值得单独说js_code有效期只有 5 分钟且换过一次就失效所以前端不能反复调用同一个 codegrant_type是固定值写错直接返回invalid grant_typeRestTemplate在这里是同步请求并发量大时建议换成带连接池的实现但毕设流量根本到不了这个瓶颈别在这过度设计。关于“微信小程序登录获取手机号”很多毕设需求里写的是“微信授权手机号登录”但现实中这条路有门槛getPhoneNumber按钮的open-type在个人主体小程序里拿不到真实手机号微信要求非个人主体才能使用该能力返回值通常是errMsg: getPhoneNumber:fail no permission。所以我的建议是毕设里不要执着于“必须拿到手机号”用 openid 做账号主体手机号做成“绑定”操作——如果 LW 论文里写了手机号登录功能就在个人中心页面加一个手动输入手机号的表单这样答辩时既演示了功能又不被微信平台的认证限制卡死。把这一步写进论文的“系统局限性”章节反而是加分项。3.2 签到接口后端如何校验经纬度与防重复签到签到接口是整个系统的核心逻辑不复杂但三个边界一定要处理好距离校验、时间窗口、防重复。距离校验的常见做法是后端拿到课程表里预设的经纬度和半径再和学生上报的经纬度做一次 Haversine 公式算距离。为什么不前端算因为前端算的距离可以被篡改locals 改一下就能在地图外签到后端的经纬度才是可信数据。PostMapping(/sign) public Result sign(RequestBody SignRequest req, RequestHeader(token) String token) { // 1. token 换用户 Integer userId (Integer) redisUtil.get(token); if (userId null) { return Result.error(401, 登录过期请重新进入小程序); } // 2. 查课程校验时间段 Course course courseMapper.selectById(req.getCourseId()); if (course null) { return Result.error(课程不存在); } Date now new Date(); if (now.before(course.getStartTime()) || now.after(course.getEndTime())) { return Result.error(当前不在签到时间段内); } // 3. 防重复当天同一课程只允许签一次 int count signRecordMapper.countByUserAndCourseAndDate( userId, req.getCourseId(), new java.sql.Date(now.getTime())); if (count 0) { return Result.error(你今天已经签到过了); } // 4. 距离校验计算两点经纬度距离 double distance distance( course.getLatitude(), course.getLongitude(), req.getLatitude(), req.getLongitude()); if (distance course.getRadius()) { return Result.error(你不在签到范围内距离签到点约 (int) distance 米); } // 5. 写入签到记录 SignRecord record new SignRecord(); record.setCourseId(req.getCourseId()); record.setUserId(userId); record.setLatitude(req.getLatitude()); record.setLongitude(req.getLongitude()); signRecordMapper.insert(record); return Result.ok(签到成功).put(signTime, now); } // Haversine 公式返回距离单位米 private double distance(double lat1, double lon1, double lat2, double lon2) { double radLat1 Math.toRadians(lat1); double radLat2 Math.toRadians(lat2); double a radLat1 - radLat2; double b Math.toRadians(lon1) - Math.toRadians(lon2); double s 2 * Math.asin(Math.sqrt( Math.pow(Math.sin(a / 2), 2) Math.cos(radLat1) * Math.cos(radLat2) * Math.pow(Math.sin(b / 2), 2) )); return s * 6371000; }countByUserAndCourseAndDate这个查询看着简单但 SQL 里日期比较是个坑如果表里sign_time是DATETIME类型直接用WHERE sign_time CURDATE()会因为带时分秒而查不到数据。正确写法是WHERE DATE(sign_time) #{date}或者WHERE sign_time BETWEEN 2024-05-20 00:00:00 AND 2024-05-20 23:59:59。DATE()函数会导致索引失效但在不失一般性下毕设单表数据量也就几万行全表扫描也不慢为了查询方便用DATE()完全能接受。距离阈值course.getRadius()的单位是米前端给用户提示时也按米展示。这个字段存 200意思是以课程坐标为圆心、200 米为半径的圆内都算有效签到。要注意的是GPS 信号在室内会漂移尤其是一楼靠窗的位置可能偏出几十米导致学生明明在教室里却签到失败。后端的解决思路是把radius放大到 150~300 米而不是改成“不做距离校验”——不加距离校验的签到系统答辩时会被评委一句话问穿。3.3 签到记录与统计一条 SQL 看全出勤签到数据积累之后LW 论文里“数据统计分析”章节就需要 SQL 支撑。最常用的两个查询一个是某门课程某天的签到明细一个是某位学生的出勤率统计。明细查询注意多表关联时分页别遗漏 count 查询-- 某个课程在某个时间段的签到明细 SELECT u.student_no AS 学号, u.username AS 姓名, c.course_name AS 课程, s.sign_time AS 签到时间, s.latitude AS 纬度, s.longitude AS 经度 FROM t_sign_record s LEFT JOIN t_user u ON s.user_id u.id LEFT JOIN t_course c ON s.course_id c.id WHERE s.course_id 1 AND s.sign_time BETWEEN 2024-05-20 00:00:00 AND 2024-05-20 23:59:59 ORDER BY s.sign_time; -- 学生出勤率统计某学生在所有课程里的签到占比 SELECT c.course_name AS 课程, COUNT(s.id) AS 已签到次数, -- 这里的 18 是每门课的应到次数毕设里可以直接写死也可以用子查询算 COUNT(s.id) / 18 * 100 AS 出勤率 FROM t_course c LEFT JOIN t_sign_record s ON c.id s.course_id AND s.user_id 5 GROUP BY c.id, c.course_name;注意第二个查询的LEFT JOIN里带了s.user_id 5条件。为什么不写在WHERE里因为写在WHERE里会把LEFT JOIN变成INNER JOIN没签过到的课程行会直接消失统计结果就少了数据。这是 SQL 里常见的条件位置陷阱答辩时如果评委看到这条 SQL问一句“为什么条件在 JOIN 后面”你能答上来会非常加分。3.4 前后端联调从按钮到状态回填的完整数据流把前后端串起来看一遍完整流程小程序端页面加载时先检查本地有没有 token没有就调用wx.login拿 code 调后端登录接口拿到 token 后存入wx.setStorageSync后续所有wx.request都在 header 里带token。签到页的核心逻辑放在onLoad里sign() { // 1. 先检查登录态 const token wx.getStorageSync(token) if (!token) { this.loginFirst() // 内部调用 wx.login 并缓存 token return } // 2. 获取当前定位 wx.getLocation({ type: gcj02, success: (res) { // 3. 调签到接口 wx.request({ url: ${app.globalData.baseUrl}/api/sign, method: POST, header: { token }, data: { courseId: this.data.courseId, latitude: res.latitude, longitude: res.longitude }, success: (resp) { if (resp.data.code 0) { wx.showToast({ title: 签到成功, icon: success }) this.refreshSignStatus() // 4. 刷新为已签到状态 } else { wx.showToast({ title: resp.data.msg, icon: none }) } } }) }, fail: () { wx.showToast({ title: 定位失败请检查手机定位权限, icon: none }) } }) }这段代码里wx.getLocation的type: gcj02是个关键参数。gcj02是国测局坐标系微信接口返回的经纬度默认是gcj02。如果你后端存的是从地图上拾取的坐标比如用腾讯地图拾取器拿到的教室位置那两边都是gcj02直接算距离没问题。如果后端存的是wgs84GPS 原生坐标系或高德的坐标两边存在几十到几百米的偏移算出来的距离会莫名其妙偏大后面避坑章节详说。状态回填这块经验是不要用wx.showToast之后直接改 data因为签到接口返回成功但列表数据可能还没有更新。正确顺序是接口成功 - 重新拉取签到记录列表 - 用列表数据驱动页面渲染。这样后端如果有补签、异常签到的状态前端展示也会跟着变不会出现“提示成功但我的签到列表里没有”这种让人觉得系统有 bug 的场景。4. 毕业设计签到系统避坑手册五个翻车现场与排查思路4.1 后端能启动小程序请求却 404 / 405现象后端启动日志正常Swagger 也能看到接口但小程序里发wx.request总是返回 404 或 405控制台打印的 URL 看着也没问题。原因九成是路径对不上三处最容易不一致——RequestMapping写的类路径是/api/auth方法路径是/login但小程序请求拼的是/api/auth/login/多了个斜杠或者后端接口是 POST小程序请求方法写成了GETSpring Boot 会返回 405。剩下还有一层是静态资源拦截如果你用了自定义拦截器且没在拦截器里放行/api/**请求根本到不了 Controller。解决先打开微信开发者工具的 Network 面板看请求的 URL 完整值和响应体内容。然后去后端启动日志里找访问记录Spring Boot 默认会打印Tomcat started on port(s): 8080但不会打印每个请求。最直接的排查是加一个简单粗暴的全放行配置确认接口没逻辑问题后再按路径收紧。还有个很少人注意的点如果后端配了server.servlet.context-path: /sign那所有接口都要带/sign前缀前端 baseUrl 很容易漏这个。4.2 MySQL 连接报 Public Key Retrieval is not allowed现象后端启动时数据源初始化失败日志堆栈里有Public Key Retrieval is not allowed或者是Unable to load authentication plugin caching_sha2_password。这个问题在我带的学生里出现频率极高尤其是在他们照着 mysql 安装教程装了 MySQL 8.0 之后。原因MySQL 8.0 默认的认证插件是caching_sha2_password而很多毕设项目是从 MySQL 5.7 迁移过来的驱动连接串里没有处理公钥检索的参数。JDBC 驱动第一次连接时会尝试从服务器获取公钥做 RSA 加密如果连接串没允许这个行为就报错。解决最省事的是在 JDBC 连接串末尾加allowPublicKeyRetrievaltrue我在 2.3 的配置里就是加了这个参数。另一种方案是把用户密码认证改回旧协议在 MySQL 里执行ALTER USER rootlocalhost IDENTIFIED WITH mysql_native_password BY 你的密码; FLUSH PRIVILEGES;。两个选一个即可毕设项目不需要纠结用哪种认证更安全能跑通才是第一诉求。4.3 模拟器定位正常真机签到距离偏差几百米现象在微信开发者工具里模拟定位到课程坐标附近能正常签到换到真机预览人在教室里后端却提示“不在签到范围内距离约 300 米”。原因坐标坐标系不对。开发者工具的模拟位置默认是gcj02火星坐标系但你从第三方地图尤其是 GPS 设备或高德开放平台拿到的教室坐标可能是wgs84或 GCJ-02 偏移后的结果。真机上wx.getLocation返回的原始 GPS 坐标是wgs84微信内部转换成gcj02才返回给你。如果后端课程表存的是wgs84前端拿到gcj02经纬度传过来两边坐标系不同距离自然偏百八十米。解决统一坐标系。推荐后端一律存gcj02前端调wx.getLocation时显式指定type: gcj02。如果课程坐标只能拿到wgs84可以在后端写一个坐标转换工具类地图库里常见原理是七参数变换签到入库前把客户端上报的gcj02转成wgs84再算距离。判断到底是不是坐标系问题最简单的办法是把后端返回的课程经纬度在小程序里用wx.openLocation打开看一眼如果地图上的点和你预期位置偏差明显那几乎可以确定是坐标来源不统一。4.4 论文 LW 文档写的功能代码里根本没有现象LW 论文的“功能模块”章节写了“支持课表导入”“支持签到数据 Excel 导出”“支持补签申请”但代码里翻遍 Controller 都找不到对应接口。答辩时评委照着论文目录提问学生不知道对应代码在哪场面非常尴尬。原因毕设源码包是不同渠道流出的论文和新代码版本脱节是常态。有些源码包本身就是从老项目改来的LW 文档甚至是作者从别处拼的根本没和代码对齐过。解决收到包后先按 LW 论文的目录结构做一张功能清单逐个对照代码里是否有对应页面和接口。论文写了但代码没有的要么删掉论文段落要么补一个最小实现。补实现优先做展示型功能比如“导出 Excel”只需要在 Controller 里加一个导出方法用EasyExcel或POI写几十行代码就能跑。我的原则是论文里出现过的名词必须能在代码里找到对应的类或接口名找不到就二选一——改论文别改到一半再来追债。这个对齐工作建议在答辩前两周就完成不要拖到前三天。4.5 Maven 依赖拉不动启动都进不去现象IDEA 打开项目后pom.xml大片飘红依赖下载报超时或者项目能编译但运行时报ClassNotFoundException。还有一种是本地装了两个 JDK项目用 11 写的但你默认环境是 8启动直接报UnsupportedClassVersionError。原因Maven 中央仓库的访问问题在国内环境一直存在虽然现在是多仓库镜像但毕设项目里可能有冷门依赖只存在某个特定仓库。JDK 版本问题则纯粹是环境变量没对齐。解决Maven 换成阿里云镜像在~/.m2/settings.xml里加mirror指向alimaven。JDK 版本的坑用 IDEA 的 Project Structure 把 Project SDK 和 Modules language level 都设成统一版本。如果项目里用了javax.*的包Java 9 以后模块系统移除了一部分类这种直接建议把 JDK 降到 8 跑别升级——毕业设计项目不值得你去兼容新 JDK 的坑。启动前在命令行执行java -version确认和pom.xml里的java.version一致这一步能省下大半天的排查时间。5. 把这套签到系统改出原创感加字段、加页面、答辩演示的验证路径源码包直接交上去答辩风险很大——评委见过太多一模一样的界面。但改动不需要伤筋动骨在现有架构上加“差异化功能”是性价比最高的路径。我最推荐加三个东西签到数据报表页、二维码签到、补卡申请。报表页是最容易出效果的后端写一个按课程分组统计出勤率的接口前端用ec-canvas画柱状图不需要太复杂一个课程对比图就能撑起“数据可视化”这个论文小节。二维码签到需要动态生成带课程 ID 的二维码小程序端用canvas绘制老师端展示二维码学生扫码后跳转到带参数的小程序页面在onLoad里读取options.courseId完成签到。这个功能工作量不大但答辩演示时的“老师扫码”场景非常抓眼球。补卡申请纯粹是表结构扩展。签到记录表加一个status字段0 表示迟到、1 表示正常、2 表示补卡再加一张t_sign_apply补卡申请表就行。后端补一个POST /api/sign/apply接口接收用户 ID、课程 ID、补卡理由老师端列表接口加一个GET /api/sign/apply/list用于审核。代码量很小但在系统功能图里能多画两个模块。验证路径上我每次改完都会做一个固定动作用 Postman 把登录、签到、查询三个接口按顺序跑一遍签到接口故意传两个相差较大的经纬度确认能触发“不在签到范围”的提示然后回到小程序开发者工具走一遍真机预览重点看定位权限弹窗和导航栏高度。这里有一条血泪经验演示前一天一定用真机跑一遍模拟器不会暴露经纬度漂移和获取手机号的权限问题这两样在答辩现场是“翻车率”最高的两个点。最后一个习惯是我从带毕设学生开始就坚持的把 LW 论文的功能清单打印出来在每项后面标上代码里的 Controller 类名和页面路径答辩前拿着这张纸从头到尾过一遍能做到“评委指到论文哪一行你就能翻开 IDE 跳到对应代码”。这套方法帮我带的学生避开了绝大多数临场翻车。希望帮到你。本文还有配套的精品资源点击获取
简介一套基于微信小程序的学生签到系统毕业设计源码包面向高校计算机相关专业毕业设计、课程设计及小程序开发入门者。系统分为管理员、教师、学生三个角色覆盖班课签到、学生签到、请假审批、销假管理等完整业务闭环管理员可在后台维护学生、教师及各类签到数据教师可发布签到、管理班课、审批请假并查看学生签到学生则可加入班课、查看签到、提交请假并完成销假。包体内共1088个文件以Java后端、Vue/JS前端、WXML/WXSS小程序页面、PNG/SVG静态资源及SQL数据库脚本为主体整体约18.8MB另附部署脚本与说明文档便于快速搭建运行环境。目前已有93人浏览学习。整套代码前后端分层清晰数据库设计完整并给出JDK1.8、MySQL5.7、Tomcat7、Maven3.3等环境配置可作为毕业设计答辩演示或小程序开发练手的直接参考资料。1. 学生签到系统毕设源码先搞清楚这份 zip 里有什么、能不能跑第一次拿到这份【微信小程序毕业设计】学生签到系统设计与实现源码java小程序mysqlLW.zip 时先别急着解压。这是一套典型的毕设三件套微信小程序做前端、Java 写后端接口、MySQL 存数据再加一份 LW 论文文档。它解决的是学生考勤这个刚需场景——老师发起签到、学生定位打卡、后台按课程统计出勤。想快速交付毕设的同学可以直接在上面改字段换皮想搭考勤原型的开发者也能把签到逻辑抽出来复用。全文按我平时落地的顺序走先拆包核对环境再建库启动然后跑通签到流程最后把答辩前踩过的坑和改造思路一次性讲清楚。2. 从 zip 到能运行拆包、建库、启动 Java 后端2.1 先看目录结构前后端与论文文档的常见布局拿到压缩包第一件事不是看代码而是看顶层目录。毕设源码包常见布局是backend或server、java放 Spring Boot 工程miniprogram或pages放微信小程序前端database或根目录下的.sql文件是初始化脚本LW文件夹里是论文 Word 文档和答辩 PPT。先花十分钟把 README 读一遍很多包即使写了 README 也写得非常潦草甚至没有版本说明所以我的习惯是按下面的清单核对缺什么补什么JDK 版本项目是 1.8 还是 11、17看pom.xml里java.version最准。构建工具Maven 还是 Gradle毕设九成是 Maven用 IDEA 打开pom.xml让它自己拉依赖。数据库版本脚本里有ENGINEInnoDB不代表 5.7 和 8.0 都能直接用重点看有没有utf8mb4、CURRENT_TIMESTAMP这类兼容性字段。前端目录里有没有node_modules有说明作者直接放了依赖没有就正常小程序端用微信开发者工具编译时会自动处理。LW 论文的章节重点看“系统设计”“数据库设计”“核心代码实现”三章答辩时评委大概率照着这些章节问。版本对不上是毕设翻车的第一大来源。我见过好几次包里的pom.xml写着 Java 8但 LW 论文截图里是 Java 11 的启动日志答辩时被当场抓包。所以拿到包先统一版本再往下走。2.2 建库建表签到系统的三张核心表签到系统不管前端怎么变后端永远绕不开三张表用户表、课程表、签到记录表。用户表区分学生和教师角色课程表维护每次签到对应的课程上下文签到记录表存每一次打卡行为。毕设的进阶版还会加一张选课表用来限制“这门课只有选课学生能签”。但多数基础版就三张表这里给出一个我常用的建表脚本字段命名和 LW 里的 E-R 图保持一致会省很多事CREATE DATABASE IF NOT EXISTS sign_system DEFAULT CHARACTER SET utf8mb4; USE sign_system; -- 用户表学生/老师共用用 role 字段区分 CREATE TABLE t_user ( id INT NOT NULL AUTO_INCREMENT, openid VARCHAR(64) NOT NULL COMMENT 微信小程序登录后的 openid, username VARCHAR(32) DEFAULT COMMENT 姓名, student_no VARCHAR(20) DEFAULT COMMENT 学号, phone VARCHAR(20) DEFAULT COMMENT 手机号, role TINYINT DEFAULT 0 COMMENT 0学生 1教师, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_openid (openid) ) ENGINEInnoDB COMMENT用户表; -- 课程表签到任务依附于课程 CREATE TABLE t_course ( id INT NOT NULL AUTO_INCREMENT, course_name VARCHAR(64) NOT NULL COMMENT 课程名称, teacher_id INT NOT NULL COMMENT t_user.id, latitude DECIMAL(10,6) DEFAULT NULL COMMENT 签到允许的纬度, longitude DECIMAL(10,6) DEFAULT NULL COMMENT 签到允许的经度, radius INT DEFAULT 200 COMMENT 允许签到半径单位米, start_time DATETIME DEFAULT NULL COMMENT 签到开始时间, end_time DATETIME DEFAULT NULL COMMENT 签到截止时间, PRIMARY KEY (id) ) ENGINEInnoDB COMMENT课程表; -- 签到记录表一次签到一行 CREATE TABLE t_sign_record ( id INT NOT NULL AUTO_INCREMENT, course_id INT NOT NULL COMMENT 课程id, user_id INT NOT NULL COMMENT 用户id, sign_time DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT 签到时间, latitude DECIMAL(10,6) DEFAULT NULL COMMENT 签到时的纬度, longitude DECIMAL(10,6) DEFAULT NULL COMMENT 签到时的经度, status TINYINT DEFAULT 1 COMMENT 1正常 0异常, PRIMARY KEY (id), UNIQUE KEY uk_course_user_date (course_id, user_id, sign_time) ) ENGINEInnoDB COMMENT签到记录表;参数上有个容易踩坑的地方DECIMAL(10,6)存经纬度足够了吗足够。微信wx.getLocation返回的经纬度精度是小数点后 6 位约等于 0.1 米再高就是噪声。radius字段我习惯同时存在课程表里因为不同课程对签到范围要求不一样——机房课 50 米操场课 300 米写死在代码里换课就要改代码。uk_course_user_date这个唯一索引是防重复签到的最粗防线但注意sign_time带时分秒同一天不同时间再签一次是插不进去的真正“按天防重复”的逻辑要在代码里做索引只防同一瞬间的并发重复。2.3 启动 Java 后端application.yml 里四个容易翻车的配置项Spring Boot 项目启动前先把application.yml过一遍。毕设后端最常见的组合是 Spring Boot MyBatis配置文件里真正决定能不能跑起来的就四个东西端口、数据源、MyBatis 映射路径、微信小程序配置。以一个多环境写法为例server: port: 8080 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/sign_system?useUnicodetruecharacterEncodingutf8mb4useSSLfalseserverTimezoneAsia/ShanghaiallowPublicKeyRetrievaltrue username: root password: 123456 # 如果用的是 MySQL 5.7驱动可以换回 com.mysql.jdbc.Driver但 cj 驱动向下兼容 mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.example.sign.entity configuration: map-underscore-to-camel-case: true wechat: appid: wx你的appid secret: 你的secret # 这个配置不是 Spring 标准项是项目里自定义的注意读代码里的 ConfigurationProperties四个坑按频次排序第一serverTimezoneAsia/Shanghai不写MySQL 8 会报时区错误Java 8 以下还会出现日期差 8 小时。第二useSSLfalse不写新版 MySQL 驱动默认开 SSL本地连不上还疯狂报 TLS 握手失败。第三allowPublicKeyRetrievaltrue是 MySQL 8 非 SSL 连接的专属设置不加上去启动时直接报Public Key Retrieval is not allowed如果是 MySQL 5.7 写这个参数也没事。第四map-underscore-to-camel-case必须显式打开否则student_no映射不到studentNo字段查询结果全是 null这个报错隐蔽到很多时候要一行行打日志才能发现。如果你还没装 MySQL先按常规的 mysql 安装教程把 5.7 或 8.0 装好再执行 2.2 的建表脚本。然后回到项目根目录IDEA 里执行mvn clean package -DskipTests java -jar target/sign-system-0.0.1-SNAPSHOT.jar如果不想打包直接mvn spring-boot:run也行。启动日志里看到Started Application in x.xxx seconds就算成功。打开浏览器访问http://localhost:8080/swagger-ui.html有 Swagger 的话或直接访问你自己写的一个测试接口确认后端活了再动小程序端。2.4 小程序端导入AppID、合法域名与顶部导航栏高度后端启动后打开微信开发者工具导入miniprogram目录。这一步有三件事容易卡住AppID 选择、合法域名配置、自定义导航栏高度计算。个人开发者在没有企业认证的情况下做毕设直接用测试号也能跑只是wx.login拿到的 openid 是测试环境的真机预览时部分接口受限。有自己注册的小程序账号就填自己的 AppID正式一点。合法域名是新手最容易忽略的坑。开发者工具里勾选“不校验合法域名”确实能在本地跑通但一到真机预览所有wx.request全部报url not in domain list。这是因为微信限制小程序的请求域名必须是 HTTPS 且在小程序后台配置过。毕设阶段解决方式有三种后端本地用http://localhost:8080配合开发者工具的不校验选项或者用内网穿透把本机端口映射成 HTTPS 域名最省事的办法是后端部署到云服务器配上 HTTPS 证书。注意个人主体小程序不支持配置本地 IP 域名只能走测试号或企业主体。自定义导航栏是微信小程序顶部导航栏的经典问题。默认导航栏没办法改背景色到想要的效果很多毕设会改成自定义导航栏但自定义之后页面顶部多出来的安全区域是多少我一般这样算// 在自定义导航栏的页面里获取顶部高度 const windowInfo wx.getWindowInfo() const menuRect wx.getMenuBoundingClientRect() Page({ data: { navHeight: 0 }, onLoad() { // 导航栏高度 状态栏高度 胶囊按钮高度 上下间距 const navHeight windowInfo.statusBarHeight menuRect.height (menuRect.top - windowInfo.statusBarHeight) * 2 this.setData({ navHeight }) } })wx.getWindowInfo是基础库 2.20.1 以后推荐的 API替代了老的wx.getSystemInfoSync。menuRect.top - windowInfo.statusBarHeight算的是胶囊按钮距离状态栏底部的高度差乘以 2 是因为胶囊上下间距对称。这套公式在 iPhone 和 Android 上表现一致比写死 64px 靠谱得多。拿到高度后页面的padding-top或height直接用navHeight变量不同机型就不会出现顶部遮挡。3. 把签到流程跑通登录、定位打卡与后端接口对接3.1 微信登录wx.login 换 openid获取手机号的现实选择签到系统的第一个接口永远是登录。小程序端wx.login只能拿到一个临时 code后端拿这个 code 去微信服务器换 openid 和 session_key。这段逻辑在毕业设计里几乎是模板代码但每个学生都会在这里卡一次因为wx.login的 code 只能用一次而且后端请求微信接口有超时和频控。我常用的 Java 实现是这样的// 登录接口小程序传 code后端换 openid RestController RequestMapping(/api/auth) public class AuthController { Resource private RestTemplate restTemplate; Value(${wechat.appid}) private String appid; Value(${wechat.secret}) private String secret; PostMapping(/login) public Result login(RequestBody LoginRequest req) { // 1. code 换 openid String url https://api.weixin.qq.com/sns/jscode2session?appid appid secret secret js_code req.getCode() grant_typeauthorization_code; MapString, Object resp restTemplate.getForObject(url, Map.class); if (resp null || resp.get(errcode) ! null) { // 常见code 过期5分钟、重复使用、appid 和 secret 不匹配 return Result.error(微信登录失败 resp); } String openid (String) resp.get(openid); // 2. 查库没有就新插入 User user userMapper.selectByOpenid(openid); if (user null) { user new User(); user.setOpenid(openid); user.setRole(0); // 默认学生 userMapper.insert(user); } // 3. 生成自己的 token后续接口带这个 token String token UUID.randomUUID().toString().replace(-, ); redisUtil.set(token, user.getId(), 7 * 24 * 60 * 60); // 单位秒 return Result.ok().put(token, token).put(userId, user.getId()); } }三个参数值得单独说js_code有效期只有 5 分钟且换过一次就失效所以前端不能反复调用同一个 codegrant_type是固定值写错直接返回invalid grant_typeRestTemplate在这里是同步请求并发量大时建议换成带连接池的实现但毕设流量根本到不了这个瓶颈别在这过度设计。关于“微信小程序登录获取手机号”很多毕设需求里写的是“微信授权手机号登录”但现实中这条路有门槛getPhoneNumber按钮的open-type在个人主体小程序里拿不到真实手机号微信要求非个人主体才能使用该能力返回值通常是errMsg: getPhoneNumber:fail no permission。所以我的建议是毕设里不要执着于“必须拿到手机号”用 openid 做账号主体手机号做成“绑定”操作——如果 LW 论文里写了手机号登录功能就在个人中心页面加一个手动输入手机号的表单这样答辩时既演示了功能又不被微信平台的认证限制卡死。把这一步写进论文的“系统局限性”章节反而是加分项。3.2 签到接口后端如何校验经纬度与防重复签到签到接口是整个系统的核心逻辑不复杂但三个边界一定要处理好距离校验、时间窗口、防重复。距离校验的常见做法是后端拿到课程表里预设的经纬度和半径再和学生上报的经纬度做一次 Haversine 公式算距离。为什么不前端算因为前端算的距离可以被篡改locals 改一下就能在地图外签到后端的经纬度才是可信数据。PostMapping(/sign) public Result sign(RequestBody SignRequest req, RequestHeader(token) String token) { // 1. token 换用户 Integer userId (Integer) redisUtil.get(token); if (userId null) { return Result.error(401, 登录过期请重新进入小程序); } // 2. 查课程校验时间段 Course course courseMapper.selectById(req.getCourseId()); if (course null) { return Result.error(课程不存在); } Date now new Date(); if (now.before(course.getStartTime()) || now.after(course.getEndTime())) { return Result.error(当前不在签到时间段内); } // 3. 防重复当天同一课程只允许签一次 int count signRecordMapper.countByUserAndCourseAndDate( userId, req.getCourseId(), new java.sql.Date(now.getTime())); if (count 0) { return Result.error(你今天已经签到过了); } // 4. 距离校验计算两点经纬度距离 double distance distance( course.getLatitude(), course.getLongitude(), req.getLatitude(), req.getLongitude()); if (distance course.getRadius()) { return Result.error(你不在签到范围内距离签到点约 (int) distance 米); } // 5. 写入签到记录 SignRecord record new SignRecord(); record.setCourseId(req.getCourseId()); record.setUserId(userId); record.setLatitude(req.getLatitude()); record.setLongitude(req.getLongitude()); signRecordMapper.insert(record); return Result.ok(签到成功).put(signTime, now); } // Haversine 公式返回距离单位米 private double distance(double lat1, double lon1, double lat2, double lon2) { double radLat1 Math.toRadians(lat1); double radLat2 Math.toRadians(lat2); double a radLat1 - radLat2; double b Math.toRadians(lon1) - Math.toRadians(lon2); double s 2 * Math.asin(Math.sqrt( Math.pow(Math.sin(a / 2), 2) Math.cos(radLat1) * Math.cos(radLat2) * Math.pow(Math.sin(b / 2), 2) )); return s * 6371000; }countByUserAndCourseAndDate这个查询看着简单但 SQL 里日期比较是个坑如果表里sign_time是DATETIME类型直接用WHERE sign_time CURDATE()会因为带时分秒而查不到数据。正确写法是WHERE DATE(sign_time) #{date}或者WHERE sign_time BETWEEN 2024-05-20 00:00:00 AND 2024-05-20 23:59:59。DATE()函数会导致索引失效但在不失一般性下毕设单表数据量也就几万行全表扫描也不慢为了查询方便用DATE()完全能接受。距离阈值course.getRadius()的单位是米前端给用户提示时也按米展示。这个字段存 200意思是以课程坐标为圆心、200 米为半径的圆内都算有效签到。要注意的是GPS 信号在室内会漂移尤其是一楼靠窗的位置可能偏出几十米导致学生明明在教室里却签到失败。后端的解决思路是把radius放大到 150~300 米而不是改成“不做距离校验”——不加距离校验的签到系统答辩时会被评委一句话问穿。3.3 签到记录与统计一条 SQL 看全出勤签到数据积累之后LW 论文里“数据统计分析”章节就需要 SQL 支撑。最常用的两个查询一个是某门课程某天的签到明细一个是某位学生的出勤率统计。明细查询注意多表关联时分页别遗漏 count 查询-- 某个课程在某个时间段的签到明细 SELECT u.student_no AS 学号, u.username AS 姓名, c.course_name AS 课程, s.sign_time AS 签到时间, s.latitude AS 纬度, s.longitude AS 经度 FROM t_sign_record s LEFT JOIN t_user u ON s.user_id u.id LEFT JOIN t_course c ON s.course_id c.id WHERE s.course_id 1 AND s.sign_time BETWEEN 2024-05-20 00:00:00 AND 2024-05-20 23:59:59 ORDER BY s.sign_time; -- 学生出勤率统计某学生在所有课程里的签到占比 SELECT c.course_name AS 课程, COUNT(s.id) AS 已签到次数, -- 这里的 18 是每门课的应到次数毕设里可以直接写死也可以用子查询算 COUNT(s.id) / 18 * 100 AS 出勤率 FROM t_course c LEFT JOIN t_sign_record s ON c.id s.course_id AND s.user_id 5 GROUP BY c.id, c.course_name;注意第二个查询的LEFT JOIN里带了s.user_id 5条件。为什么不写在WHERE里因为写在WHERE里会把LEFT JOIN变成INNER JOIN没签过到的课程行会直接消失统计结果就少了数据。这是 SQL 里常见的条件位置陷阱答辩时如果评委看到这条 SQL问一句“为什么条件在 JOIN 后面”你能答上来会非常加分。3.4 前后端联调从按钮到状态回填的完整数据流把前后端串起来看一遍完整流程小程序端页面加载时先检查本地有没有 token没有就调用wx.login拿 code 调后端登录接口拿到 token 后存入wx.setStorageSync后续所有wx.request都在 header 里带token。签到页的核心逻辑放在onLoad里sign() { // 1. 先检查登录态 const token wx.getStorageSync(token) if (!token) { this.loginFirst() // 内部调用 wx.login 并缓存 token return } // 2. 获取当前定位 wx.getLocation({ type: gcj02, success: (res) { // 3. 调签到接口 wx.request({ url: ${app.globalData.baseUrl}/api/sign, method: POST, header: { token }, data: { courseId: this.data.courseId, latitude: res.latitude, longitude: res.longitude }, success: (resp) { if (resp.data.code 0) { wx.showToast({ title: 签到成功, icon: success }) this.refreshSignStatus() // 4. 刷新为已签到状态 } else { wx.showToast({ title: resp.data.msg, icon: none }) } } }) }, fail: () { wx.showToast({ title: 定位失败请检查手机定位权限, icon: none }) } }) }这段代码里wx.getLocation的type: gcj02是个关键参数。gcj02是国测局坐标系微信接口返回的经纬度默认是gcj02。如果你后端存的是从地图上拾取的坐标比如用腾讯地图拾取器拿到的教室位置那两边都是gcj02直接算距离没问题。如果后端存的是wgs84GPS 原生坐标系或高德的坐标两边存在几十到几百米的偏移算出来的距离会莫名其妙偏大后面避坑章节详说。状态回填这块经验是不要用wx.showToast之后直接改 data因为签到接口返回成功但列表数据可能还没有更新。正确顺序是接口成功 - 重新拉取签到记录列表 - 用列表数据驱动页面渲染。这样后端如果有补签、异常签到的状态前端展示也会跟着变不会出现“提示成功但我的签到列表里没有”这种让人觉得系统有 bug 的场景。4. 毕业设计签到系统避坑手册五个翻车现场与排查思路4.1 后端能启动小程序请求却 404 / 405现象后端启动日志正常Swagger 也能看到接口但小程序里发wx.request总是返回 404 或 405控制台打印的 URL 看着也没问题。原因九成是路径对不上三处最容易不一致——RequestMapping写的类路径是/api/auth方法路径是/login但小程序请求拼的是/api/auth/login/多了个斜杠或者后端接口是 POST小程序请求方法写成了GETSpring Boot 会返回 405。剩下还有一层是静态资源拦截如果你用了自定义拦截器且没在拦截器里放行/api/**请求根本到不了 Controller。解决先打开微信开发者工具的 Network 面板看请求的 URL 完整值和响应体内容。然后去后端启动日志里找访问记录Spring Boot 默认会打印Tomcat started on port(s): 8080但不会打印每个请求。最直接的排查是加一个简单粗暴的全放行配置确认接口没逻辑问题后再按路径收紧。还有个很少人注意的点如果后端配了server.servlet.context-path: /sign那所有接口都要带/sign前缀前端 baseUrl 很容易漏这个。4.2 MySQL 连接报 Public Key Retrieval is not allowed现象后端启动时数据源初始化失败日志堆栈里有Public Key Retrieval is not allowed或者是Unable to load authentication plugin caching_sha2_password。这个问题在我带的学生里出现频率极高尤其是在他们照着 mysql 安装教程装了 MySQL 8.0 之后。原因MySQL 8.0 默认的认证插件是caching_sha2_password而很多毕设项目是从 MySQL 5.7 迁移过来的驱动连接串里没有处理公钥检索的参数。JDBC 驱动第一次连接时会尝试从服务器获取公钥做 RSA 加密如果连接串没允许这个行为就报错。解决最省事的是在 JDBC 连接串末尾加allowPublicKeyRetrievaltrue我在 2.3 的配置里就是加了这个参数。另一种方案是把用户密码认证改回旧协议在 MySQL 里执行ALTER USER rootlocalhost IDENTIFIED WITH mysql_native_password BY 你的密码; FLUSH PRIVILEGES;。两个选一个即可毕设项目不需要纠结用哪种认证更安全能跑通才是第一诉求。4.3 模拟器定位正常真机签到距离偏差几百米现象在微信开发者工具里模拟定位到课程坐标附近能正常签到换到真机预览人在教室里后端却提示“不在签到范围内距离约 300 米”。原因坐标坐标系不对。开发者工具的模拟位置默认是gcj02火星坐标系但你从第三方地图尤其是 GPS 设备或高德开放平台拿到的教室坐标可能是wgs84或 GCJ-02 偏移后的结果。真机上wx.getLocation返回的原始 GPS 坐标是wgs84微信内部转换成gcj02才返回给你。如果后端课程表存的是wgs84前端拿到gcj02经纬度传过来两边坐标系不同距离自然偏百八十米。解决统一坐标系。推荐后端一律存gcj02前端调wx.getLocation时显式指定type: gcj02。如果课程坐标只能拿到wgs84可以在后端写一个坐标转换工具类地图库里常见原理是七参数变换签到入库前把客户端上报的gcj02转成wgs84再算距离。判断到底是不是坐标系问题最简单的办法是把后端返回的课程经纬度在小程序里用wx.openLocation打开看一眼如果地图上的点和你预期位置偏差明显那几乎可以确定是坐标来源不统一。4.4 论文 LW 文档写的功能代码里根本没有现象LW 论文的“功能模块”章节写了“支持课表导入”“支持签到数据 Excel 导出”“支持补签申请”但代码里翻遍 Controller 都找不到对应接口。答辩时评委照着论文目录提问学生不知道对应代码在哪场面非常尴尬。原因毕设源码包是不同渠道流出的论文和新代码版本脱节是常态。有些源码包本身就是从老项目改来的LW 文档甚至是作者从别处拼的根本没和代码对齐过。解决收到包后先按 LW 论文的目录结构做一张功能清单逐个对照代码里是否有对应页面和接口。论文写了但代码没有的要么删掉论文段落要么补一个最小实现。补实现优先做展示型功能比如“导出 Excel”只需要在 Controller 里加一个导出方法用EasyExcel或POI写几十行代码就能跑。我的原则是论文里出现过的名词必须能在代码里找到对应的类或接口名找不到就二选一——改论文别改到一半再来追债。这个对齐工作建议在答辩前两周就完成不要拖到前三天。4.5 Maven 依赖拉不动启动都进不去现象IDEA 打开项目后pom.xml大片飘红依赖下载报超时或者项目能编译但运行时报ClassNotFoundException。还有一种是本地装了两个 JDK项目用 11 写的但你默认环境是 8启动直接报UnsupportedClassVersionError。原因Maven 中央仓库的访问问题在国内环境一直存在虽然现在是多仓库镜像但毕设项目里可能有冷门依赖只存在某个特定仓库。JDK 版本问题则纯粹是环境变量没对齐。解决Maven 换成阿里云镜像在~/.m2/settings.xml里加mirror指向alimaven。JDK 版本的坑用 IDEA 的 Project Structure 把 Project SDK 和 Modules language level 都设成统一版本。如果项目里用了javax.*的包Java 9 以后模块系统移除了一部分类这种直接建议把 JDK 降到 8 跑别升级——毕业设计项目不值得你去兼容新 JDK 的坑。启动前在命令行执行java -version确认和pom.xml里的java.version一致这一步能省下大半天的排查时间。5. 把这套签到系统改出原创感加字段、加页面、答辩演示的验证路径源码包直接交上去答辩风险很大——评委见过太多一模一样的界面。但改动不需要伤筋动骨在现有架构上加“差异化功能”是性价比最高的路径。我最推荐加三个东西签到数据报表页、二维码签到、补卡申请。报表页是最容易出效果的后端写一个按课程分组统计出勤率的接口前端用ec-canvas画柱状图不需要太复杂一个课程对比图就能撑起“数据可视化”这个论文小节。二维码签到需要动态生成带课程 ID 的二维码小程序端用canvas绘制老师端展示二维码学生扫码后跳转到带参数的小程序页面在onLoad里读取options.courseId完成签到。这个功能工作量不大但答辩演示时的“老师扫码”场景非常抓眼球。补卡申请纯粹是表结构扩展。签到记录表加一个status字段0 表示迟到、1 表示正常、2 表示补卡再加一张t_sign_apply补卡申请表就行。后端补一个POST /api/sign/apply接口接收用户 ID、课程 ID、补卡理由老师端列表接口加一个GET /api/sign/apply/list用于审核。代码量很小但在系统功能图里能多画两个模块。验证路径上我每次改完都会做一个固定动作用 Postman 把登录、签到、查询三个接口按顺序跑一遍签到接口故意传两个相差较大的经纬度确认能触发“不在签到范围”的提示然后回到小程序开发者工具走一遍真机预览重点看定位权限弹窗和导航栏高度。这里有一条血泪经验演示前一天一定用真机跑一遍模拟器不会暴露经纬度漂移和获取手机号的权限问题这两样在答辩现场是“翻车率”最高的两个点。最后一个习惯是我从带毕设学生开始就坚持的把 LW 论文的功能清单打印出来在每项后面标上代码里的 Controller 类名和页面路径答辩前拿着这张纸从头到尾过一遍能做到“评委指到论文哪一行你就能翻开 IDE 跳到对应代码”。这套方法帮我带的学生避开了绝大多数临场翻车。希望帮到你。本文还有配套的精品资源点击获取
