企业官网建设流程全解析

简介：这是一套面向Java Web初学者与课程设计者的JSP企业电子投票系统完整源码，基于JSP、Tomcat与JDK环境开发，适合用于毕业设计、课程实训或投票类功能模块的学习参考。系统分为普通用户与管理员两大模块：用户可登录退出、对已开放主题投票并查看已公布结果；管理员则能撤销或恢复主题、永久删除主题、公布或隐藏投票结果、编辑与发布新主题，以及新增删除用户，前台与后台入口清晰。资源包共64个文件，约1003KB，以37个jsp页面为核心，辅以jpg截图、css样式、xml配置、sql脚本及mdf、ldf数据库文件，另含论文文档与项目截图，便于理解整体结构与数据库设计。目前已有391人学习下载，可帮助读者快速掌握JSP动态网站的开发流程、权限划分与投票业务逻辑，并对照论文与截图完成部署与二次开发。

1. 从一份 JSP 投票系统源码说起：为什么它值得你花时间跑一遍

前阵子有个做后端的朋友吐槽，说现在接的活越来越“重”——动不动就是微服务、容器编排、前后端分离，结果回头一看，公司内部有个投票统计的小需求，愣是没人愿意接，嫌“技术栈太老”。我当时就笑了，因为我自己手里正好有一份 JSP 企业电子投票系统的源码包，解压、配 Tomcat、连数据库，前后不到半小时就跑起来了。这项目不是什么高精尖的东西，但它把“用户登录 → 发起投票 → 选项管理 → 实时统计 → 结果展示”这条链路走得很完整，特别适合两类人：一类是刚学完 JSP/Servlet 想找个完整项目练手的新手，另一类是需要快速交付一个内部投票工具、不想引入太重框架的开发者。技术栈就是经典的 JSP + Servlet + JDK + Tomcat + MySQL，没有花哨的前端工程化，但胜在结构清晰、改起来不费劲。如果你手里也有一份类似的源码包，或者正想找一个能跑通、能改动的 Java Web 项目，那这篇笔记就是按“先跑起来、再拆结构、最后动手改”的顺序写的，你可以直接抄作业。

2. 环境准备与项目启动：从 JDK 到 Tomcat 的完整链路

2.1 先确认版本，别让 JDK 和 Tomcat 打架

拿到源码包第一件事不是急着导入 IDE，而是先看它到底吃什么版本的 JDK 和 Tomcat。JSP 项目最怕的就是版本错配——用 JDK 17 去跑一个只支持 Servlet 3.0 的老项目，启动时各种ClassNotFoundException能把你逼疯。我一般会先翻一下WEB-INF/web.xml里的web-app版本声明，再决定用哪个 Tomcat。

提示：如果你不确定源码的 Servlet 版本，直接看web.xml的version属性，或者看lib目录下有没有javax.servlet-api.jar。

2.2 数据库初始化：建库、建表、改配置

投票系统的核心数据就几张表：用户表、投票主题表、选项表、投票记录表。源码包里通常会带一个.sql文件，直接导入就行。但导入之前，我习惯先手动建一个空库，字符集选utf8mb4，避免中文选项乱码。

-- 创建数据库，字符集一定要指定 CREATE DATABASE vote_system DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; -- 导入源码包里的 vote_system.sql -- 导入后检查表结构，重点关注 vote_record 表的唯一索引 USE vote_system; SHOW TABLES; DESC vote_record;

导入完成后，找到项目里的数据库配置文件。JSP 项目一般会把 JDBC 连接信息写在db.properties或者直接在DBUtil.java里硬编码。你需要改的是url、username、password这三项。

# db.properties 常见写法 jdbc.driver=com.mysql.cj.jdbc.Driver jdbc.url=jdbc:mysql://localhost:3306/vote_system?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai jdbc.username=root jdbc.password=你的密码

这里有个血泪经验：MySQL 8.0 必须加serverTimezone，否则启动就报时区错误；而 MySQL 5.7 用老驱动com.mysql.jdbc.Driver就行，别硬上 8.0 的驱动，不然连接池初始化直接翻车。

2.3 部署到 Tomcat 并验证启动

配置改完后，把项目打成 WAR 包丢进 Tomcat 的webapps目录，或者直接在 IDE 里配置 Tomcat Server 运行。启动日志里看到Server startup in xxx ms就算成功。然后浏览器访问http://localhost:8080/项目名/，应该能看到登录页。

# 命令行部署方式（Linux/Mac） cp vote_system.war $TOMCAT_HOME/webapps/ $TOMCAT_HOME/bin/startup.sh tail -f $TOMCAT_HOME/logs/catalina.out

如果访问 404，先检查web.xml里的welcome-file是不是login.jsp；如果报 500，大概率是数据库连不上，看catalina.out里的SQLException堆栈，十有八九是账号密码或驱动类名写错了。这一步跑通，后面拆代码才有意义。

3. 核心模块拆解：一个投票请求从进入到返回的完整链路

3.1 目录结构：先看清项目骨架再动手

JSP 项目的目录结构基本是固定的，但不同人写出来的包名和分层习惯差别很大。我拿到源码后第一件事就是画一棵目录树，搞清楚哪些是入口、哪些是工具类、哪些是业务逻辑。

vote_system/ ├── src/ │ └── com/ │ └── vote/ │ ├── dao/ # 数据访问层，直接操作数据库 │ ├── entity/ # 实体类，和数据库表一一对应 │ ├── servlet/ # 控制层，处理请求和跳转 │ ├── util/ # 工具类，DBUtil、MD5 加密等 │ └── filter/ # 过滤器，登录校验、编码处理 ├── WebContent/ │ ├── css/ # 样式文件 │ ├── js/ # 前端脚本 │ ├── WEB-INF/ │ │ ├── web.xml # 部署描述符 │ │ └── lib/ # 第三方 jar 包 │ ├── login.jsp # 登录页 │ ├── vote_list.jsp # 投票列表页 │ ├── vote_detail.jsp # 投票详情与提交页 │ └── result.jsp # 结果统计页 └── vote_system.sql # 数据库脚本

这个结构里，servlet包是请求入口，dao包是数据库操作，entity是数据载体。看懂这三层，改功能就不会迷路。

3.2 登录与权限过滤：一个 Filter 挡住所有未登录请求

投票系统最基础的安全要求就是“没登录不能投票”。源码里通常用一个LoginFilter来实现，拦截所有.jsp和/servlet请求，检查session里有没有用户信息。

// LoginFilter.java 核心逻辑 public class LoginFilter implements Filter { @Override public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) throws IOException, ServletException { HttpServletRequest request = (HttpServletRequest) req; HttpServletResponse response = (HttpServletResponse) resp; String uri = request.getRequestURI(); // 放行登录页、登录接口和静态资源 if (uri.contains("login.jsp") || uri.contains("LoginServlet") || uri.contains(".css") || uri.contains(".js")) { chain.doFilter(req, resp); return; } // 检查 session 中是否有用户 Object user = request.getSession().getAttribute("currentUser"); if (user == null) { response.sendRedirect(request.getContextPath() + "/login.jsp"); } else { chain.doFilter(req, resp); } } }

这段代码的关键在web.xml里的<filter-mapping>配置，url-pattern写/*表示拦截全部。参数说明：currentUser是登录成功后塞进 session 的键名，改的时候要保证LoginServlet和Filter里用的键名一致，否则会出现“明明登录了却一直被踢回登录页”的玄学问题。

3.3 投票提交与防重复：事务和唯一索引双保险

投票提交是整个系统最核心的写操作。用户点击“提交投票”后，VoteServlet会先检查该用户是否已经投过票，然后插入投票记录并更新选项计数。这里如果只靠 Java 代码判断，并发下必然出问题，所以源码里一般会用数据库唯一索引兜底。

// VoteServlet.java 投票提交核心片段 protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { int userId = (int) request.getSession().getAttribute("userId"); int topicId = Integer.parseInt(request.getParameter("topicId")); int optionId = Integer.parseInt(request.getParameter("optionId")); Connection conn = null; try { conn = DBUtil.getConnection(); conn.setAutoCommit(false); // 开启事务 // 1. 检查是否已投票 if (VoteDao.hasVoted(conn, userId, topicId)) { request.setAttribute("msg", "您已经投过票了"); request.getRequestDispatcher("vote_detail.jsp").forward(request, response); return; } // 2. 插入投票记录 VoteDao.insertRecord(conn, userId, topicId, optionId); // 3. 更新选项计数 VoteDao.updateOptionCount(conn, optionId); conn.commit(); // 提交事务 response.sendRedirect("result.jsp?topicId=" + topicId); } catch (Exception e) { if (conn != null) conn.rollback(); // 回滚 e.printStackTrace(); request.setAttribute("msg", "投票失败，请重试"); request.getRequestDispatcher("vote_detail.jsp").forward(request, response); } finally { DBUtil.close(conn); } }

逻辑说明：先查后插再更新，三步放在同一个事务里，任何一步失败都回滚。参数方面，userId从 session 取，topicId和optionId从前端表单取。常见坑是忘记conn.setAutoCommit(false)，导致插入成功但更新失败时数据不一致。另外，vote_record表上要建(user_id, topic_id)的唯一索引，这样即使代码判断漏了，数据库也会直接拒绝重复插入。

3.4 结果统计：一条 SQL 搞定分组计数

结果页不需要复杂的 Java 逻辑，直接一条GROUP BY查询就能把每个选项的票数拉出来，然后在 JSP 里用c:forEach渲染。

-- 统计某个投票主题下每个选项的票数 SELECT o.option_id, o.option_text, COUNT(r.record_id) AS vote_count FROM vote_option o LEFT JOIN vote_record r ON o.option_id = r.option_id WHERE o.topic_id = ? GROUP BY o.option_id, o.option_text ORDER BY vote_count DESC;

这里用LEFT JOIN是为了保证票数为 0 的选项也能显示出来。如果换成INNER JOIN，没人投的选项就直接消失了，用户会以为选项丢了。JSP 页面里拿到List<Map>后，用<c:forEach>遍历，再用<div style="width:${item.vote_count / total * 100}%">做个简易进度条，效果就出来了。

4. 避坑与常见问题排查：那些让我加班到凌晨的坑

4.1 中文乱码：POST 和 GET 要分开治

现象：登录页输入中文用户名，后台收到的是??????；投票选项里的中文存进数据库变成乱码。

原因：JSP 页面默认用 ISO-8859-1 解码，而 Tomcat 8 以后 GET 请求的 URI 编码又和 POST 不一样。

解决：POST 请求在web.xml里配CharacterEncodingFilter，或者在每个 Servlet 开头写request.setCharacterEncoding("UTF-8")；GET 请求要去 Tomcat 的server.xml里给 Connector 加URIEncoding="UTF-8"。数据库连接 URL 里也要带characterEncoding=utf8。三处都改，少一处都还会乱。

4.2 数据库连接池耗尽：别忘了关连接

现象：项目跑一段时间后，所有页面都卡住，日志里报Cannot get a connection, pool exhausted。

原因：DBUtil.getConnection()拿到的连接没有在finally里关闭，或者ResultSet、PreparedStatement没关，导致连接泄漏。

解决：每个 DAO 方法都严格按ResultSet → PreparedStatement → Connection的顺序在finally里关闭。如果项目用了连接池（比如 Druid 或 DBCP），检查maxActive配置是不是太小，但根本原因还是泄漏，先修代码再调参数。

4.3 投票按钮点不动：前端表单没包对

现象：选项选好了，点提交没反应，浏览器控制台也没报错。

原因：<form>标签的action写错了，或者选项的<input type="radio">没有name属性，导致request.getParameter("optionId")拿到null。

解决：检查vote_detail.jsp里每个 radio 的name是否一致，value是否对应option_id。另外，提交按钮的type必须是submit，别写成button又不加onclick。

4.4 部署后 404：上下文路径和 welcome-file 的坑

现象：Tomcat 启动正常，但访问http://localhost:8080/是 404，必须加项目名才能访问。

原因：项目没有部署为 ROOT，或者web.xml里没配welcome-file。

解决：要么把 WAR 包名改成ROOT.war，要么在web.xml里加<welcome-file-list><welcome-file>login.jsp</welcome-file></welcome-file-list>。如果是在 IDE 里跑，检查 Deployment 配置里的 Application context 是不是/。

4.5 统计结果对不上：事务隔离级别和缓存

现象：投票后跳转到结果页，票数没变，刷新几次才更新。

原因：MySQL 默认隔离级别是REPEATABLE READ，同一个事务里多次读会走快照；或者 JSP 页面被浏览器缓存了。

解决：投票提交后不要用forward，用sendRedirect重新发起请求；结果页的 JSP 头部加<% response.setHeader("Cache-Control", "no-cache"); %>。如果还不行，检查 DAO 里查询用的连接是不是和更新用的不是同一个事务。

5. 二次开发与改造思路：从能跑到好用

5.1 先加一个“我的投票”页面，验证你对 DAO 层的理解

跑通之后，最自然的改造需求就是“让用户看到自己投过哪些票”。这个功能不需要动核心逻辑，只需要在VoteDao里加一个查询方法，再建一个my_vote.jsp页面。

// VoteDao.java 新增方法 public List<Map<String, Object>> getMyVotes(int userId) { List<Map<String, Object>> list = new ArrayList<>(); String sql = "SELECT t.topic_title, o.option_text, r.vote_time " + "FROM vote_record r " + "JOIN vote_topic t ON r.topic_id = t.topic_id " + "JOIN vote_option o ON r.option_id = o.option_id " + "WHERE r.user_id = ? ORDER BY r.vote_time DESC"; try (Connection conn = DBUtil.getConnection(); PreparedStatement ps = conn.prepareStatement(sql)) { ps.setInt(1, userId); ResultSet rs = ps.executeQuery(); while (rs.next()) { Map<String, Object> row = new HashMap<>(); row.put("topicTitle", rs.getString("topic_title")); row.put("optionText", rs.getString("option_text")); row.put("voteTime", rs.getTimestamp("vote_time")); list.add(row); } } catch (SQLException e) { e.printStackTrace(); } return list; }

这个方法的参数只有一个userId，返回的是List<Map>，JSP 页面直接遍历渲染就行。改完之后，在导航栏加个链接，LoginFilter不用动，因为my_vote.jsp本来就在拦截范围内。这一步做完，你就把“读”和“写”两条链路都摸清了。

5.2 把硬编码的数据库配置抽成连接池

源码里如果用的是DriverManager直接拿连接，性能会很差。二次开发时建议换成 Druid 或 HikariCP，配置写在druid.properties里，DBUtil改成从连接池取。

# druid.properties driverClassName=com.mysql.cj.jdbc.Driver url=jdbc:mysql://localhost:3306/vote_system?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai username=root password=你的密码 initialSize=5 maxActive=20 maxWait=3000

// DBUtil.java 改造后 public class DBUtil { private static DataSource dataSource; static { try { Properties props = new Properties(); props.load(DBUtil.class.getClassLoader().getResourceAsStream("druid.properties")); dataSource = DruidDataSourceFactory.createDataSource(props); } catch (Exception e) { e.printStackTrace(); } } public static Connection getConnection() throws SQLException { return dataSource.getConnection(); } }

改造后，getConnection()从池里拿连接，close()实际上是归还连接。注意maxActive别设太大，内部投票系统 20 个连接足够，设大了反而浪费数据库资源。

5.3 加一个“投票结果导出 Excel”的功能

内部投票结束后，组织者往往需要把结果导出来存档。这个功能用 Apache POI 就能实现，核心是把result.jsp里的查询结果写成.xlsx文件。

// ExportServlet.java 核心片段 protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { int topicId = Integer.parseInt(request.getParameter("topicId")); List<Map<String, Object>> result = VoteDao.getResult(topicId); response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"); response.setHeader("Content-Disposition", "attachment; filename=vote_result.xlsx"); try (XSSFWorkbook workbook = new XSSFWorkbook()) { XSSFSheet sheet = workbook.createSheet("投票结果"); Row header = sheet.createRow(0); header.createCell(0).setCellValue("选项"); header.createCell(1).setCellValue("票数"); int rowNum = 1; for (Map<String, Object> row : result) { Row r = sheet.createRow(rowNum++); r.createCell(0).setCellValue((String) row.get("option_text")); r.createCell(1).setCellValue(((Number) row.get("vote_count")).intValue()); } workbook.write(response.getOutputStream()); } }

这个 Servlet 不需要返回 JSP，直接把 Excel 流写进response。参数topicId从 URL 传进来，前端在结果页加一个“导出”按钮指向这个地址就行。注意Content-Disposition里的文件名不要带中文，否则某些浏览器会乱码，用英文文件名最稳。

5.4 改造时的一个习惯：先备份 SQL，再动 DAO

我在这类老项目上踩过最疼的一次坑，是改VoteDao的时候顺手把vote_record表的字段名改了，结果忘记同步改result.jsp里的 EL 表达式，页面直接报PropertyNotFoundException。从那以后，我每次动 DAO 层之前，都会先把数据库导出备份，然后在代码里全局搜索一遍字段名，确认所有引用点都改到位再启动 Tomcat。这个习惯看起来笨，但能省下大量排查时间。希望帮到你。

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