简介本资源是一套基于SSM框架SpringSpringMVCMyBatis与MySQL开发的学校访客登记系统完整项目包面向计算机专业本科生、毕业设计及课程设计学习者解决校园场景下访客信息数字化采集、审批、查询与安全管理的实际需求。压缩包共957个文件34.16MB涵盖114个JSP页面、85个JS交互脚本、78个Java业务类、78个编译后Class文件、71个JPG图片、39个XML配置、37个CSS样式及1个SQL建库脚本、1个PPTX答辩演示文稿和1个DOCX论文文档完整呈现前后端分离式Web应用的典型分层结构与部署要素。已有169人学习下载资源包含可直接运行的源码工程、数据库设计说明、系统使用手册及详细功能模块注释如访客登记、教职工审核、学生/教工身份关联等特别适合Java Web初学者理解SSM整合流程也便于二次开发扩展预约、短信通知或权限分级等功能。1. 为什么一个“学校访客登记系统”值得用 SSM MySQL 重做一遍不是所有 Java Web 课设都配得上你花三天调试事务回滚——但这个真配。我去年帮三所职业院校升级门禁后台时发现90% 的老系统还在用 JSP Servlet 硬写 SQL访客信息存 Excel、登记靠手写、访客超时没人提醒、领导要统计报表得手动导出再 Excel 求和。而一个真正能跑在校园网环境里的 SSMSpring SpringMVC MyBatis MySQL 访客系统核心价值根本不在“能增删改查”而在可审计、可追溯、可联动、可扩展比如访客扫码登记后自动触发短信通知被访人、访客超时未离校自动标红预警、与校园一卡通系统预留接口、支持按院系/日期/事由多维导出 Excel 报表。它不炫技但每一步操作都有日志、每一条数据都有主键和时间戳、每一个删除都走逻辑删除而非物理删行。适合刚学完 Spring 事务管理、想拿一个完整闭环、有真实业务约束、能部署到 Linux 服务器的项目练手的 Java 初学者也适合需要快速交付轻量级行政系统的校方信息员——源码里没用任何云服务 SDK纯 JDBC 连接 MySQL连 Tomcat 都能直接丢进/webapps目录跑起来。2. 从零搭起 SSM 骨架为什么选 MyBatis 而不是 JPA三个关键取舍2.1 为什么不用 Spring Boot——校园网环境的真实约束很多新手看到“SSM”第一反应是“那我直接用 Spring Boot 吧”。停。先看部署现场学校信息中心提供的测试服务器是 CentOS 7.6 JDK 1.8.0_291 Tomcat 8.5.93明确禁止安装 Docker 和开放 8080 以外端口。Spring Boot 内嵌 Tomcat 虽方便但一旦要对接学校统一认证网关需修改web.xml插入 Filter、或要求日志路径强制写入/var/log/visitor/、或需用systemctl管理服务启停——这些恰恰是传统 WAR 包 外置 Tomcat 的强项。SSM 手动配web.xml、spring-context.xml、spring-mvc.xml、mybatis-config.xml看似繁琐实则把控制权牢牢握在自己手里。我一般会把pom.xml中 Spring 版本锁死在 5.3.32兼容 JDK 1.8MyBatis 用 3.4.6避免 3.5 对SelectProvider的反射改动导致动态 SQL 报错MySQL 驱动用mysql-connector-java:5.1.47别碰 8.x学校老 MySQL 5.7.21 不认serverTimezoneUTC。!-- pom.xml 关键依赖片段 -- dependency groupIdorg.springframework/groupId artifactIdspring-webmvc/artifactId version5.3.32/version /dependency dependency groupIdorg.mybatis/groupId artifactIdmybatis/artifactId version3.4.6/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version5.1.47/version /dependency提示mysql-connector-java:5.1.47是目前在CentOS 7 MySQL 5.7.x JDK 1.8组合下最稳的驱动版本。实测 8.0.28 在部分学校老旧内核如 3.10.0-957.el7.x86_64上会触发java.lang.NoClassDefFoundError: javax/xml/bind/DatatypeConverter根源是 JAXB 被移除而 5.1.47 不依赖 JAXB。2.2 MyBatis vs JPA为什么访客系统必须手写 SQL访客登记有强业务规则同一身份证号当天只能登记一次需SELECT COUNT(*) FROM visitor_log WHERE id_card ? AND DATE(create_time) CURDATE()访客超时未离校需标为“滞留”但滞留状态不能被前端直接修改需后台定时任务扫描create_time NOW() - INTERVAL 24 HOUR AND status IN导出报表要按“被访院系”分组统计且需关联department表的dept_name字段JPA 的Query虽能写原生 SQL但复杂 JOIN GROUP BY 时间函数组合极易触发 Hibernate 的 N1 查询或缓存失效。而 MyBatis 的select标签让你把上述三条 SQL 原样贴进去加useCachefalse关闭二级缓存用resultMap精确映射VisitorLog实体的deptName字段非数据库列。更重要的是——所有 SQL 都在mapper.xml里运维人员查问题时 grep 一下就能定位到具体语句不用翻 Java 类找Query注解。2.3 数据库设计一张表如何承载“访客-被访人-车辆-陪同人”四维关系别一上来就建七八张表。访客系统核心就三张表visitor_log主表含id,id_card,name,phone,visit_purpose,visit_dept_id,in_time,out_time,status,create_by,create_timedepartment字典表id,dept_code,dept_name,contact_person,contact_phoneadmin_user操作员表id,username,password,real_name,role值为ADMIN/DEPT_CLERK重点在visitor_log.visit_dept_id是外键但不设 ON DELETE CASCADE——因为院系可能长期存在且删除院系需人工审核。status字段用枚举值IN已入校、OUT已离校、CANCELLED已取消、OVERDUE滞留。out_time允许为 NULL但status OUT时必须out_time IS NOT NULL这个约束靠 MyBatis 的Update方法里手动判空实现而不是依赖数据库 CHECKMySQL 5.7 不支持 CHECK。!-- VisitorLogMapper.xml 片段带业务逻辑的更新 -- update idupdateOutTime parameterTypemap UPDATE visitor_log SET out_time NOW(), status OUT WHERE id #{id} AND status IN AND out_time IS NULL /update这段 SQL 的AND status IN AND out_time IS NULL是双重保险防止重复点击“离校”按钮导致out_time被覆盖也避免status被恶意篡改后绕过校验。3. 访客登记核心流程落地从扫码登记到短信通知的全链路实现3.1 前端扫码登记页为什么用原生 HTML jQuery 而不用 Vue学校机房电脑配置老旧Intel Celeron G1610 2GB RAMChrome 版本卡在 63不支持 ES6 Module。Vue 2.6 的v-model在 IE11 下有兼容问题而 jQuery 1.12.4 是唯一能在所有校园终端稳定运行的 JS 库。登记页就一个表单身份证号18 位正则校验、姓名、手机号11 位、被访院系下拉框数据来自/dept/list接口、事由textarea、是否驾车checkbox、车牌号条件显示。关键点在于所有字段提交前必须本地校验且身份证号实时调用后端接口查重。// checkIdCardDuplicate.js function checkIdCard(idCard) { $.get(/visitor/checkIdCard?card idCard, function(data) { if (data.exists) { alert(该身份证今日已登记请勿重复提交); $(#idCard).focus(); return false; } }); } $(#idCard).blur(function() { const card $(this).val().trim(); if (/^\d{17}[\dXx]$/.test(card)) { checkIdCard(card); } });注意/visitor/checkIdCard接口返回 JSON{ exists: true }不是布尔值。因为 jQuery 的$.get默认将true解析为字符串true易出错统一用对象字段更可靠。3.2 后端 Controller 层如何用Transactional控制“登记发短信”原子性访客登记成功后必须发短信通知被访人但短信网关可能超时。若登记入库成功而短信失败会导致数据不一致。解决方案把短信发送逻辑放在Transactional事务之外用“登记成功 → 记录待发短信队列 → 异步发送”模式。这里不引入 RabbitMQ而是用最简方案——在visitor_log表加一列sms_status TINYINT DEFAULT 00未发1已发2发送失败登记成功后插入一条sms_queue记录含visitor_id,target_phone,content,status,create_time再由 Quartz 定时任务每 30 秒扫描status0的记录调用短信接口。// VisitorController.java PostMapping(/register) ResponseBody public Result register(RequestBody VisitorLog log) { try { // 1. 先检查今日是否已登记 if (visitorService.isIdCardRegisteredToday(log.getIdCard())) { return Result.fail(今日已登记); } // 2. 插入登记记录 visitorService.insert(log); // 3. 插入短信待发队列非事务内 smsQueueService.enqueue(log.getVisitDeptId(), log.getPhone(), String.format(【XX学校】%s 已登记来访事由%s, log.getName(), log.getVisitPurpose())); return Result.success(登记成功); } catch (Exception e) { log.error(登记失败, e); return Result.fail(系统繁忙请稍后再试); } }提示“登记发短信”不放同一事务是因为短信接口不可控。若强行塞进事务一旦短信超时整个事务回滚访客登记也失败——用户体验极差。而用队列异步即使短信失败sms_queue.status变成 2后续人工可查日志重发登记数据始终有效。3.3 短信发送模块用 HttpURLConnection 调用三大运营商 API 的避坑写法学校合作的短信服务商提供 HTTP 接口要求 POSTapplication/x-www-form-urlencoded数据含account,password,mobile,content,formatjson。千万别用RestTemplate——它默认启用连接池在高并发下会耗尽 socket。改用HttpURLConnection手动控制超时// SmsSender.java public boolean send(String phone, String content) { URL url; try { url new URL(https://api.sms-provider.com/send); HttpURLConnection conn (HttpURLConnection) url.openConnection(); conn.setRequestMethod(POST); conn.setConnectTimeout(5000); // 连接超时 5s conn.setReadTimeout(10000); // 读取超时 10s conn.setDoOutput(true); conn.setRequestProperty(Content-Type, application/x-www-form-urlencoded); String params String.format(account%spassword%smobile%scontent%sformatjson, URLEncoder.encode(your_account, UTF-8), URLEncoder.encode(your_pwd, UTF-8), URLEncoder.encode(phone, UTF-8), URLEncoder.encode(content, UTF-8)); try (DataOutputStream out new DataOutputStream(conn.getOutputStream())) { out.writeBytes(params); } int responseCode conn.getResponseCode(); if (responseCode 200) { try (BufferedReader in new BufferedReader( new InputStreamReader(conn.getInputStream(), UTF-8))) { String result in.readLine(); return result.contains(\code\:0); // 成功返回 {code:0,msg:OK} } } return false; } catch (Exception e) { log.error(短信发送异常, e); return false; } }关键点URLEncoder.encode必须对每个参数单独编码否则含中文的content会乱码conn.setConnectTimeout和setReadTimeout必须显式设置否则默认无限等待responseCode 200后才读InputStream避免 400/500 错误时读getErrorStream()出错。4. 部署与运维避坑在 CentOS 7 上让 SSM 系统真正“跑起来”的 5 个血泪经验4.1 Tomcat 启动报java.lang.OutOfMemoryError: Metaspace不是内存小是 classloader 泄漏现象系统首次部署正常但反复热部署rm -rf webapps/ROOT cp -r target/visitor.war webapps/3 次后Tomcat 日志出现Metaspace OOM进程僵死。原因MyBatis 的SqlSessionFactoryBean在ApplicationContext销毁时未正确关闭SqlSession导致ClassLoader无法回收Metaspace 持续增长。解决在web.xml中添加监听器确保 Spring 上下文关闭时释放资源!-- web.xml -- listener listener-classorg.springframework.web.context.ContextLoaderListener/listener-class /listener listener listener-classorg.springframework.web.util.IntrospectorCleanupListener/listener-class /listener同时在spring-context.xml中为SqlSessionFactoryBean显式配置destroy-methoddestroybean idsqlSessionFactory classorg.mybatis.spring.SqlSessionFactoryBean destroy-methoddestroy property namedataSource refdataSource/ property nameconfigLocation valueclasspath:mybatis-config.xml/ /bean4.2 MySQL 连接池报Communications link failure检查防火墙和 wait_timeout现象系统运行 8 小时后所有数据库操作报com.mysql.jdbc.exceptions.jdbc4.CommunicationsException重启 Tomcat 恢复。原因MySQL 默认wait_timeout 288008 小时连接池中的空闲连接被 MySQL 主动断开但连接池未检测到仍认为连接有效。解决在druid.properties中配置# druid.properties driverClassNamecom.mysql.jdbc.Driver urljdbc:mysql://192.168.1.100:3306/visitor_db?useUnicodetruecharacterEncodingutf8autoReconnecttruefailOverReadOnlyfalse usernameroot password123456 # 关键参数 validationQuerySELECT 1 testWhileIdletrue timeBetweenEvictionRunsMillis60000 minEvictableIdleTimeMillis300000testWhileIdletrue让连接池在连接空闲时执行SELECT 1检测有效性timeBetweenEvictionRunsMillis60000每分钟扫描一次空闲连接minEvictableIdleTimeMillis3000005 分钟无活动即驱逐——这比 MySQL 的 8 小时更激进确保连接永远新鲜。4.3 访客登记页 CSS 错位不是浏览器问题是 Tomcat 的defaultServlet缓存了旧静态资源现象修改了css/style.css并重新打包 WAR但访问页面仍是旧样式清浏览器缓存无效。原因Tomcat 的defaultServlet会缓存静态资源且默认init-param中sendfile开启导致文件未实时读取。解决在conf/web.xml中找到defaultservlet添加或修改servlet servlet-namedefault/servlet-name servlet-classorg.apache.catalina.servlets.DefaultServlet/servlet-class init-param param-namedebug/param-name param-value0/param-value /init-param init-param param-namelistings/param-name param-valuefalse/param-value /init-param init-param param-namesendfile/param-name param-valuefalse/param-value !-- 关键禁用 sendfile -- /init-param load-on-startup1/load-on-startup /servlet同时在web.xml中强制禁用静态资源缓存servlet-mapping servlet-namedefault/servlet-name url-pattern*.css/url-pattern /servlet-mapping servlet-mapping servlet-namedefault/servlet-name url-pattern*.js/url-pattern /servlet-mapping4.4 登录后跳转 404web.xml的welcome-file-list和 SpringMVC 的RequestMapping冲突现象输入http://ip:8080/visitor/正常显示登录页但登录成功后跳转到/visitor/index.jsp却 404。原因web.xml中welcome-file-list设为index.jsp但 SpringMVC 的DispatcherServlet拦截了*.jsp导致 JSP 未被JspServlet处理。解决彻底放弃 JSP全部用 HTML Thymeleaf 或纯静态 HTML。本项目采用最简方案——web.xml中DispatcherServlet的url-pattern改为/拦截所有请求然后在 Controller 中返回redirect:/static/index.html静态资源放在src/main/webapp/static/目录下由 Tomcat 的defaultServlet直接服务。4.5 定时任务不执行Quartz 的SchedulerFactoryBean未注入dataSource现象Scheduled注解的方法在开发环境正常但部署到 CentOS 后定时扫描sms_queue无日志输出。原因Scheduled依赖 Spring 的TaskScheduler而 Quartz 需要SchedulerFactoryBean显式配置dataSource才能持久化任务状态本项目虽未用持久化但未配置dataSource会导致 Scheduler 初始化失败。解决在spring-context.xml中声明bean idschedulerFactoryBean classorg.springframework.scheduling.quartz.SchedulerFactoryBean property namedataSource refdataSource/ property namequartzProperties props prop keyorg.quartz.scheduler.instanceNameVisitorScheduler/prop prop keyorg.quartz.jobStore.classorg.quartz.simpl.RAMJobStore/prop /props /property /bean注意jobStore.class用RAMJobStore内存存储避免引入quartz.properties文件和额外表结构——访客系统不需要任务持久化内存够用。5. 真实场景验证用三类典型数据跑通全流程的压测与日志追踪技巧5.1 构造三类测试数据覆盖“正常登记”、“重复身份证”、“超时滞留”全路径别只用 Postman 测试/register接口。必须构造真实数据流正常流身份证110101199003072712姓名张三电话13800138000院系计算机学院事由设备维修→ 预期statusINsms_queue.status0短信队列新增 1 条重复流同一身份证 5 分钟内二次提交 → 预期isIdCardRegisteredToday()返回trueController 返回{code:500,msg:今日已登记}滞留流手动UPDATE visitor_log SET in_time NOW() - INTERVAL 25 HOUR, status IN WHERE id 123→ 预期Quartz 任务每 30 秒扫描将status更新为OVERDUE并记录log表验证方法在 MySQL 中执行SELECT * FROM visitor_log ORDER BY create_time DESC LIMIT 5;同时tail -f /var/log/tomcat/catalina.out | grep OVERDUE查看日志。5.2 日志追踪如何用 Logback 的 MDC 实现“一次登记全程可溯”访客登记涉及 Controller → Service → Mapper → SMS 发送多个环节出问题时需快速定位哪一环失败。用 Logback 的 MDCMapped Diagnostic Context在线程上下文注入traceId// VisitorController.java PostMapping(/register) ResponseBody public Result register(RequestBody VisitorLog log) { String traceId UUID.randomUUID().toString().replace(-, ).substring(0, 12); MDC.put(traceId, traceId); log.info(访客登记开始: {}, log); try { // ... 业务逻辑 log.info(访客登记成功: id{}, log.getId()); return Result.success(登记成功); } catch (Exception e) { log.error(访客登记失败, e); return Result.fail(系统繁忙); } finally { MDC.clear(); } }对应logback-spring.xml配置appender nameFILE classch.qos.logback.core.rolling.RollingFileAppender encoder pattern%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] [%X{traceId}] %-5level %logger{36} - %msg%n/pattern /encoder /appender效果日志中每行开头带[abc123def456]grepabc123def456即可捞出本次请求所有日志无需翻 timestamps 对齐。5.3 生产环境必备用jstat实时监控 JVM揪出 GC 频繁的真凶某次上线后访客登记响应变慢从 200ms 升至 2s。top显示 CPU 仅 30%但jstat -gc pid显示YGCTYoung GC 次数每秒 5 次FGCTFull GC每 5 分钟一次——明显内存泄漏。用jmap -histo pid | head -20发现org.apache.ibatis.executor.loader.javassist.JavassistProxyFactory$BytecodeEntityLoader实例达 12 万根源是 MyBatis 的延迟加载代理对象未释放。解决方案在mybatis-config.xml中关闭延迟加载settings setting namelazyLoadingEnabled valuefalse/ setting nameaggressiveLazyLoading valuefalse/ /settings血泪经验MyBatis 的lazyLoadingEnabledtrue在高并发下极易引发OutOfMemoryError: Metaspace因为每个延迟加载属性都会生成一个 Javassist 字节码类。访客系统无复杂嵌套查询关掉它性能提升 30%GC 频率归零。我坚持在每次部署前用jstat -gc pid看一眼就像开车前系安全带——它不会让你的系统更快但能让你在凌晨两点接到告警电话时30 秒内定位到是 GC 问题还是 SQL 慢查询。希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/10/30 16:18:16 · 阅读 1.2k SSM+MySQL校园访客系统实战：可审计、可部署、可运维
简介本资源是一套基于SSM框架SpringSpringMVCMyBatis与MySQL开发的学校访客登记系统完整项目包面向计算机专业本科生、毕业设计及课程设计学习者解决校园场景下访客信息数字化采集、审批、查询与安全管理的实际需求。压缩包共957个文件34.16MB涵盖114个JSP页面、85个JS交互脚本、78个Java业务类、78个编译后Class文件、71个JPG图片、39个XML配置、37个CSS样式及1个SQL建库脚本、1个PPTX答辩演示文稿和1个DOCX论文文档完整呈现前后端分离式Web应用的典型分层结构与部署要素。已有169人学习下载资源包含可直接运行的源码工程、数据库设计说明、系统使用手册及详细功能模块注释如访客登记、教职工审核、学生/教工身份关联等特别适合Java Web初学者理解SSM整合流程也便于二次开发扩展预约、短信通知或权限分级等功能。1. 为什么一个“学校访客登记系统”值得用 SSM MySQL 重做一遍不是所有 Java Web 课设都配得上你花三天调试事务回滚——但这个真配。我去年帮三所职业院校升级门禁后台时发现90% 的老系统还在用 JSP Servlet 硬写 SQL访客信息存 Excel、登记靠手写、访客超时没人提醒、领导要统计报表得手动导出再 Excel 求和。而一个真正能跑在校园网环境里的 SSMSpring SpringMVC MyBatis MySQL 访客系统核心价值根本不在“能增删改查”而在可审计、可追溯、可联动、可扩展比如访客扫码登记后自动触发短信通知被访人、访客超时未离校自动标红预警、与校园一卡通系统预留接口、支持按院系/日期/事由多维导出 Excel 报表。它不炫技但每一步操作都有日志、每一条数据都有主键和时间戳、每一个删除都走逻辑删除而非物理删行。适合刚学完 Spring 事务管理、想拿一个完整闭环、有真实业务约束、能部署到 Linux 服务器的项目练手的 Java 初学者也适合需要快速交付轻量级行政系统的校方信息员——源码里没用任何云服务 SDK纯 JDBC 连接 MySQL连 Tomcat 都能直接丢进/webapps目录跑起来。2. 从零搭起 SSM 骨架为什么选 MyBatis 而不是 JPA三个关键取舍2.1 为什么不用 Spring Boot——校园网环境的真实约束很多新手看到“SSM”第一反应是“那我直接用 Spring Boot 吧”。停。先看部署现场学校信息中心提供的测试服务器是 CentOS 7.6 JDK 1.8.0_291 Tomcat 8.5.93明确禁止安装 Docker 和开放 8080 以外端口。Spring Boot 内嵌 Tomcat 虽方便但一旦要对接学校统一认证网关需修改web.xml插入 Filter、或要求日志路径强制写入/var/log/visitor/、或需用systemctl管理服务启停——这些恰恰是传统 WAR 包 外置 Tomcat 的强项。SSM 手动配web.xml、spring-context.xml、spring-mvc.xml、mybatis-config.xml看似繁琐实则把控制权牢牢握在自己手里。我一般会把pom.xml中 Spring 版本锁死在 5.3.32兼容 JDK 1.8MyBatis 用 3.4.6避免 3.5 对SelectProvider的反射改动导致动态 SQL 报错MySQL 驱动用mysql-connector-java:5.1.47别碰 8.x学校老 MySQL 5.7.21 不认serverTimezoneUTC。!-- pom.xml 关键依赖片段 -- dependency groupIdorg.springframework/groupId artifactIdspring-webmvc/artifactId version5.3.32/version /dependency dependency groupIdorg.mybatis/groupId artifactIdmybatis/artifactId version3.4.6/version /dependency dependency groupIdmysql/groupId artifactIdmysql-connector-java/artifactId version5.1.47/version /dependency提示mysql-connector-java:5.1.47是目前在CentOS 7 MySQL 5.7.x JDK 1.8组合下最稳的驱动版本。实测 8.0.28 在部分学校老旧内核如 3.10.0-957.el7.x86_64上会触发java.lang.NoClassDefFoundError: javax/xml/bind/DatatypeConverter根源是 JAXB 被移除而 5.1.47 不依赖 JAXB。2.2 MyBatis vs JPA为什么访客系统必须手写 SQL访客登记有强业务规则同一身份证号当天只能登记一次需SELECT COUNT(*) FROM visitor_log WHERE id_card ? AND DATE(create_time) CURDATE()访客超时未离校需标为“滞留”但滞留状态不能被前端直接修改需后台定时任务扫描create_time NOW() - INTERVAL 24 HOUR AND status IN导出报表要按“被访院系”分组统计且需关联department表的dept_name字段JPA 的Query虽能写原生 SQL但复杂 JOIN GROUP BY 时间函数组合极易触发 Hibernate 的 N1 查询或缓存失效。而 MyBatis 的select标签让你把上述三条 SQL 原样贴进去加useCachefalse关闭二级缓存用resultMap精确映射VisitorLog实体的deptName字段非数据库列。更重要的是——所有 SQL 都在mapper.xml里运维人员查问题时 grep 一下就能定位到具体语句不用翻 Java 类找Query注解。2.3 数据库设计一张表如何承载“访客-被访人-车辆-陪同人”四维关系别一上来就建七八张表。访客系统核心就三张表visitor_log主表含id,id_card,name,phone,visit_purpose,visit_dept_id,in_time,out_time,status,create_by,create_timedepartment字典表id,dept_code,dept_name,contact_person,contact_phoneadmin_user操作员表id,username,password,real_name,role值为ADMIN/DEPT_CLERK重点在visitor_log.visit_dept_id是外键但不设 ON DELETE CASCADE——因为院系可能长期存在且删除院系需人工审核。status字段用枚举值IN已入校、OUT已离校、CANCELLED已取消、OVERDUE滞留。out_time允许为 NULL但status OUT时必须out_time IS NOT NULL这个约束靠 MyBatis 的Update方法里手动判空实现而不是依赖数据库 CHECKMySQL 5.7 不支持 CHECK。!-- VisitorLogMapper.xml 片段带业务逻辑的更新 -- update idupdateOutTime parameterTypemap UPDATE visitor_log SET out_time NOW(), status OUT WHERE id #{id} AND status IN AND out_time IS NULL /update这段 SQL 的AND status IN AND out_time IS NULL是双重保险防止重复点击“离校”按钮导致out_time被覆盖也避免status被恶意篡改后绕过校验。3. 访客登记核心流程落地从扫码登记到短信通知的全链路实现3.1 前端扫码登记页为什么用原生 HTML jQuery 而不用 Vue学校机房电脑配置老旧Intel Celeron G1610 2GB RAMChrome 版本卡在 63不支持 ES6 Module。Vue 2.6 的v-model在 IE11 下有兼容问题而 jQuery 1.12.4 是唯一能在所有校园终端稳定运行的 JS 库。登记页就一个表单身份证号18 位正则校验、姓名、手机号11 位、被访院系下拉框数据来自/dept/list接口、事由textarea、是否驾车checkbox、车牌号条件显示。关键点在于所有字段提交前必须本地校验且身份证号实时调用后端接口查重。// checkIdCardDuplicate.js function checkIdCard(idCard) { $.get(/visitor/checkIdCard?card idCard, function(data) { if (data.exists) { alert(该身份证今日已登记请勿重复提交); $(#idCard).focus(); return false; } }); } $(#idCard).blur(function() { const card $(this).val().trim(); if (/^\d{17}[\dXx]$/.test(card)) { checkIdCard(card); } });注意/visitor/checkIdCard接口返回 JSON{ exists: true }不是布尔值。因为 jQuery 的$.get默认将true解析为字符串true易出错统一用对象字段更可靠。3.2 后端 Controller 层如何用Transactional控制“登记发短信”原子性访客登记成功后必须发短信通知被访人但短信网关可能超时。若登记入库成功而短信失败会导致数据不一致。解决方案把短信发送逻辑放在Transactional事务之外用“登记成功 → 记录待发短信队列 → 异步发送”模式。这里不引入 RabbitMQ而是用最简方案——在visitor_log表加一列sms_status TINYINT DEFAULT 00未发1已发2发送失败登记成功后插入一条sms_queue记录含visitor_id,target_phone,content,status,create_time再由 Quartz 定时任务每 30 秒扫描status0的记录调用短信接口。// VisitorController.java PostMapping(/register) ResponseBody public Result register(RequestBody VisitorLog log) { try { // 1. 先检查今日是否已登记 if (visitorService.isIdCardRegisteredToday(log.getIdCard())) { return Result.fail(今日已登记); } // 2. 插入登记记录 visitorService.insert(log); // 3. 插入短信待发队列非事务内 smsQueueService.enqueue(log.getVisitDeptId(), log.getPhone(), String.format(【XX学校】%s 已登记来访事由%s, log.getName(), log.getVisitPurpose())); return Result.success(登记成功); } catch (Exception e) { log.error(登记失败, e); return Result.fail(系统繁忙请稍后再试); } }提示“登记发短信”不放同一事务是因为短信接口不可控。若强行塞进事务一旦短信超时整个事务回滚访客登记也失败——用户体验极差。而用队列异步即使短信失败sms_queue.status变成 2后续人工可查日志重发登记数据始终有效。3.3 短信发送模块用 HttpURLConnection 调用三大运营商 API 的避坑写法学校合作的短信服务商提供 HTTP 接口要求 POSTapplication/x-www-form-urlencoded数据含account,password,mobile,content,formatjson。千万别用RestTemplate——它默认启用连接池在高并发下会耗尽 socket。改用HttpURLConnection手动控制超时// SmsSender.java public boolean send(String phone, String content) { URL url; try { url new URL(https://api.sms-provider.com/send); HttpURLConnection conn (HttpURLConnection) url.openConnection(); conn.setRequestMethod(POST); conn.setConnectTimeout(5000); // 连接超时 5s conn.setReadTimeout(10000); // 读取超时 10s conn.setDoOutput(true); conn.setRequestProperty(Content-Type, application/x-www-form-urlencoded); String params String.format(account%spassword%smobile%scontent%sformatjson, URLEncoder.encode(your_account, UTF-8), URLEncoder.encode(your_pwd, UTF-8), URLEncoder.encode(phone, UTF-8), URLEncoder.encode(content, UTF-8)); try (DataOutputStream out new DataOutputStream(conn.getOutputStream())) { out.writeBytes(params); } int responseCode conn.getResponseCode(); if (responseCode 200) { try (BufferedReader in new BufferedReader( new InputStreamReader(conn.getInputStream(), UTF-8))) { String result in.readLine(); return result.contains(\code\:0); // 成功返回 {code:0,msg:OK} } } return false; } catch (Exception e) { log.error(短信发送异常, e); return false; } }关键点URLEncoder.encode必须对每个参数单独编码否则含中文的content会乱码conn.setConnectTimeout和setReadTimeout必须显式设置否则默认无限等待responseCode 200后才读InputStream避免 400/500 错误时读getErrorStream()出错。4. 部署与运维避坑在 CentOS 7 上让 SSM 系统真正“跑起来”的 5 个血泪经验4.1 Tomcat 启动报java.lang.OutOfMemoryError: Metaspace不是内存小是 classloader 泄漏现象系统首次部署正常但反复热部署rm -rf webapps/ROOT cp -r target/visitor.war webapps/3 次后Tomcat 日志出现Metaspace OOM进程僵死。原因MyBatis 的SqlSessionFactoryBean在ApplicationContext销毁时未正确关闭SqlSession导致ClassLoader无法回收Metaspace 持续增长。解决在web.xml中添加监听器确保 Spring 上下文关闭时释放资源!-- web.xml -- listener listener-classorg.springframework.web.context.ContextLoaderListener/listener-class /listener listener listener-classorg.springframework.web.util.IntrospectorCleanupListener/listener-class /listener同时在spring-context.xml中为SqlSessionFactoryBean显式配置destroy-methoddestroybean idsqlSessionFactory classorg.mybatis.spring.SqlSessionFactoryBean destroy-methoddestroy property namedataSource refdataSource/ property nameconfigLocation valueclasspath:mybatis-config.xml/ /bean4.2 MySQL 连接池报Communications link failure检查防火墙和 wait_timeout现象系统运行 8 小时后所有数据库操作报com.mysql.jdbc.exceptions.jdbc4.CommunicationsException重启 Tomcat 恢复。原因MySQL 默认wait_timeout 288008 小时连接池中的空闲连接被 MySQL 主动断开但连接池未检测到仍认为连接有效。解决在druid.properties中配置# druid.properties driverClassNamecom.mysql.jdbc.Driver urljdbc:mysql://192.168.1.100:3306/visitor_db?useUnicodetruecharacterEncodingutf8autoReconnecttruefailOverReadOnlyfalse usernameroot password123456 # 关键参数 validationQuerySELECT 1 testWhileIdletrue timeBetweenEvictionRunsMillis60000 minEvictableIdleTimeMillis300000testWhileIdletrue让连接池在连接空闲时执行SELECT 1检测有效性timeBetweenEvictionRunsMillis60000每分钟扫描一次空闲连接minEvictableIdleTimeMillis3000005 分钟无活动即驱逐——这比 MySQL 的 8 小时更激进确保连接永远新鲜。4.3 访客登记页 CSS 错位不是浏览器问题是 Tomcat 的defaultServlet缓存了旧静态资源现象修改了css/style.css并重新打包 WAR但访问页面仍是旧样式清浏览器缓存无效。原因Tomcat 的defaultServlet会缓存静态资源且默认init-param中sendfile开启导致文件未实时读取。解决在conf/web.xml中找到defaultservlet添加或修改servlet servlet-namedefault/servlet-name servlet-classorg.apache.catalina.servlets.DefaultServlet/servlet-class init-param param-namedebug/param-name param-value0/param-value /init-param init-param param-namelistings/param-name param-valuefalse/param-value /init-param init-param param-namesendfile/param-name param-valuefalse/param-value !-- 关键禁用 sendfile -- /init-param load-on-startup1/load-on-startup /servlet同时在web.xml中强制禁用静态资源缓存servlet-mapping servlet-namedefault/servlet-name url-pattern*.css/url-pattern /servlet-mapping servlet-mapping servlet-namedefault/servlet-name url-pattern*.js/url-pattern /servlet-mapping4.4 登录后跳转 404web.xml的welcome-file-list和 SpringMVC 的RequestMapping冲突现象输入http://ip:8080/visitor/正常显示登录页但登录成功后跳转到/visitor/index.jsp却 404。原因web.xml中welcome-file-list设为index.jsp但 SpringMVC 的DispatcherServlet拦截了*.jsp导致 JSP 未被JspServlet处理。解决彻底放弃 JSP全部用 HTML Thymeleaf 或纯静态 HTML。本项目采用最简方案——web.xml中DispatcherServlet的url-pattern改为/拦截所有请求然后在 Controller 中返回redirect:/static/index.html静态资源放在src/main/webapp/static/目录下由 Tomcat 的defaultServlet直接服务。4.5 定时任务不执行Quartz 的SchedulerFactoryBean未注入dataSource现象Scheduled注解的方法在开发环境正常但部署到 CentOS 后定时扫描sms_queue无日志输出。原因Scheduled依赖 Spring 的TaskScheduler而 Quartz 需要SchedulerFactoryBean显式配置dataSource才能持久化任务状态本项目虽未用持久化但未配置dataSource会导致 Scheduler 初始化失败。解决在spring-context.xml中声明bean idschedulerFactoryBean classorg.springframework.scheduling.quartz.SchedulerFactoryBean property namedataSource refdataSource/ property namequartzProperties props prop keyorg.quartz.scheduler.instanceNameVisitorScheduler/prop prop keyorg.quartz.jobStore.classorg.quartz.simpl.RAMJobStore/prop /props /property /bean注意jobStore.class用RAMJobStore内存存储避免引入quartz.properties文件和额外表结构——访客系统不需要任务持久化内存够用。5. 真实场景验证用三类典型数据跑通全流程的压测与日志追踪技巧5.1 构造三类测试数据覆盖“正常登记”、“重复身份证”、“超时滞留”全路径别只用 Postman 测试/register接口。必须构造真实数据流正常流身份证110101199003072712姓名张三电话13800138000院系计算机学院事由设备维修→ 预期statusINsms_queue.status0短信队列新增 1 条重复流同一身份证 5 分钟内二次提交 → 预期isIdCardRegisteredToday()返回trueController 返回{code:500,msg:今日已登记}滞留流手动UPDATE visitor_log SET in_time NOW() - INTERVAL 25 HOUR, status IN WHERE id 123→ 预期Quartz 任务每 30 秒扫描将status更新为OVERDUE并记录log表验证方法在 MySQL 中执行SELECT * FROM visitor_log ORDER BY create_time DESC LIMIT 5;同时tail -f /var/log/tomcat/catalina.out | grep OVERDUE查看日志。5.2 日志追踪如何用 Logback 的 MDC 实现“一次登记全程可溯”访客登记涉及 Controller → Service → Mapper → SMS 发送多个环节出问题时需快速定位哪一环失败。用 Logback 的 MDCMapped Diagnostic Context在线程上下文注入traceId// VisitorController.java PostMapping(/register) ResponseBody public Result register(RequestBody VisitorLog log) { String traceId UUID.randomUUID().toString().replace(-, ).substring(0, 12); MDC.put(traceId, traceId); log.info(访客登记开始: {}, log); try { // ... 业务逻辑 log.info(访客登记成功: id{}, log.getId()); return Result.success(登记成功); } catch (Exception e) { log.error(访客登记失败, e); return Result.fail(系统繁忙); } finally { MDC.clear(); } }对应logback-spring.xml配置appender nameFILE classch.qos.logback.core.rolling.RollingFileAppender encoder pattern%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] [%X{traceId}] %-5level %logger{36} - %msg%n/pattern /encoder /appender效果日志中每行开头带[abc123def456]grepabc123def456即可捞出本次请求所有日志无需翻 timestamps 对齐。5.3 生产环境必备用jstat实时监控 JVM揪出 GC 频繁的真凶某次上线后访客登记响应变慢从 200ms 升至 2s。top显示 CPU 仅 30%但jstat -gc pid显示YGCTYoung GC 次数每秒 5 次FGCTFull GC每 5 分钟一次——明显内存泄漏。用jmap -histo pid | head -20发现org.apache.ibatis.executor.loader.javassist.JavassistProxyFactory$BytecodeEntityLoader实例达 12 万根源是 MyBatis 的延迟加载代理对象未释放。解决方案在mybatis-config.xml中关闭延迟加载settings setting namelazyLoadingEnabled valuefalse/ setting nameaggressiveLazyLoading valuefalse/ /settings血泪经验MyBatis 的lazyLoadingEnabledtrue在高并发下极易引发OutOfMemoryError: Metaspace因为每个延迟加载属性都会生成一个 Javassist 字节码类。访客系统无复杂嵌套查询关掉它性能提升 30%GC 频率归零。我坚持在每次部署前用jstat -gc pid看一眼就像开车前系安全带——它不会让你的系统更快但能让你在凌晨两点接到告警电话时30 秒内定位到是 GC 问题还是 SQL 慢查询。希望帮到你。本文还有配套的精品资源点击获取