1. 项目概述与核心价值
这个资源分享系统本质上是一个基于现代Java技术栈的内容管理平台。我花了三个月时间从零搭建完整体系，核心目标是解决团队内部文档、代码片段、工具包等数字资产的集中管理与高效流转问题。在传统工作模式中，我们经常遇到同事之间用U盘拷来拷去、微信群里文件过期、SVN目录混乱等痛点。通过SpringBoot的快速开发特性，配合合理的架构设计，最终实现的系统支持：
- 多级分类资源树
- 版本控制
- 全文检索
- 权限颗粒度控制到按钮级别
实测部署后，技术部的资料查找时间平均缩短了67%，新人 onboarding 效率提升明显。特别在跨部门协作时，法务和财务部门反馈合同模板的获取再也不用反复发邮件确认版本了。
2. 技术架构设计解析
2.1 整体技术选型
采用经典的三层架构，但针对资源分享场景做了特殊优化：
code复制前端：Vue3 + Element Plus (兼容IE11的polyfill方案)
网关：Nginx + Spring Cloud Gateway
业务层：SpringBoot 2.7 + Spring Security
存储层：MySQL 8.0 + Elasticsearch 7.17 + MinIO
选型时重点考虑了以下因素：
- 文档预览兼容性：Office文件转PDF使用LibreOffice无头模式，相比OpenOffice内存占用降低40%
- 大文件上传：前端采用分片上传，后端用MinIO的multipart upload API，实测支持8GB以上CAD文件传输
- 权限模型：采用RBAC与ABAC混合模式，部门经理自动获得下属员工资源的审计权限
2.2 核心表结构设计
资源表(resource)的关键字段设计值得展开说明：
sql复制CREATE TABLE `resource` (
`id` bigint NOT NULL COMMENT '雪花算法ID',
`current_version_id` bigint DEFAULT NULL COMMENT '当前生效版本',
`category_path` varchar(512) CHARACTER SET utf8mb4 COLLATE utf8mb4_bin NOT NULL COMMENT '分类路径(如/IT/开发规范)',
`content_type` enum('FILE','URL','TEXT') NOT NULL,
`encrypt_level` tinyint DEFAULT '0' COMMENT '0-不加密 1-链接加密 2-内容加密',
`delete_flag` tinyint NOT NULL DEFAULT '0' COMMENT '逻辑删除标记',
`created_by` varchar(64) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci NOT NULL,
`created_time` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;
特别注意：
- category_path使用bin collation实现大小写敏感路径
- encrypt_level为后续扩展预留了空间
- 所有删除操作都走逻辑删除流程，配合定时任务实现回收站自动清理
3. 核心功能实现细节
3.1 版本控制机制
资源每次更新都会在resource_version表生成新记录，采用COW(Copy-On-Write)策略：
- 用户编辑资源时，前端先获取当前版本快照
- 提交修改时，系统会：
- 在MinIO存储新版本文件（相同hash值则复用）
- 生成新的version记录
- 通过事务更新resource表的current_version_id
java复制@Transactional
public ResourceVersion createNewVersion(Long resourceId, MultipartFile file) {
// 校验权限
checkEditPermission(resourceId);
// 计算文件指纹
String sha256 = DigestUtils.sha256Hex(file.getInputStream());
// 检查是否已存在相同内容
Optional<ResourceVersion> existing = versionRepo.findBySha256(sha256);
if(existing.isPresent()) {
return existing.get();
}
// 存储到MinIO
String objectName = "v2/" + sha256.substring(0,2) + "/" + sha256;
minioClient.putObject(
PutObjectArgs.builder()
.bucket(resourceBucket)
.object(objectName)
.stream(file.getInputStream(), file.getSize(), -1)
.build());
// 创建版本记录
ResourceVersion version = new ResourceVersion();
version.setResourceId(resourceId);
version.setStoragePath(objectName);
version.setSha256(sha256);
version.setFileSize(file.getSize());
version = versionRepo.save(version);
// 更新资源当前版本
resourceRepo.updateCurrentVersion(resourceId, version.getId());
return version;
}
3.2 权限控制系统
结合Spring Security和SpEL实现动态权限判断，核心配置类如下：
java复制@Configuration
@EnableGlobalMethodSecurity(prePostEnabled = true)
public class MethodSecurityConfig extends GlobalMethodSecurityConfiguration {
@Override
protected MethodSecurityExpressionHandler createExpressionHandler() {
CustomMethodSecurityExpressionHandler handler =
new CustomMethodSecurityExpressionHandler();
handler.setPermissionEvaluator(new ResourcePermissionEvaluator());
return handler;
}
}
// 在Service层使用方法级鉴权
@Service
public class ResourceServiceImpl implements ResourceService {
@PreAuthorize("@resourcePermission.check(principal, #resourceId, 'EDIT')")
public void updateResource(Long resourceId, ResourceDTO dto) {
// 业务逻辑
}
}
权限校验的核心逻辑涉及多个维度的判断：
- 用户角色是否具备全局编辑权限
- 用户是否是资源创建者
- 用户所在部门是否在资源的共享范围内
- 资源当前是否处于可编辑状态（如审核中资源禁止修改）
4. 性能优化实践
4.1 文件上传加速方案
针对大文件上传的稳定性问题，我们实现了以下优化措施：
- 前端采用Web Worker进行分片计算，主线程不阻塞
- 后端使用Redis记录上传进度，key结构为：
code复制
upload:progress:{userId}:{fileHash} - 分片合并时采用零拷贝技术：
java复制try (InputStream in = new SequenceInputStream(
Collections.enumeration(parts.stream()
.map(p -> new ByteArrayInputStream(p.getData()))
.collect(Collectors.toList())))) {
minioClient.putObject(
PutObjectArgs.builder()
.bucket(tempBucket)
.object(tmpObjectName)
.stream(in, totalSize, -1)
.build());
}
实测数据显示，在跨国办公场景下，500MB文件上传成功率从63%提升至98%，平均耗时减少42%。
4.2 搜索性能优化
Elasticsearch的索引设计经过三次迭代：
- 初始方案：所有字段不分词
- 问题：中文搜索体验差
- 第二版：使用ik_max_word分词器
- 问题：索引膨胀3倍
- 最终方案：
- 标题字段：ik_smart + edge_ngram(用于前缀匹配)
- 内容字段：ik_max_word(仅对TEXT类型)
- 分类路径：keyword类型+path_hierarchy分析器
查询DSL示例：
json复制{
"query": {
"bool": {
"must": [
{
"match": {
"title": {
"query": "项目规范",
"operator": "and"
}
}
}
],
"filter": [
{
"term": {
"department": "dev"
}
},
{
"terms": {
"permission_level": [1,2]
}
}
]
}
}
}
5. 部署与运维要点
5.1 容器化部署方案
使用Docker Compose编排关键服务，特别注意了MySQL和ES的持久化配置：
yaml复制version: '3.8'
services:
mysql:
image: mysql:8.0
volumes:
- mysql_data:/var/lib/mysql
- ./conf/mysql.cnf:/etc/mysql/conf.d/custom.cnf
environment:
MYSQL_ROOT_PASSWORD: ${DB_ROOT_PASS}
healthcheck:
test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
elasticsearch:
image: elasticsearch:7.17.7
environment:
- discovery.type=single-node
- bootstrap.memory_lock=true
- "ES_JAVA_OPTS=-Xms2g -Xmx2g"
ulimits:
memlock:
soft: -1
hard: -1
volumes:
- es_data:/usr/share/elasticsearch/data
关键配置经验：
- MySQL需要调整innodb_buffer_pool_size（建议物理内存的70%）
- ES必须禁用swap，否则性能下降明显
- MinIO集群模式下要确保时间同步
5.2 监控体系搭建
采用Prometheus+Grafana监控关键指标：
- JVM监控：Micrometer对接SpringBoot Actuator
- 业务指标：自定义的计数器统计每日资源上传量
java复制@RestController public class ResourceController { private final Counter uploadCounter; public ResourceController(MeterRegistry registry) { uploadCounter = registry.counter("resource.upload.count", "department", UserContext.getCurrentDept()); } @PostMapping("/resources") public ResponseEntity<?> uploadResource(@RequestParam MultipartFile file) { uploadCounter.increment(); // 处理逻辑 } } - 告警规则示例：
- 5分钟内JVM FullGC次数>3
- 文件上传失败率连续10分钟>5%
- ES集群状态持续Yellow超过1小时
6. 典型问题排查实录
6.1 文件上传卡顿问题
现象：部分用户反映上传200MB以上文件时进度条停滞
排查过程：
- 检查Nginx日志发现存在408超时
- 调整client_max_body_size到10G无效
- 抓包发现TCP窗口大小卡在64KB
- 最终解决方案：
nginx复制proxy_buffers 16 128k; proxy_buffer_size 256k; proxy_busy_buffers_size 256k; proxy_temp_file_write_size 256k;
6.2 内存泄漏事件
现象：容器每隔3天左右OOM重启
分析工具：
- 使用JDK Mission Control抓取内存快照
- MAT分析发现Elasticsearch RestClient的缓存未释放
- 根本原因：未正确关闭BulkProcessor
修复方案：
java复制@Bean(destroyMethod = "close")
public RestHighLevelClient esClient() {
return new RestHighLevelClient(
RestClient.builder(new HttpHost(esHost, esPort))
.setHttpClientConfigCallback(httpClientBuilder -> {
return httpClientBuilder
.setMaxConnTotal(50)
.setMaxConnPerRoute(10);
}));
}
7. 安全防护措施
7.1 防注入方案
- 全局XSS过滤：
java复制@ControllerAdvice public class XssProtectionAdvice implements ResponseBodyAdvice<Object> { @Override public boolean supports(MethodParameter returnType, Class<? extends HttpMessageConverter<?>> converterType) { return true; } @Override public Object beforeBodyWrite(Object body, MethodParameter returnType, MediaType selectedContentType, Class<? extends HttpMessageConverter<?>> selectedConverterType, ServerHttpRequest request, ServerHttpResponse response) { if(body instanceof String) { return HtmlUtils.htmlEscape((String)body); } return body; } } - MyBatis参数严格使用#{}语法
- ES查询全部采用PreparedStatement方式构造DSL
7.2 敏感操作审计
通过Spring AOP记录关键操作日志：
java复制@Aspect
@Component
public class AuditLogAspect {
@Autowired
private AuditLogService logService;
@Pointcut("@annotation(com.example.anno.AuditLog)")
public void auditPointcut() {}
@AfterReturning(pointcut = "auditPointcut()", returning = "result")
public void afterReturning(JoinPoint jp, Object result) {
MethodSignature signature = (MethodSignature) jp.getSignature();
AuditLog annotation = signature.getMethod().getAnnotation(AuditLog.class);
AuditLogEntry entry = new AuditLogEntry();
entry.setOperation(annotation.value());
entry.setParams(JsonUtils.toJson(jp.getArgs()));
entry.setResult(result != null ? result.toString() : null);
logService.saveEntry(entry);
}
}
审计日志表采用按月分表策略，历史数据自动归档到对象存储。