JSP+Servlet网盘项目实战：源码解析、部署避坑与秒传进阶

简介一份基于JSP、Servlet与MySQL的网盘系统毕业设计源码包面向计算机相关专业学生也适合需要快速搭建文件上传下载功能的开发者尤其适合毕设选题为网盘管理或文件存储方向的学生参考借鉴。项目难度适中源码经过本地编译验证按配套文档配置好环境即可运行可应用于课程设计、毕业设计或Web入门练习。资源共123个文件压缩包大小2.28MB包含22个JSP页面、20个Java类与20个Class文件以及CSS样式、JS脚本、Jar依赖包、XML配置等辅助文件其中JSP负责页面展示Servlet与Java类处理请求和数据库交互CSS与JS优化前端体验各类文件配合覆盖了用户管理、文件上传、下载、关注等核心业务逻辑。目前已有116人学习/下载代码结构清晰配置与注释齐全遇到问题还可私信博主获得解答。对于需要完整可运行项目作参考的读者这份资源能帮助理解传统Servlet加JSP的开发模式并可直接进行二次改造。1. JSPServlet还是Spring Boot网盘毕设项目为何值得搭一遍一个信息模型简单的网盘系统把用户、文件和下载关系串进去恰好把Java Web考试里最容易扣分的三个环节放在同一套代码里Servlet生命周期、过滤器链、JDBC数据访问。这套基于JSPServletMySQL实现的源码涵盖用户注册登录、文件上传下载、管理员后台和用户关注四块业务文件清单里从UserDao到DownloadFilter一共十个核心类典型毕业生在本地跑通的链路用不上Spring Boot那套依赖注入体系。如果你正在为选题发愁或者想补强原生Servlet的底子这套能完整跑通的代码比直接套Spring Boot骨架的参考资料要有价值得多——跑通它你才能说清楚一个http请求从Filter到DAO到底走了几步。2. 逆向读源码从class文件反推MVC分层与数据模型2.1 先画类图再找代码class文件名就是架构说明书压缩包解压后src目录下是一批.class文件有人看到编译产物就以为源码不全其实对Java Web项目来说class文件名本身就是最好的架构说明书。把UserServlet、UploadServlet、DownloadServlet、AdminServlet归到一起这是控制器层负责接收请求参数、调用业务方法、决定是转发还是重定向UserDao、UserFileDao、UserFollowDao归到一起这是数据访问层负责用PreparedStatement操作MySQLUserFile是实体类对应user_file表LoginFilter和DownloadFilter是横切逻辑在请求进入Servlet之前统一处理登录态和下载权限。如果IDE里给的确实是编译好的class而不是.java源文件可以用javap命令反汇编看方法签名确认每个类的入口方法都做了什么javap -p -c UserFileDao.class-p参数显示私有成员-c参数输出字节码指令。虽然不至于把字节码逐行读完但看一下方法名和成员变量就能判断这个DAO到底提供了insert、queryByUserId还是listAll。用它确认类职责比直接猜要省事得多这是拿到一个陌生Java Web项目后我一般会先做的一步。2.2 用户、文件、关注三张表的字段推演与建表SQL按照类名和业务功能反推数据库至少需要三张表。user表存账号与角色user_file表记录每次上传的文件元数据user_follow表维护用户之间的关注关系。下面是常见做法的一套建表语句CREATE TABLE user ( id int NOT NULL AUTO_INCREMENT, username varchar(50) NOT NULL COMMENT 登录账号, password varchar(100) NOT NULL COMMENT 密码保存MD5摘要, nickname varchar(50) DEFAULT NULL COMMENT 显示昵称, email varchar(100) DEFAULT NULL, role tinyint DEFAULT 0 COMMENT 0-普通用户1-管理员, create_time datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_username (username) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE user_file ( id int NOT NULL AUTO_INCREMENT, user_id int NOT NULL COMMENT 所属用户, file_name varchar(255) NOT NULL COMMENT 用户看到的原始文件名, file_path varchar(255) NOT NULL COMMENT 服务端实际存储路径, file_size bigint DEFAULT 0 COMMENT 文件字节数, file_type varchar(20) DEFAULT NULL COMMENT 扩展名, download_count int DEFAULT 0 COMMENT 下载次数, upload_time datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_user_id (user_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; CREATE TABLE user_follow ( id int NOT NULL AUTO_INCREMENT, user_id int NOT NULL COMMENT 关注发起方, follow_user_id int NOT NULL COMMENT 被关注方, create_time datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_user_follow (user_id,follow_user_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;password字段为什么预留100个字符而不是固定32位因为MD5加盐后的长度可能超过32留宽一点后面改造方便。file_type存扩展名就够了别用枚举文件种类一多扩枚举就是给自己找事。这里还有一个新手容易踩的坑file_name和file_path必须分开存上传时只把file_path指向服务器上的随机存储名file_name保留原始名。如果混着存下载时浏览器里显示的文件名就是一串UUID用户根本看不明白。提示建库阶段就用utf8mb4连排序规则一起确认。项目跑起来之后再改库表编码是最费时间的一步。字段注释最好在建表时写全。MySQL的information_schema里能看到注释毕设答辩时老师问起字段含义注释就是现成的回答提纲。2.3 LoginFilter和DownloadFilter的拦截顺序与边界Servlet容器在请求进入时按注册顺序执行过滤器链。web.xml里LoginFilter应该放最前面并且url-pattern写成/*这样所有请求都会先过一遍登录校验。DownloadFilter则精准映射到/download路径只处理下载相关请求两者职责完全不同filter filter-nameLoginFilter/filter-name filter-classcom.demo.filter.LoginFilter/filter-class /filter filter-mapping filter-nameLoginFilter/filter-name url-pattern/*/url-pattern /filter-mapping filter filter-nameDownloadFilter/filter-name filter-classcom.demo.filter.DownloadFilter/filter-class /filter filter-mapping filter-nameDownloadFilter/filter-name url-pattern/download/url-pattern /filter-mapping注意LoginFilter把/*全覆盖之后登录页面login.jsp、注册Servlet、CSS和JS文件也都会被拦截所以过滤器内部必须做白名单放行否则就会出现“连登录页都打不开”的翻车现场。常见的放行判断是这样public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException { HttpServletRequest req (HttpServletRequest) request; HttpServletResponse resp (HttpServletResponse) response; String uri req.getRequestURI(); // 白名单登录页、注册接口、静态资源 if (uri.endsWith(/login.jsp) || uri.endsWith(/register.jsp) || uri.contains(/css/) || uri.contains(/js/)) { chain.doFilter(request, response); return; } HttpSession session req.getSession(false); if (session ! null session.getAttribute(loginUser) ! null) { chain.doFilter(request, response); } else { resp.sendRedirect(req.getContextPath() /login.jsp); } }这段代码有三个关键细节。第一getSession(false)而不是getSession()前者只在会话存在时返回不会为了检查登录态而强行创建Session第二白名单判断必须放在session判断之前第三重定向和转发的区别要拎清——sendRedirect会让浏览器地址栏更新到登录页forward则会把请求在服务器内部转发。把这些想明白过滤器链的顺序问题就解决了一大半。如果要扩展权限逻辑比如“用户只能下载自己的文件”在DownloadFilter里取session中的用户ID再和请求参数的fileId比对即可。这正是这个项目把DownloadFilter单独拆出来的原因下载权限和登录权限的粒度本就不同。3. 本地复现MySQL初始化、Tomcat部署与关键配置3.1 MySQL 5.7/8.0环境准备与字符集选择本地复现的第一步是搭好数据库。安装MySQL的具体步骤各平台略有差异核心是记住一条建议优先用8.0以上版本同时把默认字符集设为utf8mb4。解压版和安装版差在初始化方式安装版在服务管理器就能启动解压版需要手工执行mysqld --initialize-insecure生成数据目录再注册为Windows服务这一步网上教程很多照着敲一遍即可。启动MySQL后创建项目数据库并把上一章的三个建表脚本按顺序执行CREATE DATABASE IF NOT EXISTS netdisk DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE netdisk;排序规则选utf8mb4_general_ci而不是unicode_ci前者在排序和比较上的开销更小对毕设项目足够。有些老资料把库建成utf8上传中文文件名时会发现emoji和生僻字变成乱码处理方式不是只改表结构而是把库、表、字段三级字符集全部改成utf8mb4改完重启MySQL才生效。连接时如果用的是Navicat或Workbench这类客户端连接串里要把characterEncodingUTF-8和useSSLfalse写清楚。JDBC驱动方面MySQL 8.0对应的是com.mysql.cj.jdbc.Driver而不是老版本的com.mysql.jdbc.Driver这是启动阶段最常见的报错点之一很多人在网上搜半天最后发现只是驱动类名没换。3.2 JDBC连接参数与web.xml部署配置项目的JDBC配置一般写在src目录下的jdbc.properties中常见模板长这样jdbc.drivercom.mysql.cj.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/netdisk?useUnicodetruecharacterEncodingUTF-8serverTimezoneAsia/ShanghaiuseSSLfalseallowPublicKeyRetrievaltrue jdbc.usernameroot jdbc.password你的密码serverTimezoneAsia/Shanghai是MySQL 8.0之后必须带的参数否则JDBC连接时会因为服务器时区解析直接抛SQLException。allowPublicKeyRetrievaltrue只在MySQL 8.0的caching_sha2_password认证方式下需要如果本地库是5.7或已改成mysql_native_password这个参数可以不写。一个判断技巧如果你用的驱动和数据库主版本不一致优先对齐驱动版本而不是改参数。提示serverTimezone参数只影响JDBC连接时的时区解析不影响MySQL服务器自身的time_zone设置两者是独立的。加载配置的代码建议放在静态块里保证整个应用只加载一次static { try (InputStream in DBUtil.class.getClassLoader() .getResourceAsStream(jdbc.properties)) { Properties props new Properties(); props.load(in); Class.forName(props.getProperty(jdbc.driver)); } catch (Exception e) { throw new ExceptionInInitializerError(e); } }这里的getResourceAsStream从classpath根目录找配置文件所以jdbc.properties必须放在src/main/resources或src目录下等它被编译进WEB-INF/classes才算有效。很多同学把配置文件放在项目根目录Tomcat启动后提示找不到配置就是这个原因。3.3 从源码到可运行编译与部署的完整步骤从拿到源码到页面能在浏览器打开我一般走这样一套步骤。第一步确认JDK版本与项目编译级别一致毕设项目大多用JDK 8如果本机是JDK 17需要在IDEA的Project Structure里把Language Level切到8否则部分Servlet API的写法不兼容。第二步导入依赖包。Servlet和JSP的API在Tomcat的lib目录里已经有了不需要拷进项目需要手工引入的是JSTL、文件上传组件commons-fileupload、commons-io和MySQL驱动把jar包放到WEB-INF/lib下。第三步是配置Tomcat。在IDEA里新建Tomcat Server的Local运行配置Deployment选项卡添加ArtifactApplication context填/netdisk这样访问路径就是http://localhost:8080/netdisk。如果项目没有生成Artifact先Build菜单里的Build Artifacts刷新一下再回来配置# 手动编译场景不依赖IDE javac -encoding UTF-8 -cp tomcat/lib/servlet-api.jar;WEB-INF/lib/* -d WEB-INF/classes src/com/demo/dao/*.java src/com/demo/servlet/*.java手动编译的好处是能看清classpath依赖但毕设开发我更推荐直接用IDE的构建功能省事。部署完成后启动Tomcat控制台出现INFO: Server startup in说明启动成功然后访问首页看能否正常跳转登录页。这一步做通了后面调试功能就有基准了。4. 核心链路拆解上传、下载、登录过滤的实现细节4.1 UploadServletmultipart解析与临时文件生命周期文件上传是网盘系统的核心。Servlet 3.0之前没有原生的multipart解析业界通行做法是用commons-fileupload组件这个项目的UploadServlet大概率也是这条路线。上传请求到达UploadServlet后先做三件事设置请求编码、校验登录session、解析multipart表单。protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { request.setCharacterEncoding(UTF-8); HttpSession session request.getSession(false); if (session null || session.getAttribute(loginUser) null) { response.sendRedirect(request.getContextPath() /login.jsp); return; } DiskFileItemFactory factory new DiskFileItemFactory(); // 缓冲区阈值小于1MB的文件直接进内存超过则写入临时文件 factory.setSizeThreshold(1024 * 1024); // 临时目录Tomcat的java.io.tmpdir factory.setRepository(new File(System.getProperty(java.io.tmpdir))); ServletFileUpload upload new ServletFileUpload(factory); upload.setHeaderEncoding(UTF-8); // 单个文件上限50MB整个请求上限100MB upload.setFileSizeMax(50 * 1024 * 1024); upload.setSizeMax(100 * 1024 * 1024); try { ListFileItem items upload.parseRequest(request); for (FileItem item : items) { if (item.isFormField()) { // 普通表单字段比如文件备注 continue; } String originalName new File(item.getName()).getName(); String ext originalName.contains(.) ? originalName.substring(originalName.lastIndexOf(.) 1) : ; String storeName UUID.randomUUID().toString().replace(-, ) . ext; File storeFile new File(saveDir, storeName); item.write(storeFile); // 把元数据写入user_file表 UserFile userFile new UserFile(); userFile.setUserId(((User) session.getAttribute(loginUser)).getId()); userFile.setFileName(originalName); userFile.setFilePath(saveDir.getAbsolutePath() File.separator storeName); userFile.setFileSize(item.getSize()); userFile.setFileType(ext); userFileDao.insert(userFile); } response.sendRedirect(request.getContextPath() /list.jsp); } catch (FileUploadBase.SizeLimitExceededException e) { request.setAttribute(error, 文件大小超过限制); request.getRequestDispatcher(/upload.jsp).forward(request, response); } catch (Exception e) { throw new ServletException(e); } }代码里的setSizeThreshold是一个值得记的参数。它表示内存缓冲区的字节阈值选小了大量小文件也会频繁写磁盘IO开销直线上升选大了并发上传时堆内存会被临时数据撑爆。对毕设项目1MB左右是比较均衡的默认值。saveDir是托管WEB-INF/upload下的目录用getServletContext().getRealPath(/WEB-INF/upload)拿到绝对路径再mkdirs。item.getName()在IE和Chrome下返回内容不一样老版本IE会返回完整路径所以代码里统一用new File(item.getName()).getName()取出纯文件名这是实战中总结出来的兼容写法。file_path字段里存物理磁盘的绝对路径下载时直接用FileInputStream打开不需要再通过ServletContext解析虚拟路径。注意上传文件的存储目录不要放在项目根目录下重新打包部署时目录会被清掉放在Tomcat外的独立路径更稳。4.2 DownloadServletContent-Disposition与下载统计下载接口和上传是镜像的两件事。DownloadServlet收到请求后先从数据库查出UserFile记录再以文件流方式输出给浏览器。这里有两个关键细节第一个是响应头必须设置Content-Disposition浏览器才会触发下载而不是在页面里直接渲染第二个是下载成功后要更新download_count字段。protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { String fileId request.getParameter(fileId); UserFile userFile userFileDao.findById(Integer.parseInt(fileId)); if (userFile null) { response.sendError(404, 文件不存在); return; } File file new File(userFile.getFilePath()); if (!file.exists()) { response.sendError(404, 文件已从服务器移除); return; } // 强迫浏览器下载而不是内联打开 response.setContentType(application/octet-stream); response.setHeader(Content-Disposition, attachment;filename URLEncoder.encode(userFile.getFileName(), UTF-8)); response.setContentLengthLong(file.length()); try (InputStream in new FileInputStream(file); OutputStream out response.getOutputStream()) { byte[] buffer new byte[8192]; int len; while ((len in.read(buffer)) ! -1) { out.write(buffer, 0, len); } out.flush(); } // 下载成功增加计数 userFileDao.increaseDownloadCount(userFile.getId()); }文件名的URLEncoder.encode是必需的否则中文文件名在部分浏览器里会变成乱码。边读边写的8KB缓冲是常见的折中选值——缓冲太大占堆内存太小放大IO次数4KB到16KB都是合理区间。还有一个容易忽略的点download_count更新放在输出流关闭之后。如果放在循环里每写一块就update一次数据库下载100MB文件会产生上万次数据库事务性能直接崩盘。这种业务字段的正确做法是下载完成更新一次失败就不动。4.3 AdminServlet与UserServlet两条业务线的请求分发UserServlet对应的是用户注册、登录、个人信息维护AdminServlet对应的是用户管理、文件清理等后台操作。两者在业务逻辑上高度相似主要区别在于AdminServlet要先校验当前登录用户的role字段是否为1没有这一层校验任何普通用户只要猜到管理员URL就能越权操作。User loginUser (User) request.getSession().getAttribute(loginUser); if (loginUser null || loginUser.getRole() ! 1) { response.sendError(403, 无权限访问); return; }这两行应放在AdminServlet的doGet和doPost最前面。虽然LoginFilter已保证用户登录但不能保证登录者就是管理员角色校验是第二道门。filter管“是不是登录用户”servlet管“能不能做这件事”职责边界划分清楚后面扩展功能时思路就清晰很多。UserFollowDao对应的关注功能在实现上也不复杂本质就是一对多关系维护。唯一需要注意的是关注关系表要有唯一约束否则用户在页面快速点击两次“关注”按钮表里会出现重复记录列表显示时同一个用户出现两遍。这个约束在表设计阶段就该加而不是靠业务代码去查重。5. 避坑指南部署网盘项目容易翻车的五个问题5.1 现象上传50MB以上文件时报错或者进度条卡住不动上传大文件时浏览器半天没反应最后不是报413就是“Connection reset”。原因是Tomcat的maxPostSize默认只有2MB超过这个值容器直接把请求体丢弃Servlet层的代码根本不会执行。解决方式有两种。一是改Tomcat的conf/server.xml里Connector的maxPostSize属性调大到预期最大值二是在UploadServlet上用注解配置multipartConfig的maxFileSize和maxRequestSize。如果项目用Servlet 3.0以上注解优先用第二种配置跟着代码走换环境部署不会漏MultipartConfig(maxFileSize 1024*1024*50, maxRequestSize 1024*1024*100)直接在server.xml里调maxPostSize虽然立竿见影但改的是Tomcat全局配置影响面太大不推荐在正规项目里这么干。提示maxPostSize改了还是超限时检查一下是否经过Nginx这类反向代理代理层的client_max_body_size同样有限制。5.2 现象下载时中文文件名全是加号或乱码Content-Disposition里对文件名做了URLEncoder.encode后Chrome正常但Firefox或老版本Edge里下载文件名变成一串带加号的乱码。原因是URL编码的加号在Content-Disposition头里被某些服务器解析成空格而不同浏览器对RFC 5987标准的支持程度不一致。比较稳的兼容写法是同时设置filename和filename*两个字段String encodedName URLEncoder.encode(fileName, UTF-8).replaceAll(\\, %20); response.setHeader(Content-Disposition, attachment;filename encodedName ;filename*UTF-8 encodedName);filename用百分号编码的ASCII串filename用RFC 5987标准写法现代浏览器优先识别filename老浏览器退回filename。这里replaceAll去掉加号是血泪经验很多乱码问题都出在这个隐形的转义上。5.3 现象登录成功后跳转列表页刷新一下又回到登录页点击登录明明成功了跳转过去也能看到用户名但一刷新就回到登录页session像被清空了一样。排查下来大部分原因是登录成功后用了forward而不是sendRedirect转发后地址栏还停在登录Servlet的URL上刷新时重复执行登录逻辑第二次因为session状态不对抛异常。正确的做法是采用Post/Redirect/Get模式登录成功用sendRedirect跳转到列表页的GET请求。这样浏览器地址栏和页面状态一致刷新时走的是列表页的处理逻辑不会再经过登录Servlet。用户注册成功跳转到登录页也是同样道理转发和重定向用错场景是这类问题最常见的根源。5.4 现象MySQL 8.0下JDBC连接报Public Key Retrieval is not allowed项目在MySQL 5.7环境跑得好好的换到8.0后启动直接抛SQLNonTransientConnectionException。原因是8.0默认用caching_sha2_password认证插件客户端首次连接时需要从服务器获取公钥做非对称加密握手而JDBC驱动默认不自动获取公钥。解决方式是在JDBC连接串加allowPublicKeyRetrievaltrue并配合useSSLfalse。如果不方便改连接串也可以把MySQL用户的认证插件改成mysql_native_password但8.0里这种方式的优先级越来越低改连接串是更面向未来的做法。另外确认驱动jar包版本至少是8.0.13老版本驱动对这个参数的支持并不完整改完参数还报错时优先查驱动版本。5.5 现象静态资源CSS全部失效页面排版乱掉页面功能正常但完全没有样式控制台一堆CSS文件的404F12看网络请求发现样式表返回的是HTML而不是CSS内容。原因是LoginFilter把url-pattern写成了/*却没有放行静态资源目录CSS请求被拦截后统一重定向到了登录页于是响应内容变成了登录页的HTML。解决方式是把css、js、images目录加入白名单判断。写Filter白名单建议用目录前缀判断而不是扩展名判断因为URL重写功能存在时路径里会出现奇怪的伪静态后缀扩展名判断容易漏。如果项目里同时存在多个Filter还要注意放行逻辑要在chain.doFilter之前完成否则拦截器链会继续往下传白名单等于没写。6. 进阶玩法给网盘加MD5文件指纹让重复文件秒传6.1 秒传思路与代码实现网盘系统有一个高频需求同一个文件上传两次能不能不重复存储给UploadServlet加一层指纹判重就能实现。上传时先计算文件的MD5再拿MD5去user_file表查一次如果存在相同指纹的文件直接把当前用户和已有文件的映射关系记录下来不再复制文件实体。String md5 DigestUtils.md5Hex(new FileInputStream(tempFile)); UserFile exists userFileDao.findByMd5(md5); if (exists ! null) { // 秒传只写映射关系不重复存文件 userFileDao.insertMirror(userId, exists.getFileId(), md5); } else { // 正常上传流程md5字段一并入库 userFileDao.insertWithMd5(userId, fileName, storePath, size, md5); }DigestUtils来自commons-codec包项目里用了commons-fileupload时一般已带入这个依赖。实现秒传要求user_file表新增md5字段并建唯一索引。文件字节数是判重的最粗粒度MD5是第二层如果需要更强的防冲突能力可以再加SHA-256做双指纹。对毕设场景MD5单层足够判重失败的最坏结果只是多存一份文件不会造成数据错误。我在自己的练习项目里也踩过类似坑一开始把秒传逻辑放在上传完成之后结果是源文件已经落盘才开始判重磁盘占用一点没省。正确做法是先落临时文件、算指纹、查重确定不重复后再把临时文件移动到正式存储目录。从那以后我每次写文件上传功能都会强制走一遍“临时文件 指纹判重 原子改名”的流程上传请求先写临时文件文件名用UUID避免冲突上传完成后计算MD5查重决定是秒传还是正式落盘正式存储用Files.move方法原子移动避免文件写一半进程重启留下残留这套习惯帮我避开过不止一次“上传一半进程终止但磁盘全是垃圾文件”的局面希望帮到你。本文还有配套的精品资源点击获取