简介一份基于JSP、MySQL与B/S结构开发的九宫格日志网站完整项目包适合Java Web课程设计、毕业设计以及需要参照内容管理型网站做二次开发的读者。项目从管理员、前台首页、普通用户三类视角出发实现日记信息、美食、景点、新闻推荐、日志展示、论坛、留言板、收藏等主要功能并配有设计论文与汇报PPT便于梳理需求分析、功能模块和答辩思路。资料以zip压缩包提供约25.18MB内含项目源码、设计文档及汇报PPT可对照代码理解JSP动态页面、MySQL数据库设计和前后端交互过程。已有58人浏览学习整体内容完整、结构清晰可用于毕业设计选题参考或快速搭建同类网站的学习实践。1. 九宫格日志网站一套能直接跑通的 javaWeb 项目源码很多人做 JSP 课设或毕设时卡住的地方往往不是业务逻辑而是环境——JDK 版本对不上、MySQL 驱动连不上、Tomcat 一启动就 404这些问题我在帮人排查项目时见过太多次。这套基于 JSP MySQL 的九宫格日志网站源码把管理员后台、用户前台、论坛、留言板、新闻推荐全做齐了是一个完整的 B/S 结构 javaWeb 项目附带设计论文和汇报 PPT。适合三类人拿它做毕业设计二次开发的在校生、想跑通 JSP 全链路请求 → Servlet → DAO → 数据库的新手以及需要一套可演示后台管理系统的从业者。下面按我自己的排查顺序从环境配置讲到部署上线把每一处坑都标出来。2. 环境组合与工程结构版本怎么选IDEA 导入后先看哪里2.1 版本选型JDK、Tomcat、MySQL 的搭配逻辑这类 JSP 毕设项目对版本非常敏感我建议直接按下面的组合来不要盲目上新版本。MySQL 8.0 虽然向下兼容但驱动和时区问题会多出一堆JDK 11 以上跑老 Tomcat 偶尔会有模块化报错。最稳的组合是组件推荐版本理由JDK1.88u202JSP Servlet 老项目在 JDK 8 下兼容性最好Tomcat 和 IDE 都不挑Tomcat8.5.x支持 Servlet 3.1支持 WebServlet 注解和 web.xml 两种方式MySQL5.7与旧版 JDBC 驱动配合最省事不需要处理 SSL 和 caching_sha2_passwordMySQL Connector/J5.1.49经典驱动无需配置 serverTimezone适合 5.7 数据库IDEA2020 以后任意版本对 JavaWeb 工程支持完整自带 Tomcat 集成这个项目是典型的 B/S 结构浏览器端负责展示Tomcat 里的 JSP 在服务端渲染页面MySQL 存数据。所谓九宫格日志就是前台首页把日记按 3×3 网格展示每格一张封面图和一个标题点击进入详情。项目分了三个视角——管理员能管所有内容登录用户能发日记和留言游客只能浏览。2.2 IDEA 运行 javaWeb 项目的配置步骤与目录解读拿到源码后不要急着打开先在 IDEA 里按下面的顺序导入。顺序错了容易出现红叉和找不到依赖。打开 IDEA选择File → New → Project from Existing Sources选中项目的根目录。选择Eclipse或Default Model导入方式均可一路 Next 到 SDK 选择界面把 Project SDK 指到本机的 JDK 1.8。导入完成后找到项目里的lib目录或WEB-INF/lib右键Add as Library把 jar 包全部加入 Classpath。打开File → Project Structure → Artifacts点选择Web Application: Exploded保证输出的部署包指向当前项目。配置 TomcatRun → Edit Configurations → → Tomcat Server → Local在Deployment标签页里把上面的 Artifacts 加进去Application context 填/ninegrid。目录结构大致长这样导入后先对照认一遍src/ ├── controller/ # Servlet 控制器接收请求并跳转 ├── service/ # 业务逻辑层处理具体业务规则 ├── dao/ # 数据访问层封装 JDBC 操作 ├── entity/ # 实体类对应数据库表 └── util/ # 公共工具类如 DBUtil、分页 web/ ├── admin/ # 后台管理页面JSP ├── front/ # 前台用户页面JSP ├── index.jsp # 前台首页九宫格核心展示页 ├── WEB-INF/ │ ├── web.xml # 部署描述符配置路由和过滤器 │ └── lib/ # 项目依赖 jar 包 └── static/ # CSS、JS、图片资源很多同学一上来就双击 JSP 文件那肯定跑不起来。JSP 必须由 Tomcat 容器解析本地文件方式只能看到源码。这也是我把 Tomcat 配置放在步骤 5 的原因——没有这一步IDEA 里根本找不到运行入口。2.3 从 web.xml 反推项目骨架不管用什么 IDE 启动 Tomcat 前先打开WEB-INF/web.xml看一遍。这个文件决定了整个项目的路由方式和过滤器链比盲猜代码结构高效得多?xml version1.0 encodingUTF-8? web-app xmlnshttp://xmlns.jcp.org/xml/ns/javaee version3.1 !-- 编码过滤器解决 GET/POST 中文乱码 -- filter filter-nameEncodingFilter/filter-name filter-classutil.EncodingFilter/filter-class init-param param-nameencoding/param-name param-valueUTF-8/param-value /init-param /filter filter-mapping filter-nameEncodingFilter/filter-name url-pattern/*/url-pattern /filter-mapping !-- 欢迎页 -- welcome-file-list welcome-fileindex.jsp/welcome-file /welcome-file-list /web-app看到这个 web.xml你就应该知道两件事第一项目里有编码过滤器页面传参出现乱码时优先检查这里第二如果 web.xml 里没有servlet映射说明 Servlet 用的是WebServlet注解方式去 controller 包里翻一下就能找到路由定义。后台管理员模块一般在admin路径下比如WebServlet(/admin/diaryList)这种写法对应后台的日记信息管理页面。3. 数据库初始化与连接配置SQL 脚本、JDBC 驱动、中文乱码3.1 导入 SQL 脚本并验证表结构源码包里会带一个.sql文件通常叫ninegrid.sql或database.sql这是全项目的地基。先建库再导入mysql -uroot -p create database ninegrid default character set utf8mb4; use ninegrid; source /path/to/ninegrid.sql;导入完成后执行show tables;正常情况下能看到下面这些核心表表名功能对应模块admin管理员账号管理员登录、管理员管理user用户账号用户管理、个人中心diary日记信息九宫格首页、日记信息管理food美食信息美食信息管理scenic景点信息景点信息管理news新闻推荐新闻推荐管理、前台新闻资讯forum / reply论坛帖子与回复论坛管理collect收藏记录我的收藏管理message留言记录留言板管理、留言反馈表结构如果用 Navicat 或 DBeaver 打开看diary表里一般会有title、cover封面图路径、content、publish_time、user_id这几个字段。九宫格首页取的就是cover和title。特别注意cover字段存的是相对路径比如upload/diary01.jpg页面渲染时会在前面拼接项目根路径路径对不上图片就会裂开。3.2 数据库连接参数详解driver、url、时区连接配置一般集中在src/util/DBUtil.java或者db.properties里。老项目最常见的是硬编码在 DBUtil 的静态块中新一点的项目用 properties 文件。我这里以 properties 文件方式说明参数含义drivercom.mysql.jdbc.Driver urljdbc:mysql://localhost:3306/ninegrid?useUnicodetruecharacterEncodingutf8useSSLfalse usernameroot password123456每个参数都有自己的作用按下面的表核对少一个就多一个坑参数作用坑点driver指定 JDBC 驱动类名5.1.x 驱动用com.mysql.jdbc.Driver8.0 驱动要用com.mysql.cj.jdbc.DriveruseUnicodetrue是否使用 Unicode 编码不配会导致中文参数乱码characterEncodingutf8指定传输字符集和数据库字符集、页面 charset 三者必须一致useSSLfalse关闭 SSL 加密连接MySQL 5.7 下不配这个驱动会频繁报警告甚至直接失败serverTimezone指定服务器时区5.1.49 驱动可不配8.0 驱动必须配Asia/Shanghai否则报时区错误连接池在这个项目里一般不会出现JSP 毕设基本都是 DriverManager 直连。资源里自带的 lib 文件夹如果有druid之类连接池 jar那是增强版没有的话就用 JDBC 直连维护成本最低。3.3 用 JDBC 快速验证连接是否正常导入 SQL 并改完密码之后不要在浏览器里碰运气先用一个独立测试类验证连接。写个临时 main 方法跑一下public class ConnectionTest { public static void main(String[] args) { String url jdbc:mysql://localhost:3306/ninegrid?useUnicodetruecharacterEncodingutf8useSSLfalse; try { Class.forName(com.mysql.jdbc.Driver); Connection conn DriverManager.getConnection(url, root, 123456); Statement stmt conn.createStatement(); ResultSet rs stmt.executeQuery(select count(*) from diary); while (rs.next()) { System.out.println(diary 表行数: rs.getInt(1)); } conn.close(); } catch (Exception e) { e.printStackTrace(); } } }Class.forName是在加载驱动类老驱动依赖这种显式注册方式executeQuery返回结果集这里是验证能查到数据库里的记录数。如果这个类能打印出日志表行数说明驱动、URL、账号密码全都没问题接下来项目启动报错就跟数据库无关了。如果报Communications link failure九成是 URL 或驱动版本的问题直接按 5.1.49 驱动配useSSLfalse就能解决。连接验证通过之后记得给 Tomcat 的server.xml里加一句URIEncodingUTF-8这一步很多人会漏——Tomcat 默认用 ISO-8859-1 解码 URL 参数GET 请求的中文到这里就会被拆成乱码。这是 javaWeb 连接 MySQL 项目里最常见的中文坑先补上再说。4. 请求流转与分层实现从点击到返回的完整链路4.1 以登录为例拆解请求处理流程这个项目的请求链路是标准的 JSP 三层结构浏览器请求 → ControllerServlet→ Service → DAO → MySQL然后原路返回 JSP 渲染。以登录为例路由关系一般是请求路径Servlet/方法处理内容/adminLoginAdminLoginServlet校验管理员账号、写入 session、跳后台/userLoginUserLoginServlet校验用户账号、写入 session、跳首页/diaryListDiaryListServlet查询日记列表转发到 index.jsp/admin/diaryManageAdminDiaryServlet后台日记 CRUD看一下管理员登录的典型实现注意 session 的用法WebServlet(/adminLogin) public class AdminLoginServlet extends HttpServlet { protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { req.setCharacterEncoding(UTF-8); String username req.getParameter(username); String password req.getParameter(password); AdminService service new AdminService(); Admin admin service.login(username, password); if (admin ! null) { req.getSession().setAttribute(admin, admin); resp.sendRedirect(req.getContextPath() /admin/index.jsp); } else { req.setAttribute(error, 账号或密码错误); req.getRequestDispatcher(adminLogin.jsp).forward(req, resp); } } }sendRedirect是重定向地址栏会变适合登录成功后的跳转forward是转发保持原地址适合带错误提示返回。这里的 Session key 用的是admin后续后台页面的权限拦截就是检查这个 key 是否存在。用户登录的逻辑完全一样只是 Session key 换成user。这个项目里req.setCharacterEncoding(UTF-8)和 web.xml 的 Filter 是双层保险——过滤器拦了全局Servlet 里再设一次保证 POST 表单在到达业务层前就是正确的编码。4.2 九宫格日记列表的后端组装逻辑首页九宫格的核心是查询最新 9 条日记把封面路径和标题塞进 List再交给 JSP 用 c:forEach 循环渲染。DAO 层的查询通常长这样public ListDiary findLatestNine() { ListDiary list new ArrayListDiary(); String sql select id, title, cover, content, publish_time from diary order by publish_time desc limit 9; try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql); ResultSet rs ps.executeQuery()) { while (rs.next()) { Diary d new Diary(); d.setId(rs.getInt(id)); d.setTitle(rs.getString(title)); d.setCover(rs.getString(cover)); d.setPublishTime(rs.getTimestamp(publish_time)); list.add(d); } } catch (Exception e) { e.printStackTrace(); } return list; }这段代码里的limit 9是九宫格的硬性来源——不管日记有多少条首页只取最近 9 条。try-with-resources会自动关闭连接避免并发场景下连接泄漏。如果想让九宫格的数据动态变化把 SQL 里的order by publish_time desc改成order by like_count desc就能变成热门推荐九宫格这是改造最少的方案。Servlet 拿到这个列表后req.setAttribute(diaryList, diaryList); req.getRequestDispatcher(index.jsp).forward(req, resp);setAttribute把数据放进 request 作用域forward转发给 JSP。JSP 这边负责把 List 循环铺成 3×3 的格子这部分放在 5.1 节详细说。整个链路里前端和后端的分工非常清楚JSP 只负责拿数据、展示数据所有 SQL 都封在 DAO 里。4.3 DAO 层参数化查询与 SQL 注入预防JSP 毕设里最常见的安全隐患是用字符串拼接 SQL尤其是搜索和筛选功能。比如按标题搜索日志如果写成下面这样用户输入 or 11 --就能绕过条件把全表拉出来// 反面写法 String sql select * from diary where title like % keyword %;正确做法是用PreparedStatement的参数占位符public ListDiary searchByTitle(String keyword) { ListDiary list new ArrayListDiary(); String sql select id, title, cover from diary where title like ?; try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql)) { ps.setString(1, % keyword %); ResultSet rs ps.executeQuery(); while (rs.next()) { // 组装对象并添加进 list } } catch (Exception e) { e.printStackTrace(); } return list; }ps.setString(1, ...)的作用是让驱动把参数当作纯字符串处理特殊字符会被转义。这个项目里的用户搜索、论坛关键词查询、后台筛选都要按这个方式写。血泪经验答辩时演示搜索功能如果直接拼接字符串评委随手输个单引号就可能让页面报 SQL 语法错误场面会非常难看。论坛模块的回复功能也走同样的链路提交表单 → Servlet 接收内容 → DAO insert 到reply表 → 查询最新回复列表转发回详情页。整体代码结构是一致的改参数和表名就能复用。5. 前台九宫格布局与后台管理的常见问题排查5.1 九宫格图片坐标定位JSP 里的布局实现很多人搜过“jsp 图片如何对坐标定位”这个需求在九宫格首页特别典型。JSP 本身不负责定位它只是输出 HTML定位交给 CSS。最省事的方式是 flex 布局把 9 张图按每行 3 个排列% taglib prefixc urihttp://java.sun.com/jsp/jstl/core % div classgrid-container c:forEach items${diaryList} vard a classgrid-item href${pageContext.request.contextPath}/diaryDetail?id${d.id} img src${pageContext.request.contextPath}/${d.cover} alt${d.title} span classgrid-title${d.title}/span /a /c:forEach /div.grid-container { width: 960px; display: flex; flex-wrap: wrap; margin: 0 auto; } .grid-item { width: 31%; margin: 1%; position: relative; overflow: hidden; border-radius: 8px; display: block; } .grid-item img { width: 100%; height: 300px; object-fit: cover; display: block; } .grid-item .grid-title { position: absolute; bottom: 0; left: 0; right: 0; background: rgba(0, 0, 0, 0.55); color: #fff; text-align: center; padding: 6px 0; font-size: 14px; }这里的核心是flex-wrap: wrap加width: 31%每行三个超过自动换行正好 3×3。object-fit: cover是个关键属性——图片尺寸不一致时会等比裁剪填充不会把格子撑变形。position: absolute的标题栏是叠加定位的一种形式bottom: 0让它固定在图片底部搜索引擎里说的“坐标定位”一般指的就是这种 absolute 相对父容器定位坐标是top/left/bottom/right的值。${pageContext.request.contextPath}是 JSP 的 EL 表达式取的是项目上下文路径相当于/项目名拼接在封面相对路径前面。这个表达式必须加否则部署到带项目名的路径时图片全部 404。5.2 后台权限边界管理员、用户、游客三个视角这个项目把使用者分成了三层后台管理菜单也因此不同。搞清楚权限边界才知道哪些页面能直接访问、哪些必须拦截角色能做什么入口游客浏览首页九宫格、详情、新闻资讯不登录也能看前台首页注册用户发布日记、管理自己的日记、留言、发帖、收藏前台「我的」模块管理员用户管理、日记/美食/景点/新闻全部 CRUD、论坛管理、留言板管理、系统管理/admin后台权限拦截一般写在一个 AdminFilter 里只拦/admin/*。拦截器的核心逻辑是public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) throws IOException, ServletException { HttpServletRequest request (HttpServletRequest) req; HttpSession session request.getSession(false); if (session ! null session.getAttribute(admin) ! null) { chain.doFilter(req, resp); } else { ((HttpServletResponse) resp).sendRedirect(request.getContextPath() /adminLogin.jsp); } }session.getAttribute(admin)为 null 说明不是管理员直接踢回登录页。这样用户即使手动输入/admin/userManage.jsp也进不去只能看到登录页。前台用户模块的拦截思路一样把admin换成user只拦/front/my/*一类的个人中心路径。5.3 五条高频踩坑记录整理几类最常见的翻车现场每条都是真刀真枪排查过的现象 1Tomcat 启动直接失败控制台报端口被占用。原因上次 IDE 异常退出Tomcat 进程没被杀掉8080 端口被占。解决Windows 下执行netstat -ano | findstr 8080拿到 PID 后taskkill /pid 对应PID /f。从那以后我每次启动前都顺手检查一下端口省得被这个浪费五分钟。现象 2启动后访问首页 404。原因Artifacts 没部署到 Tomcat或者 Application context 配错。解决在 Run 配置的 Deployment 页签确认工件已添加context 填/ninegrid访问地址必须是http://localhost:8080/ninegrid/而不是http://localhost:8080/。现象 3连接数据库报Communications link failure或 SSL 错误。原因lib 里放的是 MySQL 8.0 驱动但数据库是 5.7或者 URL 少了useSSLfalse。解决换成 5.1.49 驱动URL 加上useSSLfalsecharacterEncodingutf8重启 Tomcat。现象 4后台和前台全是中文乱码。原因三层字符集不一致——数据库不是 utf8mb4、JDBC URL 没写characterEncodingutf8、Tomcat connector 没开URIEncodingUTF-8。解决建库语句用default character set utf8mb4URL 补参数server.xml 加 URIEncoding三层对齐后重启。现象 5首页九宫格图片错位或尺寸不齐。原因上传的图片宽高比不一致直接用img原尺寸输出会被拉伸。解决固定容器宽高图片加object-fit: cover如果项目需要兼容老浏览器改成背景图方式background-size: cover效果一样。6. 部署验证与网格进阶war 包导出和移动端适配跑通 IDEA 里的调试模式只是第一步毕设答辩或交付时通常要一个可独立运行的东西。把项目打成 war 包放到 Tomcat 的webapps目录下是最稳妥的交付方式。IDEA 里操作路径File → Project Structure → Artifacts → → Web Application: Archive → 对应模块然后Build → Build Artifacts → 选择 war。打包完成后在项目输出目录一般是out/artifacts/模块名_war/找到.war文件复制到本机 Tomcat 的webapps目录启动 Tomcat 后它会自动解压部署。访问地址就是http://localhost:8080/ninegrid/。部署完成后建议按下面的清单整体走一遍确认没有遗漏验证项操作预期结果首页九宫格访问根路径显示 9 个日记卡片图片正常用户注册登录前台注册新账号并登录登录后能进入个人中心发布日记在「我的」模块写日记并上传封面首页九宫格出现新内容后台管理管理员登录修改一条日记刷新前台后内容变化留言与论坛发一条留言和一个帖子列表出现对应记录退出登录清空 Session 后访问/admin被拦截回登录页这个项目还有一个低成本进阶方向把九宫格改成响应式网格让它在手机上也能看。改动很小CSS Grid 一行就能解决问题.grid-container { display: grid; grid-template-columns: repeat(3, 1fr); gap: 12px; } media (max-width: 768px) { .grid-container { grid-template-columns: repeat(2, 1fr); } }repeat(3, 1fr)表示等分成 3 列media屏幕小于 768px 时自动变成 2 列。这个改动可以让答辩演示多一个亮点代码量只有 8 行风险很低。核心模块都验证过之后再对照附带的论文目录改功能和截图把论文里的系统设计章节和实际代码对应上汇报 PPT 里的架构图可以直接从后台菜单树反推——管理员有哪些功能PPT 就画哪些功能。这套组合拳打完整个项目从代码到文档再到演示就全闭环了。我从那以后每次拿到 JSP 项目都会强制先做三件事确认 JDK 版本、确认数据库驱动、确认三层字符集全部过关再动业务代码。这三步能挡掉九成启动问题希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/10/26 23:52:17 · 阅读 1.2k 九宫格日志网站：JavaWeb毕设源码部署与配置全攻略
简介一份基于JSP、MySQL与B/S结构开发的九宫格日志网站完整项目包适合Java Web课程设计、毕业设计以及需要参照内容管理型网站做二次开发的读者。项目从管理员、前台首页、普通用户三类视角出发实现日记信息、美食、景点、新闻推荐、日志展示、论坛、留言板、收藏等主要功能并配有设计论文与汇报PPT便于梳理需求分析、功能模块和答辩思路。资料以zip压缩包提供约25.18MB内含项目源码、设计文档及汇报PPT可对照代码理解JSP动态页面、MySQL数据库设计和前后端交互过程。已有58人浏览学习整体内容完整、结构清晰可用于毕业设计选题参考或快速搭建同类网站的学习实践。1. 九宫格日志网站一套能直接跑通的 javaWeb 项目源码很多人做 JSP 课设或毕设时卡住的地方往往不是业务逻辑而是环境——JDK 版本对不上、MySQL 驱动连不上、Tomcat 一启动就 404这些问题我在帮人排查项目时见过太多次。这套基于 JSP MySQL 的九宫格日志网站源码把管理员后台、用户前台、论坛、留言板、新闻推荐全做齐了是一个完整的 B/S 结构 javaWeb 项目附带设计论文和汇报 PPT。适合三类人拿它做毕业设计二次开发的在校生、想跑通 JSP 全链路请求 → Servlet → DAO → 数据库的新手以及需要一套可演示后台管理系统的从业者。下面按我自己的排查顺序从环境配置讲到部署上线把每一处坑都标出来。2. 环境组合与工程结构版本怎么选IDEA 导入后先看哪里2.1 版本选型JDK、Tomcat、MySQL 的搭配逻辑这类 JSP 毕设项目对版本非常敏感我建议直接按下面的组合来不要盲目上新版本。MySQL 8.0 虽然向下兼容但驱动和时区问题会多出一堆JDK 11 以上跑老 Tomcat 偶尔会有模块化报错。最稳的组合是组件推荐版本理由JDK1.88u202JSP Servlet 老项目在 JDK 8 下兼容性最好Tomcat 和 IDE 都不挑Tomcat8.5.x支持 Servlet 3.1支持 WebServlet 注解和 web.xml 两种方式MySQL5.7与旧版 JDBC 驱动配合最省事不需要处理 SSL 和 caching_sha2_passwordMySQL Connector/J5.1.49经典驱动无需配置 serverTimezone适合 5.7 数据库IDEA2020 以后任意版本对 JavaWeb 工程支持完整自带 Tomcat 集成这个项目是典型的 B/S 结构浏览器端负责展示Tomcat 里的 JSP 在服务端渲染页面MySQL 存数据。所谓九宫格日志就是前台首页把日记按 3×3 网格展示每格一张封面图和一个标题点击进入详情。项目分了三个视角——管理员能管所有内容登录用户能发日记和留言游客只能浏览。2.2 IDEA 运行 javaWeb 项目的配置步骤与目录解读拿到源码后不要急着打开先在 IDEA 里按下面的顺序导入。顺序错了容易出现红叉和找不到依赖。打开 IDEA选择File → New → Project from Existing Sources选中项目的根目录。选择Eclipse或Default Model导入方式均可一路 Next 到 SDK 选择界面把 Project SDK 指到本机的 JDK 1.8。导入完成后找到项目里的lib目录或WEB-INF/lib右键Add as Library把 jar 包全部加入 Classpath。打开File → Project Structure → Artifacts点选择Web Application: Exploded保证输出的部署包指向当前项目。配置 TomcatRun → Edit Configurations → → Tomcat Server → Local在Deployment标签页里把上面的 Artifacts 加进去Application context 填/ninegrid。目录结构大致长这样导入后先对照认一遍src/ ├── controller/ # Servlet 控制器接收请求并跳转 ├── service/ # 业务逻辑层处理具体业务规则 ├── dao/ # 数据访问层封装 JDBC 操作 ├── entity/ # 实体类对应数据库表 └── util/ # 公共工具类如 DBUtil、分页 web/ ├── admin/ # 后台管理页面JSP ├── front/ # 前台用户页面JSP ├── index.jsp # 前台首页九宫格核心展示页 ├── WEB-INF/ │ ├── web.xml # 部署描述符配置路由和过滤器 │ └── lib/ # 项目依赖 jar 包 └── static/ # CSS、JS、图片资源很多同学一上来就双击 JSP 文件那肯定跑不起来。JSP 必须由 Tomcat 容器解析本地文件方式只能看到源码。这也是我把 Tomcat 配置放在步骤 5 的原因——没有这一步IDEA 里根本找不到运行入口。2.3 从 web.xml 反推项目骨架不管用什么 IDE 启动 Tomcat 前先打开WEB-INF/web.xml看一遍。这个文件决定了整个项目的路由方式和过滤器链比盲猜代码结构高效得多?xml version1.0 encodingUTF-8? web-app xmlnshttp://xmlns.jcp.org/xml/ns/javaee version3.1 !-- 编码过滤器解决 GET/POST 中文乱码 -- filter filter-nameEncodingFilter/filter-name filter-classutil.EncodingFilter/filter-class init-param param-nameencoding/param-name param-valueUTF-8/param-value /init-param /filter filter-mapping filter-nameEncodingFilter/filter-name url-pattern/*/url-pattern /filter-mapping !-- 欢迎页 -- welcome-file-list welcome-fileindex.jsp/welcome-file /welcome-file-list /web-app看到这个 web.xml你就应该知道两件事第一项目里有编码过滤器页面传参出现乱码时优先检查这里第二如果 web.xml 里没有servlet映射说明 Servlet 用的是WebServlet注解方式去 controller 包里翻一下就能找到路由定义。后台管理员模块一般在admin路径下比如WebServlet(/admin/diaryList)这种写法对应后台的日记信息管理页面。3. 数据库初始化与连接配置SQL 脚本、JDBC 驱动、中文乱码3.1 导入 SQL 脚本并验证表结构源码包里会带一个.sql文件通常叫ninegrid.sql或database.sql这是全项目的地基。先建库再导入mysql -uroot -p create database ninegrid default character set utf8mb4; use ninegrid; source /path/to/ninegrid.sql;导入完成后执行show tables;正常情况下能看到下面这些核心表表名功能对应模块admin管理员账号管理员登录、管理员管理user用户账号用户管理、个人中心diary日记信息九宫格首页、日记信息管理food美食信息美食信息管理scenic景点信息景点信息管理news新闻推荐新闻推荐管理、前台新闻资讯forum / reply论坛帖子与回复论坛管理collect收藏记录我的收藏管理message留言记录留言板管理、留言反馈表结构如果用 Navicat 或 DBeaver 打开看diary表里一般会有title、cover封面图路径、content、publish_time、user_id这几个字段。九宫格首页取的就是cover和title。特别注意cover字段存的是相对路径比如upload/diary01.jpg页面渲染时会在前面拼接项目根路径路径对不上图片就会裂开。3.2 数据库连接参数详解driver、url、时区连接配置一般集中在src/util/DBUtil.java或者db.properties里。老项目最常见的是硬编码在 DBUtil 的静态块中新一点的项目用 properties 文件。我这里以 properties 文件方式说明参数含义drivercom.mysql.jdbc.Driver urljdbc:mysql://localhost:3306/ninegrid?useUnicodetruecharacterEncodingutf8useSSLfalse usernameroot password123456每个参数都有自己的作用按下面的表核对少一个就多一个坑参数作用坑点driver指定 JDBC 驱动类名5.1.x 驱动用com.mysql.jdbc.Driver8.0 驱动要用com.mysql.cj.jdbc.DriveruseUnicodetrue是否使用 Unicode 编码不配会导致中文参数乱码characterEncodingutf8指定传输字符集和数据库字符集、页面 charset 三者必须一致useSSLfalse关闭 SSL 加密连接MySQL 5.7 下不配这个驱动会频繁报警告甚至直接失败serverTimezone指定服务器时区5.1.49 驱动可不配8.0 驱动必须配Asia/Shanghai否则报时区错误连接池在这个项目里一般不会出现JSP 毕设基本都是 DriverManager 直连。资源里自带的 lib 文件夹如果有druid之类连接池 jar那是增强版没有的话就用 JDBC 直连维护成本最低。3.3 用 JDBC 快速验证连接是否正常导入 SQL 并改完密码之后不要在浏览器里碰运气先用一个独立测试类验证连接。写个临时 main 方法跑一下public class ConnectionTest { public static void main(String[] args) { String url jdbc:mysql://localhost:3306/ninegrid?useUnicodetruecharacterEncodingutf8useSSLfalse; try { Class.forName(com.mysql.jdbc.Driver); Connection conn DriverManager.getConnection(url, root, 123456); Statement stmt conn.createStatement(); ResultSet rs stmt.executeQuery(select count(*) from diary); while (rs.next()) { System.out.println(diary 表行数: rs.getInt(1)); } conn.close(); } catch (Exception e) { e.printStackTrace(); } } }Class.forName是在加载驱动类老驱动依赖这种显式注册方式executeQuery返回结果集这里是验证能查到数据库里的记录数。如果这个类能打印出日志表行数说明驱动、URL、账号密码全都没问题接下来项目启动报错就跟数据库无关了。如果报Communications link failure九成是 URL 或驱动版本的问题直接按 5.1.49 驱动配useSSLfalse就能解决。连接验证通过之后记得给 Tomcat 的server.xml里加一句URIEncodingUTF-8这一步很多人会漏——Tomcat 默认用 ISO-8859-1 解码 URL 参数GET 请求的中文到这里就会被拆成乱码。这是 javaWeb 连接 MySQL 项目里最常见的中文坑先补上再说。4. 请求流转与分层实现从点击到返回的完整链路4.1 以登录为例拆解请求处理流程这个项目的请求链路是标准的 JSP 三层结构浏览器请求 → ControllerServlet→ Service → DAO → MySQL然后原路返回 JSP 渲染。以登录为例路由关系一般是请求路径Servlet/方法处理内容/adminLoginAdminLoginServlet校验管理员账号、写入 session、跳后台/userLoginUserLoginServlet校验用户账号、写入 session、跳首页/diaryListDiaryListServlet查询日记列表转发到 index.jsp/admin/diaryManageAdminDiaryServlet后台日记 CRUD看一下管理员登录的典型实现注意 session 的用法WebServlet(/adminLogin) public class AdminLoginServlet extends HttpServlet { protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { req.setCharacterEncoding(UTF-8); String username req.getParameter(username); String password req.getParameter(password); AdminService service new AdminService(); Admin admin service.login(username, password); if (admin ! null) { req.getSession().setAttribute(admin, admin); resp.sendRedirect(req.getContextPath() /admin/index.jsp); } else { req.setAttribute(error, 账号或密码错误); req.getRequestDispatcher(adminLogin.jsp).forward(req, resp); } } }sendRedirect是重定向地址栏会变适合登录成功后的跳转forward是转发保持原地址适合带错误提示返回。这里的 Session key 用的是admin后续后台页面的权限拦截就是检查这个 key 是否存在。用户登录的逻辑完全一样只是 Session key 换成user。这个项目里req.setCharacterEncoding(UTF-8)和 web.xml 的 Filter 是双层保险——过滤器拦了全局Servlet 里再设一次保证 POST 表单在到达业务层前就是正确的编码。4.2 九宫格日记列表的后端组装逻辑首页九宫格的核心是查询最新 9 条日记把封面路径和标题塞进 List再交给 JSP 用 c:forEach 循环渲染。DAO 层的查询通常长这样public ListDiary findLatestNine() { ListDiary list new ArrayListDiary(); String sql select id, title, cover, content, publish_time from diary order by publish_time desc limit 9; try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql); ResultSet rs ps.executeQuery()) { while (rs.next()) { Diary d new Diary(); d.setId(rs.getInt(id)); d.setTitle(rs.getString(title)); d.setCover(rs.getString(cover)); d.setPublishTime(rs.getTimestamp(publish_time)); list.add(d); } } catch (Exception e) { e.printStackTrace(); } return list; }这段代码里的limit 9是九宫格的硬性来源——不管日记有多少条首页只取最近 9 条。try-with-resources会自动关闭连接避免并发场景下连接泄漏。如果想让九宫格的数据动态变化把 SQL 里的order by publish_time desc改成order by like_count desc就能变成热门推荐九宫格这是改造最少的方案。Servlet 拿到这个列表后req.setAttribute(diaryList, diaryList); req.getRequestDispatcher(index.jsp).forward(req, resp);setAttribute把数据放进 request 作用域forward转发给 JSP。JSP 这边负责把 List 循环铺成 3×3 的格子这部分放在 5.1 节详细说。整个链路里前端和后端的分工非常清楚JSP 只负责拿数据、展示数据所有 SQL 都封在 DAO 里。4.3 DAO 层参数化查询与 SQL 注入预防JSP 毕设里最常见的安全隐患是用字符串拼接 SQL尤其是搜索和筛选功能。比如按标题搜索日志如果写成下面这样用户输入 or 11 --就能绕过条件把全表拉出来// 反面写法 String sql select * from diary where title like % keyword %;正确做法是用PreparedStatement的参数占位符public ListDiary searchByTitle(String keyword) { ListDiary list new ArrayListDiary(); String sql select id, title, cover from diary where title like ?; try (Connection conn DBUtil.getConnection(); PreparedStatement ps conn.prepareStatement(sql)) { ps.setString(1, % keyword %); ResultSet rs ps.executeQuery(); while (rs.next()) { // 组装对象并添加进 list } } catch (Exception e) { e.printStackTrace(); } return list; }ps.setString(1, ...)的作用是让驱动把参数当作纯字符串处理特殊字符会被转义。这个项目里的用户搜索、论坛关键词查询、后台筛选都要按这个方式写。血泪经验答辩时演示搜索功能如果直接拼接字符串评委随手输个单引号就可能让页面报 SQL 语法错误场面会非常难看。论坛模块的回复功能也走同样的链路提交表单 → Servlet 接收内容 → DAO insert 到reply表 → 查询最新回复列表转发回详情页。整体代码结构是一致的改参数和表名就能复用。5. 前台九宫格布局与后台管理的常见问题排查5.1 九宫格图片坐标定位JSP 里的布局实现很多人搜过“jsp 图片如何对坐标定位”这个需求在九宫格首页特别典型。JSP 本身不负责定位它只是输出 HTML定位交给 CSS。最省事的方式是 flex 布局把 9 张图按每行 3 个排列% taglib prefixc urihttp://java.sun.com/jsp/jstl/core % div classgrid-container c:forEach items${diaryList} vard a classgrid-item href${pageContext.request.contextPath}/diaryDetail?id${d.id} img src${pageContext.request.contextPath}/${d.cover} alt${d.title} span classgrid-title${d.title}/span /a /c:forEach /div.grid-container { width: 960px; display: flex; flex-wrap: wrap; margin: 0 auto; } .grid-item { width: 31%; margin: 1%; position: relative; overflow: hidden; border-radius: 8px; display: block; } .grid-item img { width: 100%; height: 300px; object-fit: cover; display: block; } .grid-item .grid-title { position: absolute; bottom: 0; left: 0; right: 0; background: rgba(0, 0, 0, 0.55); color: #fff; text-align: center; padding: 6px 0; font-size: 14px; }这里的核心是flex-wrap: wrap加width: 31%每行三个超过自动换行正好 3×3。object-fit: cover是个关键属性——图片尺寸不一致时会等比裁剪填充不会把格子撑变形。position: absolute的标题栏是叠加定位的一种形式bottom: 0让它固定在图片底部搜索引擎里说的“坐标定位”一般指的就是这种 absolute 相对父容器定位坐标是top/left/bottom/right的值。${pageContext.request.contextPath}是 JSP 的 EL 表达式取的是项目上下文路径相当于/项目名拼接在封面相对路径前面。这个表达式必须加否则部署到带项目名的路径时图片全部 404。5.2 后台权限边界管理员、用户、游客三个视角这个项目把使用者分成了三层后台管理菜单也因此不同。搞清楚权限边界才知道哪些页面能直接访问、哪些必须拦截角色能做什么入口游客浏览首页九宫格、详情、新闻资讯不登录也能看前台首页注册用户发布日记、管理自己的日记、留言、发帖、收藏前台「我的」模块管理员用户管理、日记/美食/景点/新闻全部 CRUD、论坛管理、留言板管理、系统管理/admin后台权限拦截一般写在一个 AdminFilter 里只拦/admin/*。拦截器的核心逻辑是public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) throws IOException, ServletException { HttpServletRequest request (HttpServletRequest) req; HttpSession session request.getSession(false); if (session ! null session.getAttribute(admin) ! null) { chain.doFilter(req, resp); } else { ((HttpServletResponse) resp).sendRedirect(request.getContextPath() /adminLogin.jsp); } }session.getAttribute(admin)为 null 说明不是管理员直接踢回登录页。这样用户即使手动输入/admin/userManage.jsp也进不去只能看到登录页。前台用户模块的拦截思路一样把admin换成user只拦/front/my/*一类的个人中心路径。5.3 五条高频踩坑记录整理几类最常见的翻车现场每条都是真刀真枪排查过的现象 1Tomcat 启动直接失败控制台报端口被占用。原因上次 IDE 异常退出Tomcat 进程没被杀掉8080 端口被占。解决Windows 下执行netstat -ano | findstr 8080拿到 PID 后taskkill /pid 对应PID /f。从那以后我每次启动前都顺手检查一下端口省得被这个浪费五分钟。现象 2启动后访问首页 404。原因Artifacts 没部署到 Tomcat或者 Application context 配错。解决在 Run 配置的 Deployment 页签确认工件已添加context 填/ninegrid访问地址必须是http://localhost:8080/ninegrid/而不是http://localhost:8080/。现象 3连接数据库报Communications link failure或 SSL 错误。原因lib 里放的是 MySQL 8.0 驱动但数据库是 5.7或者 URL 少了useSSLfalse。解决换成 5.1.49 驱动URL 加上useSSLfalsecharacterEncodingutf8重启 Tomcat。现象 4后台和前台全是中文乱码。原因三层字符集不一致——数据库不是 utf8mb4、JDBC URL 没写characterEncodingutf8、Tomcat connector 没开URIEncodingUTF-8。解决建库语句用default character set utf8mb4URL 补参数server.xml 加 URIEncoding三层对齐后重启。现象 5首页九宫格图片错位或尺寸不齐。原因上传的图片宽高比不一致直接用img原尺寸输出会被拉伸。解决固定容器宽高图片加object-fit: cover如果项目需要兼容老浏览器改成背景图方式background-size: cover效果一样。6. 部署验证与网格进阶war 包导出和移动端适配跑通 IDEA 里的调试模式只是第一步毕设答辩或交付时通常要一个可独立运行的东西。把项目打成 war 包放到 Tomcat 的webapps目录下是最稳妥的交付方式。IDEA 里操作路径File → Project Structure → Artifacts → → Web Application: Archive → 对应模块然后Build → Build Artifacts → 选择 war。打包完成后在项目输出目录一般是out/artifacts/模块名_war/找到.war文件复制到本机 Tomcat 的webapps目录启动 Tomcat 后它会自动解压部署。访问地址就是http://localhost:8080/ninegrid/。部署完成后建议按下面的清单整体走一遍确认没有遗漏验证项操作预期结果首页九宫格访问根路径显示 9 个日记卡片图片正常用户注册登录前台注册新账号并登录登录后能进入个人中心发布日记在「我的」模块写日记并上传封面首页九宫格出现新内容后台管理管理员登录修改一条日记刷新前台后内容变化留言与论坛发一条留言和一个帖子列表出现对应记录退出登录清空 Session 后访问/admin被拦截回登录页这个项目还有一个低成本进阶方向把九宫格改成响应式网格让它在手机上也能看。改动很小CSS Grid 一行就能解决问题.grid-container { display: grid; grid-template-columns: repeat(3, 1fr); gap: 12px; } media (max-width: 768px) { .grid-container { grid-template-columns: repeat(2, 1fr); } }repeat(3, 1fr)表示等分成 3 列media屏幕小于 768px 时自动变成 2 列。这个改动可以让答辩演示多一个亮点代码量只有 8 行风险很低。核心模块都验证过之后再对照附带的论文目录改功能和截图把论文里的系统设计章节和实际代码对应上汇报 PPT 里的架构图可以直接从后台菜单树反推——管理员有哪些功能PPT 就画哪些功能。这套组合拳打完整个项目从代码到文档再到演示就全闭环了。我从那以后每次拿到 JSP 项目都会强制先做三件事确认 JDK 版本、确认数据库驱动、确认三层字符集全部过关再动业务代码。这三步能挡掉九成启动问题希望帮到你。本文还有配套的精品资源点击获取