1. 项目背景与需求分析
在高校信息化建设浪潮中，传统纸质档案和Excel表格管理模式的弊端日益凸显。我曾参与过某高校教务系统改造项目，亲眼目睹过这样的场景：学工办主任需要统计全院学生获奖情况时，不得不让辅导员们汇总十几个Excel文件，再手动合并去重，整个过程耗时两天且数据准确性难以保证。这正是我们开发学院个人信息管理系统的核心驱动力。
系统主要解决三类痛点：
- 数据孤岛问题：教师档案、学生信息、科研成果分散在不同部门，跨部门协作时需要反复确认数据版本
- 流程效率低下：学生修改手机号需要填写纸质申请表，经辅导员、教务员两级审批，流程长达3-5个工作日
- 安全风险：敏感信息通过微信、邮件随意传递，存在泄露风险
典型用户场景包括：
- 学生自主更新联系方式，实时同步到选课系统、宿舍管理系统等关联平台
- 教学秘书一键导出全院教师职称分布统计报表
- 院领导查看学科建设成果数据驾驶舱
2. 技术架构设计
2.1 为什么选择SpringBoot+Vue
这个技术组合的决策过程值得详细说明。我们曾对比过三种方案：
- 传统单体架构（SpringMVC + JSP）：开发速度快但前后端耦合严重，难以应对学院频繁的业务流程变更需求
- 全栈JavaScript（Node.js + Express + React）：团队JavaScript经验不足，且担心后端性能瓶颈
- 微服务架构：系统初期复杂度与运维成本过高
最终选择的SpringBoot+Vue方案平衡了：
- 开发效率：SpringBoot的starter依赖和自动配置让后端服务快速搭建
- 性能保障：Java线程池+NIO应对并发查询请求
- 前后端协作：Swagger文档+Postman调试约定好的API格式
- 技术生态：MyBatis-Plus的ActiveRecord模式大幅简化CRUD编码
2.2 核心架构组件
系统采用经典三层架构，但有些特殊设计值得注意：
code复制├── 前端层
│ ├── Vue CLI工程
│ ├── Element-UI组件库
│ └── Axios拦截器（统一处理401/500等状态码）
├── 应用层
│ ├── SpringBoot 2.7.x
│ ├── MyBatis-Plus 3.5.x（含代码生成器）
│ └── Hutool工具集
└── 数据层
├── MySQL 8.0（配置了读写分离）
├── Redis缓存（存储JWT和热点数据）
└── Elasticsearch（仅用于模糊搜索场景）
关键决策：放弃使用Spring Security而选择自研RBAC模块，因为学院的组织结构特殊（存在双肩挑干部既属教师序列又具管理权限），标准权限模型无法满足需求。
3. 核心功能实现细节
3.1 权限系统设计
权限系统经历过两次重大迭代：
- 第一版：基于URL的拦截，问题在于按钮级权限需要硬编码判断
- 当前方案：前端路由表+后端注解双重控制
核心数据结构示例：
java复制// 权限点实体
@Data
public class Permission {
private Long id;
private String code; // 如user:add
private String resourceType; // MENU/BUTTON/API
private String vueComponent;
}
// 角色权限关联
@TableName("role_permission")
public class RolePermission {
private Long roleId;
private Long permissionId;
private Integer scope; // 1本部门/2全院/3自定义
}
前端权限控制的关键代码：
javascript复制// 路由守卫中检查权限
router.beforeEach((to, from, next) => {
const requiredPerm = to.meta?.permission
if (requiredPerm && !store.getters.hasPermission(requiredPerm)) {
next('/403')
} else {
next()
}
})
3.2 高性能数据导入
处理Excel导入时踩过的坑：
- 内存溢出：初期用POI读取整个文件，300MB的Excel直接OOM
- 响应超时：同步导入导致浏览器卡死
优化后的方案：
java复制// 使用EasyExcel的监听器模式
public class StudentDataListener extends AnalysisEventListener<Student> {
private static final int BATCH_SIZE = 200;
private List<Student> cacheList = new ArrayList<>(BATCH_SIZE);
@Override
public void invoke(Student data, AnalysisContext context) {
cacheList.add(data);
if (cacheList.size() >= BATCH_SIZE) {
saveBatch();
cacheList.clear();
}
}
private void saveBatch() {
// 这里使用MyBatis-Plus的saveBatch
studentService.saveBatch(cacheList);
}
}
配合前端实现进度显示：
vue复制<template>
<el-upload :on-progress="handleProgress">
<el-progress :percentage="uploadPercent" />
</el-upload>
</template>
<script>
export default {
methods: {
handleProgress(event) {
this.uploadPercent = Math.floor((event.loaded / event.total) * 100)
}
}
}
</script>
4. 数据库优化实践
4.1 索引设计技巧
用户表查询场景分析：
sql复制-- 高频查询1：按账号登录
SELECT * FROM user WHERE user_account = ? AND is_active = true;
-- 高频查询2：按角色分页查询
SELECT * FROM user WHERE user_role = ? ORDER BY register_time DESC LIMIT ?, ?;
因此建立的复合索引：
sql复制CREATE INDEX idx_account_active ON user(user_account, is_active);
CREATE INDEX idx_role_register ON user(user_role, register_time);
血泪教训：曾在user_name字段上单独建过索引，后发现模糊查询"%张%"根本用不上该索引，最终改为ES实现搜索功能。
4.2 分库分表策略
当数据量突破50万行时遇到的性能问题：
- 学业记录表超过600MB，复杂查询响应超时
- 备份耗时长达2小时
解决方案：
yaml复制# application-sharding.yml
spring:
shardingsphere:
datasource:
names: ds0,ds1
sharding:
tables:
academic_record:
actual-data-nodes: ds$->{0..1}.academic_record_$->{0..15}
table-strategy:
inline:
sharding-column: user_id
algorithm-expression: academic_record_$->{user_id % 16}
database-strategy:
inline:
sharding-column: record_id
algorithm-expression: ds$->{record_id % 2}
5. 典型问题排查实录
5.1 JWT失效异常
现象：iOS设备频繁提示"登录已过期"
排查过程：
- 检查服务端时钟同步正常
- 发现iPhone的Safari浏览器存在时区自动切换问题
- 最终定位到JWT的exp字段使用UTC时间戳，而前端用本地时间解析
解决方案：
java复制// 原错误写法
long expTime = System.currentTimeMillis() + expire * 1000;
// 修正为
long expTime = Instant.now().plusSeconds(expire).getEpochSecond();
5.2 MyBatis缓存污染
现象：管理员看到其他院系的数据
根本原因：MyBatis二级缓存默认按namespace隔离，但多院系共用Mapper
最终方案：
xml复制<!-- 在mapper.xml中明确声明缓存范围 -->
<cache-ref namespace="com.xxx.mapper.BaseMapper"/>
<!-- 并在查询语句中添加院系条件 -->
<select id="selectByExample" resultMap="BaseResultMap">
SELECT * FROM user
WHERE college_id = #{collegeId}
<if test="example != null">
<!-- 其他条件 -->
</if>
</select>
6. 部署与运维建议
6.1 性能调优参数
生产环境JVM配置：
bash复制# JDK 11的推荐配置
JAVA_OPTS="-server -Xms2g -Xmx2g -XX:MaxMetaspaceSize=512m \
-XX:+UseG1GC -XX:MaxGCPauseMillis=200 \
-XX:ParallelGCThreads=4 -XX:ConcGCThreads=2 \
-XX:+HeapDumpOnOutOfMemoryError"
Nginx关键配置：
nginx复制# 文件上传大小限制
client_max_body_size 50M;
# Vue路由history模式配置
location / {
try_files $uri $uri/ /index.html;
}
# 接口反向代理
location /api {
proxy_set_header X-Real-IP $remote_addr;
proxy_pass http://backend;
}
6.2 监控方案
我们采用的监控组合：
- 基础监控：Prometheus + Grafana（采集CPU/内存指标）
- 日志分析：ELK收集业务异常日志
- APM工具：SkyWalking追踪慢接口
关键监控指标看板：
- 用户登录成功率
- Excel导入平均耗时
- 分页查询TP99响应时间
- 数据库连接池活跃数
这个项目让我深刻体会到：高校信息化系统最难的不是技术实现，而是平衡不同角色的使用习惯。比如老教授们坚持要保留Excel导入导出功能，而年轻辅导员则希望全部移动端操作。最终我们通过用户分层的UI设计解决了这个问题——同一个后端接口，同时支持PC端复杂操作和移动端精简视图。