簡介這是一套基于Spring Boot、MyBatis-Plus與Layui的校園疫情管理系統(tǒng)面向高校信息化管理人員、Java全棧學習者以及畢業(yè)設計開發(fā)者。系統(tǒng)圍繞疫情背景下的校園管理需求完成健康數(shù)據(jù)采集、審批流轉、多角色權限管控等核心功能。資源包為RAR壓縮格式共850個文件整體容量約58.11MB主要文件包括Java源碼、XML映射與配置文件、HTML頁面、CSS樣式、JavaScript腳本、圖片圖標以及SQL數(shù)據(jù)庫腳本等目錄結構完整導入IDE即可運行或二次開發(fā)。在功能層面系統(tǒng)接入了騰訊API可展示中國疫情確診分布地圖和實時疫情新聞并通過餅圖、折線圖、柱狀圖對疫情數(shù)據(jù)進行可視化集成Shiro安全框架實現(xiàn)學生、教師、院系管理員等不同角色的動態(tài)菜單權限分配。業(yè)務模塊覆蓋健康打卡、疫情數(shù)據(jù)管理、院系班級管理、核酸檢測管理、疫苗接種管理以及學生請假串行審批等同時支持Excel拖拽上傳與導出具備條件查詢與分頁的增刪改查能力。資源包已有1122人學習適合用作畢業(yè)設計參考也可幫助開發(fā)者深入理解RBAC權限設計與數(shù)據(jù)可視化實現(xiàn)。1. 校園疫情管理系統(tǒng)為什么還在用 SpringBoot 三件套校園疫情管理系統(tǒng)不只是一張今日健康打卡表。它的真實形態(tài)是學生每日上報體溫和行程、輔導員審核異常、校醫(yī)跟進隔離狀態(tài)、管理員看全院統(tǒng)計大屏。這句話拆開之后你會發(fā)現(xiàn)它同時踩中了三個后端項目最常見的問題數(shù)據(jù)寫入頻繁但邏輯簡單、權限層級多但又不適合上重型工作流、統(tǒng)計查詢要快但表結構天天變。SpringBoot MybatisPlus layui 這套組合恰恰把這三件事的性價比做到極致SpringBoot 管好接口生命周期和依賴注入MybatisPlus 用 ActiveRecord 風格把單表 CRUD 壓到幾乎沒有樣板代碼layui 自帶表格、彈層、日期組件不需要前端構建鏈就能在真實服務器上跑起來。對做畢設、做課設、做中小型校內系統(tǒng)的開發(fā)者來說這是最快能落地的路線。下面要寫的不是項目介紹而是一套可以照著抄的落地方案從表設計、代碼分層、layui 表格對接到分頁失效、日期控件限制、自動建表這幾個高頻坑一次說清。2. SpringBoot 與 MybatisPlus 的數(shù)據(jù)層設計先定表再寫代碼2.1 表結構設計的取舍疫情管理系統(tǒng)的核心數(shù)據(jù)無非四類學生基礎信息、每日健康上報、出校審批、異常記錄。這四類數(shù)據(jù)在真實業(yè)務里的特點是字段多但都不復雜、狀態(tài)流轉明確、查詢條件基本都是學院 日期 狀態(tài)。所以表設計不需要過度范式化反而應該把高頻查詢字段直接冗余到主表里。CREATE TABLE tb_student ( id bigint(20) NOT NULL AUTO_INCREMENT, student_no varchar(32) NOT NULL COMMENT 學號, name varchar(32) NOT NULL, college varchar(64) DEFAULT NULL COMMENT 學院, grade varchar(16) DEFAULT NULL COMMENT 年級, phone varchar(16) DEFAULT NULL, status tinyint(1) DEFAULT 1 COMMENT 1在校 0離校, PRIMARY KEY (id), UNIQUE KEY uk_student_no (student_no) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT學生表; CREATE TABLE tb_health_report ( id bigint(20) NOT NULL AUTO_INCREMENT, student_id bigint(20) NOT NULL, report_date date NOT NULL COMMENT 上報日期, temperature decimal(4,2) DEFAULT NULL COMMENT 體溫, health_code varchar(16) DEFAULT NULL COMMENT 綠碼/黃碼/紅碼, is_abnormal tinyint(1) DEFAULT 0 COMMENT 1異常 0正常, remark varchar(255) DEFAULT NULL, create_time datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_date_status (report_date, is_abnormal) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT健康上報表;字段不需要一個都不剩地照抄但兩個點要注意一是report_date用 date 而不是 datetime因為業(yè)務維度就是按天上報用 datetime 反而讓統(tǒng)計查詢多一層轉換二是唯一索引必須加在(student_id, report_date)上否則學生一天重復提交會留臟數(shù)據(jù)。MybatisPlus 的saveOrUpdate無法天然防重復最終要靠這個唯一索引兜底。2.2 SpringBoot 集成 MybatisPlus 的最小配置MybatisPlus 3.5.x 是目前主流版本SpringBoot 2.7.x 對應 JDK8 項目足夠。在pom.xml里只需要引入兩個依賴dependency groupIdcom.baomidou/groupId artifactIdmybatis-plus-boot-starter/artifactId version3.5.3.1/version /dependency dependency groupIdcom.mysql/groupId artifactIdmysql-connector-j/artifactId /dependency不需要額外引入 mybatis 依賴starter 會自動帶。application.yml里重點配置兩項邏輯刪除和分頁插件。邏輯刪除是疫情管理系統(tǒng)的剛需因為學生異動和上報記錄不能物理刪除否則事后審計沒法追溯。spring: datasource: url: jdbc:mysql://localhost:3306/campus_epidemic?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: ${DB_PASSWORD:root} jackson: date-format: yyyy-MM-dd HH:mm:ss time-zone: GMT8 mybatis-plus: global-config: db-config: logic-delete-field: deleted logic-delete-value: 1 logic-not-delete-value: 0 configuration: map-underscore-to-camel-case: true log-impl: org.apache.ibatis.logging.stdout.StdOutImpl密碼這一行用了${DB_PASSWORD:root}的占位符形式意思是環(huán)境變量里有 DB_PASSWORD 就用它沒有就 fallback 到 root。這個習慣尤其在部署到服務器后非常重要因為庫里可能有學生手機號和身份證號明文密碼寫進 yml 再推到代碼倉庫就是安全事故。如果還想更穩(wěn)妥一點用 Jasypt 把密碼整體加密成密文串springboot yml密文是這個方向最常見的檢索詞。不過對于小項目環(huán)境變量占位符已經(jīng)夠用。2.3 Service 層代碼別把所有邏輯堆在 Controller一個常見壞味道是 Controller 里直接注入 Mapper 然后寫 CRUD。疫情管理系統(tǒng)的業(yè)務規(guī)則比 CRUD 多一點比如學生只能改自己當天的上報輔導員只能看本院數(shù)據(jù)這些必須收斂到 Service 層。MybatisPlus 的IService接口加上ServiceImpl實現(xiàn)類的寫法public interface HealthReportService extends IServiceHealthReport { boolean reportToday(HealthReport report); PageHealthReportVO pageWithStudent(PageHealthReport page, String college, Integer isAbnormal); } Service public class HealthReportServiceImpl extends ServiceImplHealthReportMapper, HealthReport implements HealthReportService { Override public boolean reportToday(HealthReport report) { report.setReportDate(LocalDate.now()); report.setIsAbnormal(report.getTemperature() ! null report.getTemperature().compareTo(new BigDecimal(37.3)) 0 ? 1 : 0); return saveOrUpdate(report); } }這段代碼的核心邏輯不在saveOrUpdate而在setIsAbnormal之前的那行判斷。體溫是否異常是一個業(yè)務規(guī)則把它放在 Service 層意味著將來調整閾值時只改一個地方。前端拿到上報成功與否就夠了不應該由前端告訴后端這個人異常了因為前端可以被繞過。另外注意report.setReportDate(LocalDate.now())后端強制取服務器日期不信任客戶端傳的日期否則學生會改手機系統(tǒng)時間補填昨天的記錄。3. layui 表格與后端接口的聯(lián)調日期、分頁、行點擊事件3.1 layui 的 table 模塊和 SpringBoot 分頁接口對齊格式layui 的 table 模塊默認請求方式是把page和limit作為普通參數(shù)發(fā)到后端返回格式要求是{code:0, msg:, count:100, data:[]}。這個約定和 SpringBoot 的 Page 對象天然匹配只需在 Controller 里做一個組裝不要直接把 MybatisPlus 的 Page 對象返回出去。RestController RequestMapping(/api/report) public class HealthReportController { Autowired private HealthReportService reportService; GetMapping(/page) public MapString, Object page(RequestParam(defaultValue 1) long page, RequestParam(defaultValue 10) long limit, String college, Integer isAbnormal) { PageHealthReport p new Page(page, limit); PageHealthReportVO result reportService.pageWithStudent(p, college, isAbnormal); MapString, Object map new HashMap(); map.put(code, 0); map.put(msg, ); map.put(count, result.getTotal()); map.put(data, result.getRecords()); return map; } }把 Page 對象轉成 Map 返回一方面是為了匹配 layui 的協(xié)議另一方面是避免把 MybatisPlus 的pages、current、optimizeCountSql這些內部字段暴露給前端。defaultValue要顯式寫上否則前端第一次加載表格沒傳 page 時SpringBoot 會直接 400。layui 表格默認每頁 10 條但統(tǒng)計頁通常需要更大所以前端 render 里我會顯式寫明page: true, limit: 20。3.2 layui 日期控件限制最大日期為今天健康上報表格里日期范圍查詢是最常用篩選條件。layui 的laydate組件默認允許選未來日期如果不限制用戶選到明天甚至下個月查詢結果永遠為空而且會讓人以為是 Bug。限制最大日期的寫法是laydate.render({ elem: #reportDateRange, type: date, range: true, max: laydate.now() });max: laydate.now()是最容易被忽略的一行。laydate 的max參數(shù)支持三種格式固定字符串2025-12-31、函數(shù)laydate.now()、以及帶偏移的寫法max: -1。laydate.now()取的是客戶端本地時間而查詢接口對日期范圍的上限約束在后端還要再校驗一次。if (endDate.isAfter(LocalDate.now())) { throw new BizException(結束日期不能晚于今天); }前端限制只是體驗優(yōu)化后端校驗才是數(shù)據(jù)正確性的保障。凌晨跨天時最容易出問題前端頁面開著沒過期但到了零點之后now()已經(jīng)是新的一天用戶選了昨天作為結束日期前端不會攔截后端如果不校驗就直接放行了。所以在后端寫這個校驗不是形式主義。3.3 table 列點擊事件不只是加個監(jiān)聽器需求里常見的點擊學生姓名彈出詳情放在 layui 里有兩種做法。一種是在cols配置里給列加templet模板把名字渲染成帶lay-eventdetail的a標簽然后在table.on(tool(filter), ...)回調里操作。另一種是cellClick事件區(qū)別在于前者只能命中設置了lay-event的 HTML 元素后者可以精確到某個單元格。實際開發(fā)中我推薦第一種。table.render({ elem: #reportTable, url: /api/report/page, page: true, cols: [[ { field: studentNo, title: 學號, width: 120 }, { field: name, title: 姓名, width: 100, templet: a classlayui-table-link lay-eventstudentDetail{{ d.name }}/a }, { field: temperature, title: 體溫, width: 80, templet: function(d) { if (d.temperature ! null Number(d.temperature) 37.3) { return span stylecolor:#FF5722 d.temperature ℃/span; } return d.temperature ℃; }}, { field: createTime, title: 上報時間, width: 170 } ]] }); table.on(tool(reportTable), function(obj) { if (obj.event studentDetail) { showStudentModal(obj.data.studentId); } });templet里的d就是當前行數(shù)據(jù)用字符串模板直接拼 HTML或者用函數(shù)方式返回帶樣式的結構。體溫正紅色顯示這個細節(jié)可以一眼篩出異常記錄比多寫一列isAbnormal再判斷更直觀。注意tool監(jiān)聽的lay-filter值要和table.render里的elem對應如果 render 時沒有寫id: reportTable事件綁定是無效的。事件名和過濾器的對應關系是 layui 初學者最容易卡殼的地方。4. 單表 500 條限制、分頁失效的表單提交問題4.1 超過 500 條數(shù)據(jù) MybatisPlus 單頁查不出來先確認是不是 SQL 寫錯接觸mybatisplus單頁500條限制這個熱搜詞反映了一個常見現(xiàn)象列表頁翻到第二頁之后數(shù)據(jù)重復或缺失。先說結論MybatisPlus 本身沒有 500 條分頁限制出問題的地方大多在PaginationInnerInterceptor沒有注冊。分頁插件必須顯式聲明Configuration public class MybatisPlusConfig { Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; } }DbType.MYSQL會自動把分頁改寫為LIMIT沒配這個 Bean 時Page傳進去也是全表查詢。還有一個隱蔽場景自定義 SQL 里的分頁失效。當你在 Mapper.xml 里手寫了selectList或selectPage對應的方法并且拼接了${ew.customSqlSegment}同時查詢條件里帶了last或自己寫了LIMIT就會出現(xiàn)分頁和自定義條件互相覆蓋。select idselectReportPageWithCollege resultTypecom.example.vo.HealthReportVO SELECT r.*, s.name, s.college FROM tb_health_report r LEFT JOIN tb_student s ON r.student_id s.id where if testcollege ! null and college ! AND s.college #{college} /if /where ORDER BY r.create_time DESC /select分頁攔截器是攔截執(zhí)行層面的 SQL把整條查詢包一層COUNT再追加LIMIT。上面的自定義 SQL 帶LEFT JOIN如果發(fā)現(xiàn)總數(shù)對但列表數(shù)據(jù)偏移多半是 COUNT 語句里把 LEFT JOIN 關聯(lián)出來的重復行算進去了。排查方法很簡單把 MybatisPlus 日志打開看打印出來的 COUNT SQL 是什么單獨拿去數(shù)據(jù)庫執(zhí)行一眼就能看出 count(*) 和表實際行數(shù)對不上。4.2 表單重復提交導致一天多條上報記錄學生端最常見的一個 Bug 是點提交后接口響應慢心急再點一次結果生成了兩條同一天的上報。這個問題在reportToday這個方法里用saveOrUpdate是防不住的因為第一次請求和第二次請求到達 Service 時數(shù)據(jù)庫中都不存在當天記錄兩個線程都走 INSERT。數(shù)據(jù)庫唯一索引uk_student_report_date會攔截第二次 INSERT 并拋 DuplicateKeyException。public boolean reportToday(HealthReport report) { try { return saveOrUpdate(report); } catch (DuplicateKeyException e) { // 再次嘗試更新避免直接報錯給用戶 report.setId(getBaseMapper().selectOne(new LambdaQueryWrapperHealthReport() .eq(HealthReport::getStudentId, report.getStudentId()) .eq(HealthReport::getReportDate, LocalDate.now())).getId()); return updateById(report); } }前端按鈕加上lay-disable狀態(tài)在 ajax 回調前禁止重復點擊只是緩解。真正的防線是唯一索引加 DuplicateKeyException 捕獲二者缺一不可。注意捕獲異常后的二次更新里report.getId()可能是 null需要先從庫里把主鍵查出來再updateById這也是為什么建議保留唯一索引而不是去掉。4.3 出入校審批的狀態(tài)流轉不要用 int 裸奔出校審批的狀態(tài)字段如果直接存0/1/2過三個月沒人記得 1 是待輔導員審批還是待校醫(yī)審批。常見做法是用枚舉類管理public enum ApproveStatus { PENDING(0, 待審批), PASS(1, 已通過), REJECT(2, 已駁回); }MybatisPlus 默認的枚舉映射需要加EnumValue注解。但更簡單的方案是直接存字符串狀態(tài)碼PENDING / PASS / REJECT可讀性比數(shù)字好得多而且在 SQL 排查時一眼能看懂。這一層算是少即是多——復雜狀態(tài)機對校內審批場景屬于過度設計status加update_time加audit_remark就足夠審計了。5. 部署前的三個必查點字段自動建表、接口安全、統(tǒng)計口徑5.1 要不要讓 MybatisPlus 自動建表搜索熱詞里出現(xiàn)表不存在自動建表說明不少項目在開發(fā)階段被建表 SQL 折磨過。MybatisPlus 本身沒有內置 DDL 自動建表能力它只管 ORM。常見做法有兩種一是集成mybatis-plus-ddl這類插件啟動時比對實體類注解建表二是在application.yml配置spring.sql.init.mode: always配合schema.sql在啟動時執(zhí)行。我的建議是第二種因為 DDL 腳本可以被版本管理改動記錄清楚。spring: sql: init: mode: always schema-locations: classpath:db/schema.sql continue-on-error: falseschema.sql里寫CREATE TABLE IF NOT EXISTS啟動報錯時continue-on-error設為 false 可以快速暴露問題。生產(chǎn)環(huán)境務必把mode改成never否則每次啟動都可能覆蓋變更。5.2 接口層面的最小安全策略校園系統(tǒng)在公網(wǎng)暴露的情況不多但一旦暴露最先被掃描的就是/actuator/heapdump、/api/report/page這種無鑒權接口。最輕量的做法是加一個 HandlerInterceptor 做 token 校驗public class LoginInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { String token request.getHeader(Authorization); if (token null || !TokenStore.isValid(token)) { response.setStatus(401); response.getWriter().write({\code\:401,\msg\:\unauthorized\}); return false; } return true; } }項目里如果引了 spring-boot-starter-actuator建議把暴露端點全部關掉或者至少加management.endpoints.web.exposure.include: health避免 heapdump 敏感信息被拉走。技術上你不是在處理理論威脅而是在處理真實發(fā)生過的事故——這個風險點已經(jīng)不屬于可選項了。5.3 統(tǒng)計報表的 Slow SQL 排查管理員首頁的今日上報率各學院異常人數(shù)這類統(tǒng)計優(yōu)化空間比想象中大。一個常見壞味道是前端加載頁面時同時發(fā)十幾個統(tǒng)計請求每個請求都執(zhí)行一次GROUP BY COUNT數(shù)據(jù)庫壓力全在運行時的計算上。正確做法是加一張tb_report_statistics日匯總表每晚定時任務統(tǒng)計一次前端只查這張表Component public class StatisticTask { Scheduled(cron 0 10 0 * * ?) public void generateYesterdayStatistic() { ListDailyStatistic list reportMapper.selectDailyGroupByCollege(LocalDate.now().minusDays(1)); statisticService.saveBatch(list); } }日匯總表加定時任務是一個從功能能用到扛得住早高峰的分水嶺。如果不想加表至少給統(tǒng)計 SQL 涉及的report_date和college建聯(lián)合索引。排查慢 SQL 用 MySQL 的slow_query_log即可定位到具體 SQL 后用EXPLAIN看 type 字段是否是ref以上而不是ALL。6. 一個順手的小技巧用 MybatisPlus 的 condition 參數(shù)收斂查詢條件LambdaQueryWrapper的eq方法有一個重載接收boolean condition參數(shù)這個參數(shù)在接 layui 表格篩選時特別好用。前端可能傳college空字符串、isAbnormalnull如果不處理就會變成WHERE college 導致查不到數(shù)據(jù)。常見寫法是每個字段都if判斷一次代碼又臭又長。public PageHealthReportVO pageWithStudent(PageHealthReport page, String college, Integer isAbnormal) { LambdaQueryWrapperHealthReport wrapper new LambdaQueryWrapper(); wrapper.eq(StringUtils.hasText(college), HealthReport::getCollege, college) .eq(isAbnormal ! null, HealthReport::getIsAbnormal, isAbnormal) .orderByDesc(HealthReport::getReportDate); return baseMapper.selectReportPageWithCollege(page, wrapper); }.eq(condition, column, value)里 condition 為 false 時整段條件不拼接到 SQL。這個 API 是 MybatisPlus 比較實用的設計之一能讓查詢接口少寫 30% 的 if 判斷。注意StringUtils.hasText是 Spring 提供的工具方法如果你在非 Spring 環(huán)境測試這段代碼換成college ! null !college.isEmpty()也一樣。另外一個細節(jié)是orderByDesc要放在最后否則LIMIT分頁在排序字段有相同值時會出現(xiàn)翻頁數(shù)據(jù)重疊這也是為什么要在排序字段后面追加一個唯一字段比如orderByDesc(HealthReport::getReportDate).orderByDesc(HealthReport::getId)。加上唯一字段兜底后翻頁重復率基本歸零。整套方案寫到這里從表設計到前端聯(lián)調再到部署排錯核心鏈路已經(jīng)完整覆蓋。剩余的工作就是建兩個測試賬號跑一遍學生上報—輔導員審核—管理員看統(tǒng)計的主流程把異常體溫閾值從 37.3 改成 37.5 驗一下規(guī)則是否真的只改一處。運行mvn spring-boot:run把項目拉起來打開本地 8080 端口剩下的交互細節(jié)在日志里見真章。本文還有配套的精品資源點擊獲取