Golang实现签到功能教程

Golang活动签到系统应以轻量、可靠、易扩展为核心，依托标准库实现：通过crypto/rand生成唯一签到码并缓存校验；用Redis SETNX或数据库唯一约束防重复签到；提供二维码接口与统一响应格式；记录日志并按级别告警。

用 Golang 构建活动签到系统，核心在于轻量、可靠、易扩展——不需要复杂框架，靠标准库 + 简洁设计就能撑起中小规模活动的实时签到需求。

用户身份识别与签到入口

签到本质是“确认某人在某时到达某地”，所以第一步是明确“谁来签到”。常见做法是：为每位参与者生成唯一签到码（如 6 位数字或短字符串），通过短信/邮件/二维码下发。后端用 map[string]struct{} 或 Redis 缓存预置的合法码集合，避免每次查 DB；签到接口收到码后先校验是否存在且未使用，再执行签到逻辑。

• 签到码建议用 crypto/rand 生成，避免可预测性
• 支持扫码签到？只需提供一个 GET 接口返回带参数的二维码图片（如 /qrcode?code=abc123），前端调用即可
• 不强制登录也能用，但若需关联用户信息（如姓名、部门），可在签到时一并提交，后端做基础字段校验（如非空、长度限制）

签到状态存储与并发安全

多人同时扫码时，必须防重复签到。单纯用内存 map 不适合多实例部署，推荐两种方式：

• Redis SETNX：以签到码为 key，SETNX 成功即视为首次签到，value 可存时间戳或用户 ID；天然支持分布式和原子性
• 数据库唯一约束：在签到记录表中对 event_id + code 建联合唯一索引，INSERT 失败则说明已签过；配合事务确保数据一致
• 避免用锁（如 sync.Mutex）处理全局签到状态——它只在单进程内有效，且易成性能瓶颈

实时反馈与结果查询

用户扫码后需要立刻知道是否成功。接口返回结构建议统一：

管理员侧需快速查看签到情况，可提供简单 HTTP 接口（如 GET /api/v1/event/123/attendance），返回已签到人数、名单列表（分页）、未签到名单（对比报名表）。注意：敏感信息（如手机号）默认脱敏，如显示为 138****1234。

日志与异常兜底

签到是关键操作，必须留痕。Golang 标准 log 包足够用，按级别打日志：

• INFO：正常签到（含 IP、码、时间）
• WARN：重复码、无效码、超时请求（如活动已结束）
• ERROR：DB 写入失败、Redis 连接中断等

建议将日志写入文件，并按天轮转；关键错误可加简单告警（如发邮件或钉钉机器人），比如连续 5 次 Redis 写失败就触发通知。

基本上就这些。不复杂但容易忽略的是边界——比如活动开始前能否签到、结束后是否允许补签、同一人能否多次参加不同场次……这些业务规则，得在签到前做判断，而不是全堆在存储层硬扛。