JSP+MySQL科研项目申报管理系统：课程设计部署与SQL实战

简介：面向高校师生与科研管理人员的jsp823科研项目教学成果申报管理系统，基于JSP+MySQL实现，覆盖项目申报、审核、统计、成果展示等核心环节，可有效提升科研管理效率，也适合作为课程设计实战范例。压缩包共464个文件，包含70个jsp、31个html、24个css、53个js等前端视图与逻辑文件，198个gif用于流程演示，17个jar为运行依赖，还有java源码、sql脚本及doc/docx配套报告教程，整体7.19MB，目录结构清晰。已有36人学习下载。资源提供完整可运行源码、数据库设计与文档说明，便于学习者快速复现MVC架构下的增删改查、权限控制与数据统计功能，同时通过实际项目加深对JSP+MySQL开发的理解，对课程设计、毕业设计或教学案例均具参考价值。

1. 一个 JSP + MySQL 的课程设计能干什么？先别急着换 Spring Boot

如果你把这个 jsp823 科研项目教学成果申报管理系统 mysql 版下载下来解压，里面是一整套能直接扔进 Tomcat 的 JavaWeb 工程：JSP 写页面、Servlet 做分发、MySQL 存数据，跑起来就是高校里最常见的“项目申报 + 审核 + 统计”流程。这东西不是生产级系统，但对课程设计和毕业设计的价值很直接：它能让你完整走一遍 javaweb 项目完整案例 mysql 从登录到报表的闭环，尤其适合没写过完整 JSP 项目的人。我见过不少学生拿到这种压缩包第一反应是“太老了吧，为什么不用 Spring Boot”，实际上先把这个跑通，你才分得清哪些逻辑是 JSP 的、哪些是 JDBC 的、哪些必须靠数据库去完成。本文会把部署、代码、SQL 和踩坑一次讲透，你照着做，下午就能把申报单提交进 MySQL。

2. 拆包装看内核：JSP + MVC + MySQL 的分工方式

2.1 从类名和 .classpath 反推模块边界

压缩包里出现了一串类文件：MainCtrl.class、CommDAO.class、PageManager.class、Upload.class、StrUtil.class、SetChar.class。课程设计的命名通常很直白，不需要看 UML 就能猜出职责。

这种写法本质上是手写 MVC。没有 Spring 的时候，MainCtrl 就是 DispatcherServlet 的替代品；没有 MyBatis 的时候，CommDAO 就是通用 Mapper 的替代品。虽然代码不优雅，但好处是每一行都能看懂。还有.classpath和org.eclipse.wst.jsdt.ui.superType.container这两个文件存在，说明原始工程是在 Eclipse 里建立的，里面带了 JSDT 的 JS 支持配置。导入到 IDEA 后这些文件不会影响编译，但.classpath里的 classpath 顺序可能会让 IDEA 在首次导入时提示错乱，别慌，按第 3 章的步骤重新配置 SDK 和 Tomcat 就行。

项目中还有jquery-ui-1.9.2.custom.css，说明前端的 jQuery UI 组件引用比较老。后面如果要在页面上加日期选择器，注意只看 jQuery UI 1.9 的 API 文档，不要照搬新版的写法。

2.2 一条申报单从表单到数据库的完整数据流

以教师申报科研项目为例，完整数据流是这样的：

1. 教师在project_add.jsp填写项目名称、负责人、研究方向、预期目标、进度安排。
2. 页面将表单 POST 到/mainCtrl?action=addProject。
3. MainCtrl 读取action参数，决定调用项目模块的方法。
4. 方法把request.getParameter拿到的字符串封装进一个实体类或 Map。
5. 调用 CommDAO 的插入方法，拼接或者预编译 SQL 写入 MySQL。
6. 写入成功后，控制器response.sendRedirect("project_list.jsp?page=1")回到列表页。

这个流程最核心的入口就是 MainCtrl，它的代码风格在早期 JSP 项目里非常常见。下面是一段简化的控制器分发逻辑，帮助理解“动作分发”这件事。

protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { request.setCharacterEncoding("UTF-8"); String action = request.getParameter("action"); if (action == null || action.trim().length() == 0) { action = "list"; } if ("addProject".equals(action)) { projectService.addProject(request, response); } else if ("checkProject".equals(action)) { projectService.checkProject(request, response); } else if ("listProject".equals(action)) { projectService.listProject(request, response); } else { request.getRequestDispatcher("error.jsp").forward(request, response); } }

这里能看到几个关键点：第一步强制设置request编码，是为了避免中文表单变成乱码。action用字符串传参，优点是简单，缺点是拼错一个字母就 404，所以课设答辩时如果在控制器里改了方法名，记得同步改 JSP 表单里的隐藏域。最后兜底转发到error.jsp的做法值得留用，它保证了非法请求不会直接抛异常到页面。

数据流走到数据库之后，涉及的表设计一般在 SQL 文件里。按这个系统的申报场景，核心表一般会拆成项目表、用户表、审核记录表和成果表。项目表常见字段如下。

CREATE TABLE `project` ( `id` int(11) NOT NULL AUTO_INCREMENT, `project_name` varchar(100) NOT NULL, `principal` varchar(50) NOT NULL, `dept` varchar(50) DEFAULT NULL, `direction` varchar(200) DEFAULT NULL, `plan` text, `status` int(11) DEFAULT 0, `apply_time` datetime DEFAULT NULL, PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

状态字段status用 int 类型，0 表示草稿、1 表示待审核、2 表示已通过、3 表示已驳回。这里DEFAULT 0是个很值得学的小习惯，它让数据库在插入记录时自动把状态设置为草稿，而不是等 Java 端手动补值。你以后写自己的课设时，凡是有“状态”含义的字段都建议加默认值，不然漏传参数会让数据处于未定义状态。

2.3 权限和“安全”在课程设计里的真实边界

摘要里提到了用户身份验证、权限控制和数据加密传输。落到代码上，实际表现往往是登录后把用户 ID 和角色 ID 塞进 Session，然后在每个页面的顶部检查 Session 是否为空。常见做法是把判断逻辑写在一个公共 JSP 里，再在需要权限的页面顶部 include 它。

<%@ page contentType="text/html;charset=UTF-8" %> <% Object roleId = session.getAttribute("roleId"); if (roleId == null) { response.sendRedirect("login.jsp"); return; } %>

这段的逻辑很简单：没登录就去登录页，登录了就放行。不过你答辩的时候要注意，这种权限控制只是功能层面的“入口拦截”，不是安全防护。项目正文里说的“数据加密传输”，在这个课程设计里一般指的是对密码字段做 MD5 摘要存储，而不是 HTTPS 通道加密。如果评审老师追问网络层安全，你可以说“当前版本未启用 TLS，仅作为课程设计演示”，这比夸大表述更可信。从改造角度看，真正的重点是权限判断代码必须出现在业务方法最前面，而不是等 SQL 执行完之后再判断，否则就有越权风险。

3. 本地复现：从 .rar 到 Tomcat 里跑起来

3.1 环境选型：JDK 8 + Tomcat 8/9 + MySQL 5.7/8.0

这套东西看起来老，但它对环境的挑剔程度反而不高。我一般推荐用 JDK 1.8，因为 Tomcat 8.5 和 9 对 JDK 8 支持最友好，JSP 编译也不会出现 module 访问问题。Tomcat 8.5 和 9 的区别不大，都是 Servlet 3.1/4.0 规范，跑这种传统 JSP 项目没有任何压力。MySQL 你可以用 5.7，也可以用 8.0，区别只在 JDBC 驱动和连接 URL 上，后面会细讲。

如果你的机器上已经装了新版 JDK，比如 JDK 17，再跑这个项目会大概率出现java.lang.NoClassDefFoundError: javax/xml/bind/...这类问题，这是 JDK 9 以后移除了 Java EE 模块导致的。解决办法不是去改代码，而是老老实实装一个 JDK 1.8 并让 IDEA 项目 SDK 指向它。如果你的电脑里同时存在多个 JDK，在 Tomcat 启动配置里手动指定 JAVA_HOME 就够用。

3.2 解压导入：从 Eclipse 工程到 IDEA Web 项目

压缩包后缀是.rar，Windows 下用 7-Zip 或 WinRAR 解压。解压后不要直接双击文件夹里的.class文件，要用 IDE 的导入功能。在 IDEA 里选择File -> Open，选中解压出的工程目录，如果 IDEA 识别出.classpath，它会把工程当 Eclipse 项目导入。如果没有识别，直接选择目录后手动添加 Web 支持。

# 也可以先在命令行确认目录结构 cd jsp823科研项目教学成果申报管理系统 ls -la

这个路径里会看到src、WebRoot（或web）、WEB-INF、WEB-INF/lib等目录。确认有web.xml，后面配置发运行是必须的。IDEA 里导入之后，按Ctrl+Alt+Shift+S打开项目结构设置，将 Project SDK 改成 1.8，Modules 里把src标记为 Sources，把WebRoot标记为 Web 资源目录。没有这一步，JSP 文件会找不到。

然后添加 Tomcat：点击 IDEA 顶部运行配置，选择 Tomcat Server，Local，在 Deployment 里把工程的 war exploded 加进去。传统 JSP 项目打包 WAR 的路径在Build -> Build Artifacts -> 选择 war: exploded + war，你可以直接生成.war复制到Tomcat/webapps下，也可以直接在 IDEA 里用 Tomcat 跑 exploded。两种方式效果一样，后者调试时改 JSP 不用重启。

3.3 MySQL 初始化：建库、导 SQL、改连接参数

这套系统需要 MySQL 服务先启动。Windows 下常见操作是net start mysql，Linux 下是systemctl start mysqld。数据库初始化一般会有一个.sql文件，放在压缩包里的sql或db目录下。打开命令行导入。

mysql -uroot -p # 输入密码后执行 CREATE DATABASE IF NOT EXISTS jsp823 DEFAULT CHARACTER SET utf8mb4; USE jsp823; SOURCE /你的绝对路径/jsp823.sql;

执行完SOURCE后，用SHOW TABLES;看一眼。如果表结构都出来了，说明导入成功。接下来改数据库连接配置，这门课的配置一般写在db.properties、jdbc.properties或CommDAO.java里。以常见的db.properties为例，内容长这样。

db.driver=com.mysql.jdbc.Driver db.url=jdbc:mysql://localhost:3306/jsp823?useUnicode=true&characterEncoding=UTF-8&useSSL=false&serverTimezone=Asia/Shanghai db.user=root db.password=你的数据库密码

参数解释一下：characterEncoding=UTF-8让中文正确存储；useSSL=false避免本地连接 MySQL 8 时出现 SSL 握手警告；serverTimezone=Asia/Shanghai只对 MySQL 8.0 必要。如果你用的是 MySQL 8.0，驱动要改成com.mysql.cj.jdbc.Driver，并且连接 URL 里还要加上allowPublicKeyRetrieval=true，否则可能报Public Key Retrieval is not allowed。如果你是 5.7，保持com.mysql.jdbc.Driver就行。改完配置后，在 IDEA 里启动 Tomcat，看到控制台出现ssm或项目加载成功类日志，再打开http://localhost:8080/项目路径/login.jsp就不会白屏。

4. 核心代码解读：从登录到统计报表的关键片段

4.1 CommDAO：把 JDBC 这块黑板擦干净

课程设计里的 CommDAO 通常会把查询、插入、更新、删除都封装一遍。最值得读的是分页查询方法，因为列表页几乎都会用到。以下是一段典型的分页查询写法，你可以对照自己拿到的源码理解参数含义。

public List<String[]> getPage(String sql, int pageIndex, int pageSize) throws Exception { List<String[]> rows = new ArrayList<>(); Connection conn = null; PreparedStatement ps = null; ResultSet rs = null; try { conn = DbUtil.getConnection(); ps = conn.prepareStatement(sql); // 传统课程设计里经常看到 Statement 直接执行，但建议保留 PreparedStatement rs = ps.executeQuery(); while (rs.next()) { String[] row = new String[rs.getMetaData().getColumnCount()]; for (int i = 1; i <= row.length; i++) { row[i - 1] = rs.getString(i); } rows.add(row); } } finally { if (rs != null) rs.close(); if (ps != null) ps.close(); if (conn != null) conn.close(); } return rows; }

这段代码里最关键的是PreparedStatement而不是Statement。原始压缩包里的 CommDAO 可能是直接拼接 SQL 字符串，那个写法你有可能会在源码里看到，比如：

Statement st = conn.createStatement(); ResultSet rs = st.executeQuery("select * from project where id=" + id);

如果原来就是这种写法，你最好手动改成PreparedStatement形式。原因很简单：拼 SQL 会让1 or 1=1这类输入直接变成查询条件，虽然课设不要求安全，但答辩时被问到“你做过 SQL 注入防护吗”，你能回答说“已改用预编译”会加分很多。另一个容易忽略的地方是finally里的关闭顺序，先关 ResultSet，再关 Statement，最后关 Connection，不能反着来，否则连接池不够用。

4.2 MainCtrl：action 分发是 JSP 项目的命门

MainCtrl 是整个系统最容易被改崩的地方。它收到的每个action都对应一个业务方法，而这个对应关系完全靠字符串匹配。下面这个片段演示了登录、退出、列表三种动作的分发。

String action = request.getParameter("action"); if ("login".equals(action)) { String username = request.getParameter("username"); String password = request.getParameter("password"); UserDao dao = new UserDao(); User user = dao.findByUsernameAndPassword(username, password); if (user != null) { session.setAttribute("userId", user.getId()); session.setAttribute("roleId", user.getRoleId()); response.sendRedirect("index.jsp"); } else { request.setAttribute("msg", "用户名或密码错误"); request.getRequestDispatcher("login.jsp").forward(request, response); } } else if ("logout".equals(action)) { session.invalidate(); response.sendRedirect("login.jsp"); }

参数说明：userId和roleId是后续权限判断的依据，如果你要新增“教师只能看自己项目”的功能，就是拿userId去和project.principal_id对比。response.sendRedirect和request.getRequestDispatcher().forward的区别是重定向会改变 URL，转发不会。用重定向做登录跳转的好处是用户刷新页面不会重复提交表单，所以登录成功后我建议用重定向。

4.3 统计报表的 SQL：把状态、学院和月份算清楚

科研项目教学成果申报系统的第二个大头是统计。页面上的项目申报情况统计表和教学成果展示表，本质都是GROUP BY加SUM/COUNT。最基础的是按申报状态统计。

SELECT CASE status WHEN 0 THEN '草稿' WHEN 1 THEN '待审核' WHEN 2 THEN '已通过' WHEN 3 THEN '已驳回' END AS status_name, COUNT(*) AS cnt FROM project GROUP BY status;

如果还要按院系统计通过率，就需要把审核结果和院系维度叠加，常见写法是：

SELECT dept, SUM(CASE WHEN status = 2 THEN 1 ELSE 0 END) AS passed_count, COUNT(*) AS total_count, ROUND(SUM(CASE WHEN status = 2 THEN 1 ELSE 0 END) / COUNT(*) * 100, 2) AS pass_rate FROM project WHERE YEAR(apply_time) = 2024 GROUP BY dept ORDER BY passed_count DESC;

这段 SQL 里有三个值得背下来的表达式。CASE WHEN用来做条件计数，ROUND(..., 2)保留两位小数，YEAR(apply_time)直接从日期字段里提取年份。如果你发现原始表里apply_time是字符串而不是datetime，就需要先转一下，MySQL 里使用STR_TO_DATE处理。

UPDATE project SET apply_time = STR_TO_DATE(apply_time, '%Y-%m-%d') WHERE apply_time IS NOT NULL;

不要直接在 WHERE 里对原来字符串字段做YEAR()，那会报错或查出空结果。像这种报表查询，我一般先在 Navicat 里跑通，再把 SQL 粘回 Java 代码。课程设计里的报表参数通常是从 JSP 页面下拉框或日期控件传过来，用request.getParameter拼条件，但拼的时候同样要注意参数名不要打错。

5. 避坑：运行这个 JSP 项目最容易翻车的四个现场

5.1 现象：Tomcat 启动后访问页面报Communications link failure

原因大多不是项目代码有问题，而是 MySQL 没起来，或者连接 URL 写错。常见错误是 MySQL 8 下用了旧驱动com.mysql.jdbc.Driver，它连上新版服务端后握手失败。网络上搬来的配置教程里还残留着 5.x 时代的写法，很多人照着填就翻车。

解决方法是先确认 MySQL 进程在跑，然后检查驱动包是不是mysql-connector-java-8.x.jar。如果是 8.0，驱动类名改成com.mysql.cj.jdbc.Driver，连接 URL 里加上serverTimezone=Asia/Shanghai。改完以后重启 Tomcat，不要只按热部署按钮，控制台日志里看到连接池初始化成功才算过。

5.2 现象：页面中文全部乱码，数据库里存进去的也是乱码

这个项目里已经有SetChar.class，说明作者是知道编码问题的。实际乱码通常发生在三个环节：JSP 页面本身不是 UTF-8、请求参数没有设置 UTF-8、MySQL 表编码不是 utf8mb4。排查顺序我一般是从后往前查。

先用 SQL 看表结构：

SHOW CREATE TABLE project;

如果表是latin1，先把库和表转成 UTF-8：

ALTER DATABASE jsp823 CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

然后在 Tomcat 控制台看输出日志，确认SetChar过滤器有没有把请求编码设对。如果页面中文正常、插入到 MySQL 后变乱码，问题在 JDBC URL 少了characterEncoding=UTF-8。如果插入前就乱码，问题多半在 JSP 页面顶部缺少pageEncoding="UTF-8"。总之别一上来就改代码，先用浏览器开发者工具看响应头里的Content-Type，是不是text/html; charset=UTF-8，这一步能排除一半问题。

5.3 现象：申报附件上传时提示“目录不存在”或者“文件保存失败”

原因通常是项目里用绝对路径保存上件，比如new File("upload/" + filename)，但 Tomcat 的工作目录不是工程根目录，导致upload目录没有被创建。这属于路径写死的典型问题。

解决方法是把上传路径配置到web.xml的 context-param 里，或者算当前项目的物理根目录。如果不想改太多代码，先在 WebRoot 下手工建一个upload目录并确保 Tomcat 对它可读写。Windows 下还要注意 IDEA 里 Tomcat 的Working directory，默认指向bin目录，这和你的工程目录完全没关系。所以上传成功后去磁盘里找不到文件，不要怀疑代码，先找~/.IntelliJIdea/system/tomcat/[项目]下有没有副本目录。

5.4 现象：改了.java源文件运行还是旧逻辑

这个项目压缩包里包含了不少.class文件，如果你直接用 Tomcat 跑WEB-INF/classes里原有的 class，IDEA 有可能没有重新编译你改过的源码。现象就是页面结果始终和源码不一致，非常像“改动被缓存”。

原因是 IDE 的构建输出目录没有设置为当前项目的 classes 目录。解决方法是先把原来编译好的.class文件彻底删掉，再执行Build -> Rebuild Project。我一般也会先停掉 Tomcat，删掉out或target目录，再重新启动。有很多人在这里折腾半小时，最后发现运行的还是压缩包自带的旧字节码。如果你也不确定，可以在控制器里临时加一行System.out.println("test");，看看控制台到底有没有打印，没有打印继续查编译输出路径。

6. 给课程设计加分的验收技巧：用一行日志盯住 SQL

很多人的课设到了最后一步是“页面能点就交”，结果答辩时说不出申报数据到底存在哪张表。所以我每次拿到别人写的 JSP + MySQL 项目，第一件事不是读代码，而是先打开 MySQL 的通用日志，把页面操作和 SQL 对起来。这个习惯能让你在半小时内摸清整个系统的数据库结构。

在 MySQL 5.7 和 8.0 里都可以这样打开日志：

SET GLOBAL log_output = 'TABLE'; SET GLOBAL general_log = 'ON';

然后去页面上进行一次登录、一次申报提交、一次审核操作。接着查日志表：

SELECT event_time, argument FROM mysql.general_log WHERE command_type = 'Query' ORDER BY event_time DESC LIMIT 20;

你会在argument字段里看到刚执行的原始 SQL，比如INSERT INTO project(...) VALUES(...)，这就说明申报流程走到了数据库层。如果只看到 SELECT，没看到 INSERT，说明控制器里的写入动作压根没执行，问题在前端表单或 action 分发。这个技巧比断点调试更直接，因为它是站在数据库视角观察整个系统。

用同样的方法还能验证统计报表。执行统计操作后，日志里会出现一句带GROUP BY dept的 SELECT，你可以在 Navicat 里单独跑一遍，对比页面数字是否一致。对了，生产环境记得把日志关掉，不然文件增长很快。课程设计无所谓，用完一条SET GLOBAL general_log = 'OFF'收工。

从那以后我每次接手别人的课设压缩包，都强制自己先跑起来再开数据库日志，把申报流程完整走一遍，确认数据真的进了表，才敢去改第二行代码。希望你也能借助这个 jsp 科研项目教学成果申报管理系统，把 JSP、MySQL 和报表查询这条路走通，希望帮到你。

本文还有配套的精品资源，点击获取