简介面向Java毕业设计及课程设计学生的个人云盘管理系统完整项目包基于SpringbootMySQLVue技术栈采用B/S架构涵盖用户信息管理、博客信息管理、视频信息管理、论坛信息管理等典型业务模块可作为前后端分离开发的学习范本。资源共784个文件以Java后端源码、Vue前端页面、JavaScript脚本、SQL数据库脚本为主体另含SVG图标、CSS样式、MP4演示视频等辅助内容压缩包整体约56.62MB目录结构按后端、前端、数据库及文档分区检索与部署便捷。已有286人学习下载。资料内含可运行完整源码、操作演示视频及说明文档既有助于从零梳理SpringbootVue项目实现流程也可直接支撑毕业设计答辩或课程设计提交适合需要完整项目参考的Java初学者及应届毕业生。1. 个人云盘管理系统Spring Boot毕业设计里最容易被低估的题目很多人听到“个人云盘”第一反应是上传下载Demo真正动手才发现卡壳点全在细节上。文件多了以后目录树怎么表示、重名文件怎么处理、回收站怎么恢复、分享链接怎么过期这些问题比“把文件写到磁盘”难得多。对做Java毕业设计的学生来说这个题目正好覆盖Spring Boot框架、MyBatis持久层、文件流处理和前后端分离一套做完面试被追问也能接住。这里按一套可复现的结构拆开讲先定库表再写上传下载然后补目录与分享最后把分片和秒传装上去。适合正在做这个题目的学生也适合拿这个项目给新人做评审点的老工程师。2. Spring Boot个人云盘的库表设计与元数据模型2.1 为什么云盘要先建表再写上传接口个人云盘管理系统的核心不是二进制文件本身而是文件的元数据。文件扔到磁盘后用户看到的名字、所在目录、大小、分享链接全部来自数据库里的记录。常见的错误做法是把物理存储路径直接写进文件的name字段用户一重命名就得挪动真实文件还有人用/a/b/c.txt这样的字符串存目录结构移动一个父目录要递归改写所有子节点的路径字段。正确的建模方式是parentId自引用文件表里只记录逻辑树关系物理路径由存储层单独决定。这样重命名只是更新一行记录移动目录只是更新一个外键回收站只是翻转一个标记位。Spring Boot框架的自动配置帮我们省去了Servlet时代的XML装配但表关系设计这件事框架替不了。2.2 三张核心表user、file_metadata、share_link我一般会至少建三张表用户表、文件元数据表、分享链接表。把total_space和used_space放在用户表里便于上传时做配额判断文件表用parent_id支撑整棵目录树分享链接单独成表不要在文件表里塞一个share_token字段了事。CREATE TABLE IF NOT EXISTS user ( id BIGINT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(64) NOT NULL UNIQUE, password_hash VARCHAR(128) NOT NULL, total_space BIGINT NOT NULL DEFAULT 10737418240, used_space BIGINT NOT NULL DEFAULT 0, created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE IF NOT EXISTS file_metadata ( id BIGINT PRIMARY KEY AUTO_INCREMENT, user_id BIGINT NOT NULL, parent_id BIGINT NULL, name VARCHAR(255) NOT NULL, storage_path VARCHAR(512) NULL, storage_name VARCHAR(128) NULL, file_size BIGINT NOT NULL DEFAULT 0, file_hash VARCHAR(64) NULL, content_type VARCHAR(128) NULL, is_folder TINYINT NOT NULL DEFAULT 0, is_deleted TINYINT NOT NULL DEFAULT 0, deleted_at DATETIME NULL, created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, INDEX idx_user_parent (user_id, parent_id, is_deleted), INDEX idx_hash (file_hash) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;这段DDL里几个字段容易被忽略。storage_path存相对路径和用户可见的name分离物理文件名用UUID重命名用户改名时不需要碰真实文件parent_id为空表示根目录整个文件系统是树而不是平铺列表file_hash是给秒传做准备的索引不能省否则上传大文件时查重会全表扫描。CREATE TABLE IF NOT EXISTS share_link ( id BIGINT PRIMARY KEY AUTO_INCREMENT, file_id BIGINT NOT NULL, owner_id BIGINT NOT NULL, token VARCHAR(64) NOT NULL UNIQUE, expire_time DATETIME NULL, visit_count INT NOT NULL DEFAULT 0, created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;分享表里token用UUID生成expire_time为空表示永久链接建议业务上强制默认7天有效。文件和文件夹的分享都走这一张表共享同一套访问逻辑后续加提取码也只需要扩展两个字段。2.3 MyBatis-Plus实体映射与Spring Boot自动建表配置实体类对应TableName(file_metadata)主键用TableId(type IdType.AUTO)parent_id用Long文件大小用Long而不是Integer单文件超过2GB时Integer直接溢出。很多人搜索“springboot mybatis 当表不存在自动建表”核心是理解MyBatis-Plus本身不负责建表要配合Spring Boot的SQL初始化机制。把上面的DDL存到resources/schema.sql然后在配置里打开开关spring: datasource: url: jdbc:mysql://localhost:3306/clouddisk?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: root sql: init: mode: always schema-locations: classpath:schema.sql servlet: multipart: max-file-size: 200MB max-request-size: 210MBspring.sql.init.modealways表示每次启动都执行脚本配合CREATE TABLE IF NOT EXISTS实现幂等建表生产环境建议改成never由发布流程单独管理表结构。spring.servlet.multipart两个参数必须显式配置Spring Boot的默认上传限制只有1MB不配的话大文件直接报MaxUploadSizeExceededException这类问题在个人云盘项目里几乎人人都会踩一次。3. 用Spring Boot实现文件上传、下载与存储路径拆分3.1 存本地还是存MinIO选型跟着演示环境走毕业设计答辩现场的机器配置参差不齐本地目录存储是最稳的选择。云OSS要联网、MinIO要额外装客户端演示时服务一旦起不来整个功能全废。常见的做法是把存储根路径放到配置里比如cloud.storage.root/data/clouddisk上传时拼接目录。如果确实想展示容器化能力可以定义一个StorageService接口本地和MinIO各写一个实现配置切换即可。方案部署成本演示稳定性代码量适用阶段本地磁盘零高少毕设、单机演示MinIO一个容器中需要客户端展示对象存储概念云OSS账号/网络依赖网络中生产环境对Spring Boot项目来说本地方案还有一个额外好处断点调试时可以直接打开目录看文件落盘没落盘排除问题时少一层不确定因素。3.2 上传接口MultipartFile流式落地与文件重名策略Controller层只做参数绑定业务逻辑全部放进Service。文件上传接口的核心是拿到MultipartFile后用UUID生成物理文件名把用户原始文件名存进元数据表物理文件和逻辑文件彻底拆分。PostMapping(/api/files/upload) public ResultLong upload(RequestParam(file) MultipartFile file, RequestParam(value parentId, required false) Long parentId) { if (file.isEmpty()) { return Result.fail(上传文件为空); } return Result.ok(fileService.upload(file, parentId, currentUserId())); }Service里做四件事校验配额、生成存储路径、流式落盘、插入元数据并累加用户已用空间。Transactional public Long upload(MultipartFile file, Long parentId, Long userId) { // 1. 先判断配额避免文件写一半才报空间不足 User user userMapper.selectById(userId); if (user.getUsedSpace() file.getSize() user.getTotalSpace()) { throw new BizException(存储空间不足); } // 2. 存储路径按用户隔离再按日期分目录避免单目录文件过多 String dateDir LocalDate.now().format(DateTimeFormatter.ofPattern(yyyy/MM/dd)); String storageName UUID.randomUUID().toString().replace(-, ) getExt(file.getOriginalFilename()); String path userId / dateDir / storageName; File target Paths.get(storageRoot, path).toFile(); target.getParentFile().mkdirs(); // 3. 用Files.copy流式写入不要用FileUtils.readFileToByteArray try (InputStream in file.getInputStream()) { Files.copy(in, target.toPath(), StandardCopyOption.REPLACE_EXISTING); } catch (IOException e) { throw new BizException(文件落盘失败); } // 4. 保存元数据name保留用户原始文件名 FileMetadata meta new FileMetadata(); meta.setUserId(userId); meta.setParentId(parentId); meta.setName(file.getOriginalFilename()); meta.setStoragePath(path); meta.setFileSize(file.getSize()); meta.setContentType(file.getContentType()); meta.setIsFolder(false); fileMetadataMapper.insert(meta); userMapper.incrUsedSpace(userId, file.getSize()); return meta.getId(); }参数说明REPLACE_EXISTING配合UUID生成的storageName物理层面几乎不会出现同名冲突这个替换选项只是双保险。try-with-resources保证InputStream在任何异常路径下都能关闭Windows环境下文件句柄泄漏会导致已上传文件无法删除这是上传功能最常见的隐藏坑。用户原始文件名可以重名重名策略放在Service里做比较常见的是自动追加“ (1)”后缀也可以直接拒绝并提示用户改名。提示MultipartFile的getSize()是long不要强转成int大文件超过2GB时精度直接溢出配额校验会失效。3.3 下载与预览中文文件名编码与流的关闭下载接口比上传简单但有两个坑中文文件名和文件流关闭。Content-Disposition里直接拼中文会乱码需要用URLEncoder做RFC 5987编码。GetMapping(/api/files/{id}/download) public ResponseEntityResource download(PathVariable Long id) { FileMetadata meta fileMetadataMapper.selectById(id); File file Paths.get(storageRoot, meta.getStoragePath()).toFile(); // 标准做法filename* 后面跟UTF-8编码的文件名 String downloadName URLEncoder.encode(meta.getName(), StandardCharsets.UTF_8) .replace(, %20); return ResponseEntity.ok() .header(HttpHeaders.CONTENT_DISPOSITION, attachment; filename*UTF-8 downloadName) .contentType(MediaType.APPLICATION_OCTET_STREAM) .body(new FileSystemResource(file)); }逻辑说明FileSystemResource由Spring管理流的打开和关闭不需要手动close但要避免在Service里先new FileInputStream再返回给Controller那样流的生命周期会跨层漏关的概率大增。预览功能与下载共用这个接口视频预览需要支持 Range 请求返回206片段浏览器播放器组件会自己发Range头Spring的ResourceHttpMessageConverter可以处理前提是不要手动把整个文件读进byte[]大文件直接内存溢出。4. 个人云盘的文件移动、回收站与分享链接实现4.1 目录树操作重命名与移动不能只改一个字段文件重命名是最容易的接口一条更新语句把name改掉物理文件完全不动。但要在同一个parent_id下做重名校验否则用户会得到两个同名的文件后续展示层要额外处理。移动文件则要小心一个循环引用问题不能把目录移动到它自己的子孙节点下面否则目录树出现环递归遍历直接栈溢出。public boolean isDescendant(Long targetParentId, Long nodeId) { Long cursor targetParentId; while (cursor ! null) { if (cursor.equals(nodeId)) { return true; } FileMetadata node fileMetadataMapper.selectById(cursor); cursor node null ? null : node.getParentId(); } return false; }这个算法沿父链向上走循环次数等于树的深度个人网盘的目录深度一般不会超过几十层完全够用。更严谨的方案是给文件表加一个ancestor_path字段存储祖先ID链用前缀匹配判断是否后代但会引入数据冗余和一致性问题毕业设计里不用过度设计。移动时还要校验目标parent_id属于同一个user_id否则会出现跨用户的目录引用列表查询时把别人的文件树挂进来这是权限上的低级漏洞。4.2 回收站逻辑删除、恢复与定时清理删除文件时不要直接删物理文件把is_deleted置1同时对它的所有子孙节点做同样的标记。这里用递归子查询或者一次性查出子树ID列表都可以数据量不大时逐层查没问题。恢复操作要处理一个边界如果文件被删到回收站后它的父目录也被删了恢复时父目录可能不存在最简单的策略是统一恢复到根目录避免一串文件挂在看不见的目录下。清理用Spring的Scheduled定时任务每天凌晨3点把删除超过30天的记录物理删掉同时删除磁盘文件。注意物理删除前要确认file_hash没有被其他未删除记录引用——秒传复用的文件同一份物理文件可能对应多条元数据记录直接删磁盘文件会让其他用户文件损坏。这个细节在评审时被点到的概率极高。4.3 分享链接token、有效期与访问计数分享功能的实现是生成一条share_link记录把token拼成前端路由/s/{token}。访问时通过token查出分享记录校验过期时间然后决定返回文件下载流还是文件夹文件列表。GetMapping(/s/{token}) public ResponseEntity? accessShare(PathVariable String token) { ShareLink share shareMapper.selectOne( new LambdaQueryWrapperShareLink() .eq(ShareLink::getToken, token)); if (share null || (share.getExpireTime() ! null share.getExpireTime().isBefore(LocalDateTime.now()))) { return Result.fail(链接失效); } shareMapper.incrementVisitCount(share.getId()); FileMetadata meta fileMetadataMapper.selectById(share.getFileId()); // 文件夹返回文件列表文件返回下载重定向 if (meta.getIsFolder() 1) { return Result.ok(listFiles(meta.getId(), share.getOwnerId())); } return ResponseEntity.ok().build(); }方法路径参数说明POST/api/sharesfileId, expireDays创建分享链接GET/s/{token}无访问分享内容DELETE/api/shares/{id}无取消分享expireTime为空表示永久有效但默认给7天更符合真实产品逻辑。分享链接在被访问前不校验文件是否存在文件被删除后链接依然存在访问时查不到元数据要统一返回“文件已删除”。前端是Vue的话/s/:token做成独立路由通过token调后端接口拿文件列表JSON或下载流不要在后端拼HTML页面这样前后端分离的边界才清晰。5. 个人云盘的分片上传、秒传与答辩验证性能口径5.1 大文件分片前端切块、后端乱序兜底合并文件超过200MB时一次性提交MultipartFile容易触发连接超时。常见做法是前端用Blob.slice切成固定大小的分片逐片上传后端把每个分片先写进临时目录全部到位后再合并。public void mergeChunks(String uploadId, int totalChunks, String destPath) throws IOException { File dest new File(storageRoot, destPath); dest.getParentFile().mkdirs(); // 按分片序号顺序读入合并成完整文件 try (FileOutputStream fos new FileOutputStream(dest)) { for (int i 0; i totalChunks; i) { File chunk new File(tempDir, uploadId _ i); try (FileInputStream fis new FileInputStream(chunk)) { byte[] buf new byte[8192]; int len; while ((len fis.read(buf)) ! -1) { fos.write(buf, 0, len); } } } } }uploadId在前端发起首个分片请求时由后端生成并返回后续每个分片都带上它。合并时按序号顺序写不要把并发完成的乱序分片直接按到达顺序拼接那会产出一个错乱的文件。场景分片大小500MB文件请求数说明局域网/本地演示50MB10请求少合并快公网/弱网环境10MB50重传代价小进度细腻5.2 秒传hash命中直接挂载元数据前端用 spark-md5 或 Web Crypto API 计算文件hash后台上传前先查file_hashFileMetadata exist fileMetadataMapper.selectOne( new LambdaQueryWrapperFileMetadata() .eq(FileMetadata::getFileHash, md5) .eq(FileMetadata::getIsDeleted, 0) .last(limit 1)); if (exist ! null) { // 复用的是物理文件元数据还是要新插入归属到当前用户 FileMetadata meta new FileMetadata(); meta.setUserId(userId); meta.setParentId(parentId); meta.setName(originalName); meta.setStoragePath(exist.getStoragePath()); meta.setFileSize(exist.getFileSize()); meta.setFileHash(md5); fileMetadataMapper.insert(meta); // 注意新记录插入后used_space照样要累加 userMapper.incrUsedSpace(userId, exist.getFileSize()); }这个方案有个容易忽略的点秒传插入了新元数据但物理文件体积不变用户配额要按逻辑文件累加不能按磁盘扫描结果计算。回收站物理删除时也要对应做引用计数避免误删。5.3 演示环境验证与日志观察答辩前把演示视频录好但现场往往开新环境别人拷来的源码未必能一次起服务。拿到一份Spring Boot项目压缩包第一件事不是解压后直接mvn spring-boot:run而是确认三件事pom.xml里parent的版本决定用的是javax还是jakarta命名空间JDK版本和JAVA_HOME指向是否匹配Spring Boot 2.x配Java 8Spring Boot 3.x必须Java 17schema.sql有没有被执行数据库账号有没有建表权限。网上搜“springboot版本太高”踩坑的人大半是拿着Spring Boot 3.x的项目用Java 8去跑报错一堆NoClassDefFoundError。并发验证没必要上复杂工具。给虚拟机限制2核CPU和1G内存用浏览器同时拖三个200MB文件上去观察上传过程中内存曲线是否平稳结束后是否有回落。如果内存持续上涨不释放先查Service里有没有把MultipartFile转成byte[]存内存。再把日志级别调到DEBUG盯上传时的文件流打开和关闭日志句柄只增不减说明流生命周期管理有问题。这一步排掉的坑比按教程重写一遍代码值钱得多。本文还有配套的精品资源点击获取 Spring Boot个人云盘系统：元数据、上传下载与秒传实现
简介面向Java毕业设计及课程设计学生的个人云盘管理系统完整项目包基于SpringbootMySQLVue技术栈采用B/S架构涵盖用户信息管理、博客信息管理、视频信息管理、论坛信息管理等典型业务模块可作为前后端分离开发的学习范本。资源共784个文件以Java后端源码、Vue前端页面、JavaScript脚本、SQL数据库脚本为主体另含SVG图标、CSS样式、MP4演示视频等辅助内容压缩包整体约56.62MB目录结构按后端、前端、数据库及文档分区检索与部署便捷。已有286人学习下载。资料内含可运行完整源码、操作演示视频及说明文档既有助于从零梳理SpringbootVue项目实现流程也可直接支撑毕业设计答辩或课程设计提交适合需要完整项目参考的Java初学者及应届毕业生。1. 个人云盘管理系统Spring Boot毕业设计里最容易被低估的题目很多人听到“个人云盘”第一反应是上传下载Demo真正动手才发现卡壳点全在细节上。文件多了以后目录树怎么表示、重名文件怎么处理、回收站怎么恢复、分享链接怎么过期这些问题比“把文件写到磁盘”难得多。对做Java毕业设计的学生来说这个题目正好覆盖Spring Boot框架、MyBatis持久层、文件流处理和前后端分离一套做完面试被追问也能接住。这里按一套可复现的结构拆开讲先定库表再写上传下载然后补目录与分享最后把分片和秒传装上去。适合正在做这个题目的学生也适合拿这个项目给新人做评审点的老工程师。2. Spring Boot个人云盘的库表设计与元数据模型2.1 为什么云盘要先建表再写上传接口个人云盘管理系统的核心不是二进制文件本身而是文件的元数据。文件扔到磁盘后用户看到的名字、所在目录、大小、分享链接全部来自数据库里的记录。常见的错误做法是把物理存储路径直接写进文件的name字段用户一重命名就得挪动真实文件还有人用/a/b/c.txt这样的字符串存目录结构移动一个父目录要递归改写所有子节点的路径字段。正确的建模方式是parentId自引用文件表里只记录逻辑树关系物理路径由存储层单独决定。这样重命名只是更新一行记录移动目录只是更新一个外键回收站只是翻转一个标记位。Spring Boot框架的自动配置帮我们省去了Servlet时代的XML装配但表关系设计这件事框架替不了。2.2 三张核心表user、file_metadata、share_link我一般会至少建三张表用户表、文件元数据表、分享链接表。把total_space和used_space放在用户表里便于上传时做配额判断文件表用parent_id支撑整棵目录树分享链接单独成表不要在文件表里塞一个share_token字段了事。CREATE TABLE IF NOT EXISTS user ( id BIGINT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(64) NOT NULL UNIQUE, password_hash VARCHAR(128) NOT NULL, total_space BIGINT NOT NULL DEFAULT 10737418240, used_space BIGINT NOT NULL DEFAULT 0, created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE IF NOT EXISTS file_metadata ( id BIGINT PRIMARY KEY AUTO_INCREMENT, user_id BIGINT NOT NULL, parent_id BIGINT NULL, name VARCHAR(255) NOT NULL, storage_path VARCHAR(512) NULL, storage_name VARCHAR(128) NULL, file_size BIGINT NOT NULL DEFAULT 0, file_hash VARCHAR(64) NULL, content_type VARCHAR(128) NULL, is_folder TINYINT NOT NULL DEFAULT 0, is_deleted TINYINT NOT NULL DEFAULT 0, deleted_at DATETIME NULL, created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, INDEX idx_user_parent (user_id, parent_id, is_deleted), INDEX idx_hash (file_hash) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;这段DDL里几个字段容易被忽略。storage_path存相对路径和用户可见的name分离物理文件名用UUID重命名用户改名时不需要碰真实文件parent_id为空表示根目录整个文件系统是树而不是平铺列表file_hash是给秒传做准备的索引不能省否则上传大文件时查重会全表扫描。CREATE TABLE IF NOT EXISTS share_link ( id BIGINT PRIMARY KEY AUTO_INCREMENT, file_id BIGINT NOT NULL, owner_id BIGINT NOT NULL, token VARCHAR(64) NOT NULL UNIQUE, expire_time DATETIME NULL, visit_count INT NOT NULL DEFAULT 0, created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;分享表里token用UUID生成expire_time为空表示永久链接建议业务上强制默认7天有效。文件和文件夹的分享都走这一张表共享同一套访问逻辑后续加提取码也只需要扩展两个字段。2.3 MyBatis-Plus实体映射与Spring Boot自动建表配置实体类对应TableName(file_metadata)主键用TableId(type IdType.AUTO)parent_id用Long文件大小用Long而不是Integer单文件超过2GB时Integer直接溢出。很多人搜索“springboot mybatis 当表不存在自动建表”核心是理解MyBatis-Plus本身不负责建表要配合Spring Boot的SQL初始化机制。把上面的DDL存到resources/schema.sql然后在配置里打开开关spring: datasource: url: jdbc:mysql://localhost:3306/clouddisk?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: root sql: init: mode: always schema-locations: classpath:schema.sql servlet: multipart: max-file-size: 200MB max-request-size: 210MBspring.sql.init.modealways表示每次启动都执行脚本配合CREATE TABLE IF NOT EXISTS实现幂等建表生产环境建议改成never由发布流程单独管理表结构。spring.servlet.multipart两个参数必须显式配置Spring Boot的默认上传限制只有1MB不配的话大文件直接报MaxUploadSizeExceededException这类问题在个人云盘项目里几乎人人都会踩一次。3. 用Spring Boot实现文件上传、下载与存储路径拆分3.1 存本地还是存MinIO选型跟着演示环境走毕业设计答辩现场的机器配置参差不齐本地目录存储是最稳的选择。云OSS要联网、MinIO要额外装客户端演示时服务一旦起不来整个功能全废。常见的做法是把存储根路径放到配置里比如cloud.storage.root/data/clouddisk上传时拼接目录。如果确实想展示容器化能力可以定义一个StorageService接口本地和MinIO各写一个实现配置切换即可。方案部署成本演示稳定性代码量适用阶段本地磁盘零高少毕设、单机演示MinIO一个容器中需要客户端展示对象存储概念云OSS账号/网络依赖网络中生产环境对Spring Boot项目来说本地方案还有一个额外好处断点调试时可以直接打开目录看文件落盘没落盘排除问题时少一层不确定因素。3.2 上传接口MultipartFile流式落地与文件重名策略Controller层只做参数绑定业务逻辑全部放进Service。文件上传接口的核心是拿到MultipartFile后用UUID生成物理文件名把用户原始文件名存进元数据表物理文件和逻辑文件彻底拆分。PostMapping(/api/files/upload) public ResultLong upload(RequestParam(file) MultipartFile file, RequestParam(value parentId, required false) Long parentId) { if (file.isEmpty()) { return Result.fail(上传文件为空); } return Result.ok(fileService.upload(file, parentId, currentUserId())); }Service里做四件事校验配额、生成存储路径、流式落盘、插入元数据并累加用户已用空间。Transactional public Long upload(MultipartFile file, Long parentId, Long userId) { // 1. 先判断配额避免文件写一半才报空间不足 User user userMapper.selectById(userId); if (user.getUsedSpace() file.getSize() user.getTotalSpace()) { throw new BizException(存储空间不足); } // 2. 存储路径按用户隔离再按日期分目录避免单目录文件过多 String dateDir LocalDate.now().format(DateTimeFormatter.ofPattern(yyyy/MM/dd)); String storageName UUID.randomUUID().toString().replace(-, ) getExt(file.getOriginalFilename()); String path userId / dateDir / storageName; File target Paths.get(storageRoot, path).toFile(); target.getParentFile().mkdirs(); // 3. 用Files.copy流式写入不要用FileUtils.readFileToByteArray try (InputStream in file.getInputStream()) { Files.copy(in, target.toPath(), StandardCopyOption.REPLACE_EXISTING); } catch (IOException e) { throw new BizException(文件落盘失败); } // 4. 保存元数据name保留用户原始文件名 FileMetadata meta new FileMetadata(); meta.setUserId(userId); meta.setParentId(parentId); meta.setName(file.getOriginalFilename()); meta.setStoragePath(path); meta.setFileSize(file.getSize()); meta.setContentType(file.getContentType()); meta.setIsFolder(false); fileMetadataMapper.insert(meta); userMapper.incrUsedSpace(userId, file.getSize()); return meta.getId(); }参数说明REPLACE_EXISTING配合UUID生成的storageName物理层面几乎不会出现同名冲突这个替换选项只是双保险。try-with-resources保证InputStream在任何异常路径下都能关闭Windows环境下文件句柄泄漏会导致已上传文件无法删除这是上传功能最常见的隐藏坑。用户原始文件名可以重名重名策略放在Service里做比较常见的是自动追加“ (1)”后缀也可以直接拒绝并提示用户改名。提示MultipartFile的getSize()是long不要强转成int大文件超过2GB时精度直接溢出配额校验会失效。3.3 下载与预览中文文件名编码与流的关闭下载接口比上传简单但有两个坑中文文件名和文件流关闭。Content-Disposition里直接拼中文会乱码需要用URLEncoder做RFC 5987编码。GetMapping(/api/files/{id}/download) public ResponseEntityResource download(PathVariable Long id) { FileMetadata meta fileMetadataMapper.selectById(id); File file Paths.get(storageRoot, meta.getStoragePath()).toFile(); // 标准做法filename* 后面跟UTF-8编码的文件名 String downloadName URLEncoder.encode(meta.getName(), StandardCharsets.UTF_8) .replace(, %20); return ResponseEntity.ok() .header(HttpHeaders.CONTENT_DISPOSITION, attachment; filename*UTF-8 downloadName) .contentType(MediaType.APPLICATION_OCTET_STREAM) .body(new FileSystemResource(file)); }逻辑说明FileSystemResource由Spring管理流的打开和关闭不需要手动close但要避免在Service里先new FileInputStream再返回给Controller那样流的生命周期会跨层漏关的概率大增。预览功能与下载共用这个接口视频预览需要支持 Range 请求返回206片段浏览器播放器组件会自己发Range头Spring的ResourceHttpMessageConverter可以处理前提是不要手动把整个文件读进byte[]大文件直接内存溢出。4. 个人云盘的文件移动、回收站与分享链接实现4.1 目录树操作重命名与移动不能只改一个字段文件重命名是最容易的接口一条更新语句把name改掉物理文件完全不动。但要在同一个parent_id下做重名校验否则用户会得到两个同名的文件后续展示层要额外处理。移动文件则要小心一个循环引用问题不能把目录移动到它自己的子孙节点下面否则目录树出现环递归遍历直接栈溢出。public boolean isDescendant(Long targetParentId, Long nodeId) { Long cursor targetParentId; while (cursor ! null) { if (cursor.equals(nodeId)) { return true; } FileMetadata node fileMetadataMapper.selectById(cursor); cursor node null ? null : node.getParentId(); } return false; }这个算法沿父链向上走循环次数等于树的深度个人网盘的目录深度一般不会超过几十层完全够用。更严谨的方案是给文件表加一个ancestor_path字段存储祖先ID链用前缀匹配判断是否后代但会引入数据冗余和一致性问题毕业设计里不用过度设计。移动时还要校验目标parent_id属于同一个user_id否则会出现跨用户的目录引用列表查询时把别人的文件树挂进来这是权限上的低级漏洞。4.2 回收站逻辑删除、恢复与定时清理删除文件时不要直接删物理文件把is_deleted置1同时对它的所有子孙节点做同样的标记。这里用递归子查询或者一次性查出子树ID列表都可以数据量不大时逐层查没问题。恢复操作要处理一个边界如果文件被删到回收站后它的父目录也被删了恢复时父目录可能不存在最简单的策略是统一恢复到根目录避免一串文件挂在看不见的目录下。清理用Spring的Scheduled定时任务每天凌晨3点把删除超过30天的记录物理删掉同时删除磁盘文件。注意物理删除前要确认file_hash没有被其他未删除记录引用——秒传复用的文件同一份物理文件可能对应多条元数据记录直接删磁盘文件会让其他用户文件损坏。这个细节在评审时被点到的概率极高。4.3 分享链接token、有效期与访问计数分享功能的实现是生成一条share_link记录把token拼成前端路由/s/{token}。访问时通过token查出分享记录校验过期时间然后决定返回文件下载流还是文件夹文件列表。GetMapping(/s/{token}) public ResponseEntity? accessShare(PathVariable String token) { ShareLink share shareMapper.selectOne( new LambdaQueryWrapperShareLink() .eq(ShareLink::getToken, token)); if (share null || (share.getExpireTime() ! null share.getExpireTime().isBefore(LocalDateTime.now()))) { return Result.fail(链接失效); } shareMapper.incrementVisitCount(share.getId()); FileMetadata meta fileMetadataMapper.selectById(share.getFileId()); // 文件夹返回文件列表文件返回下载重定向 if (meta.getIsFolder() 1) { return Result.ok(listFiles(meta.getId(), share.getOwnerId())); } return ResponseEntity.ok().build(); }方法路径参数说明POST/api/sharesfileId, expireDays创建分享链接GET/s/{token}无访问分享内容DELETE/api/shares/{id}无取消分享expireTime为空表示永久有效但默认给7天更符合真实产品逻辑。分享链接在被访问前不校验文件是否存在文件被删除后链接依然存在访问时查不到元数据要统一返回“文件已删除”。前端是Vue的话/s/:token做成独立路由通过token调后端接口拿文件列表JSON或下载流不要在后端拼HTML页面这样前后端分离的边界才清晰。5. 个人云盘的分片上传、秒传与答辩验证性能口径5.1 大文件分片前端切块、后端乱序兜底合并文件超过200MB时一次性提交MultipartFile容易触发连接超时。常见做法是前端用Blob.slice切成固定大小的分片逐片上传后端把每个分片先写进临时目录全部到位后再合并。public void mergeChunks(String uploadId, int totalChunks, String destPath) throws IOException { File dest new File(storageRoot, destPath); dest.getParentFile().mkdirs(); // 按分片序号顺序读入合并成完整文件 try (FileOutputStream fos new FileOutputStream(dest)) { for (int i 0; i totalChunks; i) { File chunk new File(tempDir, uploadId _ i); try (FileInputStream fis new FileInputStream(chunk)) { byte[] buf new byte[8192]; int len; while ((len fis.read(buf)) ! -1) { fos.write(buf, 0, len); } } } } }uploadId在前端发起首个分片请求时由后端生成并返回后续每个分片都带上它。合并时按序号顺序写不要把并发完成的乱序分片直接按到达顺序拼接那会产出一个错乱的文件。场景分片大小500MB文件请求数说明局域网/本地演示50MB10请求少合并快公网/弱网环境10MB50重传代价小进度细腻5.2 秒传hash命中直接挂载元数据前端用 spark-md5 或 Web Crypto API 计算文件hash后台上传前先查file_hashFileMetadata exist fileMetadataMapper.selectOne( new LambdaQueryWrapperFileMetadata() .eq(FileMetadata::getFileHash, md5) .eq(FileMetadata::getIsDeleted, 0) .last(limit 1)); if (exist ! null) { // 复用的是物理文件元数据还是要新插入归属到当前用户 FileMetadata meta new FileMetadata(); meta.setUserId(userId); meta.setParentId(parentId); meta.setName(originalName); meta.setStoragePath(exist.getStoragePath()); meta.setFileSize(exist.getFileSize()); meta.setFileHash(md5); fileMetadataMapper.insert(meta); // 注意新记录插入后used_space照样要累加 userMapper.incrUsedSpace(userId, exist.getFileSize()); }这个方案有个容易忽略的点秒传插入了新元数据但物理文件体积不变用户配额要按逻辑文件累加不能按磁盘扫描结果计算。回收站物理删除时也要对应做引用计数避免误删。5.3 演示环境验证与日志观察答辩前把演示视频录好但现场往往开新环境别人拷来的源码未必能一次起服务。拿到一份Spring Boot项目压缩包第一件事不是解压后直接mvn spring-boot:run而是确认三件事pom.xml里parent的版本决定用的是javax还是jakarta命名空间JDK版本和JAVA_HOME指向是否匹配Spring Boot 2.x配Java 8Spring Boot 3.x必须Java 17schema.sql有没有被执行数据库账号有没有建表权限。网上搜“springboot版本太高”踩坑的人大半是拿着Spring Boot 3.x的项目用Java 8去跑报错一堆NoClassDefFoundError。并发验证没必要上复杂工具。给虚拟机限制2核CPU和1G内存用浏览器同时拖三个200MB文件上去观察上传过程中内存曲线是否平稳结束后是否有回落。如果内存持续上涨不释放先查Service里有没有把MultipartFile转成byte[]存内存。再把日志级别调到DEBUG盯上传时的文件流打开和关闭日志句柄只增不减说明流生命周期管理有问题。这一步排掉的坑比按教程重写一遍代码值钱得多。本文还有配套的精品资源点击获取