简介这是一份围绕科研成果申报管理系统设计实现展开的技术文档适合JSP入门与进阶者、Java Web开发人员以及正在准备课程设计或毕业设计的学生阅读。文档采用JSPJavaBean与SQL Server 2000相结合的技术路线突出静态页面与动态页面的分离设计从开发背景、设计目标、系统模型与可行性分析入手逐步梳理需求分析结果与功能模块划分申报管理、审批管理、用户管理等在数据库设计层面绘制了数据流图与实体关系图并定义了数据表结构强调数据一致性、完整性与安全性。随后重点讲解JavaBean组件设计及系统主界面、科研申报、申报员登录、科研审批等关键页面的实现并给出关键源代码分析可帮助读者理解一个完整JSP管理系统的构建流程。资源包仅含1个doc文档大小516KB内容完整适合离线阅读和对照实践。目前已有62人学习下载对需要快速搭建类似科研管理平台的开发者具有直接的参考价值。1. 科研成果申报管理系统是什么JSP 项目的典型骨架每年九十月是科研处最忙的时候论文、专利、软著、获奖证书全堆在邮箱里管理员一边收邮件一边对表。科研成果申报管理系统就是把这股乱流搬上 Web教师在线填成果管理员在线审核最后按单位、按成果类型导出统计。很多人挑毕业设计时会点名要基于 Jsp 的毕设选题核心诉求其实是同一个要一个能跑通录入、流转、审核、展示的完整 Web 应用又不想一上来就碰 Spring Boot 那套全家桶。Jsp1016 这个命名看起来像某个课程设计或论文题目但背后的东西并不复杂。系统用 JSP 做页面展示Servlet 做请求入口JDBC 直接连 MySQLTomcat 做容器。没有微服务没有 Redis没有消息队列。缺点是什么JSP 里容易堆满 Java 代码数据访问容易写成全表扫描部署时各种编码坑。但这套组合到今天还能存活是因为它足够轻一个 Tomcat、一个 war 包扔上去就能跑对几百人规模的研究所完全够用。这篇文章按我做这类系统的顺序来写先定表和状态机再写 JSP 与 Servlet 的交互然后把部署和排障讲透。新手能照着把主流程搭起来熟手也能避开几个老生常谈的坑。没有通用的黑匣子关键是每一步都知道自己在等什么、改什么。2. 从建表到核心页面把科研成果申报主流程跑通先别急着写页面。这类管理系统的核心不在界面而在两张表申报主表和审核日志表。表一旦定了后面的 Servlet、JSP、权限判断全都要围着表结构打转改字段的成本远高于改页面。2.1 数据模型先行申报表与审核表的字段设计我一般先建申报主表字段方向是“谁能看到这条记录、这条记录现在处于什么状态、这条记录的内容是什么”。最少得包含以下内容-- 申报主表一条记录对应一次成果申报 CREATE TABLE declaration ( id INT AUTO_INCREMENT PRIMARY KEY, user_id INT NOT NULL, title VARCHAR(255) NOT NULL, category VARCHAR(50) NOT NULL, -- 论文 / 专利 / 软著 / 获奖 achievement VARCHAR(255) DEFAULT , -- 成果简介 file_path VARCHAR(255) DEFAULT , -- 附件路径 status TINYINT DEFAULT 0, -- 0 草稿, 1 已提交, 2 审核中, 3 通过, 4 退回 check_comment VARCHAR(500) DEFAULT , -- 审核不通过时的意见 create_time DATETIME DEFAULT CURRENT_TIMESTAMP, update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP );几个容易纠结的点说明一下。status 用 TINYINT 而不是 ENUM是因为后面改状态枚举值时不需要 ALTER TABLE直接改 Java 常量就行。category 用 VARCHAR 存固定枚举值配合应用层校验能避免数据库层和代码层维护两份字典。create_time 和 update_time 是审计底线一旦线上数据对不上第一件事就是查这两列。光有主表不够审核动作也得落库-- 审核日志表谁在什么时间做了什么事 CREATE TABLE audit_log ( id INT AUTO_INCREMENT PRIMARY KEY, declaration_id INT NOT NULL, operator_id INT NOT NULL, action VARCHAR(20) NOT NULL, -- submit / approve / reject / revert comment VARCHAR(500) DEFAULT , audit_time DATETIME DEFAULT CURRENT_TIMESTAMP );入门阶段很多人会把这个表省掉审核结果只更新主表 status 字段。真上线后你会发现管理员A退回了一条记录教师打电话来问原因双方各执一词没有日志根本说不清。所以哪怕只是课程设计我也建议把 audit_log 建出来成本非常低回报却很高。2.2 JSP 页面与 Servlet 控制器的交互写法传统 JSP 项目最忌讳的写法是把 Java 代码直接塞进% %里。正确姿势是JSP 只负责展示表单和结果Servlet 负责收参数和跳转。先看申报表单这一段form action${pageContext.request.contextPath}/declaration/add methodpost input typehidden nameuserId value${sessionScope.user.id} input typetext nametitle placeholder成果名称 required select namecategory option valuepaper论文/option option valuepatent专利/option option valuesoftware软著/option option valueaward获奖/option /select textarea nameachievement rows4/textarea button typesubmit保存草稿/button /formaction 里不能写死路径要用${pageContext.request.contextPath}拼接这样应用改部署目录时不会失效。userId 从 session 取不能信任前端传的隐藏字段否则会被抓包后改成别人的 ID。页面上看只有这些东西重量全在 Servlet 上WebServlet(/declaration/add) public class DeclarationAddServlet extends HttpServlet { Override protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { req.setCharacterEncoding(UTF-8); String title req.getParameter(title); String category req.getParameter(category); String achievement req.getParameter(achievement); Integer userId ((User) req.getSession().getAttribute(user)).getId(); DeclarationService service new DeclarationService(); service.insert(userId, title, category, achievement); resp.sendRedirect(req.getContextPath() /declaration/list); } }注意第一行req.setCharacterEncoding(UTF-8)必须写在读取任何参数之前后写就晚了。service 层把 insert 包起来是为了留一个放业务校验的地方避免所有状态判断都堆在 Servlet 里。2.3 用 JDBC 查询申报列表的最小可运行代码列表页是所有管理系统的刚需。这里给出一个最小可运行的 JDBC 查询方法后面所有列表功能都能从这里改出来public ListDeclaration listByUser(int userId) throws SQLException { ListDeclaration list new ArrayList(); String sql SELECT id, title, category, status, create_time FROM declaration WHERE user_id? ORDER BY create_time DESC; try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql)) { ps.setInt(1, userId); try (ResultSet rs ps.executeQuery()) { while (rs.next()) { Declaration d new Declaration(); d.setId(rs.getInt(id)); d.setTitle(rs.getString(title)); d.setCategory(rs.getString(category)); d.setStatus(rs.getInt(status)); d.setCreateTime(rs.getTimestamp(create_time)); list.add(d); } } } return list; }三个要点。第一用 PreparedStatement 而不是 StatementSQL 拼接是最常见的注入入口“柯力”写法的后果不用多说。第二用 try-with-resources 包住 Connection、PreparedStatement、ResultSet谁都不用记着关资源也省了 finally 里到处判空。第三查询列表只查列表要用的字段不要一口气SELECT *后面加个大字段附件路径时拖慢整页。页面展示列表我用 JSTL 而不是脚本片段c:forEach items${list} vard tr td${d.title}/td td${d.category}/td td c:choose c:when test${d.status 0}草稿/c:when c:when test${d.status 1}已提交/c:when c:when test${d.status 2}审核中/c:when c:when test${d.status 3}通过/c:when c:otherwise退回/c:otherwise /c:choose /td /tr /c:forEachJSTL 需要把 jstl.jar 放到 WEB-INF/lib 下并在 JSP 顶部加 taglib 声明。如果不依赖 JSTL直接写 Java 脚把表拼出来页面可读性会直线下降后续改状态文案要在十个页面里重复翻工。3. 系统功能拆解个人信息展示页面与审核状态的联动科研成果申报系统和一个普通 CRUD 的区别在于“状态”和“角色”。这一章把这两个点拆开看并特别处理 jsp 个人信息展示页面因为它是用户进入系统的第一眼也是数据回显最容易被忽略的地方。3.1 个人信息展示页面在 JSP 里的数据回显登录后跳到一个展示个人信息的页面上面显示姓名、工号、所在单位、手机号和自己的申报记录。回显写错是最常见的入门翻车点%-- 从 session 里拿 user 对象注意是 user 已经不是 userDto --% h3${sessionScope.user.name} 的科研成果申报记录/h3 p工号${sessionScope.user.empNo} 单位${sessionScope.user.dept}/p %-- 编辑表单回显value 一定要从对象取值 --% form action${pageContext.request.contextPath}/profile/update methodpost input typetext namephone value${sessionScope.user.phone} button typesubmit保存/button /form注意${sessionScope.user.phone}这行如果 User 对象里没有 phone 字段页面不会报错而是显示空白。罗列状态下的第一反应是把锅甩给 JSP其实问题在 JavaBean 属性对不上。另一个坑是回显时把密码框也填了 value结果前端源码里直接把密码暴露给所有人。个人信息展示页原则上不回显密码即使是为了编辑也不要改成点击按钮后重新输入。3.2 申报状态流转填写、提交、审核、退回状态机是整个系统的灵魂。我在项目里用 TINYINT 存这五个状态按流程定义如下转换状态码状态含义可选动作目标状态0草稿提交11已提交管理员审核2 / 3 / 42审核中通过 / 退回3 / 43通过无无4退回修改后重新提交1每个动作都带状态条件比如用户提交时只允许“草稿”和“退回”状态的记录进入“已提交”。做法是这样UPDATE declaration SET status 1, update_time NOW() WHERE id ? AND status IN (0, 4);这里 WHERE 里带 status 条件相当于给数据行加了一把乐观锁。如果这个 SQL 影响行数为 0说明这条记录已经被别人处理过了界面上要提示“记录状态已刷新请重新查看”而不是继续往下走。这一点特别重要如果两个人同时打开同一条草稿记录的编辑页一个提交一个删除不带条件更新会把删除过的记录又救活。3.3 权限区分普通用户和管理员的 JSP 判断权限不能只靠 JSP 里藏链接JSP 里做的是“显示控制”真正的拦截要在 Servlet 的 Filter 上做。页面判断可以这么写c:if test${sessionScope.user.role admin} a href${pageContext.request.contextPath}/admin/audit?id${d.id}审核/a /c:if c:if test${sessionScope.user.id d.userId || sessionScope.user.role admin} a href${pageContext.request.contextPath}/declaration/edit?id${d.id}编辑/a /c:if用户只能编辑自己的记录管理员能编辑所有人的记录这个判断要在列表页和服务端都做。JSP 这层只影响按钮显示直接手工拼 URL 还是能打到接口所以还要给后台接口加 FilterWebFilter(/admin/*) public class AdminAuthFilter implements Filter { Override public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException { HttpServletRequest req (HttpServletRequest) request; User user (User) req.getSession().getAttribute(user); if (user null || !admin.equals(user.getRole())) { req.getRequestDispatcher(/login.jsp).forward(req, response); return; } chain.doFilter(request, response); } }这块代码读完你会想管理员权限判断真的只需要三行吗对因为系统小没有细粒度的“谁能审核哪个学院”需求一个 role 字段加一个 Filter 就解决了。当前这个阶段提前设计复杂权限体系只会让项目在毕业设计的截止日期前翻车先把“普通用户和管理员”这层隔离开后面有能力再做 RBAC。4. JSP 项目部署避坑war 包、Tomcat 与中文乱码排查本地 IDEA 里跑得欢打包部署到服务器就出各种幺蛾子这是传统 JSP 项目最常见的转折点。部署上的问题不像代码报错信息千奇百怪排查全靠经验和细节。这一章把最容易踩的几个坑列出来。4.1 传统 JSP 项目打包 war 并部署到 Tomcat常见的做法是在 IDEA 里建一个 Web Application 项目然后在 Project Structure 里配置 Artifact打出一个 war 包。也可以用命令行直接打适合没有图形界面的服务器环境# 在项目根目录下WEB-INF 同级执行 jar -cvf declaration.war . # 把 war 包放入 Tomcat 的 webapps 目录启动时自动解压 cp declaration.war /opt/tomcat/webapps/ # 前台启动 Tomcat方便看日志 /opt/tomcat/bin/catalina.sh runwar 包内部结构必须满足约定WEB-INF 下有 web.xml、classes 目录放编译后的 class 文件、lib 目录放依赖 jar。JSP 页面放在 WEB-INF 外层这样可以直接通过 URL 访问。使用jar -cvf declaration.war .时注意那个点号它表示当前目录下所有内容不要加额外的上级路径否则解压后 web.xml 路径就错了。IDEA 打 war 包时有一个隐蔽问题Project Structure 里的“Web Resource Directory”如果是空打出来的 war 里没有 JSP 页面。我一般直接在 Artifact Output Layout 里确认 web 目录被标记成/classes 输出到WEB-INF/classeslib 输出到WEB-INF/lib。部署后立刻用浏览器访问一次首页把 404/500 一次排掉再继续下一步。4.2 排查一JSP 文件出现源码或 500现象浏览器访问某个 .jsp 页面时响应是一整页 Java 代码或者直接 500 错误错误信息指向 JSP 编译失败。原因第一种情况通常是 Tomcat 的 JspServlet 映射被 web.xml 覆盖或者项目中误把 jsp-api.jar、servlet-api.jar 放进了 WEB-INF/lib导致 Tomcat 加载了错误的类。第二种情况通常是 JSP 里用了% %脚本片段而段内引用了未导入的包或空对象。解决先打开 Tomcat 的conf/web.xml确认 org.apache.jasper.servlet.JspServlet 存在且 url-pattern 是*.jsp然后把 WEB-INF/lib 里所有 servlet-api 和 jsp-api 相关 jar 删掉Tomcat 自己带的不要重复放。最后清一次work/Catalina/localhost/declaration目录这个目录里的旧编译缓存能解决一部分“代码改了但页面不变”的玄学问题。4.3 排查二控制台中文乱码现象管理系统里的中文存进 MySQL 显示正常但温控台上 log 出来是“???”或者页面上读取回来变成“??”。原因整条链路里任何一个环节用了错误编码都会被传导下去。常见的是三层Tomcat 连接器默认 URI 编码是 ISO-8859-1Servlet 里没有设置 request/response 编码JDBC URL 没带 characterEncoding。解决按三层逐一改。先改 Tomcat 的 server.xml 里的 ConnectorConnector port8080 protocolHTTP/1.1 connectionTimeout20000 redirectPort8443 URIEncodingUTF-8 /再在自己的项目 Filter 里设置Override public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) { req.setCharacterEncoding(UTF-8); resp.setCharacterEncoding(UTF-8); chain.doFilter(req, resp); }最后改 JDBC URL加上characterEncodingutf8和useUnicodetrue。这三个地方少一个乱码就会在某个场景里突然冒出来。4.4 排查三JDBC 连接失败和驱动类找不到现象访问首页正常登录后一点“我的成果”就报ClassNotFoundException: com.mysql.jdbc.Driver或者No suitable driver found偶尔是Communications link failure。原因ClassNotFoundException是 WEB-INF/lib 下没有 MySQL 驱动 jar或者 jar 版本不对。No suitable driver是驱动的类名或连接 URL 前缀写错。Communications link failure是数据库地址、端口或防火墙问题。解决确认WEB-INF/lib下有 mysql-connector-java 5.1.x 的 jar然后统一在 DBUtil 的静态块里加载驱动static { try { Class.forName(com.mysql.jdbc.Driver); } catch (ClassNotFoundException e) { throw new ExceptionInInitializerError(e); } }连接 URL 建议写成jdbc:mysql://localhost:3306/declaration_db?useUnicodetruecharacterEncodingutf8useSSLfalse里面的 serverTimezone 在 MySQL 8 驱动下必须加否则日期会报错。高版本 MySQL 要用com.mysql.cj.jdbc.Driver这个一定要看驱动 jar 的版本说明不是凭感觉写。4.5 排查四上传文件后路径丢失现象附件上传后在页面能回显点开也能看。但重启 Tomcat 或者重新部署 war 包后原来上传的附件全部 404。原因很多入门项目把附件保存在webapps/declaration/upload下面这个目录会在 Tomcat 解压 war 包时被覆盖或者被清理。上传文件不能放在应用部署目录里否则重部署就是“有意删除”。解决把上传目录放到应用外部比如/data/declaration/uploads然后通过 Tomcat 的虚拟路径映射到 web 访问路径。在 server.xml 的 Host 节点下加Context docBase/data/declaration/uploads path/uploads reloadabletrue /前端展示附件时写成/uploads/xxx.pdf代码里存相对路径不要存http://localhost:8080/...这类带域名的东西否则以后改域名就要刷数据库。这是传统 JSP 项目里最容易被忽略的部署细节越早改越省心。5. 让申报系统更稳分页、SQL 参数化与复用技巧5.1 分页查询与 PreparedStatement把列表改成能用的接口申报记录不可能永远只有几十条跑到几百上千条时一次性全查出来会让页面变慢。分页是每个管理系统都逃不掉的技能。核心做法是先查总数再查当前页public ListDeclaration listByUserPage(int userId, int page, int pageSize) throws SQLException { String sql SELECT id, title, category, status, create_time FROM declaration WHERE user_id? ORDER BY create_time DESC LIMIT ?, ?; try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql)) { ps.setInt(1, userId); ps.setInt(2, (page - 1) * pageSize); ps.setInt(3, pageSize); try (ResultSet rs ps.executeQuery()) { // 组装对象到 list } } return list; }LIMIT 的第一个参数是偏移量很多人第一次会写成page但第一页page0时LIMIT 0, 10确实没错可第二页就直接跳到第 10 条只返回 10 条之后的奇数页会错得很隐晦。用(page - 1) * pageSize是通用的写法或者在页面上从 0 开始传页号。推荐后一种减少一次乘法。5.2 让 JSP 页面瘦身的复用习惯后期维护最大的痛苦来自 JSP 模板里到处重复的头部导航和脚本片段。我现在的习惯是抽公共页头、页脚把 Java 代码全往 Servlet 和 Service 层收JSP 里只留 JSTL 和 EL。抽出来的方式不复杂就是jsp:include page_header.jsp/把每个页面里的sessionScope.user判断、菜单高亮都写在一个文件里。另一个提高复用率的小技巧是把状态枚举拉出来比如在 Java 常量类里定义STATUS_SUBMIT 1页面用fmt:formatDate处理时间避免每个 list 页面都写一份 if-else。这样带过来的好处是后面想加一个“已退回重新提交”的按钮只改一个公共模板和两个 Servlet时间成本从半天缩到半小时。我自己做这类系统时最常告诫自己的就是“先守住数据层再美化展示层”。一次赶工把 SQL 拼接写得到处都是上线第一周就被后台管理员的搜索条件放翻了——一个单引号让整个列表 500。后来把所有查询都换成 PreparedStatement再没出过这种问题。如果你也想走这条路希望你跳过这个坑直接按照先建表、再写 Servlet、最后套 JSP 的顺序来。希望帮到你。本文还有配套的精品资源点击获取