简介这是一份基于JAVA/JSP技术开发的电子书下载系统毕业设计资料面向计算机专业学生、毕业设计选题者及需要快速搭建同类项目的开发者。系统完整覆盖图书信息分类查询、书名与作者检索、用户注册、点券充值、留言板、公告阅览等前台功能后台则包含个人信息管理、会员信息管理、点券充值审核、图书类别管理、电子书信息管理、留言与公告管理等模块前后台功能链路清晰贴近真实业务场景。资源包为rar压缩格式大小约89.36MB内含可运行源码、MySQL5数据库脚本、配套操作视频及毕业论文文档源码经作者亲测可完整运行数据库版本为MySQL5。目前已有187人学习下载适合用于理解JSP项目整体架构、学习增删改查与权限操作设计也可直接部署调试并作为毕业设计代码与论文的参考蓝本能有效节省从零搭建和梳理业务逻辑的时间。1. 基于JAVA_JSP的电子书下载系统毕业设计里最值得复盘的一类Java Web项目电子书下载系统是Java Web课程设计和毕业设计里出现频率最高的题目之一。JSP、Servlet、JDBC、MySQL、文件上传下载、Session权限控制这些Java Web刚入门时绕不开的知识点这个题目全串起来了。但别以为拿到一套带源码、数据库、视频和论文的完整项目包就能直接交差——换台电脑、换个JDK版本就全红报错的项目我见过太多。这套系统看着简单真正落地时环境版本、字符编码、文件路径、数据库连接四个环节都容易翻车。这篇文章就照着真实落地过程走一遍环境怎么搭、代码怎么读、上传下载怎么实现、部署时哪里最容易踩坑最后再给两个能让答辩加分的小功能。新手跟着把系统跑起来并看懂核心模块想做Java工程师的也能从这里挖到面试要考的东西。2. 环境搭不对源码再好也白扯JDK/Tomcat/MySQL版本搭配与项目骨架拆解拿到任何一套JSP源码第一步一定是做环境匹配而不是直接把项目丢进IDE。JSP项目对环境敏感JDK、Tomcat、MySQL的版本组合只要有一个不兼容轻则编译报错重则部署后白屏。这一章按我自己的套路来先讲怎么判断代码需要什么环境再拆解源码包里的四类资源各自是什么角色最后把数据库表结构过一遍。2.1 JDK、Tomcat、MySQL版本怎么选先看代码再定环境我一般建议先看代码再装环境。第一件事是打开项目里的Java类看一眼import语句里是javax.servlet还是jakarta.servlet。这一步非常关键Tomcat 10.0以后把Servlet API从javax包迁移到了jakarta包如果代码里全是javax.servlet开头那就老老实实用Tomcat 9及以下版本要是代码里已经用jakarta.servlet了那Tomcat 8或9反而编译不过。判断清楚以后剩下就是一套黄金组合JDK 1.8加Tomcat 8.5或9.0再加MySQL 5.7或8.0。这套组合兼容性最好网上能搜到的解决方案最多比起追新版本踩进兼容性泥潭稳定永远排在第一位。环境变量配置也值得多说一句。三件套里JAVA_HOME是必须配的Tomcat的启动脚本会用它找Java运行环境Path里加上JAVA_HOME\bin是为了命令行能直接敲java命令CATALINA_HOME是可选的只有你想在任意目录下用catalina.bat管理Tomcat时才需要配。很多新手把三个变量全部配好却发现Tomcat起不来往往是JAVA_HOME指向了JRE而不是JDK或者JDK和JRE的路径混用了。命令行验证是最简单直接的方式# 检查JDK版本 java -version # Windows下设置当前会话环境变量临时生效 set JAVA_HOMEC:\Program Files\Java\jdk1.8.0_202 set CATALINA_HOMEC:\apache-tomcat-9.0.98 set Path%JAVA_HOME%\bin;%CATALINA_HOME%\bin;%Path% # Linux下临时设置也可写进/etc/profile持久化 export JAVA_HOME/usr/lib/jvm/java-8-openjdk-amd64 export CATALINA_HOME/opt/apache-tomcat-9.0.98 export PATH$JAVA_HOME/bin:$CATALINA_HOME/bin:$PATH这里注意一点set和export都只对当前终端会话生效真正部署到服务器时Windows要写进系统环境变量Linux要写进/etc/profile或用户目录下的.bashrc否则重新开一个终端窗口Java命令又找不到了。另一点Tomcat 8.5以后对JDK版本没有那么挑剔但JDK 1.8跑Tomcat 9是最稳的组合JDK 11跑Tomcat 9也没问题JDK 17再跑Tomcat 9就会出现反射访问警告。所以保险起见JDK 1.8是首选这套JSP项目本来就是为老环境写的别拿新版本去折腾它。2.2 源码包里的四块资产src、WebRoot、SQL脚本和论文各自有什么用题目里说的源码、数据库、视频、论文四件套拆开看各有各的用途。src目录是Java源码一般按包划分entity或model放实体类dao放数据库访问类servlet或controller放控制层filter放过滤器。WebRoot或WebContent是Web应用根目录JSP页面、CSS、JS、图片和WEB-INF/web.xml都放这里。这里有个容易让人困惑的点JSP文件虽然在浏览器地址栏里能直接访问但Tomcat会把每个JSP编译成一个Java类再运行所以JSP依然属于逻辑视图层真正的前端静态资源是CSS和JS。数据库资产是一个或多个.sql文件。执行前先打开看一眼内容确认里面有没有CREATE DATABASE语句如果有执行时就要小心这条语句会把同名的旧库直接覆盖掉。建议先手动创建一个专用数据库再执行.sql里的建表语句。Word格式的论文是文档资产重点看需求分析、ER图、数据字典、系统测试几个章节这些内容答辩时会被反复追问。视频一般是最初作者录制的演示过程对跑通系统最有价值它告诉你原作者的Tomcat部署路径、初始管理员账号和操作顺序照着做能少走很多弯路。2.3 建库建表先看懂三张核心表再动手执行SQL执行SQL前先改一个细节数据库字符集统一用utf8mb4别用utf8。utf8在MySQL里最多存3字节的字符emoji和个别生僻字存不进去utf8mb4是完整版的UTF-8。这套系统最核心的三张表是用户表、图书表、下载记录表字段设计大同小异但有几个字段值得特别留意。-- 创建数据库字符集统一utf8mb4 CREATE DATABASE IF NOT EXISTS ebook_db DEFAULT CHARACTER SET utf8mb4; USE ebook_db; -- 用户表role字段区分普通用户和管理员 CREATE TABLE user ( id INT NOT NULL AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE COMMENT 登录名, password VARCHAR(64) NOT NULL COMMENT 存储加盐MD5值原开源源码可能是明文, salt VARCHAR(8) DEFAULT NULL COMMENT 每个用户独立的盐值, email VARCHAR(100) DEFAULT NULL, role TINYINT DEFAULT 0 COMMENT 0普通用户 1管理员, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 图书表file_path存相对路径不存大文件本体 CREATE TABLE book ( id INT NOT NULL AUTO_INCREMENT, title VARCHAR(200) NOT NULL, author VARCHAR(100) DEFAULT NULL, category VARCHAR(50) DEFAULT NULL, file_path VARCHAR(255) NOT NULL COMMENT 相对路径如ebook_files/1650000000_xxx.pdf, download_count INT DEFAULT 0, upload_time DATETIME DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 下载记录表每次下载落一条记录 CREATE TABLE download_record ( id INT NOT NULL AUTO_INCREMENT, user_id INT NOT NULL, book_id INT NOT NULL, download_time DATETIME DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), KEY idx_user_id (user_id), KEY idx_book_id (book_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;先解释几个设计决策。user表里单独放一列salt说明这套源码考虑过加盐如果原表没有这一列就得在改密码存储时一并加上详情看下一章的3.4节。book表里的file_path是关键它只存相对路径不存文件内容这样数据库文件体积不会随图书数量增长变得难以管理导出导入也更快。真正的电子书文件统一放在应用目录外的某个磁盘目录下比如D:/ebook_files。download_record表是下载次数的统计基础后台统计和图书排行榜都靠它连接book表查出来。三张表之间是典型的1对多关系一个用户可以下载多本书所以download_record同时引用user_id和book_id作为逻辑外键。不过课程设计级别的代码一般不建物理外键约束因为需要手动删数据时物理外键会带来麻烦逻辑外键已经够用。执行完建表语句后记得插入一条管理员账号初始用户名和密码在论文里一般有说明没有说明就从源码里的初始化SQL或README里找找不到就自己写一条INSERT进去然后在登录时用这条记录验证整个链路。3. 注册登录和权限控制把Session、Filter和密码加密一次讲透用户模块是这套系统里代码量最大的部分也是Java面试基础题里最常被问到的部分。这套JSP项目的技术栈非常经典JSP页面负责展示Servlet负责接收请求和跳转DAO负责数据库增删改查。别嫌它老这套模式吃透了以后切到Spring MVC时思路完全能平移Servlet对应ControllerDAO对应MapperJSP对应View。这一章按注册、登录、拦截、加密四个层次往下讲。3.1 注册功能的双重校验前端管体验后端管安全注册是这套系统入门的第一段代码。先看清楚register.jsp前端的校验逻辑用户名长度、密码一致性、邮箱格式这些是用JavaScript在浏览器里做的只影响用户体验。但前端校验可以被绕过所以后端Servlet里必须有完整的二次校验。这是Java Web一个很基础也很重要的安全意识。protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { // 请求编码统一UTF-8解决中文参数乱码 request.setCharacterEncoding(UTF-8); String username request.getParameter(username); String password request.getParameter(password); // 后端基础校验空值和长度 if (username null || username.trim().isEmpty() || username.length() 3) { request.setAttribute(error, 用户名至少3个字符); request.getRequestDispatcher(register.jsp).forward(request, response); return; } if (password null || password.length() 6) { request.setAttribute(error, 密码至少6位); request.getRequestDispatcher(register.jsp).forward(request, response); return; } // 检查重复用户名存在则回注册页并提示 UserDao dao new UserDao(); if (dao.isUsernameExists(username.trim())) { request.setAttribute(error, 用户名已存在); request.getRequestDispatcher(register.jsp).forward(request, response); return; } // 加盐MD5后入库如果原代码是明文看3.4节改成这里 String salt MD5Util.generateSalt(); String hashedPwd MD5Util.md5WithSalt(password, salt); User user new User(username.trim(), hashedPwd, salt); dao.insert(user); response.sendRedirect(login.jsp?registered1); }这段代码里有三个值得停下来讲透的细节。第一个是转发和重定向的区别request.getRequestDispatcher(...).forward()是转发浏览器地址栏不变request里带的attribute可以在JSP页面取到所以错误信息能显示出来response.sendRedirect()是重定向浏览器地址栏变化request里的attribute全部丢失所以注册成功只需要跳转到登录页。第二个是数据库操作全部封装在UserDao里Servlet层不出现SQL语句这是这套MVC分层的基本功。第三个是getParameter得到的是字符串长度校验要针对trim()后的值做否则用户输入前后空格时会绕过长校验。3.2 登录与Session过期为什么密码不能写进Cookie登录逻辑比注册多一个场景登录成功后需要维持状态。常用做法是登录成功后把User对象放进SessionJSP页面通过Session里的数据判断当前是否登录、是哪个用户、有没有管理权限。Session存在服务器端客户端手里的只是一个JSESSIONID别人拿到这个ID确实能冒充会话但它毕竟不是明文密码。有些版本的源码会把用户名和密码放在Cookie里方便记住登录状态这是一种典型的错误示范。Cookie存在浏览器本地用户可以随手修改把role改成1就能伪装成管理员。哪怕只存用户名也不行因为Cookie值被篡改后服务端如果用Cookie里的用户名去查询权限一样会被绕过。正确做法Session里存User对象需要“记住我”功能时生成一个不可预测的Token把Token和用户ID的对应关系存数据库而不是存原始账号密码。这套课程设计没有“记住我”功能所以直接用Session就够。protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { request.setCharacterEncoding(UTF-8); String username request.getParameter(username); String password request.getParameter(password); UserDao dao new UserDao(); User user dao.findByUsername(username.trim()); if (user null) { request.setAttribute(error, 用户不存在); request.getRequestDispatcher(login.jsp).forward(request, response); return; } // 加盐MD5校验原代码可能是明文对比务必改成这里 String inputHash MD5Util.md5WithSalt(password, user.getSalt()); if (!inputHash.equals(user.getPassword())) { request.setAttribute(error, 密码错误); request.getRequestDispatcher(login.jsp).forward(request, response); return; } // 登录成功User对象放进Session而不是Cookie HttpSession session request.getSession(); session.setAttribute(currentUser, user); session.setMaxInactiveInterval(30 * 60); // 管理员和普通用户去不同首页 if (user.getRole() 1) { response.sendRedirect(admin/index.jsp); } else { response.sendRedirect(index.jsp); } }两个细节值得记一下。session.setMaxInactiveInterval(30 * 60)表示30分钟无操作后Session失效这是个安全参数会话过期后用户必须重新登录。管理员和普通用户跳转不同首页用role字段判断这个字段在第2章的user表里已经定义好了。退出登录的Servlet一般也很简单session.invalidate()把整个Session销毁而不是只移除某个attribute这样能防止用户按浏览器后退键重新看到登录前的页面。3.3 用Filter最小拦截放过登录页挡住其余全部光有登录还不够还得防止用户绕过登录直接访问受保护页面。Filter就是干这个的它在请求到达Servlet之前先过一遍。配置方式是web.xml里写filter和filter-mapping或者用注解WebFilter。我习惯用web.xml的方式因为换环境部署时方便排查。public class LoginFilter implements Filter { public void init(FilterConfig config) throws ServletException { // 初始化钩子当前场景无资源需要加载 } public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) throws IOException, ServletException { HttpServletRequest request (HttpServletRequest) req; HttpServletResponse response (HttpServletResponse) resp; String uri request.getRequestURI(); // 白名单放行登录页、注册页、登录注册的Servlet、静态资源 if (uri.endsWith(login.jsp) || uri.endsWith(register.jsp) || uri.endsWith(loginServlet) || uri.endsWith(registerServlet) || uri.contains(/css/) || uri.contains(/js/) || uri.contains(/images/)) { chain.doFilter(request, response); return; } // 其余请求必须已登录 HttpSession session request.getSession(false); if (session null || session.getAttribute(currentUser) null) { response.sendRedirect(request.getContextPath() /login.jsp); return; } chain.doFilter(request, response); } public void destroy() { } }这段代码最重要的细节是request.getSession(false)。如果直接调request.getSession()没有会话时会自动创建一个新Session结果是每一个没登录的请求也会在Tomcat里建一个HttpSession白白占用服务器内存用户量一大Session堆积起来Tomcat会变得迟钝甚至内存不足。传false表示“没有就返回null”这样未登录用户只做一次重定向不消耗服务器资源。白名单方式比黑名单方式更适合这个项目以后新增页面时默认状态是被Filter保护只有显式放进白名单才开放比手动去Filter里逐个拦截受保护页面更不容易漏。web.xml里对应的配置如下filter filter-nameloginFilter/filter-name filter-classcom.ebook.filter.LoginFilter/filter-class /filter filter-mapping filter-nameloginFilter/filter-name url-pattern/*/url-pattern /filter-mappingurl-pattern配成/*表示所有请求都先进这个Filter再决定是否放行。如果代码里已经有WebFilter注解再用web.xml配置会导致Filter被注册两次每个请求被拦截两次重定向逻辑会变得难以排查注意检查项目里有没有重复注册。3.4 密码存储升级明文改加盐MD5一篇代码说透这类开源老项目一个常见隐患是数据库里密码存明文。第2章的建表SQL里我加了salt字段这节把它说透。加盐MD5并不是最先进的密码存储方案现代方案是BCrypt或PBKDF2但对于课程设计和入门级Java项目加盐MD5已经比明文强了几个等级代码量小、逻辑好讲答辩时也不会被问垮。import java.security.MessageDigest; import java.util.Random; public class MD5Util { // 生成8位随机盐注册时调用 public static String generateSalt() { String chars abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789; StringBuilder sb new StringBuilder(); Random random new Random(); for (int i 0; i 8; i) { sb.append(chars.charAt(random.nextInt(chars.length()))); } return sb.toString(); } // 密码盐拼一起做MD5注册和登录必须调用同一个方法 public static String md5WithSalt(String password, String salt) { String input password salt; try { MessageDigest md MessageDigest.getInstance(MD5); byte[] digest md.digest(input.getBytes(UTF-8)); StringBuilder hex new StringBuilder(); for (byte b : digest) { hex.append(String.format(%02x, b)); } return hex.toString(); } catch (Exception e) { throw new RuntimeException(MD5加密失败, e); } } }改动时注意三个点。第一注册时生成盐、加密、把盐存进user表的salt字段第二登录时先按用户名查user拿到该用户自己的盐再对输入密码做同样的md5WithSalt计算最后对比结果第三如果原库里已经有明文密码的存量用户需要写一个一次性的迁移SQL把每条记录的salt补上、password更新为加盐后的值。迁移脚本在本地测好再执行别直接在跑着正式数据的库上改这是血泪经验。提示迁移前先备份数据库。加盐加密的迁移SQL需要在同一个事务里完成salt更新和password更新否则中间出错会让旧密码全部无法校验。4. 电子书上传下载文件流、中文文件名和下载统计的完整实现用户模块解决的是身份问题电子书上传下载才是这套系统的核心业务。这一章把文件上传、文件下载、下载统计三个功能的实现细节拆开重点说清楚参数怎么设、坑在哪里、为什么这样写。4.1 图书上传Servlet 3.0的MultipartConfig参数与文件保存图书上传是老式JSP项目里比较“现代”的部分。Servlet 3.0以后文件上传不用再依赖第三方组件早期常用做法是Commons-fileupload直接在Servlet上标注MultipartConfig就能用request.getPart拿到上传的文件。注意两个体系的代码风格差异Commons-fileupload方案的代码量更大要手动解析FileItem而Servlet 3.0简洁很多。如果源码用的是Servlet 3.0那Tomcat版本必须7.0以上不过前面环境组合已经满足这个要求。MultipartConfig( maxFileSize 1024 * 1024 * 50, // 单个文件最大50MB maxRequestSize 1024 * 1024 * 100, // 整个请求最大100MB fileSizeThreshold 1024 * 1024 // 文件超过1MB后写入临时文件 ) public class BookUploadServlet extends HttpServlet { protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { request.setCharacterEncoding(UTF-8); // 表单参数不是文件 String title request.getParameter(title); String author request.getParameter(author); String category request.getParameter(category); // 取出文件部分 Part part request.getPart(file); String originalFileName getFileName(part); // 保存到服务器目录用时间戳前缀避免同名文件覆盖 String uploadDir D:/ebook_files/; File dir new File(uploadDir); if (!dir.exists()) { dir.mkdirs(); } String storedName System.currentTimeMillis() _ originalFileName; part.write(uploadDir storedName); // 数据库只存相对路径 Book book new Book(title, author, category, ebook_files/ storedName); new BookDao().insert(book); response.sendRedirect(admin/books.jsp); } // 从Part的Content-Disposition头里解析原始文件名 private String getFileName(Part part) { String header part.getHeader(content-disposition); for (String token : header.split(;)) { if (token.trim().startsWith(filename)) { return token.substring(token.indexOf() 1).trim().replace(\, ); } } return unknown.pdf; } }三个参数分别控制什么要能说清楚。maxFileSize是单文件上限超过会报异常maxRequestSize是整个请求的上限包含表单其他字段fileSizeThreshold是内存与磁盘的切换阈值文件小于这个值先放内存超过就写临时文件这是防止大文件占满堆内存的关键开关。课程设计场景50MB足够调到200MB以上反而会让Tomcat在高并发时更容易被拖垮。文件保存路径这里有个设计上的正反两面。例子里的D:/ebook_files是个绝对路径好处是文件和应用分离重新部署应用时文件不会被清掉坏处是换一台机器就必须改代码。更通用的做法是把路径做成可配置项例如web.xml里配一个init-parameter或者放在properties配置文件里Servlet启动时读取。对这个项目来说把路径写在代码里能少一个配置文件、更快跑通但部署的时候记得全局搜索替换一次。哪个更好取决于你更在意“快速跑通”还是“可迁移”两个选择都有道理但一定要知道自己在做什么选择。4.2 下载响应头Content-Disposition中文名的处理与流式传输下载功能的实现比较标准从数据库查出记录从磁盘读文件用输出流写给浏览器。代码看着不长但三个细节处理不好就会翻车一是中文文件名乱码二是响应头设置错误导致浏览器直接打开文件而不是下载三是读文件时一次性读进内存导致内存溢出。protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { String id request.getParameter(id); if (id null) { response.sendError(400, 缺少图书ID); return; } BookDao dao new BookDao(); Book book dao.findById(Integer.parseInt(id)); if (book null) { response.sendError(404, 图书不存在); return; } File file new File(D:/ebook_files/ book.getFilePath()); if (!file.exists()) { response.sendError(404, 文件不存在可能已被移动); return; } // 强制下载不是浏览器内打开 response.setContentType(application/octet-stream); String fileName book.getTitle() .pdf; fileName URLEncoder.encode(fileName, UTF-8).replace(, %20); response.setHeader(Content-Disposition, attachment; filename fileName); // 流式传输杜绝一次性读入内存 try (InputStream in new FileInputStream(file); OutputStream out response.getOutputStream()) { byte[] buffer new byte[4096]; int len; while ((len in.read(buffer)) ! -1) { out.write(buffer, 0, len); } out.flush(); } // 下载成功后再更新计数和记录 dao.incrementDownloadCount(book.getId()); }Content-Disposition是下载功能的核心响应头。值为attachment; filenamexxx.pdf时浏览器会弹出下载如果漏掉attachmentPDF这类文件会被浏览器内置插件直接打开而不是下载到本地。中文文件名必须经过URLEncoder.encode否则浏览器收到的响应头里中文会乱码或者直接被截断后面的replace是处理URLEncoder把空格变成加号的问题加号在URL里会被解码成空格而文件名里的空格应该编码成%20。流式传输是防止大文件内存溢出的关键。byte[4096]循环读写每次只在内存里占用4KB即使下载几个GB的文件堆内存也只消耗4KB。try-with-resources语法保证输入输出流一定被关闭避免文件句柄泄漏。有些老代码会把文件读成byte[]再一次性write出去小文件看不出问题遇到大PDF就会把内存打穿这是下载接口最常见的性能隐患。4.3 下载记录与次数统计数据入库的两个时机下载功能里还有一个容易被忽略的业务逻辑什么时候更新download_count什么时候写download_record。这两个操作都要放在文件流传输成功之后不能放在传输之前。原因很简单如果文件不存在或者传输中出错用户实际没有下载成功数据已经写了统计就会失真。代码里dao.incrementDownloadCount(book.getId())和insertDownloadRecord(userId, bookId)两个方法都封装在BookDao里。DAO层的写法一般是这样// 下载次数1 public void incrementDownloadCount(int bookId) { String sql UPDATE book SET download_count download_count 1 WHERE id ?; try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql)) { ps.setInt(1, bookId); ps.executeUpdate(); } catch (SQLException e) { throw new RuntimeException(e); } } // 插入下载记录 public void insertDownloadRecord(int userId, int bookId) { String sql INSERT INTO download_record (user_id, book_id) VALUES (?, ?); try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql)) { ps.setInt(1, userId); ps.setInt(2, bookId); ps.executeUpdate(); } catch (SQLException e) { throw new RuntimeException(e); } }注意SQL里用PreparedStatement而不是拼字符串。这既是防SQL注入的标准写法也是Java面试里数据库增删改查的必考点PreparedStatement有预编译机制参数用?占位传进去的值不会被当作SQL语句执行。这套系统的所有DAO方法都应该遵循这个模式如果发现原代码里有Statement拼字符串的写法建议改成PreparedStatement答辩时也能多讲一个安全点。5. 避坑指南部署这套JSP系统最常碰到的5个坑从环境搭建到功能跑通这套系统至少有5个高频翻车点每一个我都见过不止一次。按现象、原因、解决三步写方便对号入座。5.1 中文乱码三层编码必须对齐现象JSP页面打开后中文全是问号或者在页面上输入中文提交后Servlet拿到的参数是乱码。原因编码不一致的环节至少有四个——JSP文件保存时的编码、pageEncoding声明、HTTP请求编码、数据库连接的字符集。只改其中一两个问题不会消失。解决JSP第一行确认是% page contentTypetext/html; charsetUTF-8 pageEncodingUTF-8%Servlet的doPost开头加request.setCharacterEncoding(UTF-8)且必须在getParameter之前执行数据库连接URL带characterEncodingUTF-8参数如果数据库已经建好且编码不对可以用ALTER TABLE ... CONVERT TO CHARACTER SET utf8mb4转一下但注意这只能处理存量数据新建表的默认字符集还是要靠建表语句控制。第一步做完了才能往下走乱码问题的排查顺序就是请求到响应的全链路请求参数、Servlet处理、JSP渲染、数据库存取每一环都必须统一在UTF-8上。5.2 下载404文件保存路径和虚拟目录的坑现象点击下载按钮浏览器地址栏URL正确但返回404Tomcat日志里没有对应的Servlet报错记录。原因两种典型情况。一是下载Servlet里用了new File(相对路径)而相对路径是相对于Tomcat的启动目录不是相对于应用目录二是原项目中把文件目录映射成了虚拟目录比如server.xml里配了一个Context指向D:/ebook_files但换机器后没有重新配。解决下载Servlet里不要用相对路径用绝对路径或者基于应用根目录拼路径。代码里可以这样取应用根目录this.getServletContext().getRealPath(/)得到的路径是Tomcat部署目录下的应用文件夹再往里拼相对路径。如果原代码写的是绝对路径部署时全局搜索替换成新机器上的路径即可。5.3 MySQL连接失败驱动版本和serverTimezone缺一不可现象Tomcat一启动访问任何需要连数据库的页面都报Communications link failure堆栈里能看到ClassNotFoundException或SQLNonTransientConnectionException。原因最常见是mysql-connector-java的jar包版本和MySQL版本对不上。MySQL 5.7配5.1.x驱动没问题但MySQL 8.0用5.1.x驱动一定会报连接失败因为8.0默认的认证插件是caching_sha2_password5.1.x驱动不支持。这个坑排查起来有点玄学因为错误堆栈里经常同时出现时区和驱动两个关键词容易让人摸不着头脑。另外MySQL 8.0要求连接URL里带serverTimezone参数否则驱动会因无法识别时区而报错。解决先查MySQL版本和驱动jar版本让两者匹配。MySQL 8.0的驱动用8.0.x的jar连接URL用 jdbc:mysql://localhost:3306/ebook_db?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingUTF-8 MySQL 5.7则用 jdbc:mysql://localhost:3306/ebook_db?useUnicodetruecharacterEncodingUTF-8 驱动jar放在WEB-INF/lib下如果lib里有多个版本的mysql jar全部删掉只留一个多个驱动jar并存也是常见的怪问题来源。5.4 上传大文件内存溢出阈值参数是后悔药现象上传一个50MB的PDFTomcat直接报OutOfMemoryError服务整个挂掉其他用户也访问不了。原因Servlet 3.0上传时如果MultipartConfig没配fileSizeThreshold或者配得过大文件数据会全部缓存在内存中。Tomcat默认堆内存一般是256MB或512MB几个大文件并发上传堆内存瞬间被打满。解决MultipartConfig里显式设置fileSizeThreshold1024*1024超过1MB的文件自动落临时文件同时maxFileSize和maxRequestSize都设置上限给服务留出余量。另外在Tomcat的catalina.bat或catalina.sh里设置CATALINA_OPTS把堆内存调大但调大只是兜底真正的解法还是阈值参数。5.5 换台电脑就白屏绝对路径是根源现象在本机跑得好好的把整个项目文件夹拷到另一台电脑打开后页面白屏、图片和CSS全部加载不出来下载也失败。原因源码里把静态资源路径、文件下载路径、上传目录写成了本机的绝对路径比如/img/xxx.jpg或D:/ebook_files。换机器后路径变了所有依赖路径的功能一起失效。这种项目我见过太多拷之前好好的拷完就翻车。解决全项目搜索D:/、/img、/upload这类硬编码路径把静态资源路径改成${pageContext.request.contextPath}/img/xxx.jpgEL表达式会自动带上应用的上下文路径上传下载目录统一抽成一个配置项或常量类部署时只改一处。这个动作虽然琐碎但也是面试时能讲的代码可维护性加分点。6. 进阶玩法给项目加日志、测并发、理顺答辩演示功能跑通之后这套系统还有三个增值点一个给管理员看的下载日志页、一次能写进论文的并发测试、一套有节奏的答辩演示顺序。每个改动本身都不复杂但都能让答辩和面试时多讲几句实在内容性价比很高。6.1 后台下载日志页一次多表连接查询的练手管理员后台通常只有图书管理缺一个业务闭环用户下载了哪些书、什么时候下的看不见。加一个admin/log.jsp页面的成本很低写一个DownloadRecordDaoSQL是download_record连接user再连接book三表查询只取最近50条记录JSP表格展示。这个功能牵涉多表连接、后台权限、页面展示三个知识点答辩时从上往下讲每个点都能接住追问。6.2 用JMeter压一下下载接口给论文留一张真图论文测试部分最怕写空话。装一个JMeter建一个线程组模拟20到30个用户同时请求下载接口把聚合报告截图放进论文的性能测试小节比“系统性能良好”有说服力得多。注意先把Tomcat的Connector线程数调大默认配置下并发一高就会出现连接拒绝调参过程本身就是素材。6.3 答辩演示顺序先数据库、再普通用户、最后切管理员演示顺序决定了评委能不能快速理解你的系统。我自己的固定套路先打开数据库展示表结构和初始数据让评委知道数据从哪来然后以普通用户身份走一遍注册、登录、浏览、下载的完整链路接着切管理员演示图书上传和下载日志最后用JMeter报告收尾。把演示步骤写在提示纸上放旁边千万别在台上翻代码找按钮。这个习惯是我当年第一次答辩当场忘管理员账号之后养成的从那以后再也不靠记忆演示。这套系统的技术栈看着老但知识点密度相当高MVC分层、Session和Filter的权限控制机制、文件流的处理、PreparedStatement的参数化查询都是Java面试基础里反复出现的考点。能把它从环境搭建一路做到功能完善收获比泛读框架要扎实得多。希望帮到你。本文还有配套的精品资源点击获取