学生签到系统源码拆解：微信小程序+Java+MySQL毕设实战

简介：面向高校毕业设计与课程设计场景，这套基于微信小程序的学生签到系统源码提供了管理员、教师、学生三类角色的完整业务闭环，覆盖签到管理、班课管理、请假审批与销假操作等核心流程。资源共一千零八十八个文件，压缩包约十八点八MB，包含Java后端、Vue管理端、小程序页面、数据库脚本及部署配置，其中图片资源丰富，便于界面预览与后续定制。目前已有九十三人浏览/学习，项目附带完整前后端源码、数据库文件与运行环境说明，可直接导入Eclipse、IDEA及微信开发者工具使用。整体代码结构清晰，模块划分明确，适合毕业设计答辩展示、课程设计参考或二次开发练习，可帮助快速理解小程序端与Java服务端交互、权限控制及请假审批逻辑。

1. 学生签到系统：拿到源码后第一件事该做什么

临近毕设答辩季，微信小程序+Java+MySQL 这套组合几乎成了签到类题目的标准答案。我拆过不少这类项目包，坦白说，里面真正能跑的代码可能只有七成，剩下三成要靠你自己把数据库、接口路径和微信小程序开发者工具的配置对齐。这份「学生签到系统设计与实现源码」就是一个典型：Java 后端负责业务逻辑与数据持久化，微信小程序端负责学生打卡、请假与记录查看，MySQL 存全部业务数据，附带的设计文档（LW）则用来应付论文和答辩。适合正在做毕业设计或课程设计、需要快速把项目跑起来并讲清楚原理的人。这篇笔记我会按「代码结构 → 后端接口 → 小程序端 → 数据库 → 避坑 → 答辩打磨」的顺序拆，尽量让你拿到包后两小时内跑通全流程。

2. Spring Boot 后端：先看清分层，再动手改配置

2.1 后端工程结构：从 controller 到 mapper 的一条完整链路

大多数毕业设计级别的 Java 后端都是 Spring Boot + MyBatis + Maven 的单体应用，这份源码也不例外。解压后你看到的典型目录结构如下：

src/main/java/com/example/sign/ ├── controller/ # 接口层，接收微信小程序端请求 │ ├── StudentController.java │ ├── TeacherController.java │ └── SignController.java ├── service/ # 业务逻辑层，处理签到规则、请假审批等 │ ├── SignService.java │ └── LeaveService.java ├── mapper/ # MyBatis 数据访问层 │ ├── StudentMapper.java │ └── SignRecordMapper.java ├── entity/ # 实体类，与数据库表字段一一对应 │ ├── Student.java │ └── SignRecord.java └── config/ # 跨域配置、微信登录拦截器、WebMvc 配置

先别急着改代码，我拿到任何 Spring Boot 项目的第一件事，是找application.yml或application.properties，确认三样东西：端口号、数据库连接串、MyBatis 配置。这份源码的配置文件一般长这样：

server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/sign_system?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.example.sign.entity

这里有两个参数最容易翻车：serverTimezone必须设成Asia/Shanghai，否则插入时间记录时 MySQL 会直接报时区错误；useSSL=false能避免本地无证书时频繁告警。端口号默认 8080，如果你本机 8080 被占用，改成 8081 或 8090 都可以，但记得小程序端的 request 请求地址要同步改。

2.2 MySQL 五张核心表：字段设计与一个关键索引

签到系统的业务逻辑不复杂，但表设计决定了后续代码好不好写。这套源码里我数了一下，核心表有五张：学生表、教师表、课程表（也可理解为签到任务表）、签到记录表、请假记录表。其中学生表和签到记录表是核心，字段大致如下：

CREATE TABLE `student` ( `id` int(11) NOT NULL AUTO_INCREMENT, `stu_no` varchar(20) NOT NULL COMMENT '学号', `name` varchar(50) NOT NULL COMMENT '姓名', `openid` varchar(64) DEFAULT NULL COMMENT '微信openid，用于登录绑定', `class_name` varchar(50) DEFAULT NULL COMMENT '班级', `create_time` datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (`id`), UNIQUE KEY `uk_stu_no` (`stu_no`), KEY `idx_openid` (`openid`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

注意openid字段加了普通索引而不是唯一索引，原因是一个学生可能同时绑定多个微信号（比如换手机号），但一个 openid 理论上只对应一个学生。签到记录表才是整个系统的关键：

CREATE TABLE `sign_record` ( `id` int(11) NOT NULL AUTO_INCREMENT, `student_id` int(11) NOT NULL COMMENT '学生ID', `course_id` int(11) NOT NULL COMMENT '课程/签到任务ID', `sign_time` datetime NOT NULL COMMENT '签到时间', `location` varchar(255) DEFAULT NULL COMMENT '签到位置描述', `latitude` double DEFAULT NULL COMMENT '纬度', `longitude` double DEFAULT NULL COMMENT '经度', `status` tinyint(4) DEFAULT 1 COMMENT '1-正常签到 2-迟到 3-缺勤', PRIMARY KEY (`id`), UNIQUE KEY `uk_student_course` (`student_id`, `course_id`), KEY `idx_sign_time` (`sign_time`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

uk_student_course这个唯一索引是防重复签到最重要的兜底手段。即使前端按钮没做防抖、网络请求重复提交，数据库层也会把同一学生同一课程的第二次签到挡回去。这个设计在答辩时值得单独讲，属于「虽然简单但考虑到了边界情况」的加分点。

2.3 签到接口实现：一个典型的 controller + service 交互

后端最核心的接口是「学生签到」，也就是SignController里的/api/sign/in接口。代码逻辑量不大，但毕业设计项目恰恰需要这种简洁到能讲清楚每条分支的代码：

@RestController @RequestMapping("/api/sign") public class SignController { @Autowired private SignService signService; @PostMapping("/in") public Result signIn(@RequestBody SignRequest req) { // 参数校验：学生ID、课程ID、经纬度都不能为空 if (req.getStudentId() == null || req.getCourseId() == null) { return Result.error("参数不完整"); } return signService.signIn(req); } }

@Service public class SignService { @Autowired private SignRecordMapper signRecordMapper; public Result signIn(SignRequest req) { // 1. 防重复签到：数据库唯一索引兜底 SignRecord existing = signRecordMapper.findByStudentAndCourse( req.getStudentId(), req.getCourseId()); if (existing != null) { return Result.error("你已经签到过了"); } // 2. 判断迟到：签到时间晚于课程开始时间15分钟视为迟到 SignRecord record = new SignRecord(); record.setStudentId(req.getStudentId()); record.setCourseId(req.getCourseId()); record.setSignTime(new Date()); record.setLatitude(req.getLatitude()); record.setLongitude(req.getLongitude()); if (signRecordMapper.insert(record) > 0) { return Result.success("签到成功"); } return Result.error("签到失败，请重试"); } }

这段代码有两个参数逻辑值得你答辩时重点准备：一是findByStudentAndCourse的查询，它先做了一次业务层防重判断，数据库唯一索引是最后一道防线——这两层缺一不可，面试官问「重复提交怎么解决」就可以拿这个答；二是迟到判断，这里写的是「晚于课程开始时间 15 分钟」，但实际项目中这个阈值一般放在课程表配置里而不是写死，你可以自己动手把这个值提取出来，算是一个不错的改进点。

3. 微信小程序端：从 wx.login 到定位签到完整链路

3.1 小程序端目录结构：页面与后端接口的一一对应

小程序端的代码通常和miniprogram或pages目录放在一起，结构比较固定。拿到源码后先打开app.json，看注册了哪些页面，然后对照后端接口去理解每个页面是干什么的：

├── app.js # 全局逻辑，初始化登录态 ├── app.json # 页面注册、窗口样式、tabBar 配置 ├── utils/ │ └── request.js # 封装 wx.request，统一带 token 请求头 ├── pages/ │ ├── login/ # 登录页：wx.login 换取用户身份 │ ├── index/ # 首页：显示课程列表和今日签到状态 │ ├── sign/ # 签到页：定位+打卡按钮 │ ├── record/ # 记录页：历史签到列表 │ └── leave/ # 请假页：提交请假申请

一个常见的坑是：源码里给的pages/index/index.js可能直接写死了后端地址，比如http://localhost:8080。这在模拟器里没问题，但真机预览一定失败，后面避坑章我会专门讲。现在你只需要记住一个原则——小程序端所有请求都应该走utils/request.js里封装好的方法，而不是在每个页面里裸写wx.request。

3.2 wx.login 登录：code2Session 换取 openid 与 token 存储

微信小程序登录不像网页那种用户名密码，它走的是微信官方的「静默登录」机制。核心逻辑在app.js或login.js里，代码大概是这样的：

// app.js App({ onLaunch() { this.login(); }, login() { wx.login({ success: (res) => { // res.code 是临时凭证，5分钟内有效，只能使用一次 const code = res.code; wx.request({ url: 'http://localhost:8080/api/login', method: 'POST', data: { code: code }, success: (resp) => { const { token, openid } = resp.data.data; wx.setStorageSync('token', token); wx.setStorageSync('openid', openid); } }); } }); } });

对应的后端登录接口收到这个 code 后，会拿着 code 去微信服务器换 openid，再把 openid 和本地学生表比对。如果比对成功就返回一个自定义 token，后续请求都靠这个 token 识别身份，而不是每次都用 code。

要注意，code 是一次性的，强刷页面会重新触发 wx.login，生成新的 code，这没问题。但如果你在onLaunch里登录的同时首页又在请求签到列表，就会出现 token 还没返回、请求已经发出的竞态问题。常见的解决方式是在 request.js 里做 token 等待队列——请求发出前检查 storage 里有没有 token，没有就先等待登录完成。源码里可能没做这个处理，但你在答辩的时候提出来，就是「发现了项目的一个隐患并给出了方案」。

3.3 定位签到：wx.getLocation 与距离计算

这份源码的签到页在三种签到方式里应该选了「定位签到」，也就是学生必须到教室一定范围内才能打卡。核心代码在pages/sign/sign.js里：

Page({ data: { courseId: null, latitude: null, longitude: null, signing: false }, onLoad(options) { this.setData({ courseId: options.courseId }); this.getLocation(); }, getLocation() { wx.getLocation({ type: 'gcj02', // 国测局坐标，国内定位必选 success: (res) => { this.setData({ latitude: res.latitude, longitude: res.longitude }); }, fail: () => { wx.showToast({ title: '定位失败，请检查权限', icon: 'none' }); } }); }, submitSign() { if (this.data.signing) return; // 防止重复点击 this.setData({ signing: true }); const { courseId, latitude, longitude } = this.data; wx.request({ url: 'http://localhost:8080/api/sign/in', method: 'POST', data: { studentId: wx.getStorageSync('studentId'), courseId: courseId, latitude: latitude, longitude: longitude }, success: (res) => { if (res.data.code === 200) { wx.showToast({ title: '签到成功' }); } else { wx.showToast({ title: res.data.msg, icon: 'none' }); } }, complete: () => { this.setData({ signing: false }); } }); } });

重点看type: 'gcj02'这个参数。微信返回的经纬度是国测局坐标系，如果你拿它和高德地图比对没问题，但如果后端比对的是原始 GPS 坐标，会有几十到几百米的偏差，可能导致学生在教室里却提示「不在签到范围」。比较稳妥的做法是把比对逻辑挪到后端，后端只存老师设定的教室中心点坐标，用 Haversine 公式计算距离：

public static double distance(double lat1, double lng1, double lat2, double lng2) { double radLat1 = Math.toRadians(lat1); double radLat2 = Math.toRadians(lat2); double a = radLat1 - radLat2; double b = Math.toRadians(lng1) - Math.toRadians(lng2); 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; // 地球半径 6371km，结果单位米 }

这个公式不用背，但要知道原理：经度纬度转弧度，然后套球面距离公式。把签到半径设成 100 米还是 200 米，取决于教室大小和 GPS 误差，我一般建议设 150 米，既能防止学生宿舍签到，又不会误伤坐在窗边的同学。

3.4 请假流程：状态机设计与后端接口配合

请假模块是签到系统的标配，也是很多源码包做得比较粗糙的地方。好的实现方式是请假单有一个状态字段，从「待审批」到「已通过」或「已驳回」，学生端只能看到自己的请假状态，教师端能看到待审批列表。这份源码的请假接口大致是三条：提交请假、审批请假、查询请假列表。数据表结构的关键字段是status，它在 Java 里通常用一个 Integer 表示：

这个设计在答辩时被问到的概率很高。面试官或评委可能会问「如果学生请假通过了，但他又去签到了怎么办」。答案一般是：签到接口先查请假表，如果该学生当天对这门课有已通过的请假记录，就跳过签到校验直接标记为「已请假」。这是一个业务规则，源码里不一定实现得完整，但你要能说出来。

4. MySQL 部署与初始化：从零建库到数据验证

4.1 建库建表脚本：一份能直接 source 的 SQL

源码包里的sql目录一般会放一个初始化脚本，但不是每个包都有。没有也别慌，手写一份也就十几分钟。我的习惯是建一个init.sql，里面包含建库、建表、插入初始数据三步：

CREATE DATABASE IF NOT EXISTS sign_system DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE sign_system; -- 学生表 CREATE TABLE student (...); -- 教师表 CREATE TABLE teacher ( id INT AUTO_INCREMENT PRIMARY KEY, teacher_no VARCHAR(20) NOT NULL, name VARCHAR(50) NOT NULL ); -- 课程表 CREATE TABLE course ( id INT AUTO_INCREMENT PRIMARY KEY, course_name VARCHAR(100) NOT NULL, teacher_id INT NOT NULL, start_time DATETIME NOT NULL, end_time DATETIME NOT NULL, latitude DOUBLE DEFAULT NULL, longitude DOUBLE DEFAULT NULL, sign_radius INT DEFAULT 150 ); -- 初始化一个测试学生 INSERT INTO student (stu_no, name, class_name) VALUES ('2024001', '张三', '计科1班'); INSERT INTO teacher (teacher_no, name) VALUES ('T001', '李老师'); INSERT INTO course (course_name, teacher_id, start_time, end_time) VALUES ('软件工程', 1, '2024-05-20 08:00:00', '2024-05-20 09:40:00');

sign_radius这个字段就是上一章说的签到半径，有的源码把它写死在后端常量里，放在表里显然更合理。插入测试数据的目的是让你第一遍跑通流程时不用先注册，直接用现成的学生 ID 去测签到接口。

执行方式取决于你用的 MySQL 客户端。命令行的话是：

mysql -u root -p < init.sql

如果表已经存在需要重置，用DROP TABLE IF EXISTS或者直接删库重建。我见过很多同学反复执行 init.sql 报Table already exists，原因就是脚本里没写DROP TABLE IF EXISTS，这个细节值得你自己检查一下。

4.2 连接配置与版本匹配：mysql-connector 驱动的玄学

JDBC 连接串里最容易出问题的两个参数是serverTimezone和驱动版本。如果你用的是 MySQL 5.7，com.mysql.jdbc.Driver和com.mysql.cj.jdbc.Driver都能跑；但如果你本地是 MySQL 8.0，只能用com.mysql.cj.jdbc.Driver，同时 pom.xml 里 mysql-connector-java 的版本最好在 8.0.11 以上，否则一启动就报ClassNotFoundException或Communications link failure。

还有一个非常隐蔽的坑：useSSL=false不改的话，MySQL 8.0 会在连接时尝试 SSL 握手，如果你本地没配证书，控制台会疯狂刷 warning 但不影响使用。很多同学看到满屏的红字 warning 以为项目坏了，其实只是 alert，真正会崩的是 SSL 握手失败导致的Public Key Retrieval is not allowed，遇到这个错，在连接串尾部加allowPublicKeyRetrieval=true就好。

库建好、配置改对之后，启动后端项目，浏览器访问http://localhost:8080/api/health如果能返回类似{"code":200,"msg":"ok"}的 JSON，说明后端和数据库已经联通。这一步是后面调试小程序端的基础，后端起不来，前端怎么做都是白搭。

5. 避坑指南：微信小程序签到系统最常见的 6 个翻车点

5.1 真机预览连不上本地后端

• 现象：模拟器里签到、登录一切正常，但用手机扫码预览时，所有请求全部超时，控制台报request:fail。
• 原因：小程序真机预览时，你的手机和电脑不在同一个局域网，或者你请求的地址写的是localhost。localhost在手机上指手机自己，而电脑上的后端服务它根本访问不到。
• 解决：把utils/request.js里的 baseUrl 从http://localhost:8080改成你电脑的局域网 IP，比如http://192.168.1.101:8080。查看 IP 的方式是命令行执行ipconfig（Windows）或ifconfig（Mac/Linux）。另外微信开发者工具里要勾选「不校验合法域名」，否则真机预览也会被拦。

5.2 扫码签到与定位签到混用导致的逻辑冲突

• 现象：同一门课，一部分同学用扫码签到成功，另一部分用定位签到也成功，但数据库里出现两条签到记录，或者有一个学生两个方式都签了。
• 原因：源码里两种签到方式走的可能是两个不同的接口，防重复签到逻辑只写在了其中一个接口里。
• 解决：统一签到入口。后端只提供一个/api/sign/in接口，用type参数区分location或qr_code，但无论哪种方式，都要执行同一套「查重 → 校验 → 插入」流程。前端也只在同一个页面放签到按钮，不要做成两个页面各签各的。

5.3 签到时间与课表时间对不上：时区与字符串解析双向坑

• 现象：学生明明准点签到，数据库里记录的时间却慢了 8 小时；或者后端返回的签到时间在 iOS 上显示为NaN。
• 原因：第一个是 MySQL 连接串里没配serverTimezone=Asia/Shanghai，默认取了 UTC；第二个是 iOS 的new Date()不支持解析"2024-05-20 08:00:00"这种带横杠的格式，必须替换成"2024/05/20 08:00:00"。
• 解决：连接串统一加serverTimezone=Asia/Shanghai；前端在解析后端返回时间时，先做一次/替换，例如new Date(timeStr.replace(/-/g, '/'))，一劳永逸。

5.4 微信登录获取手机号：个人开发者绕不过的坎

• 现象：代码里有button open-type="getPhoneNumber"，预览时点击没反应，或者提示「该功能需要企业认证」。
• 原因：getPhoneNumber接口从 2023 年起要求小程序必须有企业主体认证，个人开发者无权调用。很多毕业设计源码里为了实现「手机号登录」写了这个功能，但你个人账号根本跑不了。
• 解决：别在这个功能上死磕。登录方式改用wx.login换取 openid，完全够用，也不影响答辩演示。如果论文里写了手机号登录相关章节，就说「由于微信平台政策限制，实现上采用 openid 作为用户唯一标识」，这是合规的理由，评委都能理解。

5.5 数据库唯一索引和前端防重复同时失效

• 现象：用户点击签到按钮后卡顿，又点了两下，最后数据库里出现两条记录。
• 原因：前端虽然用signing标志位做了拦截，但两个请求几乎同时到达后端，后端两次查询都没查到记录，就都执行了插入，唯一索引没建或建错了字段组合。
• 解决：第一，确认sign_record表有(student_id, course_id)的唯一索引；第二，插入时改用INSERT IGNORE或ON DUPLICATE KEY UPDATE，让数据库层来做最终的拦截，这是最硬的兜底。

5.6 uni-app 打包或导入时 API 兼容问题

• 现象：源码里的页面是用微信原生语法写的，但有人用 HBuilderX 导入后发现wx.getLocation报错，或者页面的onLoad不触发。
• 原因：如果源码是原生小程序，就不能直接用 uni-app 项目去打开；反过来，源码如果是 uni-app 写的，用微信开发者工具打开dist目录也会出现各种诡异报错。
• 解决：先看目录开头有没有uni-app或manifest.json。原生小程序认app.json，uni-app 认manifest.json，别混。如果老师要求必须 uni-app 打包，正确做法是把原生页面改造成vue单文件组件，并统一把wx.前缀换成uni.，这不是零成本操作，提前留出至少两天时间。

6. 从能跑到好答辩：三个半小时内做好的进阶打磨

签到系统这种经典毕设，代码本身撑不起一场高质量的答辩，真正加分的是你比别人多走的那半步。这里分享三个我实际用过且成本很低的打磨方向。

第一个：用 Redis 做签到幂等。数据库唯一索引已经能挡重复，但如果你在答辩时加一句「考虑到高并发场景，我用 Redis 的SETNX做了前置去重」，瞬间就不一样了。实现也很简单，签到接口收到请求后先执行redisTemplate.opsForValue().setIfAbsent("sign:" + studentId + ":" + courseId, "1", 5, TimeUnit.MINUTES)，如果返回false直接拒绝，返回true才继续查库。这展示了你知道缓存能解决什么问题，也顺带解释了为什么数据库索引还不够——因为高并发下数据库压力太大。

第二个：签到记录导出 Excel。教师端加一个导出按钮，后端用 EasyExcel 或 POI 生成考勤统计表，文件名带日期。这个功能很讨喜，因为几乎所有答辩评委都会问「学生出勤情况怎么统计」。实现思路是新增一个/api/export接口，查出某门课所有人每节课的签到状态，然后按行写入 Excel。源代码包如果没做，你就自己写一个 controller 方法，二十行代码搞定，但展示效果立刻不同。

第三个：准备一份「答辩演示验证清单」。这是我个人血泪经验总结出来的习惯。每次答辩前一天，我都会按这个顺序完整走一遍：

这张表看似简单，但能帮你避免 90% 的演示事故。尤其是第 6、7 步，如果后端没做防重，第二次签到返回的是 200 而不是错误提示，答辩现场就会很尴尬。

从那以后，我每次拿到新的项目源码，都强制自己先花十五分钟把数据库跑起来、登录接口打通，再去看页面代码——代码可以慢慢读，但系统必须先在手里转起来。希望这份拆解能让你少走几个我走过的弯路，也祝你顺利通过答辩。

本文还有配套的精品资源，点击获取