简介JavaWeb开发是理解后端技术栈的基础路径其中Servlet与JSP承担了请求处理与页面渲染的核心职责配合MySQL完成数据持久化形成了经典的三层架构。这种组合虽然不如Spring Boot便捷但能清晰展现HTTP请求从Tomcat到Java方法再到数据库的完整链路对于初学者掌握Web应用运行原理具有不可替代的价值。在实际工程中个人博客系统正是这一技术栈的典型落地场景涵盖登录注册、文章发布、分类评论等完整模块。然而从数据库脚本导入到中文乱码排查再到Tomcat部署每一步都可能成为新手绕不开的坎。本文以JavaWeb个人博客系统为例系统讲解其项目结构、数据库设计、环境配置与常见问题修复帮助读者快速跑通一个可用的全栈项目。1. 个人博客系统从零搭一个能跑的 JavaWeb 项目值不值得下载我拆过不少学生毕设和练手项目说实话很多标题写着「个人博客系统」的压缩包打开一看要么是代码缺文件要么就是数据库脚本和代码对不上。但这个基于 JavaWeb 的个人博客系统设计与实现属于那种「拿过来能跑、改一改能交」的类型。它解决的核心问题是作为一个典型的 JavaWeb 全栈练手项目怎么把前端页面、后端 Servlet、数据库表设计、评论和分类这些模块串成一条完整的链路。适合正在做课程设计、毕业设计或者想补一遍 JavaWeb 基础的人。这个项目最大的价值不是代码量而是结构登录注册、文章发布、分类归档、评论管理该有的模块都在。你不需要从零去纠结过滤器怎么配、分页怎么做直接看它怎么写的比自己闷头造轮子快得多。当然拆项目嘛坑也不少后面我会把数据库编码、依赖冲突这些坑一一挑出来。2. 项目结构和技术选型先看懂它的骨架再动手2.1 Servlet JSP MySQL为什么这套组合还在被大规模使用网上现在铺天盖地都是 Spring Boot 的教程但课程设计和毕业设计里纯 JavaWeb 的 Servlet JSP 方案依然占很大比例。原因很直接一是学校课程大纲还没更新到 Spring Boot二是 Servlet 方案能让你看清 HTTP 请求从 Tomcat 到 Java 方法再到页面的完整路径不会被框架的自动配置遮住关键环节。说白了框架玩得再花ServletRequest、ServletResponse、Session 这些底子还是 Servlet 那套东西。这个博客系统的技术栈非常典型层级技术选型作用Web 容器Tomcat 8.5运行 Servlet 和 JSP后端Java Servlet JSP JSTL处理请求、渲染页面数据库MySQL 5.7存储文章、用户、评论数据JDBC 封装DBUtils 或手写 DAO简化数据库操作前端HTML CSS JavaScript Bootstrap页面布局和交互构建Maven 或手动导包依赖管理和打包选这套组合还有一个隐性好处部署环境要求低。只要机器上有 JDK 8 和 Tomcat不需要装 Maven 中央仓库里那一大堆依赖把 war 包丢进 Tomcat 的 webapps 目录就能跑。对于学校里只有一台旧电脑、装不起 IDEA 旗舰版的人来说Eclipse Tomcat 插件就能完成全部开发。2.2 解压之后先看哪几个文件源码包的正确打开顺序下载下来的 zip 包里面通常包含完整工程目录和数据库脚本。但是很多同学一解压就急着双击.sql文件导入数据库结果导入失败或者中文乱码到后面才痛苦。我一般会按这个顺序检查# 假设项目解压在 D:\blog-system cd D:\blog-system ls -la # 重点关注这几个目录/文件通常都会存在 # src/main/java - Java 源码按包名分好 # src/main/webapp - JSP、CSS、JS、图片 # sql/blog.sql 或者 database/blog.sql - 建库建表脚本 # pom.xml 或 README.md - 依赖说明和启动步骤先不要急着跑手动确认三件事第一数据库脚本文件用的是什么字符集。用编辑器打开看第一行有没有SET NAMES utf8mb4或CREATE DATABASE ... DEFAULT CHARACTER SET utf8mb4。如果没有麻烦在后面。第二数据库连接配置在哪。一般会在src/main/resources/db.properties或src/main/java下的一个工具类里找jdbc:mysql://localhost:3306/这样的字符串。第三Tomcat 版本。如果项目的web.xml头声明是 Servlet 3.1那至少得 Tomcat 8 及以上如果是 2.5Tomcat 7 也能跑。这个顺序能帮你把「项目跑不起来」的问题从环境因素里先剥离掉。很多人翻车就是因为跳过了第一步直接启动 Tomcat然后报 ClassNotFoundException回头查半天才发现是数据库脚本没导入。2.3 数据库表设计五张表撑起一个博客系统的核心逻辑博客系统的数据库设计其实大同小异。这个项目里通常会有这么几张表用户表、文章表、分类表、评论表有的还会加标签表和友链表。我拆过的版本里核心表大概是这样-- 用户表 CREATE TABLE t_user ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(255) NOT NULL, -- 建议是 MD5 或 BCrypt 后的密文 nickname VARCHAR(50), create_time DATETIME DEFAULT CURRENT_TIMESTAMP ); -- 文章表 CREATE TABLE t_article ( id INT PRIMARY KEY AUTO_INCREMENT, title VARCHAR(200) NOT NULL, content MEDIUMTEXT NOT NULL, category_id INT, user_id INT, view_count INT DEFAULT 0, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, KEY idx_category (category_id), KEY idx_user (user_id) ); -- 分类表 CREATE TABLE t_category ( id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(50) NOT NULL UNIQUE ); -- 评论表 CREATE TABLE t_comment ( id INT PRIMARY KEY AUTO_INCREMENT, article_id INT NOT NULL, user_id INT, content VARCHAR(500) NOT NULL, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, KEY idx_article (article_id) );这里有个细节值得注意评论表推荐用article_id建索引因为博客首页或文章详情页最常见的操作就是「查某篇文章下的所有评论」。不建索引的话数据量到几千条的时候页面加载就会明显变慢。这个项目里如果没建你可以自己加上算是一个低成本高收益的优化。外键这块很多教材强调要加 FOREIGN KEY但实际项目里尤其是这种学生项目不加外键反而省心。原因是插入数据时要维护外键约束报错信息也不友好。用逻辑外键只是存一个user_id查询时 JOIN完全够用性能还更好。这个观点可能和教科书相反但在真实开发中很实用。3. 从部署到跑通数据库导入、项目配置和启动全步骤3.1 本地环境准备JDK、Tomcat、MySQL 的版本搭配先明确版本搭配不然一会儿报错一会儿又要重装组件推荐版本说明JDK1.8项目如果是更早写的JDK 11 可能编译报错Tomcat8.5兼容 JDK 1.8 和 Servlet 3.1MySQL5.7 或 8.08.0 要注意驱动版本Navicat / MySQL Workbench任意导入 sql 用MySQL 8.0 的驱动是com.mysql.cj.jdbc.Driver5.7 及以前是com.mysql.jdbc.Driver。如果项目里用的是老驱动但你的数据库是 8.0启动时大概率会报 ClassNotFoundException需要在pom.xml或 lib 里换成新驱动同时把 URL 改成jdbc:mysql://localhost:3306/blog?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf8。很多跑不通的情况就是栽在这条 URL 上。3.2 导入数据库脚本解决「导入失败」和「中文乱码」两个老大难数据库导入是整个过程中翻车率最高的一步。先看这个脚本头部的示例-- 如果脚本没有这些请手动执行前两行 CREATE DATABASE IF NOT EXISTS blog DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE blog; SET NAMES utf8mb4; SET FOREIGN_KEY_CHECKS 0; -- 下面是建表语句...命令行导入方式如下mysql -u root -p blog.sql如果你是 Windows 环境注意命令行的编码问题。先执行chcp 65001切到 UTF-8 代码页再导入否则脚本里的中文注释会变成乱码。导入完成后务必执行下面这条验证语句SELECT table_name, table_collation FROM information_schema.tables WHERE table_schema blog;如果看到utf8mb4_general_ci或utf8mb4_unicode_ci说明表字符集没问题如果出现latin1_swedish_ci那文章里写中文肯定会存乱码。这时候不要手动一张张改直接删库重新建把CREATE DATABASE那句加上DEFAULT CHARACTER SET utf8mb4再导一次。3.3 修改数据库连接配置JdbcUtils 类或 properties 文件连接数据库的配置一般写在两个地方。一是src/main/resources/db.properties二是某个JdbcUtils.java类里的静态代码块。先找到它再用编辑器打开# db.properties 典型内容 jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/blog?useSSLfalsecharacterEncodingutf8 jdbc.usernameroot jdbc.password123456如果项目没有 properties 文件配置会写在JdbcUtils的静态块里static { try { Class.forName(com.mysql.jdbc.Driver); // 注意 MySQL 8.0 驱动要换成 com.mysql.cj.jdbc.Driver String url jdbc:mysql://localhost:3306/blog?useSSLfalsecharacterEncodingutf8; conn DriverManager.getConnection(url, root, 123456); } catch (Exception e) { e.printStackTrace(); } }密码改成你自己本机的 MySQL root 密码。然后有个小习惯把characterEncodingutf8这个参数写成utf8mb4更好。虽然大多数情况下一个字节能存下中文但遇到特殊符号比如 emoji 就崩了。既然表已经建成了 utf8mb4连接也建议保持一致。3.4 部署到 Tomcat 并启动排除端口占用和 ClassNotFoundException部署这一步Eclipse 用户直接把项目 Import 成 Dynamic Web Project然后右键 Run On Server。IDEA 用户则要配置好 Tomcat 路径。如果你是命令行选手可以直接用 Maven 打 war 包# 如果有 pom.xml mvn clean package -DskipTests # 打出的 war 包在 target/blog.war复制到 Tomcat 的 webapps 下 cp target/blog.war /path/to/tomcat/webapps/ # 启动 Tomcat /path/to/tomcat/bin/startup.sh启动后观察日志/path/to/tomcat/logs/catalina.outtail -f /path/to/tomcat/logs/catalina.out看到Deploying web application archive和Deployment of web application archive ... has finished in xxx ms就说明部署成功。然后浏览器访问http://localhost:8080/blog/。常见报错和处理方式Address already in use: JVM_Bind8080 端口被占了。要么改 Tomcat 的server.xml端口要么把占用进程干掉。Windows 下用netstat -ano | findstr 8080查到 PID 再taskkill /PID xxx /F。ClassNotFoundException: com.mysql.jdbc.DriverMySQL 驱动 jar 没放进 Tomcat。确认WEB-INF/lib下有没有mysql-connector-java-xxx.jar。用 Maven 的话检查pom.xml的依赖。常见坑新手必踩。HTTP 404部署成功但资源路径不对。可能是项目访问路径和文件名不一致检查http://localhost:8080/项目名/login.jsp这种路径。3.5 验证核心功能注册、登录、发文章、评论的测试路径项目跑起来后不要急着浏览所有页面先按用户视角把核心链路走一遍打开首页看文章列表是否加载分类导航是否显示。注册一个新账号然后退出用新账号登录。进入后台管理新建分类如果有发布一篇带中文标题和中文正文的文章。回前台首页找刚才发的文章点进去看正文显示是否正常、有没有乱码。在文章底部发一条评论刷新页面确认评论存在。在这些步骤里第 4 步最容易出问题。如果正文是乱码先关掉浏览器缓存重新刷新还不行的话检查 JSP 页面头部的pageEncoding% page languagejava contentTypetext/html; charsetUTF-8 pageEncodingUTF-8%如果这一行写的是GBK或ISO-8859-1跟数据库的 utf8mb4 一冲突中文必乱。这种问题基本都在 JSP 的编码设置上按照上面这行改好一般就能解决。4. 常见问题排查个人博客系统跑不起来的三类根源4.1 数据库脚本导入时报错SQL 语法异常现象导入.sql文件时命令行提示ERROR 1064 (42000)之类的语法错误。原因大部分情况是 MySQL 版本不兼容比如AUTO_INCREMENT从 MySQL 5.7 到 8.0 一直没变但有些脚本里用了TYPEInnoDB这种老写法5.7 以后就不再支持必须改成ENGINEInnoDB。还有可能是脚本里有DELIMITER $$的存储过程写法而你没有用命令行而是用了某个图形工具执行导致的。一个更隐蔽的原因是编码问题——如果脚本文件本身是 GBK 编码里面有中文注释导入时被解析成全角字符容易误判语法。解决用编辑器比如 VS Code打开脚本文件把编码批量转成 UTF-8 保存再重新导入。如果脚本里有TYPE全局替换成ENGINE。用命令行导入并且执行前先chcp 65001切编码。4.2 部署后访问所有页面都 404虚拟路径和 web.xml 对不上现象Tomcat 启动正常但访问http://localhost:8080/blog/index.jsp返回 404其他页面也一样。原因项目在 Tomcat 里部署的应用名和你访问的路径不一致。比如 war 包叫blog_1.war那访问路径应该是/blog_1/不是/blog/。还有一种原因是项目不是打包部署而是直接把源码目录放进了 webapps但目录里没有WEB-INF/web.xml或者编译输出的 classes 没生成。解决先用ls /path/to/tomcat/webapps/看下实际部署的文件夹名。再访问/实际文件夹名/index.jsp。如果 classes 没生成回到 IDE 重新 Build Project或者在 Tomcat 的 context 配置里指定 docBase 路径。这里有个很实用的调试技巧启动时看控制台的Catalina.start Server startup in之前的日志里面有Deploying web application archive [xxxx.war]会直接告诉你应用名是什么。4.3 中文乱码从数据库到浏览器层层排查现象页面上的中文全部变成???或者数据库表里能看到中文但页面上全是乱码。原因字符集在「数据库 → 连接 → JSP 页面」三层的某一层断了。最常见的是t_article表是 utf8mb4但连接串没带characterEncoding参数JDBC 默认按系统编码传字符串Windows 中文系统默认往往不是 UTF-8于是写入和读取都乱。另一个常见情况是 JSP 页面本身用了GBK编码但浏览器按 UTF-8 解析。解决分三层检查。第一层验证数据库SHOW VARIABLES LIKE character_set_database;确认是utf8mb4。第二层看连接串必须有characterEncodingutf8或utf8mb4。第三层看 JSP 文件头三个属性language、contentType、pageEncoding是否统一是 UTF-8。顺带提一个容易忽略的点如果项目里配了 Filter定义编码的过滤器一定要做成setCharacterEncoding(UTF-8)并且在过滤链里放在最前。很多项目自带一个EncodingFilter但放在其他过滤器之后就没效果了。这三类问题基本覆盖了「跑不起来」的九成场景。遇到报错不要慌先看控制台完整堆栈再按这三条路对号入座。5. 进阶技巧给项目加上明文密码校验和简单访问统计5.1 改造登录逻辑从固定账号到动态校验如果你拿到的源码里登录是写死用户名密码在硬编码里或者全部用户共用一套admin/123456我建议你改成查表校验。这段代码放在登录的 Servlet 里User user userDao.findByUsername(username); if (user ! null user.getPassword().equals(md5(password))) { // 登录成功写入 Session session.setAttribute(loginUser, user); response.sendRedirect(index.jsp); } else { request.setAttribute(errorMsg, 用户名或密码错误); request.getRequestDispatcher(login.jsp).forward(request, response); }逻辑说明先从数据库查出该用户名对应的用户对象再用 MD5 后的输入密码和库里密文比对。这样做的好处是即使数据库被拖走攻击者拿到的也是密文而不是明文。参数说明password参数来自request.getParameter(password)。如果你的库里存的是明文那 equals 后一半就直接比对如果原来是加密存储第一次测试时很可能因为算法不一致导致登录失败。踩坑建议先手动在数据库里生成一条正确的密文再用这组账号登录排除算法问题。5.2 增加浏览量统计一个字段加一段 SQL 的事很多个人博客系统只做了文章表但没有浏览量统计。如果你想要这个功能改造量非常小。在t_article表加一个view_count字段ALTER TABLE t_article ADD COLUMN view_count INT NOT NULL DEFAULT 0;然后在文章详情页的 Servlet 里每次请求文章详情时 1int articleId Integer.parseInt(request.getParameter(id)); articleDao.increaseViewCount(articleId); Article article articleDao.findById(articleId);increaseViewCount对应的 SQL 是UPDATE t_article SET view_count view_count 1 WHERE id ?;实现上既有更新又有查询但速度完全可接受。这里有个实际开发中的取舍真正高并发的博客系统不会这么做因为每次点击都更新一条记录数据库压力大一般用 Redis 做计数器然后定期刷回 MySQL。但对于课程设计和日均几十次访问的个人博客这种朴素做法反而更好理解。把这个字段加到前台首页的文章列表顺便还能按浏览量降序排序SELECT * FROM t_article ORDER BY view_count DESC LIMIT 6;这样首页就能展示「热门文章」区块了算是一个看得见的加分项。5.3 访问统计一个 Filter 搞定全站计数如果你想让页面底部显示「本站被访问 N 次」可以写一个VisitCountFilterpublic class VisitCountFilter implements Filter { private int visitCount 0; public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException { visitCount; request.setAttribute(visitCount, visitCount); chain.doFilter(request, response); } }然后在web.xml里配置对所有请求生效filter filter-nameVisitCountFilter/filter-name filter-classcom.blog.filter.VisitCountFilter/filter-class /filter filter-mapping filter-nameVisitCountFilter/filter-name url-pattern/*/url-pattern /filter-mapping这里要提醒一个细节如果统计频率是计数而不是 PV只靠一个类变量在内存里累加Tomcat 一重启就清零而且多实例部署时会各算各的。更稳的做法是把计数写进一张单独的表或者用 ServletContext 存初始值从数据库读取。但对于课程设计来说Filter 加内存变量往往已经够交差了。我习惯的做法是每加一个这种小功能都会顺手写一个 Readme 文件记录改动点比如「加了 view_count 字段对应 SQL 在 sql-update.txt 里改了文章详情 Servlet」。因为这种项目放一个月后再回头看你会完全忘记自己改过哪里。从那以后我每拆一个源码包都会先记录原始状态再动手改避免最后交作业时连自己都说不清哪些是原创、哪些是从原项目里修出来的。希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/10/8 10:44:03 · 阅读 1.2k JavaWeb个人博客系统从零搭建：Servlet+JSP+MySQL部署全攻略
简介JavaWeb开发是理解后端技术栈的基础路径其中Servlet与JSP承担了请求处理与页面渲染的核心职责配合MySQL完成数据持久化形成了经典的三层架构。这种组合虽然不如Spring Boot便捷但能清晰展现HTTP请求从Tomcat到Java方法再到数据库的完整链路对于初学者掌握Web应用运行原理具有不可替代的价值。在实际工程中个人博客系统正是这一技术栈的典型落地场景涵盖登录注册、文章发布、分类评论等完整模块。然而从数据库脚本导入到中文乱码排查再到Tomcat部署每一步都可能成为新手绕不开的坎。本文以JavaWeb个人博客系统为例系统讲解其项目结构、数据库设计、环境配置与常见问题修复帮助读者快速跑通一个可用的全栈项目。1. 个人博客系统从零搭一个能跑的 JavaWeb 项目值不值得下载我拆过不少学生毕设和练手项目说实话很多标题写着「个人博客系统」的压缩包打开一看要么是代码缺文件要么就是数据库脚本和代码对不上。但这个基于 JavaWeb 的个人博客系统设计与实现属于那种「拿过来能跑、改一改能交」的类型。它解决的核心问题是作为一个典型的 JavaWeb 全栈练手项目怎么把前端页面、后端 Servlet、数据库表设计、评论和分类这些模块串成一条完整的链路。适合正在做课程设计、毕业设计或者想补一遍 JavaWeb 基础的人。这个项目最大的价值不是代码量而是结构登录注册、文章发布、分类归档、评论管理该有的模块都在。你不需要从零去纠结过滤器怎么配、分页怎么做直接看它怎么写的比自己闷头造轮子快得多。当然拆项目嘛坑也不少后面我会把数据库编码、依赖冲突这些坑一一挑出来。2. 项目结构和技术选型先看懂它的骨架再动手2.1 Servlet JSP MySQL为什么这套组合还在被大规模使用网上现在铺天盖地都是 Spring Boot 的教程但课程设计和毕业设计里纯 JavaWeb 的 Servlet JSP 方案依然占很大比例。原因很直接一是学校课程大纲还没更新到 Spring Boot二是 Servlet 方案能让你看清 HTTP 请求从 Tomcat 到 Java 方法再到页面的完整路径不会被框架的自动配置遮住关键环节。说白了框架玩得再花ServletRequest、ServletResponse、Session 这些底子还是 Servlet 那套东西。这个博客系统的技术栈非常典型层级技术选型作用Web 容器Tomcat 8.5运行 Servlet 和 JSP后端Java Servlet JSP JSTL处理请求、渲染页面数据库MySQL 5.7存储文章、用户、评论数据JDBC 封装DBUtils 或手写 DAO简化数据库操作前端HTML CSS JavaScript Bootstrap页面布局和交互构建Maven 或手动导包依赖管理和打包选这套组合还有一个隐性好处部署环境要求低。只要机器上有 JDK 8 和 Tomcat不需要装 Maven 中央仓库里那一大堆依赖把 war 包丢进 Tomcat 的 webapps 目录就能跑。对于学校里只有一台旧电脑、装不起 IDEA 旗舰版的人来说Eclipse Tomcat 插件就能完成全部开发。2.2 解压之后先看哪几个文件源码包的正确打开顺序下载下来的 zip 包里面通常包含完整工程目录和数据库脚本。但是很多同学一解压就急着双击.sql文件导入数据库结果导入失败或者中文乱码到后面才痛苦。我一般会按这个顺序检查# 假设项目解压在 D:\blog-system cd D:\blog-system ls -la # 重点关注这几个目录/文件通常都会存在 # src/main/java - Java 源码按包名分好 # src/main/webapp - JSP、CSS、JS、图片 # sql/blog.sql 或者 database/blog.sql - 建库建表脚本 # pom.xml 或 README.md - 依赖说明和启动步骤先不要急着跑手动确认三件事第一数据库脚本文件用的是什么字符集。用编辑器打开看第一行有没有SET NAMES utf8mb4或CREATE DATABASE ... DEFAULT CHARACTER SET utf8mb4。如果没有麻烦在后面。第二数据库连接配置在哪。一般会在src/main/resources/db.properties或src/main/java下的一个工具类里找jdbc:mysql://localhost:3306/这样的字符串。第三Tomcat 版本。如果项目的web.xml头声明是 Servlet 3.1那至少得 Tomcat 8 及以上如果是 2.5Tomcat 7 也能跑。这个顺序能帮你把「项目跑不起来」的问题从环境因素里先剥离掉。很多人翻车就是因为跳过了第一步直接启动 Tomcat然后报 ClassNotFoundException回头查半天才发现是数据库脚本没导入。2.3 数据库表设计五张表撑起一个博客系统的核心逻辑博客系统的数据库设计其实大同小异。这个项目里通常会有这么几张表用户表、文章表、分类表、评论表有的还会加标签表和友链表。我拆过的版本里核心表大概是这样-- 用户表 CREATE TABLE t_user ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(255) NOT NULL, -- 建议是 MD5 或 BCrypt 后的密文 nickname VARCHAR(50), create_time DATETIME DEFAULT CURRENT_TIMESTAMP ); -- 文章表 CREATE TABLE t_article ( id INT PRIMARY KEY AUTO_INCREMENT, title VARCHAR(200) NOT NULL, content MEDIUMTEXT NOT NULL, category_id INT, user_id INT, view_count INT DEFAULT 0, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, update_time DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, KEY idx_category (category_id), KEY idx_user (user_id) ); -- 分类表 CREATE TABLE t_category ( id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(50) NOT NULL UNIQUE ); -- 评论表 CREATE TABLE t_comment ( id INT PRIMARY KEY AUTO_INCREMENT, article_id INT NOT NULL, user_id INT, content VARCHAR(500) NOT NULL, create_time DATETIME DEFAULT CURRENT_TIMESTAMP, KEY idx_article (article_id) );这里有个细节值得注意评论表推荐用article_id建索引因为博客首页或文章详情页最常见的操作就是「查某篇文章下的所有评论」。不建索引的话数据量到几千条的时候页面加载就会明显变慢。这个项目里如果没建你可以自己加上算是一个低成本高收益的优化。外键这块很多教材强调要加 FOREIGN KEY但实际项目里尤其是这种学生项目不加外键反而省心。原因是插入数据时要维护外键约束报错信息也不友好。用逻辑外键只是存一个user_id查询时 JOIN完全够用性能还更好。这个观点可能和教科书相反但在真实开发中很实用。3. 从部署到跑通数据库导入、项目配置和启动全步骤3.1 本地环境准备JDK、Tomcat、MySQL 的版本搭配先明确版本搭配不然一会儿报错一会儿又要重装组件推荐版本说明JDK1.8项目如果是更早写的JDK 11 可能编译报错Tomcat8.5兼容 JDK 1.8 和 Servlet 3.1MySQL5.7 或 8.08.0 要注意驱动版本Navicat / MySQL Workbench任意导入 sql 用MySQL 8.0 的驱动是com.mysql.cj.jdbc.Driver5.7 及以前是com.mysql.jdbc.Driver。如果项目里用的是老驱动但你的数据库是 8.0启动时大概率会报 ClassNotFoundException需要在pom.xml或 lib 里换成新驱动同时把 URL 改成jdbc:mysql://localhost:3306/blog?useSSLfalseserverTimezoneAsia/ShanghaicharacterEncodingutf8。很多跑不通的情况就是栽在这条 URL 上。3.2 导入数据库脚本解决「导入失败」和「中文乱码」两个老大难数据库导入是整个过程中翻车率最高的一步。先看这个脚本头部的示例-- 如果脚本没有这些请手动执行前两行 CREATE DATABASE IF NOT EXISTS blog DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; USE blog; SET NAMES utf8mb4; SET FOREIGN_KEY_CHECKS 0; -- 下面是建表语句...命令行导入方式如下mysql -u root -p blog.sql如果你是 Windows 环境注意命令行的编码问题。先执行chcp 65001切到 UTF-8 代码页再导入否则脚本里的中文注释会变成乱码。导入完成后务必执行下面这条验证语句SELECT table_name, table_collation FROM information_schema.tables WHERE table_schema blog;如果看到utf8mb4_general_ci或utf8mb4_unicode_ci说明表字符集没问题如果出现latin1_swedish_ci那文章里写中文肯定会存乱码。这时候不要手动一张张改直接删库重新建把CREATE DATABASE那句加上DEFAULT CHARACTER SET utf8mb4再导一次。3.3 修改数据库连接配置JdbcUtils 类或 properties 文件连接数据库的配置一般写在两个地方。一是src/main/resources/db.properties二是某个JdbcUtils.java类里的静态代码块。先找到它再用编辑器打开# db.properties 典型内容 jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/blog?useSSLfalsecharacterEncodingutf8 jdbc.usernameroot jdbc.password123456如果项目没有 properties 文件配置会写在JdbcUtils的静态块里static { try { Class.forName(com.mysql.jdbc.Driver); // 注意 MySQL 8.0 驱动要换成 com.mysql.cj.jdbc.Driver String url jdbc:mysql://localhost:3306/blog?useSSLfalsecharacterEncodingutf8; conn DriverManager.getConnection(url, root, 123456); } catch (Exception e) { e.printStackTrace(); } }密码改成你自己本机的 MySQL root 密码。然后有个小习惯把characterEncodingutf8这个参数写成utf8mb4更好。虽然大多数情况下一个字节能存下中文但遇到特殊符号比如 emoji 就崩了。既然表已经建成了 utf8mb4连接也建议保持一致。3.4 部署到 Tomcat 并启动排除端口占用和 ClassNotFoundException部署这一步Eclipse 用户直接把项目 Import 成 Dynamic Web Project然后右键 Run On Server。IDEA 用户则要配置好 Tomcat 路径。如果你是命令行选手可以直接用 Maven 打 war 包# 如果有 pom.xml mvn clean package -DskipTests # 打出的 war 包在 target/blog.war复制到 Tomcat 的 webapps 下 cp target/blog.war /path/to/tomcat/webapps/ # 启动 Tomcat /path/to/tomcat/bin/startup.sh启动后观察日志/path/to/tomcat/logs/catalina.outtail -f /path/to/tomcat/logs/catalina.out看到Deploying web application archive和Deployment of web application archive ... has finished in xxx ms就说明部署成功。然后浏览器访问http://localhost:8080/blog/。常见报错和处理方式Address already in use: JVM_Bind8080 端口被占了。要么改 Tomcat 的server.xml端口要么把占用进程干掉。Windows 下用netstat -ano | findstr 8080查到 PID 再taskkill /PID xxx /F。ClassNotFoundException: com.mysql.jdbc.DriverMySQL 驱动 jar 没放进 Tomcat。确认WEB-INF/lib下有没有mysql-connector-java-xxx.jar。用 Maven 的话检查pom.xml的依赖。常见坑新手必踩。HTTP 404部署成功但资源路径不对。可能是项目访问路径和文件名不一致检查http://localhost:8080/项目名/login.jsp这种路径。3.5 验证核心功能注册、登录、发文章、评论的测试路径项目跑起来后不要急着浏览所有页面先按用户视角把核心链路走一遍打开首页看文章列表是否加载分类导航是否显示。注册一个新账号然后退出用新账号登录。进入后台管理新建分类如果有发布一篇带中文标题和中文正文的文章。回前台首页找刚才发的文章点进去看正文显示是否正常、有没有乱码。在文章底部发一条评论刷新页面确认评论存在。在这些步骤里第 4 步最容易出问题。如果正文是乱码先关掉浏览器缓存重新刷新还不行的话检查 JSP 页面头部的pageEncoding% page languagejava contentTypetext/html; charsetUTF-8 pageEncodingUTF-8%如果这一行写的是GBK或ISO-8859-1跟数据库的 utf8mb4 一冲突中文必乱。这种问题基本都在 JSP 的编码设置上按照上面这行改好一般就能解决。4. 常见问题排查个人博客系统跑不起来的三类根源4.1 数据库脚本导入时报错SQL 语法异常现象导入.sql文件时命令行提示ERROR 1064 (42000)之类的语法错误。原因大部分情况是 MySQL 版本不兼容比如AUTO_INCREMENT从 MySQL 5.7 到 8.0 一直没变但有些脚本里用了TYPEInnoDB这种老写法5.7 以后就不再支持必须改成ENGINEInnoDB。还有可能是脚本里有DELIMITER $$的存储过程写法而你没有用命令行而是用了某个图形工具执行导致的。一个更隐蔽的原因是编码问题——如果脚本文件本身是 GBK 编码里面有中文注释导入时被解析成全角字符容易误判语法。解决用编辑器比如 VS Code打开脚本文件把编码批量转成 UTF-8 保存再重新导入。如果脚本里有TYPE全局替换成ENGINE。用命令行导入并且执行前先chcp 65001切编码。4.2 部署后访问所有页面都 404虚拟路径和 web.xml 对不上现象Tomcat 启动正常但访问http://localhost:8080/blog/index.jsp返回 404其他页面也一样。原因项目在 Tomcat 里部署的应用名和你访问的路径不一致。比如 war 包叫blog_1.war那访问路径应该是/blog_1/不是/blog/。还有一种原因是项目不是打包部署而是直接把源码目录放进了 webapps但目录里没有WEB-INF/web.xml或者编译输出的 classes 没生成。解决先用ls /path/to/tomcat/webapps/看下实际部署的文件夹名。再访问/实际文件夹名/index.jsp。如果 classes 没生成回到 IDE 重新 Build Project或者在 Tomcat 的 context 配置里指定 docBase 路径。这里有个很实用的调试技巧启动时看控制台的Catalina.start Server startup in之前的日志里面有Deploying web application archive [xxxx.war]会直接告诉你应用名是什么。4.3 中文乱码从数据库到浏览器层层排查现象页面上的中文全部变成???或者数据库表里能看到中文但页面上全是乱码。原因字符集在「数据库 → 连接 → JSP 页面」三层的某一层断了。最常见的是t_article表是 utf8mb4但连接串没带characterEncoding参数JDBC 默认按系统编码传字符串Windows 中文系统默认往往不是 UTF-8于是写入和读取都乱。另一个常见情况是 JSP 页面本身用了GBK编码但浏览器按 UTF-8 解析。解决分三层检查。第一层验证数据库SHOW VARIABLES LIKE character_set_database;确认是utf8mb4。第二层看连接串必须有characterEncodingutf8或utf8mb4。第三层看 JSP 文件头三个属性language、contentType、pageEncoding是否统一是 UTF-8。顺带提一个容易忽略的点如果项目里配了 Filter定义编码的过滤器一定要做成setCharacterEncoding(UTF-8)并且在过滤链里放在最前。很多项目自带一个EncodingFilter但放在其他过滤器之后就没效果了。这三类问题基本覆盖了「跑不起来」的九成场景。遇到报错不要慌先看控制台完整堆栈再按这三条路对号入座。5. 进阶技巧给项目加上明文密码校验和简单访问统计5.1 改造登录逻辑从固定账号到动态校验如果你拿到的源码里登录是写死用户名密码在硬编码里或者全部用户共用一套admin/123456我建议你改成查表校验。这段代码放在登录的 Servlet 里User user userDao.findByUsername(username); if (user ! null user.getPassword().equals(md5(password))) { // 登录成功写入 Session session.setAttribute(loginUser, user); response.sendRedirect(index.jsp); } else { request.setAttribute(errorMsg, 用户名或密码错误); request.getRequestDispatcher(login.jsp).forward(request, response); }逻辑说明先从数据库查出该用户名对应的用户对象再用 MD5 后的输入密码和库里密文比对。这样做的好处是即使数据库被拖走攻击者拿到的也是密文而不是明文。参数说明password参数来自request.getParameter(password)。如果你的库里存的是明文那 equals 后一半就直接比对如果原来是加密存储第一次测试时很可能因为算法不一致导致登录失败。踩坑建议先手动在数据库里生成一条正确的密文再用这组账号登录排除算法问题。5.2 增加浏览量统计一个字段加一段 SQL 的事很多个人博客系统只做了文章表但没有浏览量统计。如果你想要这个功能改造量非常小。在t_article表加一个view_count字段ALTER TABLE t_article ADD COLUMN view_count INT NOT NULL DEFAULT 0;然后在文章详情页的 Servlet 里每次请求文章详情时 1int articleId Integer.parseInt(request.getParameter(id)); articleDao.increaseViewCount(articleId); Article article articleDao.findById(articleId);increaseViewCount对应的 SQL 是UPDATE t_article SET view_count view_count 1 WHERE id ?;实现上既有更新又有查询但速度完全可接受。这里有个实际开发中的取舍真正高并发的博客系统不会这么做因为每次点击都更新一条记录数据库压力大一般用 Redis 做计数器然后定期刷回 MySQL。但对于课程设计和日均几十次访问的个人博客这种朴素做法反而更好理解。把这个字段加到前台首页的文章列表顺便还能按浏览量降序排序SELECT * FROM t_article ORDER BY view_count DESC LIMIT 6;这样首页就能展示「热门文章」区块了算是一个看得见的加分项。5.3 访问统计一个 Filter 搞定全站计数如果你想让页面底部显示「本站被访问 N 次」可以写一个VisitCountFilterpublic class VisitCountFilter implements Filter { private int visitCount 0; public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException { visitCount; request.setAttribute(visitCount, visitCount); chain.doFilter(request, response); } }然后在web.xml里配置对所有请求生效filter filter-nameVisitCountFilter/filter-name filter-classcom.blog.filter.VisitCountFilter/filter-class /filter filter-mapping filter-nameVisitCountFilter/filter-name url-pattern/*/url-pattern /filter-mapping这里要提醒一个细节如果统计频率是计数而不是 PV只靠一个类变量在内存里累加Tomcat 一重启就清零而且多实例部署时会各算各的。更稳的做法是把计数写进一张单独的表或者用 ServletContext 存初始值从数据库读取。但对于课程设计来说Filter 加内存变量往往已经够交差了。我习惯的做法是每加一个这种小功能都会顺手写一个 Readme 文件记录改动点比如「加了 view_count 字段对应 SQL 在 sql-update.txt 里改了文章详情 Servlet」。因为这种项目放一个月后再回头看你会完全忘记自己改过哪里。从那以后我每拆一个源码包都会先记录原始状态再动手改避免最后交作业时连自己都说不清哪些是原创、哪些是从原项目里修出来的。希望帮到你。本文还有配套的精品资源点击获取