1. 项目概述
企业级文档管理系统是现代企业数字化转型的核心基础设施之一。我在参与某大型制造集团文档管理平台重构时，深刻体会到传统文件共享方式的痛点：销售部门找不到最新版合同模板、研发团队频繁覆盖重要设计文档、审计时无法追溯文件操作记录...这些问题最终促使我们开发了这套基于SpringBoot+Vue的文档管理系统。
系统采用主流的前后端分离架构，后端基于SpringBoot 2.7提供RESTful API服务，前端使用Vue 3组合式API开发管理界面，数据持久层采用MyBatis-Plus简化数据库操作。特别在权限控制方面，我们实现了基于RBAC模型的细粒度权限管理，支持部门隔离、文档水印等企业级特性。经过半年生产环境验证，目前稳定管理着超过15TB的企业文档，日均API调用量达20万次。
2. 技术架构解析
2.1 后端技术栈设计
SpringBoot的选择绝非偶然。在技术选型阶段，我们对比了传统SSM架构和SpringBoot的启动性能：在同等硬件条件下，SpringBoot应用启动时间缩短了63%，内存占用减少40%。这主要得益于：
- 自动配置机制：通过spring-boot-starter-data-redis等starter依赖，自动配置连接池、序列化等参数
- 嵌入式容器：内置Tomcat线程池调优参数（默认最大200，等待队列100）
- 健康检查：集成Actuator暴露/health端点，监控关键指标示例：
yaml复制management:
endpoint:
health:
show-details: always
endpoints:
web:
exposure:
include: "*"
MyBatis-Plus的采用极大提升了开发效率。其Wrapper条件构造器可以这样构建复杂查询：
java复制QueryWrapper<Document> wrapper = new QueryWrapper<>();
wrapper.like("doc_name", "季度报告")
.between("create_time", startDate, endDate)
.orderByDesc("update_time");
List<Document> docs = documentMapper.selectList(wrapper);
2.2 前端架构实现
Vue 3的组合式API使权限控制代码更清晰。我们在src/permission.js中实现路由守卫：
javascript复制router.beforeEach(async (to) => {
const userStore = useUserStore()
if (!userStore.token && to.path !== '/login') {
return '/login'
}
if (to.meta.roles && !hasPermission(userStore.roles, to.meta.roles)) {
return '/403'
}
})
Element Plus的ProTable组件配合自定义hooks实现高效文档列表：
vue复制<template>
<pro-table
:columns="columns"
:request="loadData"
:row-key="docId"
@selection-change="handleSelect"
/>
</template>
<script setup>
const loadData = async (params) => {
return await documentApi.list({
page: params.current,
size: params.pageSize,
...params
})
}
</script>
3. 核心功能实现
3.1 文档存储方案
文件存储采用混合策略：
- 小文件（<10MB）直接存入MySQL的BLOB字段
- 大文件使用MinIO对象存储，数据库只保留元数据
关键上传代码实现分片上传：
java复制@PostMapping("/upload")
public R upload(@RequestParam("file") MultipartFile file) {
String key = UUID.randomUUID().toString();
minioClient.putObject(
PutObjectArgs.builder()
.bucket("documents")
.object(key)
.stream(file.getInputStream(), file.getSize(), -1)
.contentType(file.getContentType())
.build());
documentService.saveMetaData(file, key);
return R.ok();
}
3.2 权限控制系统
RBAC模型在数据库中的实现包含五张表：
- sys_user（用户基础信息）
- sys_role（角色定义）
- sys_menu（权限菜单）
- sys_user_role（用户-角色关联）
- sys_role_menu（角色-权限关联）
权限验证通过Spring Security的PreAuthorize注解实现：
java复制@PreAuthorize("@ss.hasPermission('document:delete')")
@DeleteMapping("/{docId}")
public R delete(@PathVariable Long docId) {
return documentService.removeById(docId) ? R.ok() : R.fail();
}
4. 性能优化实践
4.1 数据库优化
MySQL表设计遵循以下原则：
- 文档表使用分库分表策略（按年份分表）
- 建立组合索引：
INDEX idx_search (doc_name, doc_type, create_time) - 大文本字段单独拆分存储
查询优化示例：
sql复制EXPLAIN SELECT * FROM document
WHERE doc_name LIKE '%合同%'
AND create_time > '2023-01-01'
ORDER BY update_time DESC LIMIT 10;
4.2 缓存策略
采用多级缓存架构：
- 本地Caffeine缓存热点文档（最大1000条，过期时间5分钟）
- Redis集群缓存文档元数据（过期时间30分钟）
- 使用Redisson实现分布式锁防止缓存击穿
缓存配置示例：
java复制@Cacheable(value = "document", key = "#docId")
public Document getById(Long docId) {
return baseMapper.selectById(docId);
}
@CacheEvict(value = "document", key = "#docId")
public boolean updateById(Document entity) {
return updateById(entity);
}
5. 安全防护措施
5.1 文件安全控制
关键安全策略：
- 所有上传文件进行病毒扫描（集成ClamAV）
- 敏感文档自动添加动态水印（包含用户ID和时间戳）
- 下载链接设置有效期（默认30分钟）
水印生成逻辑：
java复制BufferedImage watermarked = new BufferedImage(original.getWidth(),
original.getHeight(), BufferedImage.TYPE_INT_RGB);
Graphics2D g2d = (Graphics2D) watermarked.getGraphics();
g2d.drawImage(original, 0, 0, null);
g2d.setFont(new Font("Arial", Font.BOLD, 30));
g2d.setColor(Color.RED);
g2d.drawString("CONFIDENTIAL - " + username, 50, 50);
5.2 审计日志实现
操作日志通过AOP统一记录：
java复制@Aspect
@Component
public class LogAspect {
@AfterReturning(pointcut = "@annotation(operLog)", returning = "result")
public void afterReturning(JoinPoint jp, OperLog operLog, Object result) {
SysOperLog operLog = new SysOperLog();
operLog.setOperIp(ServletUtils.getClientIP());
operLog.setOperUrl(ServletUtils.getRequest().getRequestURI());
operLog.setJsonResult(JSON.toJSONString(result));
operLogService.save(operLog);
}
}
6. 部署与运维
6.1 容器化部署
Docker Compose编排文件示例：
yaml复制version: '3'
services:
mysql:
image: mysql:8.0
environment:
MYSQL_ROOT_PASSWORD: ${DB_PASSWORD}
volumes:
- ./mysql/data:/var/lib/mysql
redis:
image: redis:6
command: redis-server --requirepass ${REDIS_PASS}
backend:
build: ./backend
ports:
- "8080:8080"
depends_on:
- mysql
- redis
6.2 监控方案
Prometheus监控指标配置：
yaml复制- job_name: 'springboot'
metrics_path: '/actuator/prometheus'
static_configs:
- targets: ['backend:8080']
Grafana监控看板包含：
- JVM内存/线程监控
- API响应时间P99
- 数据库连接池使用率
- 文档上传下载吞吐量
7. 踩坑与解决方案
7.1 大文件上传问题
初期直接使用Spring MultipartFile导致内存溢出，最终方案：
- 前端采用分片上传（每片5MB）
- 后端使用临时文件缓存
- 合并时校验MD5值
核心代码片段：
javascript复制// 前端分片逻辑
const chunkSize = 5 * 1024 * 1024;
const chunks = Math.ceil(file.size / chunkSize);
for (let i = 0; i < chunks; i++) {
const chunk = file.slice(i * chunkSize, (i + 1) * chunkSize);
uploadChunk(chunk, i, file.name);
}
7.2 权限缓存一致性问题
RBAC权限变更后出现缓存延迟，解决方案：
- 发布权限变更事件
- 使用Redis Pub/Sub通知各节点
- 本地缓存设置短过期时间（1分钟）
事件处理逻辑：
java复制@EventListener
public void handleRoleChange(RoleChangeEvent event) {
String channel = "role_update:" + event.getRoleId();
redisTemplate.convertAndSend(channel, "flush");
}
8. 扩展与二次开发
8.1 与OA系统集成
通过Webhook实现文档状态同步：
- 定义回调接口：
java复制@PostMapping("/webhook/oa")
public R oaCallback(@RequestBody OaEvent event) {
documentService.syncOaStatus(event);
return R.ok();
}
- 配置OA系统回调地址：
code复制http://doc-system/api/webhook/oa?secret=xxxx
8.2 移动端适配
基于uniapp的移动端方案：
- 封装通用上传组件
- 实现离线缓存机制
- 指纹/面部识别登录
关键配置：
javascript复制// manifest.json
"permission": {
"scope.userLocation": {
"desc": "用于记录文档操作位置"
}
}
在实际部署过程中，我们发现Nginx的client_max_body_size默认1MB限制会导致大文件上传失败，建议在配置中加入：
nginx复制client_max_body_size 1024m;
client_body_buffer_size 1024k;
对于高并发场景下的MySQL连接池配置，经过压测后我们最终采用以下参数：
yaml复制spring:
datasource:
hikari:
maximum-pool-size: 20
minimum-idle: 5
connection-timeout: 30000
idle-timeout: 600000
max-lifetime: 1800000