Java+JSP+MySQL学生作品展示系统实战：环境搭建、核心功能与避坑指南

简介这份资源是面向高校计算机相关专业学生与Java Web初学者的毕业设计完整项目包主题为基于JavaJSPMySQL的学生作品展示系统可用于课程设计、毕设参考或Web开发入门练手。压缩包共825个文件约11.47MB以gif、js、html、jpg、jsp、png等前端与页面资源为主另含class、jar、xml、css、java等后端与配置类文件以及少量数据库脚本与说明文档基本覆盖表现层、业务逻辑层与数据访问层的完整结构。系统实现用户注册登录与权限管理、作品上传、分类展示与搜索、评分评论及管理员审核删除等功能采用JSPJavaBean/ServletJDBC三层架构源码层次清晰便于读者理解Java、JSP与MySQL如何协同完成一个典型Web应用。目前已有211人学习下载适合需要完整赛题方案、可运行源码与项目结构参考的读者对照研读与二次开发。1. 从一份 .rar 说起JavaJSPMySQL 学生作品展示系统到底在做什么很多计算机专业的同学在选题阶段都会卡在同一个地方想做一个「能演示、能答辩、能写进论文」的系统又不想把时间全耗在环境配置和框架学习上。这时候基于 JavaJSPMySQL 的学生作品展示系统就成了一个很务实的选择。它的核心逻辑并不复杂——用 JSP 做页面渲染用 Servlet 或简单 JavaBean 处理业务逻辑用 MySQL 存学生信息、作品信息和分类数据最终跑在 Tomcat 上形成一个可以浏览、上传、管理作品的后台系统。这类系统之所以在毕业设计里经久不衰是因为它把 Java Web 的基础链路完整走了一遍请求、会话、数据库连接、页面跳转、表单提交一个都不少。你把它跑通等于把 Java Web 的骨架摸了一遍。适合谁适合刚学完 Java 基础、想找一个完整项目练手的人也适合需要快速搭出一个可演示系统的毕设选手。但要注意JSP 不是「过时技术」的代名词它在教学和中小型内部系统里依然有明确的定位关键是你要知道它的边界在哪。2. 环境选型与项目骨架为什么 Tomcat 9 JDK 8 仍是稳妥组合2.1 JDK、Tomcat、MySQL 的版本匹配逻辑在动手之前先把版本关系理清楚。JSP 本质是 Servlet 的模板层Servlet 规范由 Tomcat 实现而 Tomcat 版本又和 JDK 版本有绑定关系。常见做法是JDK 8 配 Tomcat 8.5 或 9.0JDK 11 配 Tomcat 9.0 以上。MySQL 用 5.7 或 8.0 都可以但 8.0 的驱动类名和连接串参数有变化下面会细说。为什么不用最新的 JDK 17因为很多老教程和现成代码里用的还是javax.servlet包而 Tomcat 10 之后改成了jakarta.servlet直接跑会报 ClassNotFound。这不是玄学是包名迁移的硬性变化。所以如果你拿到的源码是传统 JSP 项目优先选 Tomcat 9能省掉大量改包名的时间。安装顺序建议先装 JDK配好JAVA_HOME再装 MySQL设好 root 密码最后解压 Tomcat改一下conf/server.xml里的端口避免和已占用端口冲突。验证 JDK 用java -version验证 Tomcat 用启动后访问localhost:8080验证 MySQL 用mysql -u root -p能进命令行。2.2 用 IDEA 新建 JSP 项目的完整步骤很多人卡在「idea 新建 jsp 项目」这一步因为 IDEA 不同版本里 Web 项目的入口位置不一样。下面按常见做法走一遍。# 第一步确认 JDK 和 Tomcat 已安装 java -version # 输出应为 1.8.x 或 11.x # 第二步在 IDEA 中新建项目 # File - New - Project - Java Enterprise # 勾选 Web Application选择 JDK 8 # 不要勾选任何额外框架Spring 等保持纯净项目建好后目录结构大致是src/ main/ java/ # 放 Servlet、DAO、实体类 webapp/ # 放 JSP、CSS、JS、WEB-INF WEB-INF/ web.xml # 部署描述符 lib/ # 放 mysql-connector-java.jar关键动作把 MySQL 驱动 jar 包复制到WEB-INF/lib下或者在 IDEA 的 Project Structure 里加到 Libraries。少了这一步后面一定报No suitable driver found。!-- web.xml 里配置欢迎页和 Servlet 映射 -- welcome-file-list welcome-filelogin.jsp/welcome-file /welcome-file-list servlet servlet-nameLoginServlet/servlet-name servlet-classcom.demo.servlet.LoginServlet/servlet-class /servlet servlet-mapping servlet-nameLoginServlet/servlet-name url-pattern/login/url-pattern /servlet-mapping这段配置的作用是访问根路径时默认打开login.jsp表单提交到/login时由LoginServlet处理。参数说明url-pattern要和 JSP 里form actionlogin保持一致大小写敏感。2.3 数据库建表与连接池的最小配置学生作品展示系统通常需要三张核心表学生表、作品表、分类表。建表语句如下CREATE DATABASE student_works DEFAULT CHARACTER SET utf8mb4; USE student_works; CREATE TABLE student ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(100) NOT NULL, real_name VARCHAR(50), class_name VARCHAR(50) ); CREATE TABLE category ( id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(50) NOT NULL ); CREATE TABLE work ( id INT PRIMARY KEY AUTO_INCREMENT, title VARCHAR(100) NOT NULL, description TEXT, file_path VARCHAR(255), student_id INT, category_id INT, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, FOREIGN KEY (student_id) REFERENCES student(id), FOREIGN KEY (category_id) REFERENCES category(id) );字符集用utf8mb4是为了支持中文和特殊符号避免插入作品描述时出现乱码。外键约束保证作品必须属于某个学生和某个分类删除学生时如果有作品会报错这是有意为之的数据完整性保护。连接数据库的代码新手常用DriverManager直接连但每次请求都新建连接开销大。常见做法是用一个简单的连接池比如 Druid 或 C3P0但为了减少依赖也可以先写一个工具类public class DBUtil { private static final String URL jdbc:mysql://localhost:3306/student_works?useSSLfalseserverTimezoneUTCcharacterEncodingutf8; private static final String USER root; private static final String PASSWORD 你的密码; static { try { Class.forName(com.mysql.cj.jdbc.Driver); } catch (ClassNotFoundException e) { e.printStackTrace(); } } public static Connection getConnection() throws SQLException { return DriverManager.getConnection(URL, USER, PASSWORD); } }注意连接串里的useSSLfalse和serverTimezoneUTC这是 MySQL 8.0 驱动必须带的参数少了会报时区错误或 SSL 警告。驱动类名com.mysql.cj.jdbc.Driver是 8.0 版本的写法5.7 用com.mysql.jdbc.Driver。如果你从网上下的源码跑不起来先检查这两个地方。3. 核心功能落地登录、作品上传与列表展示的代码实现3.1 登录鉴权Session 与过滤器的最小闭环登录功能是系统的入口也是理解 JSP 会话机制的起点。流程是用户提交表单 → Servlet 查数据库 → 匹配成功则把用户信息存入 Session → 跳转到主页。下面是一个精简的 LoginServletWebServlet(/login) public class LoginServlet extends HttpServlet { protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { String username request.getParameter(username); String password request.getParameter(password); try (Connection conn DBUtil.getConnection()) { String sql SELECT * FROM student WHERE username ? AND password ?; PreparedStatement ps conn.prepareStatement(sql); ps.setString(1, username); ps.setString(2, password); ResultSet rs ps.executeQuery(); if (rs.next()) { HttpSession session request.getSession(); session.setAttribute(studentId, rs.getInt(id)); session.setAttribute(realName, rs.getString(real_name)); response.sendRedirect(work_list.jsp); } else { request.setAttribute(msg, 用户名或密码错误); request.getRequestDispatcher(login.jsp).forward(request, response); } } catch (SQLException e) { throw new ServletException(e); } } }逻辑说明用PreparedStatement而不是字符串拼接是为了防 SQL 注入。sendRedirect和forward的区别要清楚——前者是客户端跳转地址栏会变后者是服务器内部转发地址栏不变。登录失败时用 forward 把错误信息带回原页面。参数说明session.setAttribute存的是用户标识后续页面通过session.getAttribute(studentId)判断是否登录。为了防止未登录直接访问作品列表加一个过滤器WebFilter(/work_*.jsp) public class AuthFilter implements Filter { public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain) throws IOException, ServletException { HttpServletRequest request (HttpServletRequest) req; HttpServletResponse response (HttpServletResponse) res; HttpSession session request.getSession(false); if (session null || session.getAttribute(studentId) null) { response.sendRedirect(login.jsp); } else { chain.doFilter(req, res); } } }这个过滤器拦截所有work_开头的 JSP没登录就踢回登录页。注意getSession(false)表示不自动创建新会话避免给未登录用户也发 Session。3.2 作品上传文件流处理与路径存储的四个参数作品上传涉及两个部分文件本身存到磁盘文件路径存到数据库。JSP 页面用form enctypemultipart/form-dataServlet 端用Part接口读取。WebServlet(/upload) MultipartConfig(maxFileSize 1024 * 1024 * 10) // 限制 10MB public class UploadServlet extends HttpServlet { protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { request.setCharacterEncoding(UTF-8); String title request.getParameter(title); String description request.getParameter(description); int categoryId Integer.parseInt(request.getParameter(categoryId)); int studentId (int) request.getSession().getAttribute(studentId); Part filePart request.getPart(file); String fileName System.currentTimeMillis() _ filePart.getSubmittedFileName(); String savePath getServletContext().getRealPath(/uploads); File uploadDir new File(savePath); if (!uploadDir.exists()) uploadDir.mkdirs(); filePart.write(savePath File.separator fileName); try (Connection conn DBUtil.getConnection()) { String sql INSERT INTO work (title, description, file_path, student_id, category_id) VALUES (?, ?, ?, ?, ?); PreparedStatement ps conn.prepareStatement(sql); ps.setString(1, title); ps.setString(2, description); ps.setString(3, uploads/ fileName); ps.setInt(4, studentId); ps.setInt(5, categoryId); ps.executeUpdate(); } catch (SQLException e) { throw new ServletException(e); } response.sendRedirect(work_list.jsp); } }关键参数maxFileSize控制单文件大小超过会抛异常getSubmittedFileName()拿原始文件名前面拼时间戳防止重名覆盖getRealPath(/uploads)拿到的是部署目录下的绝对路径重启 Tomcat 后如果重新部署这个目录可能被清空所以生产环境一般存到外部固定目录。数据库里存的是相对路径uploads/xxx页面展示时拼上上下文路径即可。3.3 作品列表与分页JSP 页面里该写多少 Java 代码作品列表页是 JSP 和 Java 代码混合的典型场景。原则是JSP 只负责展示查询逻辑放在 Servlet 或 DAO 里通过 request 传过来。% page contentTypetext/html;charsetUTF-8 languagejava % % page importjava.util.List % % page importcom.demo.entity.Work % html headtitle作品列表/title/head body h2学生作品展示/h2 table border1 trth标题/thth分类/thth作者/thth操作/th/tr % ListWork works (ListWork) request.getAttribute(works); if (works ! null) { for (Work w : works) { % tr td% w.getTitle() %/td td% w.getCategoryName() %/td td% w.getRealName() %/td tda hrefwork_detail.jsp?id% w.getId() %查看/a/td /tr % } } % /table /body /html这段代码里用了脚本片段% %和表达式% %这是 JSP 最原始的写法。虽然现在不推荐在 JSP 里写大量 Java 代码但作为毕设项目这种写法足够直观也方便答辩时讲清楚「页面怎么拿到数据」。分页的话在 Servlet 里用LIMIT和OFFSET控制SELECT w.*, c.name AS category_name, s.real_name FROM work w LEFT JOIN category c ON w.category_id c.id LEFT JOIN student s ON w.student_id s.id ORDER BY w.create_time DESC LIMIT ? OFFSET ?;LIMIT是每页条数OFFSET是跳过的记录数当前页码从请求参数拿。注意 MySQL 的LIMIT在数据量大时深分页会慢但毕设级别几百条数据完全无感。4. 避坑与排查从 404 到乱码的五个血泪现场4.1 现象启动 Tomcat 后访问页面报 404原因通常有三种一是web.xml里url-pattern和实际访问路径不一致二是 JSP 文件放在了WEB-INF下面这个目录是受保护的外部不能直接访问三是 IDEA 的 Artifact 配置里没有把webapp目录加进去。解决检查web.xml映射确认 JSP 在webapp根目录或子目录下在 Project Structure → Artifacts 里看输出布局是否包含WEB-INF/lib和webapp内容。4.2 现象数据库连接报「Access denied for user」原因MySQL 8.0 默认的 root 用户认证插件是caching_sha2_password而老版本驱动不认。解决要么升级驱动到 8.0 以上要么改用户认证方式ALTER USER rootlocalhost IDENTIFIED WITH mysql_native_password BY 你的密码; FLUSH PRIVILEGES;另外检查连接串里的用户名密码是否和实际一致localhost和127.0.0.1在 MySQL 权限表里可能被当成不同主机。4.3 现象上传的中文文件名变成乱码原因请求没有设置编码或者 Tomcat 的server.xml里 Connector 没配URIEncoding。解决在 Servlet 第一行加request.setCharacterEncoding(UTF-8)同时在server.xml的 Connector 标签里加URIEncodingUTF-8。如果是文件内容乱码检查数据库表和字段的字符集是否为utf8mb4。4.4 现象JSP 页面修改后刷新没变化原因Tomcat 缓存了编译后的 Servlet或者浏览器缓存了页面。解决在 JSP 顶部加% page sessionfalse %不一定有用更直接的是清理 Tomcat 的work目录或者在 IDEA 里配置热部署。浏览器端用CtrlF5强制刷新。如果还不行检查是不是改错了文件——IDEA 有时会打开target目录下的副本。4.5 现象打包成 war 后放到独立 Tomcat 跑不起来原因IDEA 里跑用的是展开目录war 包里的路径结构可能不同。常见问题是WEB-INF/lib下的 jar 没打进去或者web.xml版本声明和 Tomcat 不匹配。解决用jar -tf your.war查看包内结构确认WEB-INF/classes和WEB-INF/lib都存在。web.xml的version属性如果是 4.0Tomcat 9 支持Tomcat 8 可能报错改成 3.1 试试。5. 从能跑到能讲答辩演示的三个加分技巧5.1 用一条 SQL 把「学生-作品-分类」串起来展示答辩时老师常问「你的表之间怎么关联的」。与其口头解释不如在作品详情页直接展示关联查询结果SELECT s.real_name, s.class_name, w.title, w.description, c.name AS category FROM work w JOIN student s ON w.student_id s.id JOIN category c ON w.category_id c.id WHERE w.id ?;这条语句把三张表串在一起页面上显示「张三 / 计科 1801 班 / 作品智能小车 / 分类硬件设计」。老师一眼就能看懂数据关系比画 ER 图更直接。5.2 给上传功能加一个文件类型白名单毕设系统虽然简单但安全细节能加分。在 UploadServlet 里加一段String fileName filePart.getSubmittedFileName(); String ext fileName.substring(fileName.lastIndexOf(.) 1).toLowerCase(); ListString allowed Arrays.asList(jpg, png, pdf, zip, docx); if (!allowed.contains(ext)) { request.setAttribute(msg, 不支持的文件类型); request.getRequestDispatcher(upload.jsp).forward(request, response); return; }这段代码限制只能上传图片、PDF、压缩包和 Word 文档。参数说明lastIndexOf(.)找扩展名分隔符toLowerCase()统一大小写防止.JPG绕过。白名单比黑名单可靠因为黑名单永远列不全。5.3 把数据库密码从代码里挪出去很多源码把数据库密码硬编码在DBUtil里答辩时被问到「密码泄露怎么办」会很尴尬。常见做法是放到db.properties文件里jdbc.urljdbc:mysql://localhost:3306/student_works?useSSLfalseserverTimezoneUTC jdbc.usernameroot jdbc.passwordyour_password jdbc.drivercom.mysql.cj.jdbc.Driver然后用Properties类加载InputStream is DBUtil.class.getClassLoader().getResourceAsStream(db.properties); Properties props new Properties(); props.load(is); String url props.getProperty(jdbc.url);这样改密码不用重新编译代码也显得你对配置管理有基本概念。注意db.properties放在src根目录下编译后会进WEB-INF/classes。我自己带过几届毕设最深的教训是不要等到答辩前三天才把项目从「能跑」推到「能讲」。能跑只需要环境对能讲需要你清楚每一行代码为什么这么写。上面这些配置和代码你照着敲一遍遇到报错就按第 4 章的排查思路走基本能覆盖 90% 的翻车场景。剩下的 10%多半是版本差异导致的玄学问题换回 JDK 8 Tomcat 9 MySQL 5.7 的组合往往就消失了。希望帮到你。本文还有配套的精品资源点击获取