Java Web新闻系统实战：JSP+Servlet+MySQL完整闭环

简介：本资源是一套完整的Java毕业设计项目——新闻发布及管理系统，面向计算机专业本科生、Java初学者及课程设计实践者，解决新闻内容发布、用户交互与后台管理等典型Web系统开发需求。压缩包共55个文件，含40张系统界面截图（PNG），用于直观展示登录、新闻列表、评论管理等核心功能；3份PDF文档（含软件开发词汇、JAVA/Python课程介绍），3份TXT说明文件（含部署指引、注意事项及README）；2个ZIP源码包（xwtj.zip为系统源代码，论文资料.zip含配套论文素材），1个SQL数据库脚本（xwtj.sql）支持一键建库。资源大小37.79MB，结构清晰、模块分明，覆盖MVC分层实现与基础前后端交互逻辑。目前已有79人学习下载，提供从环境搭建、数据库初始化、项目启动到管理员与用户双角色操作的完整闭环方案，附带多个URL链接指向尚学堂等优质教学视频资源，便于延伸学习与工程复用。

1. 这不是又一个“登录+增删改查”的Java毕设模板，而是一套可跑通、可调试、可延展的新闻业务闭环系统

你手头这份051 基于java新闻发布及管理系统.zip，表面看是高校常见的Java毕业设计资源包，但拆开后你会发现：它不是用Servlet硬写三层架构的“教学演示品”，也不是套用Struts2模板拼凑的空壳系统。它真实跑在Tomcat 7+JDK 1.7环境下，数据库脚本（xwtj.sql）含12张表，覆盖用户权限分级（管理员/普通用户）、新闻多级分类（国内/国际/体育/娱乐）、评论审核流、图片上传路径固化、分页查询缓存等生产级细节。截图里反复出现的“尚学堂”标识和配套视频URL（如1_Java新闻发布系统_部署_数据库创建_项目启动.url）说明它经历过真实教学验证——不是纸上谈兵，而是学生真能从零部署、登录后台、发布首条新闻、看到前端列表实时刷新。适合两类人：一是大三下学期正卡在毕设选题与技术落地之间的同学，需要一套结构清晰、注释完整、无版权风险的Java Web基线代码；二是刚转岗Java后端的初级开发者，想通过一个“小而全”的垂直场景（新闻业务），吃透MVC分层、DAO封装、JSP+EL表达式渲染、MySQL事务控制等核心链路。

2. 技术栈解耦与环境复现：为什么选JSP+Servlet+MySQL而非Spring Boot？

2.1 架构选型逻辑：教学场景下的可控性优先于技术先进性

这套系统采用经典Java Web三层架构（表现层JSP+Servlet、业务层Service、数据层DAO），而非当前主流的Spring Boot+Vue组合，其根本原因在于教学可追溯性。JSP页面中嵌入的<%=request.getAttribute("list")%>、Servlet里HttpSession session = request.getSession()、DAO层手动编写PreparedStatement参数绑定——这些代码每一行都能对应到《Java Web编程》教材第X章第X节。学生调试时，打断点能看到request域对象如何从LoginServlet传入login.jsp，能观察到ResultSet rs = stmt.executeQuery("SELECT * FROM news WHERE status=1")执行后rs.next()的逐行遍历过程。反观Spring Boot自动装配的@Autowired NewsService，初学者容易陷入“Bean在哪初始化？AOP代理怎么织入？”的黑盒困惑。该系统刻意保留了web.xml中<servlet-mapping>的显式配置，正是为了强化URL路由与Servlet类的映射关系这一基础认知。

提示：不要试图强行将此项目升级为Spring Boot。它的价值在于“可拆解性”——每个.java文件、每个.jsp页面、每条SQL语句都独立承担明确职责，修改某处逻辑不会引发全局连锁异常。

2.2 环境搭建四步法：从JDK到Tomcat再到数据库初始化

2.2.1 JDK与Tomcat版本锁定

必须使用JDK 1.7 或 JDK 1.8（非JDK 11+），因源码中存在@Override标注在接口默认方法上的兼容性写法（如UserDaoImpl类继承BaseDao时重写deleteById）。Tomcat版本需为7.0.x 或 8.0.x（不支持9.0+），理由是web.xml中<web-app>声明使用的是Servlet 3.0规范，而Tomcat 9默认启用Servlet 4.0，会导致<filter>配置解析失败。验证方式：解压Tomcat后进入bin目录，执行version.bat（Windows）或./version.sh（Linux），输出应含Servlet Specification 3.0字样。

2.2.2 数据库初始化实操命令

# 1. 登录MySQL（假设root密码为空） mysql -u root -p # 2. 创建数据库并指定字符集（关键！避免中文乱码） CREATE DATABASE xwtj CHARACTER SET utf8 COLLATE utf8_general_ci; # 3. 切换数据库并导入SQL脚本（注意路径需替换为实际位置） USE xwtj; SOURCE D:/download/xwtj.sql; -- Windows路径示例 -- SOURCE /home/user/download/xwtj.sql; -- Linux路径示例 # 4. 验证表结构（重点检查news、user、category三张核心表） SHOW TABLES; DESC news; SELECT COUNT(*) FROM user; -- 初始化后应有2条记录（admin/admin, user/user）

注意：xwtj.sql中news表的content字段类型为TEXT而非VARCHAR(2000)，这是为支持长新闻正文预留的设计；user表的role字段值为0（普通用户）或1（管理员），而非字符串枚举，降低查询开销。

2.2.3 项目导入Eclipse的三个关键配置

1. 编码统一：右键项目 → Properties → Resource → Text file encoding → 选择UTF-8（JSP页面、Java源码、SQL脚本必须同编码）
2. Target Runtime绑定：Project Facets → Java → Version选1.7；Dynamic Web Module → Version选3.0；右侧点击Further configuration available...→ 选择已配置的Tomcat v7.0 Server
3. Libraries补全：WEB-INF/lib目录下必须包含mysql-connector-java-5.1.38.jar（非8.x版本！），若缺失则手动下载并Add to Build Path；commons-fileupload-1.3.1.jar和commons-io-2.4.jar用于图片上传功能，缺一不可

验证成功标志：启动Tomcat后访问http://localhost:8080/xwtj/，首页显示“欢迎来到新闻发布系统”，且底部版权信息为“北京尚学堂”。

3. 核心模块深度解析：从新闻发布流程看MVC各层协作机制

3.1 新闻发布全流程：从前端表单提交到数据库持久化

3.1.1 JSP表单与Servlet参数接收

addNews.jsp中关键HTML片段：

<form action="NewsServlet?method=add" method="post" enctype="multipart/form-data"> <input type="text" name="title" required> <select name="categoryId"> <!-- 分类ID来自category表 --> <option value="1">国内</option> <option value="2">国际</option> </select> <textarea name="content" required></textarea> <input type="file" name="pic"> <!-- 图片上传控件 --> <input type="submit" value="发布新闻"> </form>

对应NewsServlet.java中add方法：

protected void add(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { // 1. 解析文件上传（使用commons-fileupload） DiskFileItemFactory factory = new DiskFileItemFactory(); ServletFileUpload upload = new ServletFileUpload(factory); List<FileItem> items = upload.parseRequest(request); // 关键：获取所有表单字段 String title = "", content = "", categoryId = ""; String picPath = "upload/default.jpg"; // 默认图路径 for (FileItem item : items) { if (item.isFormField()) { // 普通字段 String fieldName = item.getFieldName(); String value = item.getString("UTF-8"); // 显式指定编码防乱码 if ("title".equals(fieldName)) title = value; else if ("content".equals(fieldName)) content = value; else if ("categoryId".equals(fieldName)) categoryId = value; } else { // 文件字段 if (item.getSize() > 0) { String fileName = new File(item.getName()).getName(); // 获取原始文件名 String savePath = request.getServletContext().getRealPath("/upload/"); File uploadDir = new File(savePath); if (!uploadDir.exists()) uploadDir.mkdirs(); item.write(new File(savePath + fileName)); picPath = "upload/" + fileName; // 存入数据库的相对路径 } } } // 2. 封装News对象并调用Service News news = new News(); news.setTitle(title); news.setContent(content); news.setCategoryId(Integer.parseInt(categoryId)); news.setPicPath(picPath); news.setStatus(1); // 1=已发布，0=草稿 news.setCreateTime(new Date()); boolean result = newsService.add(news); if (result) { request.setAttribute("msg", "新闻发布成功！"); } else { request.setAttribute("msg", "发布失败，请重试"); } request.getRequestDispatcher("addNews.jsp").forward(request, response); }

逻辑说明：ServletFileUpload.parseRequest(request)是文件上传的核心，它将enctype="multipart/form-data"请求体解析为FileItem集合；item.isFormField()区分普通字段与文件字段；item.write()将文件写入服务器磁盘，路径由getRealPath("/upload/")动态生成，确保跨平台兼容性。

3.1.2 Service层事务控制与DAO层SQL执行

NewsServiceImpl.java中add方法：

@Override public boolean add(News news) { Connection conn = null; try { conn = JdbcUtil.getConnection(); // 自定义工具类获取连接 conn.setAutoCommit(false); // 开启事务 // 插入新闻主表 String sql1 = "INSERT INTO news(title,content,categoryId,picPath,status,createTime) VALUES(?,?,?,?,?,?)"; PreparedStatement ps1 = conn.prepareStatement(sql1, Statement.RETURN_GENERATED_KEYS); ps1.setString(1, news.getTitle()); ps1.setString(2, news.getContent()); ps1.setInt(3, news.getCategoryId()); ps1.setString(4, news.getPicPath()); ps1.setInt(5, news.getStatus()); ps1.setTimestamp(6, new Timestamp(news.getCreateTime().getTime())); ps1.executeUpdate(); // 获取自增主键ID（用于后续操作） ResultSet rs = ps1.getGeneratedKeys(); int newsId = 0; if (rs.next()) { newsId = rs.getInt(1); } // 插入新闻标签关联表（假设有tag表，此处为扩展点） // String sql2 = "INSERT INTO news_tag(newsId,tagId) VALUES(?,?)"; // PreparedStatement ps2 = conn.prepareStatement(sql2); // ... 执行插入 conn.commit(); // 提交事务 return true; } catch (SQLException e) { if (conn != null) { try { conn.rollback(); // 异常时回滚 } catch (SQLException ex) { ex.printStackTrace(); } } e.printStackTrace(); return false; } finally { JdbcUtil.close(conn); // 工具类统一关闭连接 } }

参数说明：ps1.setTimestamp(6, new Timestamp(news.getCreateTime().getTime()))将JavaDate转换为SQLTIMESTAMP；Statement.RETURN_GENERATED_KEYS参数使executeUpdate()后可通过getGeneratedKeys()获取数据库自增ID，这是实现“新闻发布后跳转详情页”的关键；JdbcUtil是项目自封装的JDBC工具类，内部使用DriverManager.getConnection()，未使用连接池（教学简化设计）。

3.2 权限控制机制：基于Session的角色路由拦截

3.2.1 登录认证与Session绑定

LoginServlet.java中doPost方法：

String username = request.getParameter("username"); String password = request.getParameter("password"); User user = userService.login(username, password); if (user != null && user.getStatus() == 1) { // status=1表示账号启用 HttpSession session = request.getSession(); session.setAttribute("user", user); // 将User对象存入Session session.setMaxInactiveInterval(1800); // Session超时30分钟 // 根据角色跳转不同首页 if (user.getRole() == 1) { // 管理员 response.sendRedirect("admin/index.jsp"); } else { // 普通用户 response.sendRedirect("user/index.jsp"); } } else { request.setAttribute("error", "用户名或密码错误"); request.getRequestDispatcher("login.jsp").forward(request, response); }

3.2.2 后台管理页面的Session校验过滤器

AdminFilter.java（配置在web.xml中拦截/admin/*路径）：

public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) throws IOException, ServletException { HttpServletRequest request = (HttpServletRequest) req; HttpServletResponse response = (HttpServletResponse) resp; HttpSession session = request.getSession(false); User user = (User) session.getAttribute("user"); if (user == null || user.getRole() != 1) { // 未登录或非管理员 response.sendRedirect(request.getContextPath() + "/login.jsp"); return; } chain.doFilter(request, response); // 放行 }

关键点：session.getAttribute("user")返回的是完整的User对象，因此可在JSP中直接使用<%=((User)session.getAttribute("user")).getUsername()%>获取用户名；user.getRole() != 1判断比字符串比较（如"admin".equals(role)）更高效，且避免空指针。

4. 实战排错指南：五类高频问题定位与修复方案

4.1 中文乱码问题：从HTTP请求到数据库存储的全链路排查

提示：最彻底的解决方案是在web.xml中配置CharacterEncodingFilter，统一拦截所有请求：

<filter> <filter-name>CharacterEncodingFilter</filter-name> <filter-class>org.apache.catalina.filters.CharacterEncodingFilter</filter-class> <init-param> <param-name>encoding</param-name> <param-value>UTF-8</param-value> </init-param> </filter> <filter-mapping> <filter-name>CharacterEncodingFilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping>

4.2 图片上传失败：路径、权限与MIME类型的三重校验

常见现象：addNews.jsp提交后picPath始终为upload/default.jpg，服务器upload目录无文件。

诊断步骤：

1. 检查NewsServlet.add()中item.getSize() > 0是否成立（打印item.getSize()值）
2. 查看request.getServletContext().getRealPath("/upload/")返回的实际路径（如D:\apache-tomcat-7.0.96\webapps\xwtj\upload）
3. 确认该路径所在磁盘有写入权限（Windows需赋予Users组“修改”权限）

关键修复代码：

// 替换原代码中的item.write()部分 String fileName = item.getName(); if (fileName != null && !fileName.trim().isEmpty()) { // 清理文件名中的路径字符（防../攻击） fileName = fileName.substring(fileName.lastIndexOf("\\") + 1); fileName = fileName.substring(fileName.lastIndexOf("/") + 1); // 校验文件类型（仅允许jpg/png/gif） String contentType = item.getContentType(); if (!"image/jpeg".equals(contentType) && !"image/png".equals(contentType) && !"image/gif".equals(contentType)) { request.setAttribute("error", "只支持JPG/PNG/GIF格式图片"); request.getRequestDispatcher("addNews.jsp").forward(request, response); return; } String savePath = request.getServletContext().getRealPath("/upload/"); File uploadDir = new File(savePath); if (!uploadDir.exists()) uploadDir.mkdirs(); // 使用UUID重命名避免冲突 String uuid = UUID.randomUUID().toString().replace("-", ""); String ext = fileName.substring(fileName.lastIndexOf(".")); File destFile = new File(uploadDir, uuid + ext); item.write(destFile); picPath = "upload/" + uuid + ext; }

4.3 分页查询性能瓶颈：LIMIT子句与索引优化

NewsDaoImpl.java中分页方法：

@Override public List<News> findByPage(int start, int pageSize) { String sql = "SELECT n.id,n.title,n.content,n.picPath,n.status,n.createTime," + "c.name AS categoryName FROM news n " + "LEFT JOIN category c ON n.categoryId=c.id " + "WHERE n.status=1 ORDER BY n.createTime DESC LIMIT ?,?"; // ... 执行查询 }

问题：当新闻量超过10万条时，ORDER BY createTime DESC LIMIT 10000,10会导致全表扫描。

优化方案：

1. 在news表createTime字段上创建复合索引：

ALTER TABLE news ADD INDEX idx_status_time (status, createTime DESC);

2. 将分页逻辑改为游标分页（适用于后台管理）：

-- 第一页（最新10条） SELECT * FROM news WHERE status=1 ORDER BY createTime DESC LIMIT 10; -- 下一页（需记录上一页最后一条的createTime） SELECT * FROM news WHERE status=1 AND createTime < '2023-01-01 10:00:00' ORDER BY createTime DESC LIMIT 10;

5. 功能延展技巧：在原系统基础上快速集成搜索与评论审核

5.1 基于MySQL全文索引的新闻标题模糊搜索

5.1.1 创建全文索引并验证

-- 在news表title字段创建FULLTEXT索引 ALTER TABLE news ADD FULLTEXT(title, content); -- 测试搜索（自然语言模式） SELECT id,title, MATCH(title,content) AGAINST('Java 教程' IN NATURAL LANGUAGE MODE) AS score FROM news WHERE MATCH(title,content) AGAINST('Java 教程' IN NATURAL LANGUAGE MODE) ORDER BY score DESC;

5.1.2 在NewsService中封装搜索方法

@Override public List<News> search(String keyword) { String sql = "SELECT n.id,n.title,n.content,n.picPath,n.status,n.createTime," + "c.name AS categoryName FROM news n " + "LEFT JOIN category c ON n.categoryId=c.id " + "WHERE n.status=1 AND MATCH(n.title,n.content) AGAINST(? IN NATURAL LANGUAGE MODE) " + "ORDER BY MATCH(n.title,n.content) AGAINST(?) DESC"; List<News> list = new ArrayList<>(); Connection conn = null; PreparedStatement ps = null; ResultSet rs = null; try { conn = JdbcUtil.getConnection(); ps = conn.prepareStatement(sql); ps.setString(1, keyword); ps.setString(2, keyword); rs = ps.executeQuery(); while (rs.next()) { News news = new News(); news.setId(rs.getInt("id")); news.setTitle(rs.getString("title")); news.setContent(rs.getString("content")); news.setPicPath(rs.getString("picPath")); news.setCreateTime(rs.getTimestamp("createTime")); // ... 设置其他字段 list.add(news); } } catch (SQLException e) { e.printStackTrace(); } finally { JdbcUtil.close(rs, ps, conn); } return list; }

应用场景：在search.jsp中接收request.getParameter("q")，调用newsService.search(keyword)，结果集直接request.setAttribute("list", list)传递给JSP展示。

5.2 评论审核工作流：从用户提交到管理员审批

5.2.1 数据库新增comment表结构

CREATE TABLE `comment` ( `id` int(11) NOT NULL AUTO_INCREMENT, `newsId` int(11) NOT NULL COMMENT '关联新闻ID', `userId` int(11) NOT NULL COMMENT '评论用户ID', `content` text NOT NULL COMMENT '评论内容', `status` tinyint(1) NOT NULL DEFAULT '0' COMMENT '0-待审核,1-已通过,2-已拒绝', `createTime` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (`id`), KEY `idx_news_status` (`newsId`,`status`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8;

5.2.2 管理员审核页面核心逻辑

admin/comment-list.jsp中审核按钮：

<c:forEach items="${commentList}" var="c"> <tr> <td>${c.id}</td> <td>${c.content}</td> <td> <c:choose> <c:when test="${c.status==0}">待审核</c:when> <c:when test="${c.status==1}">已通过</c:when> <c:otherwise>已拒绝</c:otherwise> </c:choose> </td> <td> <c:if test="${c.status==0}"> <a href="CommentServlet?method=pass&id=${c.id}">通过</a> | <a href="CommentServlet?method=reject&id=${c.id}">拒绝</a> </c:if> </td> </tr> </c:forEach>

CommentServlet.java中pass方法：

protected void pass(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { String idStr = request.getParameter("id"); if (idStr != null) { int commentId = Integer.parseInt(idStr); boolean result = commentService.updateStatus(commentId, 1); // 1=通过 if (result) { // 发送站内信通知用户（可扩展） request.setAttribute("msg", "审核通过"); } } response.sendRedirect("admin/comment-list.jsp"); }

技巧：comment表status字段使用tinyint(1)而非varchar，既节省空间又便于SQL条件查询；idx_news_status索引覆盖newsId和status，加速“查询某新闻所有待审评论”场景（WHERE newsId=? AND status=0）。

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