1. 项目背景与核心需求
在企事业单位日常运营中，档案管理一直是基础但至关重要的环节。传统纸质档案管理方式存在检索效率低、存储空间占用大、易损毁丢失等问题。我曾参与过某大型国企的档案数字化改造项目，亲眼目睹了员工为查找一份10年前的合同档案，需要花费半天时间在档案室翻找的窘境。这种低效模式在信息化时代显得格格不入。
本系统正是为解决这类痛点而设计，主要实现以下核心目标：
- 实现档案全生命周期电子化管理（上传、分类、存储、检索、借阅）
- 建立完善的权限控制体系（基于RBAC模型）
- 支持高并发访问与海量数据存储（单节点支持10万+档案条目）
- 提供多维度的检索方式（关键字、分类、时间范围等组合查询）
2. 技术选型与架构设计
2.1 前后端分离架构优势
采用前后端分离架构（前端Vue.js + 后端SpringBoot）主要基于以下考量：
- 开发效率：前后端可并行开发，通过Swagger定义接口规范
- 性能优化：前端静态资源通过Nginx部署，减轻应用服务器压力
- 扩展性：未来可轻松扩展移动端（只需开发新的前端项目）
- 技术栈成熟度：Vue+SpringBoot组合有丰富的社区支持
实践建议：在团队协作中，建议使用YAPI等接口管理平台维护API文档，避免前后端对接混乱
2.2 后端技术栈详解
SpringBoot 2.7.x 关键配置：
java复制// 数据源配置示例（application.yml）
spring:
datasource:
url: jdbc:mysql://localhost:3306/archive_db?useSSL=false&serverTimezone=Asia/Shanghai
username: root
password: 加密密码建议使用Jasypt
hikari:
maximum-pool-size: 20 # 根据服务器配置调整
connection-timeout: 30000
# MyBatis配置
mybatis:
mapper-locations: classpath:mapper/*.xml
configuration:
map-underscore-to-camel-case: true
安全防护方案：
- 密码加密：采用BCryptPasswordEncoder（Spring Security内置）
- XSS防护：自定义Jackson反序列化器过滤特殊字符
- SQL注入：使用MyBatis预编译语句+正则校验入参
2.3 前端技术栈优化
Vue 3组合式API示例：
javascript复制// 档案上传组件逻辑
import { ref } from 'vue'
import { ElMessage } from 'element-plus'
export function useFileUpload() {
const fileList = ref([])
const beforeUpload = (file) => {
const isLt50M = file.size / 1024 / 1024 < 50
if (!isLt50M) {
ElMessage.error('单个文件大小不能超过50MB')
return false
}
return true
}
return { fileList, beforeUpload }
}
性能优化技巧：
- 路由懒加载：
() => import('./views/ArchiveList.vue') - 接口防抖：使用lodash的debounce处理高频搜索请求
- 组件缓存：
<keep-alive>包裹高频访问的列表组件
3. 数据库设计与优化
3.1 核心表结构增强版
档案分类表（archive_category）优化：
sql复制CREATE TABLE `archive_category` (
`id` bigint NOT NULL AUTO_INCREMENT COMMENT '分类ID',
`parent_id` bigint DEFAULT 0 COMMENT '父分类ID（实现多级分类）',
`name` varchar(50) COLLATE utf8mb4_bin NOT NULL COMMENT '分类名称',
`code` varchar(20) COLLATE utf8mb4_bin NOT NULL COMMENT '分类编码（唯一标识）',
`sort` int DEFAULT 0 COMMENT '排序权重',
`status` tinyint DEFAULT 1 COMMENT '状态（0停用 1启用）',
`create_by` varchar(64) COLLATE utf8mb4_bin DEFAULT '' COMMENT '创建人',
`create_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP,
`update_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
PRIMARY KEY (`id`),
UNIQUE KEY `idx_code` (`code`),
KEY `idx_parent` (`parent_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin COMMENT='档案分类表';
档案文件表关键改进：
- 增加文件哈希值字段（sha256）用于去重校验
- 添加存储策略字段（本地/OSS/七牛云）
- 支持版本控制（通过version字段实现）
3.2 索引优化方案
针对高频查询场景设计索引：
- 组合索引：
(category_id, status, create_time)用于分类页筛选 - 全文索引：对档案标题、关键词字段建立ES索引
- 覆盖索引：
SELECT id,name FROM archive WHERE category_id=?
踩坑记录：曾因未对update_time字段加索引，导致日志查询接口在百万数据时响应超时
4. 核心功能实现细节
4.1 文件上传与存储方案
断点续传实现逻辑：
- 前端计算文件分块MD5（使用spark-md5）
- 后端校验分块是否存在（接口：/api/upload/check）
- 并行上传分块（建议3-5个并发）
- 合并分块（使用Java的Files.createFile）
存储策略抽象：
java复制public interface FileStorage {
String upload(InputStream is, String path);
InputStream download(String path);
boolean delete(String path);
}
// 本地存储实现
@Service
@Profile("local")
public class LocalStorage implements FileStorage {
@Value("${file.local.path}")
private String basePath;
@Override
public String upload(InputStream is, String path) {
Path target = Paths.get(basePath, path);
Files.createDirectories(target.getParent());
Files.copy(is, target, StandardCopyOption.REPLACE_EXISTING);
return path;
}
}
4.2 权限控制系统
RBAC模型实现：
java复制// 权限注解
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface RequiresPermission {
String[] value();
}
// 拦截器逻辑
public boolean preHandle(HttpServletRequest request, ...) {
String permission = request.getAttribute(HandlerMapping.BEST_MATCHING_PATTERN_ATTRIBUTE);
Set<String> userPermissions = getUserPermissions();
if (!userPermissions.contains(permission)) {
throw new UnauthorizedException("无访问权限");
}
return true;
}
前端权限控制方案：
- 路由级：通过meta.roles配置可访问角色
- 按钮级：v-permission指令控制显隐
- API级：axios拦截器处理403响应
5. 典型问题排查实录
5.1 大文件上传失败排查
现象：超过100MB的文件上传到80%左右中断
排查过程：
- 检查Nginx配置：
client_max_body_size 100m; - 确认SpringBoot配置：
spring.servlet.multipart.max-file-size=200MB - 发现应用服务器内存不足（Tomcat线程被kill）
解决方案：
- 采用分片上传方案
- 增加服务器Swap空间
- 添加上传进度提示
5.2 模糊查询性能优化
慢SQL日志分析：
sql复制-- 优化前（全表扫描）
SELECT * FROM archive WHERE title LIKE '%合同%'
-- 优化方案
-- 1. 添加全文索引
ALTER TABLE archive ADD FULLTEXT INDEX ft_idx_title(title);
-- 2. 使用ES实现高级搜索
6. 部署与运维建议
6.1 生产环境部署方案
最小化高可用架构：
code复制 +-------------+
| Nginx |
| (负载均衡) |
+------+------+
|
+--------------+--------------+
| |
+-----+------+ +-----+------+
| SpringBoot | | SpringBoot |
| (Node1) | | (Node2) |
+-----+------+ +-----+------+
| |
+-----+------+ +-----+------+
| MySQL | | Redis |
| (主从复制) | | (集群) |
+------------+ +------------+
关键启动参数：
bash复制java -jar archive-system.jar \
--server.port=8080 \
-Xms512m -Xmx1024m \
-XX:+UseG1GC \
-Dspring.profiles.active=prod
6.2 监控方案
- SpringBoot Actuator + Prometheus + Grafana
- 关键指标监控：
- 文件上传成功率
- 平均查询响应时间
- 并发用户数阈值预警
7. 扩展方向建议
- OCR集成：使用Tesseract实现档案内容文字识别
- 区块链存证：关键档案上链存证（Hyperledger Fabric）
- 自动化分类：基于NLP的智能分类（可使用HanLP）
- 多租户支持：Saas化改造（通过tenant_id字段隔离）
这个项目从第一行代码到最终上线历时3个月，期间最大的收获是认识到良好的抽象设计比急于编码更重要。比如早期没有设计统一文件存储接口，导致后期切换OSS存储时不得不修改多处业务代码。建议开发者在项目初期就做好关键模块的接口抽象，这将大幅降低后期扩展成本。