1. 项目整体设计与业务拆解
1.1 为什么高校需要学业预警系统
这些年高校扩招带来的一个现实问题，就是学生基数变大之后，靠辅导员人工盯成绩、算学分、查考勤的做法，已经跟不上了。一个辅导员往往要带两百号学生，单是期中期末去教务系统里逐个查成绩、算绩点，就得折腾好几天，等发现某个学生挂科太多的时候，往往已经错过了最佳干预时机。学业预警系统要解决的核心问题，就是把"事后补救"变成"事中干预"，通过规则化的数据计算，在学生的学业状态刚出现异常苗头时，就自动触发提醒。
我接这个项目的时候，对方信息化中心的老师给了一个很直接的需求：系统必须能按学期自动计算学生的学业状态，把学生分成正常、关注、警告、严重警告、退学预警几个等级，并且做到"系里能看到本系、辅导员能看到本班、教务处能看到全校"这种分级视角。这就决定了系统本质上不是简单的CRUD，而是一个带规则引擎、带角色权限、带定时任务的业务系统。
1.2 技术选型背后的取舍
后端用Spring Boot基本上是当前Java技术栈里最优解，一方面是因为Spring Boot的自动装配特性让项目初始化成本极低，另一方面是高校信息化中心现有的运维体系普遍对Java生态更熟悉。考虑到后续可能要和教务系统做数据对接，Spring Boot自带的RestTemplate和WebClient也能方便地调用外部接口。这里我没有选择微服务架构——学业预警系统虽然涉及学生、课程、成绩、预警记录等多个模块，但业务体量远没到需要拆分的程度，单体应用加模块化分包，部署运维成本低得多，出了问题也好排查。
前端选Vue而不是React，核心原因是Vue对国内开发者更友好，中文资料丰富，而且Vue 3的组合式API配合Element Plus做后台管理界面，开发效率非常可观。另一个重要因素是高校信息化部门往往需要后续人员能快速接手，Vue的上手曲线相对平缓，招人也好招。我用的版本组合是Spring Boot 2.7.x + Vue 3 + Element Plus，这套组合已经过大量生产环境验证，稳定性有保障。
1.3 业务模块与数据库设计的前置规划
学业预警系统的核心业务可以拆成五大模块：学生信息管理、课程与成绩管理、预警规则配置、预警计算引擎、预警结果处理。在设计阶段就要想清楚一个关键问题：预警规则是每个学校各不相同的，有的学校按挂科学分算，有的按平均绩点算，有的还要考虑一学期不及格课程数量，所以规则必须做成可配置的，绝对不能把规则写死在代码里。
数据库表设计上，我用了以下几张核心表：学生表（含学号、姓名、年级、专业、班级）、课程表（含课程编号、课程名称、学分、课程性质）、成绩表（含学号、课程编号、学期、成绩）、预警规则表（含规则名称、指标项、阈值、比较运算符）、预警记录表（含学号、预警类型、预警等级、触发时间、处理状态）。预警规则表这个设计很关键，它存储的是类似"挂科学分>12"、"GPA<2.0"这样的可解析规则，运行时由计算引擎动态读取，不用改代码就能调整预警标准。
2. 后端Spring Boot核心架构与实现
2.1 项目基础搭建与分层设计
创建Spring Boot项目时，我习惯在Spring Initializr上直接生成基础工程，依赖勾选了Spring Web、MyBatis-Plus、MySQL Driver、Lombok、Validation。这里有个经验之谈：如果学校内网环境访问不了Spring Initializr，可以直接在IDEA里用内置的Spring Initializr，或者用阿里云的镜像地址初始化。项目建好后，包结构我是这样划分的：
com.example.academicwarning ├── controller // 接口层，只做参数接收和结果封装 ├── service // 业务层，核心逻辑都在这层 ├── mapper // 数据访问层，MyBatis-Plus的Mapper接口 ├── entity // 实体类，对应数据库表 ├── dto // 数据传输对象，用于接口参数和返回结果 ├── config // 配置类，包括MyBatis-Plus配置、跨域配置等 ├── common // 公共类，统一返回结果、异常处理、工具类 └── task // 定时任务，预警计算引擎的调度入口分层设计的原则是：Controller不写业务逻辑，只做参数校验和调用Service；Service层处理核心业务；Mapper层只做数据库交互。这个习惯在你后续维护项目时会省很多事，千万不要图省事把业务逻辑堆在Controller里。
2.2 核心依赖与配置文件的详细说明
pom.xml里除了基础的Web依赖，有几个关键依赖值得展开说说。MyBatis-Plus代替了传统MyBatis，它的最大价值是内置了通用的增删改查方法，对于学业预警系统这种大量单表操作的场景，能少写至少一半的Mapper XML。代码生成器也建议安排上，直接从数据库表生成entity、mapper、service，十几张表几分钟就能生成完。
配置文件我用了application.yml作为主配置，下面是精简后的内容：
server: port: 8080 servlet: context-path: /api spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/academic_warning?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai username: root password: root jackson: date-format: yyyy-MM-dd HH:mm:ss time-zone: GMT+8 mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl map-underscore-to-camel-case: true global-config: db-config: logic-delete-field: deleted logic-delete-value: 1 logic-not-delete-value: 0 spring: redis: host: localhost port: 6379 database: 0注意几个细节：数据库连接串一定要加上serverTimezone=Asia/Shanghai，否则服务器时区和数据库时区不一致会导致时间字段错乱；map-underscore-to-camel-case开启后，数据库的下划线字段名能自动映射到Java的驼峰属性，这个必须开；Redis做缓存，主要用来存学生的预警计算结果和登录会话，减少数据库压力。
2.3 预警规则引擎的实现思路
这是整个系统的核心。预警规则不能硬编码，我的方案是设计一个规则解析器，把数据库里配置的规则字符串解析成可执行的判断逻辑。规则表结构大致是这样的：
CREATE TABLE warning_rule ( id BIGINT PRIMARY KEY AUTO_INCREMENT, rule_name VARCHAR(100) NOT NULL COMMENT '规则名称', rule_type VARCHAR(50) NOT NULL COMMENT '规则类型：gpa/credit/course_count', operator VARCHAR(10) NOT NULL COMMENT '比较运算符：LT/LTE/GT/GTE/EQ', threshold_value DECIMAL(5,2) NOT NULL COMMENT '阈值', warning_level VARCHAR(20) NOT NULL COMMENT '预警等级：attention/warning/severe/dropout', is_active TINYINT DEFAULT 1 COMMENT '是否启用', create_time DATETIME DEFAULT CURRENT_TIMESTAMP );比如一条规则是"一学期挂科学分超过10分触发严重警告"，存储时rule_type就是credit，operator是GT，threshold_value是10.00，warning_level是severe。计算引擎在跑预警任务时，会先查出所有启用的规则，然后遍历学生计算对应的指标值，最后和阈值做比较。
计算引擎的核心逻辑写成Java代码大概是这样的：
@Service public class WarningCalculateService { @Autowired private StudentMapper studentMapper; @Autowired private ScoreMapper scoreMapper; @Autowired private WarningRuleMapper warningRuleMapper; @Autowired private WarningRecordMapper warningRecordMapper; public void calculateAllStudents(String semester) { // 1. 查询所有在校学生 List<Student> students = studentMapper.selectList( new LambdaQueryWrapper<Student>().eq(Student::getStatus, "enrolled")); // 2. 获取当前启用的所有预警规则 List<WarningRule> rules = warningRuleMapper.selectList( new LambdaQueryWrapper<WarningRule>().eq(WarningRule::getIsActive, 1)); // 3. 遍历学生，逐个计算预警结果 for (Student student : students) { calculateForOneStudent(student, semester, rules); } } private void calculateForOneStudent(Student student, String semester, List<WarningRule> rules) { // 查询该学生本学期的成绩 List<Score> scores = scoreMapper.selectList( new LambdaQueryWrapper<Score>() .eq(Score::getStudentId, student.getId()) .eq(Score::getSemester, semester)); // 计算平均绩点（GPA） BigDecimal gpa = calculateGPA(scores); // 计算挂科学分 BigDecimal failedCredit = calculateFailedCredit(scores); // 计算不及格课程数 int failedCourseCount = calculateFailedCourseCount(scores); // 遍历规则，判断是否触发预警 Map<String, BigDecimal> metrics = new HashMap<>(); metrics.put("gpa", gpa); metrics.put("credit", failedCredit); metrics.put("course_count", new BigDecimal(failedCourseCount)); for (WarningRule rule : rules) { BigDecimal metricValue = metrics.get(rule.getRuleType()); if (metricValue == null) continue; boolean triggered = compare(metricValue, rule.getOperator(), rule.getThresholdValue()); if (triggered) { // 插入预警记录，注意去重，避免重复预警 WarningRecord existing = warningRecordMapper.selectOne( new LambdaQueryWrapper<WarningRecord>() .eq(WarningRecord::getStudentId, student.getId()) .eq(WarningRecord::getSemester, semester) .eq(WarningRecord::getRuleId, rule.getId())); if (existing == null) { WarningRecord record = new WarningRecord(); record.setStudentId(student.getId()); record.setRuleId(rule.getId()); record.setSemester(semester); record.setWarningLevel(rule.getWarningLevel()); record.setTriggerValue(metricValue); record.setStatus("pending"); record.setCreateTime(LocalDateTime.now()); warningRecordMapper.insert(record); } } } } private boolean compare(BigDecimal value, String operator, BigDecimal threshold) { switch (operator) { case "LT": return value.compareTo(threshold) < 0; case "LTE": return value.compareTo(threshold) <= 0; case "GT": return value.compareTo(threshold) > 0; case "GTE": return value.compareTo(threshold) >= 0; case "EQ": return value.compareTo(threshold) == 0; default: return false; } } }计算GPA和挂科学分的逻辑里有个容易踩坑的地方：不同学校的学分绩点计算方式不一样，有的是5分制，有的是4分制，甚至有的学校不同学院还有不同的算法。我的做法是把GPA计算规则也做成可配置项，在系统参数表里存一个gpa_algorithm字段，值为4.0_scale或5.0_scale，然后在计算逻辑里做分支处理。这个设计在后期对接不同学院的个性化需求时非常有用。
2.4 定时任务与消息通知的整合
学业预警不能光靠手动触发，每学期期中、期末都要跑一次，这时候就需要定时任务。我用Spring Boot自带的@Scheduled注解来实现，配置一个每半小时扫描一次的定时任务，检查是否有需要执行的预警计算任务。通过配置中心去控制是否启用，避免每次都要重新部署。
@Component public class WarningScheduledTask { @Autowired private WarningCalculateService warningCalculateService; @Autowired private WarningNotificationService notificationService; // 每天凌晨2点执行一次全量预警计算 @Scheduled(cron = "0 0 2 * * ?") public void runDailyWarningCalculation() { // 获取当前学期，实际项目中可以从系统参数表读取 String semester = "2024-2025-1"; warningCalculateService.calculateAllStudents(semester); } // 每天凌晨3点推送预警通知给辅导员 @Scheduled(cron = "0 0 3 * * ?") public void sendWarningNotifications() { notificationService.sendPendingNotifications(); } }通知这块，我集成了邮件和短信两种渠道。学生触发预警后，系统会给辅导员发邮件，辅导员可以登录系统查看详细预警信息和处理建议。短信接口走的阿里云短信服务，需要提前申请签名和模板，高校场景下建议先做邮件通知，短信可以放到二期再做。
定时任务这块有两点要注意：一是@Scheduled默认是单线程执行的，多个定时任务会相互阻塞，如果定时任务多，要配置线程池；二是定时任务跑批时尽量在凌晨执行，避免影响正常上课时间的系统访问。
3. Vue前端核心实现与前后端对接
3.1 Vue项目初始化和目录规划
前端我用Vue 3 + Vite + Element Plus的组合。创建项目的时候直接用官方脚手架：
npm create vue@latest注意这里有个坑：不同版本的Node.js对Vite版本的要求不一样，如果Node版本太低会直接报错。建议Node版本用16.18以上或者18.x版本，Vite用4.x或5.x。创建完成后，按下面的目录组织代码：
src ├── api // 所有接口请求都放在这里，按模块拆分 ├── assets // 静态资源 ├── components // 公共组件 ├── router // 路由配置 ├── store // Pinia状态管理 ├── views // 页面组件 │ ├── student // 学生信息管理页面 │ ├── score // 成绩管理页面 │ ├── warning // 预警管理页面 │ ├── rule // 规则配置页面 │ └── system // 系统管理页面 ├── utils // 工具函数，包括axios封装 ├── App.vue └── main.js前端项目结构清晰非常重要，特别是多人协作时，目录规整能少很多沟通成本。我的习惯是api目录下的文件名和views目录一一对应，比如views/student/index.vue对应api/student.js，这样找代码非常快。
3.2 路由配置与权限控制
学业预警系统的用户角色有三种：学生、辅导员、管理员（教务处），不同角色看到的菜单和可操作功能不同。前端路由我用了动态路由方案，后端返回该用户可访问的路由列表，前端通过router.addRoute()动态挂载。
简化起见，我用了一个更直接的方案：路由写死，但在路由守卫里做角色校验。核心代码如下：
// router/index.js import { createRouter, createWebHistory } from 'vue-router' import { useUserStore } from '@/store/user' const router = createRouter({ history: createWebHistory(), routes: [ { path: '/login', name: 'Login', component: () => import('@/views/Login.vue'), meta: { public: true } }, { path: '/', component: () => import('@/layout/Index.vue'), redirect: '/dashboard', children: [ { path: 'dashboard', name: 'Dashboard', component: () => import('@/views/Dashboard.vue'), meta: { title: '首页', roles: ['admin', 'teacher', 'student'] } }, { path: 'student', name: 'StudentManage', component: () => import('@/views/student/index.vue'), meta: { title: '学生管理', roles: ['admin'] } }, { path: 'warning', name: 'WarningManage', component: () => import('@/views/warning/index.vue'), meta: { title: '预警管理', roles: ['admin', 'teacher'] } } ] } ] }) // 路由守卫 router.beforeEach((to, from, next) => { const userStore = useUserStore() const token = localStorage.getItem('token') if (to.meta.public) { next() return } if (!token) { next('/login') return } // 检查角色权限 const userRole = userStore.role if (to.meta.roles && !to.meta.roles.includes(userRole)) { next('/403') return } next() })使用localStorage存储token有个安全小隐患，在真实生产环境建议换成更安全的存储方案。另外记住一个细节：beforeEach守卫里一定要处理404和403页面，不然用户访问不存在的路由时会白屏。
3.3 Axios封装与接口对接实践
axios封装是前端工程质量的关键一环。统一封装的好处是：所有请求自动带上token、统一处理错误提示、统一处理HTTP状态码、方便做请求拦截和响应拦截的日志打印。我提供一份我常用的封装模板：
// utils/request.js import axios from 'axios' import { ElMessage } from 'element-plus' import router from '@/router' const service = axios.create({ baseURL: '/api', timeout: 10000 }) // 请求拦截器：自动附加token service.interceptors.request.use( config => { const token = localStorage.getItem('token') if (token) { config.headers['Authorization'] = token } return config }, error => { return Promise.reject(error) } ) // 响应拦截器：统一处理错误码 service.interceptors.response.use( response => { const res = response.data // 后端统一返回格式：{ code: 200, message: 'success', data: ... } if (res.code === 200) { return res.data } if (res.code === 401) { // token过期，跳转登录页 localStorage.removeItem('token') router.push('/login') return Promise.reject(new Error('登录已过期')) } ElMessage.error(res.message || '请求失败') return Promise.reject(new Error(res.message)) }, error => { ElMessage.error('网络异常，请稍后重试') return Promise.reject(error) } ) export default service// api/warning.js import request from '@/utils/request' // 获取预警列表 export function getWarningList(params) { return request({ url: '/warning/list', method: 'get', params }) } // 处理预警 export function handleWarning(data) { return request({ url: '/warning/handle', method: 'post', data }) }实际项目中，后端返回的数据结构和前端期望的格式统一非常重要。我后端定义了一个Result类，所有接口返回格式都是{ code: 200, message: 'success', data: ... }，这样前端不用在拦截器里做各种特殊判断。
3.4 核心页面实现与组件复用
预警管理页面是整个系统使用频率最高的页面，用来展示所有学生的预警状态，以及提供预警处理和跟踪功能。用Element Plus的表格组件实现，支持筛选和分页：
<template> <div class="warning-container"> <el-card> <div class="filter-bar"> <el-select v-model="queryParams.level" placeholder="预警等级" clearable> <el-option label="关注" value="attention" /> <el-option label="警告" value="warning" /> <el-option label="严重警告" value="severe" /> <el-option label="退学预警" value="dropout" /> </el-select> <el-input v-model="queryParams.keyword" placeholder="学号/姓名" clearable style="width: 200px" /> <el-button type="primary" @click="handleSearch">查询</el-button> <el-button @click="handleReset">重置</el-button> </div> <el-table :data="warningList" v-loading="loading" border stripe> <el-table-column prop="studentNo" label="学号" width="120" /> <el-table-column prop="studentName" label="姓名" width="100" /> <el-table-column prop="className" label="班级" width="150" /> <el-table-column prop="warningLevel" label="预警等级" width="120"> <template #default="{ row }"> <el-tag :type="levelTagType(row.warningLevel)"> {{ levelText(row.warningLevel) }} </el-tag> </template> </el-table-column> <el-table-column prop="triggerValue" label="触发值" width="100" /> <el-table-column prop="ruleName" label="触发规则" /> <el-table-column prop="semester" label="学期" width="100" /> <el-table-column prop="status" label="处理状态" width="100"> <template #default="{ row }"> <el-tag :type="row.status === 'handled' ? 'success' : 'warning'"> {{ row.status === 'handled' ? '已处理' : '待处理' }} </el-tag> </template> </el-table-column> <el-table-column label="操作" width="150" fixed="right"> <template #default="{ row }"> <el-button v-if="row.status === 'pending'" type="primary" link @click="handleWarning(row)" > 处理 </el-button> <el-button type="primary" link @click="viewDetail(row)"> 详情 </el-button> </template> </el-table-column> </el-table> <el-pagination v-model:current-page="queryParams.pageNum" v-model:page-size="queryParams.pageSize" :total="total" :page-sizes="[10, 20, 50]" layout="total, sizes, prev, pager, next" @size-change="handleSearch" @current-change="handleSearch" /> </el-card> </div> </template>这个页面的一个细节是预警等级的显示，我给不同的等级配了不同的颜色和文字，比如"关注"用蓝色标签、"警告"用橙色、"严重警告"用红色、"退学预警"用深红色，这样在列表页扫一眼就能快速识别高风险学生。做管理类系统的经验是：能用颜色区分状态的就不要只用文字，人眼对颜色的识别速度远快于文字阅读。
3.5 后端接口联调与Vite代理配置
前后端分离开发时，最大的痛点就是跨域问题。我在开发环境用的是Vite代理，在vite.config.js中配置如下：
// vite.config.js import { defineConfig } from 'vite' import vue from '@vitejs/plugin-vue' export default defineConfig({ plugins: [vue()], server: { port: 3000, proxy: { '/api': { target: 'http://localhost:8080', changeOrigin: true } } } })这样前端请求/api/warning/list就会被代理到http://localhost:8080/api/warning/list，本地开发就没有跨域问题了。但生产环境部署时，跨域问题的处理方式完全不同，一般靠Nginx反向代理解决，这个在后面部署章节会详细说。
联调时我习惯先用Apifox（或者Postman）把后端接口调试通，再让前端对接。前端开发时如果后端接口还没写好，可以用Mock数据或Apifox的Mock功能先跑通页面流程，避免互相等待。
4. 部署落地与常见问题排查
4.1 打包与多环境配置
项目开发完成后的打包部署，我采用的是Spring Boot fat JAR方式。后端在pom.xml中配置多环境切换，在application.yml中配置统一的配置入口，比如：
spring: profiles: active: @profile.active@然后在pom.xml的<profiles>节点下配置dev/prod两个环境：
<profiles> <profile> <id>dev</id> <properties> <profile.active>dev</profile.active> </properties> <activation> <activeByDefault>true</activeByDefault> </activation> </profile> <profile> <id>prod</id> <properties> <profile.active>prod</profile.active> </properties> </profile> </profiles>打包命令如下：
# 开发环境打包 mvn clean package -DskipTests -Pdev # 生产环境打包 mvn clean package -DskipTests -Pprod前端打包比较简单，执行npm run build后会生成dist目录，这个目录下就是纯静态文件。注意Vue 3打包后，如果部署在Nginx子路径下，需要在vite.config.js中配置base: './'，否则打包后的资源路径会指向根目录，导致样式和JS加载异常——这正是热搜词里提到的"vue 打包后布局异常"问题，绝大多数情况就是base路径配置不对。
4.2 服务器部署：Nginx + Spring Boot 实操
生产环境我习惯用一台Linux服务器，后端跑Spring Boot，前端用Nginx托管，通过反向代理把/api路径转发给后端。Nginx配置如下：
server { listen 80; server_name your-domain.com; # 前端静态文件 location / { root /var/www/academic-warning; index index.html; try_files $uri $uri/ /index.html; # 解决Vue路由刷新404问题 } # 后端接口反向代理 location /api/ { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } }try_files $uri $uri/ /index.html;这行一定要写，否则Vue的history模式路由在刷新页面时会404。很多人初次部署Vue项目都踩过这个坑，浏览器直接访问/warning时，Nginx找不到这个真实文件，返回404，加了try_files就能把它重写到index.html上。
后端进程我建议用systemd管理，这样能实现开机自启和崩溃自动重启。创建/etc/systemd/system/academic-warning.service：
[Unit] Description=Academic Warning System After=network.target mysql.service redis.service [Service] Type=simple User=root WorkingDirectory=/opt/academic-warning ExecStart=/usr/bin/java -Xms512m -Xmx1024m -jar /opt/academic-warning/academic-warning.jar Restart=on-failure RestartSec=10s [Install] WantedBy=multi-user.target配置好之后执行systemctl daemon-reload && systemctl enable academic-warning && systemctl start academic-warning，服务就能正常运行了。日志用journalctl -u academic-warning -f查看，排查问题非常方便。
4.3 Spring Boot与Vue联调中的典型问题
前后端联调阶段我遇到并解决了不少问题，挑几个代表性的记录一下。
第一个是跨域问题。虽然开发环境用Vite代理解决了开发期跨域，但上线后如果前端和后端没走同一个域名，浏览器还是会拦截。我的做法是在Nginx层统一转发，让前端和后端都从同一个域名访问，避免不必要的跨域配置。如果确实需要跨域，我后端用的CORS配置是这样的：
@Configuration public class CorsConfig implements WebMvcConfigurer { @Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping("/**") .allowedOrigins("http://localhost:3000") .allowedMethods("GET", "POST", "PUT", "DELETE", "OPTIONS") .allowedHeaders("*") .allowCredentials(true) .maxAge(3600); } }第二个是日期格式问题。前端通过JSON传日期字符串给后端，如果格式不统一就会报错。我在后端配置了全局的Jackson格式，同时接收参数时使用@DateTimeFormat注解明确格式，避免因为时区或格式导致的时间错乱。
第三个是请求体格式不匹配。前端用axios.post(url, data)发送数据时，默认会JSON序列化，如果后端接口用@RequestParam接收就会报错。我的做法是统一使用@RequestBody接收JSON对象，同时在前端axios封装里设置Content-Type: application/json。前后端约定一个好的接口规范，能省掉一大批联调问题。
4.4 Actuator端点暴露与安全加固
这是我在安全扫描时踩过的坑，提醒大家一定要重视。Spring Boot的Actuator依赖如果配置不当，会把heapdump等敏感端点暴露出去，通过/actuator/heapdump可以下载堆内存快照，里面可能包含数据库密码、用户token等敏感信息。热搜词里的"springboot heapdump 敏感信息泄露漏洞"讲的就是这个问题。
生产环境的安全配置我建议这样做：
management: endpoints: web: exposure: include: health,info endpoint: health: show-details: never只暴露health和info端点，或者干脆把Actuator的依赖从生产环境排除掉。如果确实需要监控端点，要加上Spring Security认证保护。另外，数据库密码、Redis密码这些敏感信息不要明文写在配置文件里，推荐用环境变量注入：
spring: datasource: password: ${DB_PASSWORD}服务器上通过export DB_PASSWORD=xxx或者在systemd配置里指定Environment=DB_PASSWORD=xxx，这样即使代码或者配置文件泄露，密码也还是安全的。
4.5 系统上线后的稳定性与性能优化
老生常谈但还是要说一遍：联调通过不代表系统能上线，真实环境的流量和数据量常常会暴露出开发环境下看不见的问题。我在上线前做了一轮性能压测，发现预警列表页在大数据量下响应变慢，分析后发现是SQL查询没有走索引。我的解决思路是：
第一，给常用查询字段加索引，比如student_no、warning_record表的student_id和semester组合索引。
第二，MyBatis-Plus的分页查询在数据量大时，默认的count查询会比较慢，考虑优化为近似分页或者加缓存。
第三，预警计算结果做了Redis缓存，同一学生在同一学期内重复查询预警状态时，直接返回缓存结果，降低数据库压力。
上生产后的监控我也配置了一套轻量方案：后端用Spring Boot Actuator暴露health端点配合在线检测，另外我写了一个简单的定时脚本，每5分钟检查后端进程是否存活，异常时自动重启并发送告警通知到工作群。这套组合不是最专业的，但胜在轻量和够用，单机部署完全足够。
5. 项目复盘与二次扩展建议
5.1 这套架构还能复用到哪些场景
学业预警系统跑通之后，我最大的感受是这套"Spring Boot + Vue + 规则引擎 + 定时任务"的技术底座，完全可以直接复制到同类的校园管理场景里。比如：学生考勤预警系统（通过门禁或刷卡数据计算缺勤率，超过阈值自动预警）、学生心理状态排查系统（通过问卷结果计算风险等级）、资助资格核查系统（通过家庭经济数据和消费数据交叉验证申请资格）。
甚至往大了说，任何"基于规则判断状态 + 需要定时批量计算 + 需要分级分角色查看和处置"的业务，都可以在这套框架上快速改造。核心价值在于规则引擎的设计——把业务规则从代码里抽离出来放到数据库，让业务人员自己调整预警标准，这是整个项目最值得保留的资产。
5.2 后续可以加深的方向
就这个系统本身而言，有几个方向值得继续投入。第一是引入更智能的预测算法，比如用学生历史成绩数据训练模型，在学期刚开始就预测哪些学生有挂科风险，做到真正的"提前预警"，而不仅仅是基于当前成绩做判断。第二是接入更多数据源，比如图书馆入馆数据、食堂消费数据，结合学生的行为特征做更精准的风险画像。第三是把这个系统学生的移动端，目前的移动端适配只做了H5的响应式，没有开发原生App或小程序，而学生群体用手机的场景远比PC多。
不过说句实在话，做校园信息化项目，最重要的不是技术多么花哨，而是贴合用户的实际使用习惯。这学期上线后，辅导员普遍反馈最好用的功能就是每日待办提醒——系统每天把新增的预警学生名单推送到辅导员界面，点开就能看到学生详细成绩和预警原因。这种小而实用、能嵌入用户现有工作流程的功能，价值远比一个酷炫的数据大屏高。做这类系统的经验就是：多和一线用户聊，他们说的"要是能这样就好了"，往往就是下一个版本最该做的功能。
