JSP+MySQL个人记事系统源码部署实战：从JDBC配置到Tomcat war包发布

简介：基于JSP与MySQL实现的个人记事备忘系统完整源码包，面向正在学习Java Web开发的初学者、毕业设计学生以及需要快速搭建轻量级记事本应用的开发者。项目采用JSP+Servlet+JDBC经典技术栈，涵盖用户笔记增删改查、分类管理、登录验证等核心功能，涉及MVC分层、SQL注入防范、数据库连接池等进阶要点。资源共374个文件，包含Java源码与Servlet类、JSP页面、HTML/CSS/JS前端界面、数据库配置文件与jar依赖库等，压缩包约27.51MB。目前已有109人学习下载。通过研读代码目录与页面实现，可掌握从数据库表设计、DAO数据访问层编写到前端页面联调的全过程，适合作为课程设计、毕业设计或求职作品参考，也可直接部署到Tomcat运行验证学习效果。

1. 基于Jsp和MySQL实现的个人记事备忘系统：这套源码到底能不能拿来就用

“基于Jsp和MySQL实现的个人记事备忘系统”这个标题，放到今天看就像一套标准的JavaWeb课设/毕设题：JSP管页面展示，Servlet接请求，MySQL存数据。市面上这种源码包流传很广，但大多数人解压后都会卡在同一个地方——先跑哪个文件、用什么版本的环境、为什么数据库连不上。这篇笔记就从“源码包拿到手之后”的顺序走一遍：先拆结构和表设计，再在IDEA里跑起来，打成war部署到Tomcat，最后把高频踩坑现场挨个说清楚。适合刚学完JavaWeb基础的人、拿它做毕设但缺实操经验的学生，以及需要快速在本地复现一套老项目来改功能的开发者。

2. 拆解源码结构：JSP+Servlet+MySQL的记事备忘系统是怎么分层设计的

2.1 这套JSP+Servlet+MySQL组合为什么成了记事备忘系统的常见底座

个人记事备忘系统的业务很简单：用户注册登录、新增记事、编辑删除、按时间查看。这类系统用SpringBoot来做当然可以，但JSP+Servlet+MySQL的组合在课程设计和毕业设计里仍然是最常见的题材，原因是它的分层足够直观——JSP页面放在Web根目录下，Servlet类控制跳转，DAO类通过JDBC读写数据库。三层全部手写，每个文件做什么一目了然，答辩时也容易讲清楚。

对比一下SpringBoot集成JSP的目录约束：SpringBoot官方不推荐JSP，需要额外指定spring-boot-starter-tomcat和JSP编译依赖，打包时还要把JSP放到META-INF/resources下，否则war包里找不到页面。传统JSP项目则没有这些限制，源码包的目录结构基本都是WebContent或src/main/webapp，JSP文件直接放里面，Tomcat会自动映射。所以这类源码包对新手友好，不需要理解复杂的自动配置，改一个JSP文件就能看到效果。

记事备忘系统的数据量不大，交互以增删改查为主，不存在高并发、事务嵌套、分库分表的需求。用JDBC直连或简单连接池就够了。理解了这一点，你会发现源码包里的几十个文件完全可以按“JSP视图层、Servlet控制层、DAO数据层”三条线去读，不用从头到尾逐行看。

2.2 user、note、category三张表：个人记事系统的核心建表脚本

打开源码包，通常会有database或sql目录，里面放一个建表脚本，名字一般是note.sql或memo.sql。个人记事备忘系统最常见的表结构是三张表：用户表、记事表、分类表。分类表可以没有，但用户表和记事表必须有。记事表里一般存标题、正文、创建时间、是否置顶、用户ID，这些字段直接决定了系统的功能边界。

下面是一份符合JSP+MySQL课设水平、同时兼顾MySQL 5.7和8.0兼容性的建表脚本：

-- 用户表 CREATE TABLE `user` ( `id` INT NOT NULL AUTO_INCREMENT, `username` VARCHAR(32) NOT NULL COMMENT '登录名', `password` VARCHAR(64) NOT NULL COMMENT '加密或明文密码，看源码实现', `nickname` VARCHAR(32) DEFAULT NULL COMMENT '昵称，可为空', `create_time` DATETIME DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (`id`), UNIQUE KEY `uk_username` (`username`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='用户表'; -- 记事表 CREATE TABLE `note` ( `id` INT NOT NULL AUTO_INCREMENT, `user_id` INT NOT NULL COMMENT '所属用户', `title` VARCHAR(100) NOT NULL DEFAULT '' COMMENT '记事标题', `content` TEXT COMMENT '正文内容', `is_top` TINYINT NOT NULL DEFAULT 0 COMMENT '是否置顶，0不置顶 1置顶', `create_time` DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', `update_time` DATETIME DEFAULT NULL ON UPDATE CURRENT_TIMESTAMP COMMENT '修改时间', PRIMARY KEY (`id`), KEY `idx_user_time` (`user_id`, `create_time`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='记事表';

这段脚本的关键参数要说明一下。username字段用UNIQUE KEY做唯一约束，注册时重名会直接抛异常，比在Java里先查一遍再插入更可靠。password字段长度给64，是为了兼容MD5或SHA256加密后的密文，如果源码里是明文存储，拿到手后建议改成加密。content用TEXT而不是VARCHAR，是为了让正文不受65535字节限制，个人记事的日志类内容经常超过这个长度。is_top的TINYINT DEFAULT 0是热搜里“mysql设置默认值为0”的典型场景，置顶逻辑就是按这个字段倒序排列。create_time用DATETIME而不是TIMESTAMP，可以规避2038年问题和MySQL 8.0对TIMESTAMP默认值的一些严格限制。

索引方面，idx_user_time这个联合索引覆盖了“查看某用户的所有记事，按时间倒序”这个核心查询，查询条件里带上user_id可以高效走索引。如果你拿到手的源码表结构里没有这个索引，在数据量上了几千条后，列表页每次查询都会做全表扫描。MySQL的排序如果不需要可以不加，但这个联合索引建议保留。导入脚本时注意先执行CREATE DATABASE note DEFAULT CHARSET utf8mb4，否则直接建表会因为没选中库而报错。

2.3 DBUtil与连接参数：useSSL、serverTimezone、characterEncoding一次调对

源码包的数据库连接层，常见做法是放一个DBUtil.java，内部维护一个连接池或者直接用DriverManager.getConnection。有连接池的会用DBCP、C3P0或Druid，没有连接池的就是每次请求都新建连接。个人项目用连接池更好，改动成本也不高。配置信息通常集中在db.properties或jdbc.properties里，数据库账号密码都在这一个文件里改。

jdbc.driver=com.mysql.cj.jdbc.Driver jdbc.url=jdbc:mysql://localhost:3306/note?useSSL=false&serverTimezone=Asia/Shanghai&characterEncoding=utf8&allowPublicKeyRetrieval=true jdbc.username=root jdbc.password=your_password jdbc.initialSize=5 jdbc.maxTotal=20

对应的DBUtil核心代码是这样的：

import java.sql.Connection; import java.sql.DriverManager; import java.sql.SQLException; import java.util.Properties; import java.io.InputStream; public class DBUtil { private static String url; private static String username; private static String password; static { try (InputStream in = DBUtil.class.getClassLoader() .getResourceAsStream("db.properties")) { Properties props = new Properties(); props.load(in); Class.forName(props.getProperty("jdbc.driver")); url = props.getProperty("jdbc.url"); username = props.getProperty("jdbc.username"); password = props.getProperty("jdbc.password"); } catch (Exception e) { throw new ExceptionInInitializerError(e); } } public static Connection getConnection() throws SQLException { return DriverManager.getConnection(url, username, password); } }

url那一段参数值得逐字理解。useSSL=false是关掉SSL加密连接，MySQL 8.0默认开启SSL，而很多老源码用的连接驱动版本对SSL握手兼容性差，不关会报“SSL connection error”之类的错。serverTimezone=Asia/Shanghai解决时间差8小时的问题，热搜里“mysql jdbc usessl 与 sslmode 使用”和“mysql将字符串转为日期”其实都指向这些参数。characterEncoding=utf8解决中文乱码。allowPublicKeyRetrieval=true是配合MySQL 8.0的caching_sha2_password认证插件用的，不加这个参数会报“Public Key Retrieval is not allowed”。

如果你下载的源码包里是纯JDBC直连而没有连接池，注意不要再加initialSize和maxTotal这两个配置，否则配置文件里写了但代码不读，不会有问题，但会让人误以为连接池已经生效。判断源码是否用了连接池，看DBUtil类里有没有DataSource对象或者BasicDataSource之类的导入即可。

3. 用IDEA把源码跑起来：JSP项目导入、数据库配置与首次启动的完整步骤

3.1 JDK、Tomcat、MySQL版本怎么配对：老源码对环境敏感

JSP老项目对运行环境很敏感，版本不匹配会出一堆奇怪报错。最常见的是JDK版本过高导致Tomcat启动失败或JSP编译报错，以及MySQL驱动版本和数据库版本不匹配。参考下面这个组合，踩坑率最低：

JSP规范本身是跟着Servlet走的：Tomcat 8.5对应Servlet 3.1和JSP 2.3，Tomcat 9对应Servlet 4.0和JSP 2.4。老源码里如果用了Tomcat专属标签或旧版JSTL，8.5比9的兼容性稍好。我一般建议先试Tomcat 8.5，报错少。如果你本机只有JDK 11或17，强行跑一个编译级别为1.8的老项目，启动时大概率遇到java.lang.UnsupportedClassVersionError，或者Tomcat内部框架反射报ClassNotFound。最简单的办法是装一个JDK 8并让IDEA的Project SDK指向它。

MySQL版本要单独说。MySQL 5.7和8.0在认证方式上有本质区别，8.0默认用caching_sha2_password，老驱动com.mysql.jdbc.Driver只认mysql_native_password，会直接报认证失败。如果你的源码包里驱动是5.x版本的jar，连MySQL 8.0时要把数据库用户的插件改回mysql_native_password，或者直接把驱动替换成mysql-connector-java 8.x并修改驱动类名为com.mysql.cj.jdbc.Driver。

3.2 用IDEA导入既有JSP源码：Web Facet、Artifacts与Tomcat配置

拿到源码包后不要急着双击JSP文件，那只会用浏览器打开源码文本。正确做法是把整个目录当成项目导入IDEA，然后手动告诉IDEA这是Web项目。打开方式：IDEA启动界面选Open，选中源码根目录。如果根目录有pom.xml，IDEA会提示作为Maven项目导入，选Trust Project即可；如果只有WebContent或src目录，就选New Project from Existing Sources，一路Next，到SDK选择时指定JDK 1.8。

导入后最关键的一步是配置Web Facet和Artifacts。打开File → Project Structure → Facets，点加号选Web，然后在Web Resource Directories里把WebContent或src/main/webapp目录标记为Web资源目录。再到Artifacts确认有一个war或war exploded的产出物。如果Artifacts里是空的，后面配置Tomcat时会找不到可部署的东西，启动直接报错。

然后是配置Tomcat运行环境：Run → Edit Configurations → 左上角加号 → Tomcat Server → Local。在Server选项卡里配置Tomcat安装目录，在Deployment选项卡里点加号选Artifact，把项目部署进去。Application context这一栏要重点看一眼，它决定了访问路径。比如写/note，启动后访问地址就是http://localhost:8080/note/。很多源码包里的过滤器或登录跳转写的是绝对路径，比如response.sendRedirect("/login.jsp")，这时Application context配成/才行，否则跳转会404。这一步是整个IDEA配置里最常见的坑。

3.3 导入SQL脚本并修改数据库连接：命令行和Workbench两条路

数据库准备环节要先把脚本导入MySQL。两种方式任选，命令行适合熟手，MySQL Workbench适合需要可视化确认的人。命令行方式如下：

mysql -u root -p < note.sql

注意这条命令执行前要确认note.sql文件路径，且脚本里如果没有CREATE DATABASE语句，就要先手动创建库。可以用mysql -u root -p -e "CREATE DATABASE note DEFAULT CHARSET utf8mb4"先建库再导入。导入完成后用SHOW TABLES;验证三张表是否都在，顺便执行SELECT * FROM user;看看有没有内置账号，有的源码包会预置一个admin账号用于演示。

改数据库连接参数是源码跑通的关键一步。打开src目录下的db.properties，把密码改成你自己的MySQL密码。如果你用的MySQL是8.0，同时确认jar包是8.x的驱动，然后按前面2.3节的url参数修改。改完先别急着启动，写一个两行的Java测试类或者直接用数据库客户端连一次，确认账号能远程或本地登录。这里不推荐在代码里硬编码密码，源码包该有的习惯是集中配置。

3.4 启动后按什么顺序验证：从Tomcat日志到数据库记录

首次启动不要直接点浏览器刷新，先看IDEA的Run窗口里的Tomcat日志。看到“Server startup in [xxx] milliseconds”才算真正启动完成。如果一直卡在“Deployment is in progress”或者报端口占用，先查8080端口是否被其它进程占用，然后检查Artifacts是否构建成功。日志里出现严重错误时，点左侧的红色错误行跳转到具体异常，最常见的就两类：数据库连接失败和JSP编译异常。

启动成功后按这个顺序验证：先访问部署路径的根地址，看是否能跳转到登录页（如果源码有登录拦截）；注册一个新账号；登录后新建一条带中文的记事；然后执行一条SQL去库里查这条数据是否存在。如果页面显示成功但库里没有记录，问题出在事务管理或SQL执行后的提交；如果页面乱码，则回到2.3节的字符集参数去排查。这个顺序能快速把问题定位到是前端JSP、Servlet跳转还是数据访问层。

4. 传统JSP项目打包成war：从源码包到可部署的Tomcat产物的标准流程

4.1 war包是什么：给“源码打包”补上最后一步

源码包里的“打包”两个字有两层含义。第一层是源码文件的压缩归档，也就是你下载到的zip或rar；第二层是把整个Web项目构建成war包——这是JavaWeb的标准部署单元。war包本质上是一个特殊格式的zip，里面包含JSP、class文件、jar依赖、web.xml配置。Tomcat拿到war包后会自动解压到webapps目录下，不需要额外手工复制class文件。个人记事系统打包成war，意味着可以脱离IDEA直接部署到任意一台装有Tomcat的机器上，不管是演示还是放到自己的服务器都方便。

为什么不直接把整个源码目录拷到Tomcat的webapps下？因为源码目录里包含.java源文件和IDEA工程文件，Tomcat运行时不关心这些，它只需要编译后的.class、JSP、WEB-INF/lib下的依赖jar包和web.xml。war包就是把这一堆运行时文件按标准目录结构组织起来。很多课设源码包里会直接带一个现成的war，但那个war是作者机器上构建的，数据库连接配置大概率指向作者本机，你依然要解压web.xml和配置文件去改数据库地址。

4.2 三种打war包的方式：Maven、IDEA Artifacts与手动jar

对于源码包，打war包的方式取决于项目结构。如果源码带pom.xml，用Maven最省事，在项目根目录执行：

mvn clean package -DskipTests

命令执行完后，war包在target目录下，文件名一般是artifactId-version.war。由于源码包经常不配套完整的Maven配置，如果pom.xml里缺了打包插件，执行后会在target目录只生成class而没有war，这时候给pom.xml补上maven-war-plugin插件即可。注意JDBC驱动如果声明的scope是provided或test，是不会打进war的WEB-INF/lib的，部署后运行会报找不到驱动类，要把scope改成compile。

不带Maven的纯Web目录项目，用IDEA的Build Artifacts功能更直接。菜单路径为Build → Build Artifacts → Build，前提是3.2节里已经配置好Web Facet和Artifacts类型。IDEA会按Artifacts定义的输出布局，把编译好的class和Web目录资源打包成war。这种方式不依赖Maven，适合那些解压出来就是一个纯Web目录的老源码。还有更原始的手动方式：把WebContent里的内容连同WEB-INF目录一起打进zip，然后改扩展名为war，但class文件必须是你自己编译过的。初学者别选这个，容易漏文件或放错目录。可以理解为：有pom用Maven，没pom用IDEA，手动jar只在你明确知道要包含哪些文件时才推荐。

三者的对比如下：

4.3 部署到Tomcat并验证：从webapps目录到浏览器访问

war包打出来后，部署就变得很机械。先停掉正在运行的Tomcat，避免端口占用或文件被锁定。然后把war包复制到Tomcat的webapps目录，再执行启动脚本。Linux或macOS下大概是这个样子：

cp note.war /path/to/tomcat/webapps/ /path/to/tomcat/bin/startup.sh

启动后Tomcat会自动把note.war解压成note目录。这时访问http://localhost:8080/note/，如果能看到登录页，说明war包内容结构正确。如果看到404，先确认war文件名和访问路径一致——Tomcat默认用war包文件名作为应用上下文路径，note.war对应的上下文就是/note。网页上能打开后，再做一个更彻底的验证：执行curl命令看返回状态码，以及用数据库客户端查一下登录成功后是否生成了新的会话记录或数据。

curl -I http://localhost:8080/note/ curl -L http://localhost:8080/note/login.jsp

如果下面有动态请求，注意一个问题：很多人会把war部署到Tomcat后，再用nginx做服务器前置，然后问“nginx支持jsp吗”。答案是不支持，nginx本身不解析JSP，需要把动态请求反向代理到Tomcat端口，通常是配置nginx的location块proxy_pass到http://127.0.0.1:8080。个人记事系统直接访问Tomcat就够用了，不需要上nginx。

5. 避坑：JSP+MySQL项目从源码到上手的5个高频翻车现场

5.1 报错“Public Key Retrieval is not allowed”或SSL连接错误

现象是：项目启动后点任何需要访问数据库的功能，页面直接500，Tomcat日志里出现java.sql.SQLNonTransientConnectionException，提示Public Key Retrieval is not allowed。或者日志里有SSL connection error相关的异常，一堆带SSL关键词的堆栈。

原因分两类。Public Key Retrieval是因为MySQL 8.0默认的caching_sha2_password认证需要向服务器获取公钥来加密密码传输，JDBC驱动出于安全考虑默认不自动获取。SSL连接错误则是因为MySQL 8.0默认开启SSL，而老驱动或老连接参数没有正确处理SSL握手。

解决方法是修改jdbc.url参数，把allowPublicKeyRetrieval=true和useSSL=false都加上。如果修改后仍报错，再看驱动版本，mysql-connector-java 5.x在MySQL 8.0下兼容性很差，换成8.x版本并把driver类名改成com.mysql.cj.jdbc.Driver。

5.2 JSP页面中文乱码三层各乱各的

现象是：页面显示的问号或乱码有时是标题乱码、正文正常，有时全页面都乱，写入数据库的也是乱码。最迷惑的是改一处编码后另一个页面又乱了。

原因是JSP+MySQL的中文乱码涉及三个独立节点：JSP文件的保存编码和pageEncoding指令、HTTP请求响应之间的字符编码、JDBC连接MySQL时传输的字符编码。它们必须全部一致，只改JSP页面的pageEncoding是不够的。

解决方法是逐个统一。JSP文件头部确认<%@ page contentType="text/html;charset=UTF-8" pageEncoding="UTF-8"%>；MySQL数据库建库时用utf8mb4，连接URL里保证characterEncoding=utf8；如果还有乱码，检查Tomcat的server.xml里Connector是否缺少URIEncoding="UTF-8"属性。控制台输出乱码另说，那个不影响业务数据。

5.3 war部署后访问项目路径404，Tomcat首页却正常

现象是：Tomcat启动成功，访问http://localhost:8080/能看到Tomcat默认欢迎页，访问http://localhost:8080/note/就404，webapps目录里确认war已经解压出note目录了。

原因是应用上下文路径不匹配。Tomcat的webapps下目录叫note，那上下文路径就是/note。如果war包里的JSP页面有跳转逻辑写的是绝对路径，例如response.sendRedirect("/index.jsp")，那么这个路径实际会映射到Tomcat根上下文，也就是/下，当然404。还有一种情况是IDEA部署时Application context配成了/note_war，和你预期的/note不一样。

解决方法是先确认上下文：访问http://localhost:8080/note/login.jsp试试直接打开物理JSP文件，如果这个能开而/note/不能，多半是欢迎页或Servlet映射的问题。然后打开Tomcat的conf/server.xml，看Host里是否有Context配置覆盖了默认映射。大多数情况下，把war包重新命名为你想要的上下文名（比如note.war）再部署就能解决。

5.4 启动后页面提示找不到驱动类或连接池依赖

现象是：运行时抛ClassNotFoundException: com.mysql.jdbc.Driver，或者在IDEA里运行正常，打成war包部署到另一台机器上就报同样的错。

原因是依赖没有进入war包。IDEA里运行项目时，依赖在IDEA的classpath里能找到；但独立部署时，Tomcat只认WEB-INF/lib目录下的jar。源码包里如果带了lib目录但IDEA没有把lib里的jar纳入Artifacts，或者pom.xml里驱动依赖的scope是provided，都会导致war包缺少驱动。

解决方法是：打开Project Structure → Artifacts，在右侧的Available Elements里找到lib目录下所有jar，右键选Put into WEB-INF/lib。Maven项目则检查pom里mysql-connector-java的scope，改成compile后重新package，再打开war包确认WEB-INF/lib下有没有这个jar。

5.5 记事时间比当前时间少8小时或多了8小时

现象是：新建一条记事，列表页显示的时间比本地时间晚8小时；或者数据库里存的时间对，但页面显示就偏了。

原因是时区在三个环节不断传递：MySQL连接URL的serverTimezone参数、Java运行环境的默认时区、浏览器显示用的本地时区。老源码连接MySQL时没写serverTimezone，驱动默认取JVM所在时区，如果服务器是UTC就会差8小时。

解决方法是统一时区。在jdbc.url里加serverTimezone=Asia/Shanghai，这是最直接的手段。如果改完还差，检查MySQL系统变量time_zone是否为SYSTEM，可以执行SET GLOBAL time_zone = '+08:00'，但重启MySQL会恢复，稳妥做法是在my.cnf的[mysqld]下配置default-time-zone='+08:00'。源码包通常不需要改到数据库system级别，优先改JDBC参数。

6. 把个人记事备忘系统做深一步：登录态、数据备份与扩展点

6.1 登录态：用一个Filter拦掉未登录访问

很多源码包的登录校验都写在每个JSP页面里，每次跳转都要重复判断session，既容易漏又难维护。改成统一Filter是成本最低的加固动作。核心逻辑是放行登录页和登录接口，其余请求都检查session里有没有用户对象。一个最小实现大致是：doFilter里判断request.getSession().getAttribute("user")是否为空，为空就跳转到login.jsp，不为空放行。配置web.xml时把过滤路径设为/*，但注意放行/css、/js这类静态资源，否则登录页本身的样式也加载不出来。

6.2 数据备份：个人记事的后悔药

记事系统用久了才知道备份多重要。MySQL单库备份一条命令就能做完整导出：

mysqldump -u root -p note > note_backup_$(date +%Y%m%d).sql

配合crontab每天凌晨执行一次，再配合文件保留策略，比如只保留最近30天的备份文件，个人项目的数据库安全基本就到位了。恢复时执行mysql -u root -p note < backup.sql即可。这一条值得写进任何源码包的自述文档里。

6.3 让记事系统更像成品：搜索、分组和导出

源码包的记事列表通常只是一个顺序倒排的表格，但实际使用时搜索是刚需。后加搜索功能不用改数据库表，直接在DAO层加一个LIKE查询就能验完业务。数据量大了之后再用MySQL的FULLTEXT索引优化。分类筛选在现有表基础上增加一个category_id字段，配合一个分类管理页面即可。导出功能用JSP输出原生内容就行：新建一个note_export.jsp，通过out.println直接输出纯文本或HTML，浏览器另存为就是文本文件。

我自己的习惯是接到这种老项目源码，第一件事不是看业务代码，而是先把lib目录和web.xml扫一遍，确认依赖和Servlet映射版本，再启动数据库连一下。前面省10分钟，后面能少踩一半的坑。希望这篇笔记能帮你把这个个人记事备忘系统从源码包变成真正能每天打开写点东西的工具。

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