是不是想自己开发个留言板项目，却不知道从哪里开始？看着别人做的网页能接收留言、显示列表，自己却连页面都搭不起来；跟着教程写代码，要么数据库连不上，要么提交的留言存不进去；好不容易做出页面，样式乱得像一团麻，根本没法看？其实啊，零基础用 JSP 开发留言板没那么难，只要按步骤来，从环境搭建到功能实现，再到样式美化，每个环节都讲透，新手也能做出能正常用的留言板。今天兔子哥就带大家一步步做这个项目，附详细步骤和常见错误解决，保证你看完就知道该怎么动手！

一、开发前准备：这 3 样东西得先弄好

场景痛点：“刚学 JSP，不知道开发留言板需要哪些工具和知识”

开发留言板不用太复杂的工具，基础的 JSP 知识加上简单的数据库操作就行，新手别被 “项目” 两个字吓住。

1. 必备工具：3 个软件就能开工

• JDK：选 1.8 版本最稳定，安装时记得勾选 “配置环境变量”，不然后面 Tomcat 启动不了。
• Tomcat：8.5 或 9.0 版本都可以，解压后双击 bin 文件夹里的 startup.bat，能看到 “Server startup in xxx ms” 就说明启动成功。
• Eclipse/IDEA：用来写代码的 IDE，新手用 Eclipse 更简单，新建 “Dynamic Web Project” 时记得选对 Tomcat 版本。
• MySQL：存留言数据的数据库，装 5.7 版本就行，记住登录密码，后面连接数据库要用。

这些工具官网都能免费下载，跟着安装教程一步步来，半小时就能搞定。兔子哥刚开始学的时候，总担心工具版本不兼容，后来发现只要 JDK 和 Tomcat 版本对应（比如 JDK8 配 Tomcat8），基本不会有问题。

2. 基础知识：懂这 3 点就能开始做

• JSP 基础语法：会用<%= %>输出内容，<% %>写简单的 Java 代码，知道 EL 表达式${}怎么取数据。
• 简单的 SQL 语句：会写CREATE TABLE建表，INSERT存数据，SELECT查数据，这些基础语句就行。
• Servlet 工作原理：知道 Servlet 是用来处理请求的，能接收表单数据，调用数据库方法。

二、项目结构搭建：分清楚文件放哪里，别乱糟糟

场景问题：“文件随便放，写着写着就找不到了”

规范的项目结构能让代码更清晰，后期改 bug 也方便，新手刚开始就要养成好习惯。

1. 文件夹分工：每个文件夹放什么要记牢

• WebContent：放 JSP 页面、CSS、JS 文件，用户访问的页面都在这里。
  • 里面建个 “css” 文件夹放样式文件，“js” 文件夹放脚本，JSP 页面直接放 WebContent 下。
  
  
• src：放 Java 代码，按功能分包更清晰。
  • entity：放实体类，比如Message.java，定义留言的属性（id、内容、作者、时间）。
  • dao：放数据库操作类，比如MessageDao.java，写增删改查的方法。
  • servlet：放 Servlet 类，比如AddMessageServlet.java，处理用户提交的留言。
  • util：放工具类，比如DBUtil.java，封装数据库连接和关闭的代码。
  
  

刚开始可以简单点，先建这几个包，随着功能增加再慢慢扩展。

2. 数据库准备：建表语句直接用

打开 MySQL 客户端，新建数据库 “messageboard”，然后建表 “message”：
sql

CREATE DATABASE messageboard;USE messageboard;CREATE TABLE message (id INT PRIMARY KEY AUTO_INCREMENT, -- 留言id，自动增长author VARCHAR(50) NOT NULL, -- 留言人姓名content TEXT NOT NULL, -- 留言内容time DATETIME NOT NULL -- 留言时间);

建表后可以手动插一条测试数据，后面查数据时能看到效果：
INSERT INTO message (author, content, time) VALUES ('测试', '这是一条测试留言', NOW());

三、核心功能实现：从显示留言到提交留言，一步步来

场景痛点：“功能太多不知道先做哪个，越做越乱”

留言板核心功能就两个：显示所有留言、提交新留言，先实现这两个基础功能，再考虑美化。

1. 显示留言列表：让用户能看到已有的留言

① 写实体类 Message.java

java

public class Message {private int id;private String author;private String content;private String time;// 自动生成get和set方法public int getId() { return id; }public void setId(int id) { this.id = id; }// 其他属性的get、set方法同理}

② 写数据库工具类 DBUtil.java

java

public class DBUtil {private static String url = "jdbc:mysql://localhost:3306/messageboard?useSSL=false&serverTimezone=UTC";private static String user = "root"; // 你的MySQL用户名private static String password = "123456"; // 你的密码// 获取数据库连接public static Connection getConn() throws Exception {Class.forName("com.mysql.cj.jdbc.Driver");return DriverManager.getConnection(url, user, password);}// 关闭连接public static void close(Connection conn, PreparedStatement ps, ResultSet rs) {try { if (rs != null) rs.close(); } catch (Exception e) {}try { if (ps != null) ps.close(); } catch (Exception e) {}try { if (conn != null) conn.close(); } catch (Exception e) {}}}

③ 写数据访问类 MessageDao.java

java

public class MessageDao {// 查询所有留言public List<Message> findAll() {List<Message> list = new ArrayList<>();Connection conn = null;PreparedStatement ps = null;ResultSet rs = null;try {conn = DBUtil.getConn();String sql = "SELECT * FROM message ORDER BY time DESC"; // 按时间倒序ps = conn.prepareStatement(sql);rs = ps.executeQuery();while (rs.next()) {Message msg = new Message();msg.setId(rs.getInt("id"));msg.setAuthor(rs.getString("author"));msg.setContent(rs.getString("content"));msg.setTime(rs.getString("time"));list.add(msg);}} catch (Exception e) {e.printStackTrace();} finally {DBUtil.close(conn, ps, rs);}return list;}}

④ 写 Servlet：MessageListServlet.java

java

@WebServlet("/MessageListServlet")public class MessageListServlet extends HttpServlet {protected void doGet(HttpServletRequest request, HttpServletResponse response) {MessageDao dao = new MessageDao();List<Message> list = dao.findAll();request.setAttribute("messages", list); // 把留言列表存到requesttry {// 跳转到留言列表页面request.getRequestDispatcher("index.jsp").forward(request, response);} catch (Exception e) {e.printStackTrace();}}}

⑤ 写 JSP 页面：index.jsp 显示留言

jsp

<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
简易留言板
姓名：
留言：
提交留言
留言列表
作者：${msg.author} 时间：${msg.time}
${msg.content}

2. 提交留言功能：让用户能发表新留言

① 写 Servlet：AddMessageServlet.java 处理提交

java

@WebServlet("/AddMessageServlet")public class AddMessageServlet extends HttpServlet {protected void doPost(HttpServletRequest request, HttpServletResponse response) {// 设置编码，解决中文乱码request.setCharacterEncoding("UTF-8");// 接收表单数据String author = request.getParameter("author");String content = request.getParameter("content");// 存到数据库MessageDao dao = new MessageDao();dao.add(author, content); // 后面实现add方法// 跳回列表页try {response.sendRedirect("MessageListServlet");} catch (Exception e) {e.printStackTrace();}}}

② 在 MessageDao 里加 add 方法

java

// 新增留言public void add(String author, String content) {Connection conn = null;PreparedStatement ps = null;try {conn = DBUtil.getConn();String sql = "INSERT INTO message (author, content, time) VALUES (?, ?, NOW())";ps = conn.prepareStatement(sql);ps.setString(1, author);ps.setString(2, content);ps.executeUpdate(); // 执行插入} catch (Exception e) {e.printStackTrace();} finally {DBUtil.close(conn, ps, null);}}

四、样式美化：加几句 CSS，让页面好看点

场景问题：“功能实现了，但页面太丑，不像正经项目”

简单的 CSS 就能让页面大变样，新手不用学复杂的样式，掌握基础的布局和颜色设置就行。
在 css 文件夹里建 style.css：
css

body {width: 800px;margin: 0 auto;padding: 20px;font-family: 微软雅黑;}.message-list {margin-top: 30px;padding-top: 20px;border-top: 1px solid #ccc;}.message-item {padding: 10px;margin: 10px 0;border: 1px solid #eee;border-radius: 5px;}input, textarea {width: 100%;padding: 8px;margin: 5px 0 15px 0;box-sizing: border-box;}button {padding: 8px 20px;background-color: #4CAF50;color: white;border: none;border-radius: 4px;cursor: pointer;}

在 index.jsp 里通过引入这个 CSS 文件，页面瞬间整齐多了。

五、常见错误解决：这些坑新手最容易踩

1. 数据库连接失败，报 “ClassNotFoundException”

原因：没加 MySQL 驱动包，或者驱动类名写错了。
解决：下载 mysql-connector-java-8.0.28.jar，放到 WebContent/WEB-INF/lib 文件夹下；驱动类名用com.mysql.cj.jdbc.Driver（8.0 以上版本）。

2. 提交留言后中文乱码

原因：没设置请求编码。
解决：在 Servlet 的 doPost 方法开头加request.setCharacterEncoding("UTF-8");。

3. 访问 Servlet 报 404 错误

原因：Servlet 路径写错了，或者没加 @WebServlet 注解。
解决：检查表单的 action 属性和 Servlet 的 @WebServlet 路径是否一致，比如都写成 “/AddMessageServlet”。

六、自问自答：开发留言板最常问的问题

Q：“怎么给留言板加删除功能？”
A：在留言列表加个 “删除” 按钮，传当前留言的 id 到 DeleteServlet，Servlet 里调用 dao 的 delete 方法，执行DELETE FROM message WHERE id=?语句就行。
Q：“页面刷新后留言才更新，能不能实时显示？”
A：可以用 Ajax！用户提交留言后，不用刷新页面，用 JavaScript 调用 Servlet，成功后在页面加一条新留言，这个后面学 Ajax 再试试。
Q：“这个留言板太简单了，能加哪些功能升级？”
A：可以加留言分页（一次只显示 10 条）、用户登录（只有登录才能留言）、留言审核（管理员批准后才显示），这些功能都能在这个基础上扩展。
兔子哥觉得，开发留言板是零基础学 JSP 的好项目，功能不复杂，却能用到 JSP、Servlet、数据库、CSS 这些核心知识。刚开始写代码时，谁都难免报错，别慌，把错误提示复制到百度搜，大部分问题都有现成的解决办法。
带过的学员里，有个零基础的同学跟着这个步骤做，三天就做出了能正常用的留言板，虽然简单，但特别有成就感。其实编程就是这样，动手做项目比光看教程进步快得多。现在就打开你的 IDE，按步骤一步步来，你会发现开发项目真的没那么难，动手试试吧！

标签： 基础知识 startup.bat