企业官网建设流程全解析

先交代一个背景：这几年我带过不少毕业生做Java方向的课题，问得最多的就是“做什么题目好过、好写、有东西可讲”。如果非要在传统Web开发里挑一个容错率最高、扩展性最强的，基于JSP的农业信息管理系统绝对能排进前三。它既踩中了农业信息化这个政策热点和民生刚需，又完美覆盖了JavaWeb课程的核心考点——Session会话管理、JDBC数据库操作、Servlet请求分发、MVC分层思想，无论你是打算自己动手从零写一遍，还是手上已经有一套旧代码想改造升级，这个题目都能让你在答辩时有足够多的“技术点”可以展开讲，不至于被评委问三句就卡壳。

这篇文章我就围绕这个毕设题目，把从选题思路、技术选型、数据库设计到核心功能落地、常见坑点排查的完整路径拆开讲一遍。内容偏实操，代码和步骤都能直接参考，适合正在做JavaWeb类毕业设计的学生，也适合想用这个题目练手的初学者。

1. 项目概述与选题思路

1.1 这个系统到底在解决什么问题

农业信息管理系统的核心定位很简单：把分散的农产品信息、农业资讯、供求消息、农资产品，通过一个Web平台统一管理起来，让管理员能维护内容，让普通农户或访客能快速检索和发布信息。这类系统的本质是一套“分类信息发布平台”，只不过领域从通用的信息分类换到了农业场景。

说得更直白一点：你完全可以把它理解成一个小型的“58同城农业版”。农产品供求、农机租赁、农业技术文章、化肥种子价格——这些信息过去靠贴墙报、口口相传，效率低且无法沉淀。系统要做的事就是把它们搬上线，支持发布、审核、分类浏览、关键词检索。

1.2 为什么选JSP而不是Spring Boot

每年都有人问：现在企业里都写Spring Boot了，毕设还写JSP是不是过时了？

我的看法是：毕设和技术选型，要分清楚“教学考核目标”和“工业应用”是两回事。JSP直接翻译成“Java服务端页面”，是JavaWeb课程的必学基础，它能把请求处理、页面渲染、数据库访问这些底层原理赤裸裸地摆在你面前。你写Spring Boot，框架帮你把一堆东西都藏起来了，评委问“Servlet生命周期是什么”“HTTP请求怎么被处理的”，你反而答不上来。

而用JSP + Servlet + MySQL这套组合做毕设，优点是：

• 逻辑链路完整，每一步都能解释清楚，答辩时好讲；
• 不需要引入过多的框架依赖，环境搭建简单，出一两个报错自己也能排查；
• 代码量适中，一个人完全能在三周内写完主体部分；
• 后期如果你想往Spring Boot迁移，这套业务逻辑几乎可以无缝平移。

我个人的建议很明确：如果你做的是本科毕设，且题目明确点名了JSP，那就老老实实把JSP这套吃透。它能让你看到HTTP协议、URL映射、请求转发这些最基础但又最重要的概念，这些恰恰是面试时JavaWeb岗位的高频考点。

2. 技术选型与前置环境准备

2.1 技术栈清单与版本

系统开发使用的基础技术栈如下：

• 后端：JSP + Servlet 3.0
• 前端：HTML + CSS + JavaScript（可引入Bootstrap做快速美化）
• 数据库：MySQL 5.7
• 服务器：Tomcat 8.5
• 开发工具：Eclipse IDE for Java EE 或 IntelliJ IDEA
• JDK版本：1.8
• 项目管理：Maven（也可用纯Web项目，但建议用Maven管理依赖）

这里有一个容易纠结的点：MySQL到底用5.7还是8.0？如果你是自己配环境，建议用5.7。MySQL 8.0的默认认证插件是caching_sha2_password，老版本驱动连不上，经常报“Unable to load authentication plugin”的错，需要额外改配置，这对毕设阶段来说完全没必要。而5.7稳定、教程多、遇到问题搜索出来的答案也最多。

2.2 开发环境搭建的一个关键细节

Eclipse和IDEA二选一即可，但我建议你优先用IDEA。原因不是Eclipse不能写，而是IDEA对Maven和Tomcat的集成更省心，部署Web项目的时候只需要在Run Configuration里加一个Tomcat Server就可以了。而Eclipse的Dynamic Web Project结构如果没建好，经常会碰到servlet编译不通过、部署目录对不上之类的问题。

不过有一个细节无论用什么IDE你都得注意：Tomcat的“Application context”一定要配置成/agri这种简洁路径，而不是一大串默认路径。因为你在代码里写绝对路径时，比如request.getContextPath()返回的字符串会拼到前端页面的链接里，路径太长不仅丑，还容易引发“CSS和JS加载失败”这种看起来诡异的问题。具体实操中，我建议你统一使用相对当前项目根路径的方式，前端所有静态资源引用都写成类似${pageContext.request.contextPath}/css/style.css，后端重定向也统一使用response.sendRedirect(request.getContextPath() + "/login.jsp")，这样不管部署路径怎么改都不会404。

2.3 为什么建议用Maven管理依赖

有些学校的毕设模板还是纯手工往WEB-INF/lib目录里丢jar包，这种做法在只有一个项目的时候没什么问题，但你后面想加一个JSON解析库、想升级MySQL驱动版本，就会很痛苦。Maven的好处是依赖通过配置文件声明，自动下载、自动管理版本冲突，clone到新机器上一条mvn clean install就能把依赖全还原。

这部分操作用代码块展示会更清楚。在pom.xml中只需要引入四个核心依赖：

<dependencies> <!-- Servlet API，Tomcat自带，scope用provided --> <dependency> <groupId>javax.servlet</groupId> <artifactId>javax.servlet-api</artifactId> <version>3.1.0</version> <scope>provided</scope> </dependency> <!-- JSP API --> <dependency> <groupId>javax.servlet.jsp</groupId> <artifactId>javax.servlet.jsp-api</artifactId> <version>2.3.1</version> <scope>provided</scope> </dependency> <!-- MySQL驱动 --> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>5.1.49</version> </dependency> <!-- JSTL标签库，JSP页面里做c:forEach、c:if判断 --> <dependency> <groupId>jstl</groupId> <artifactId>jstl</artifactId> <version>1.2</version> </dependency> </dependencies>

Maven的scope为provided的地方要重点说明一下：Servlet和JSP的jar包Tomcat里面已经有了，如果你不设置provided，打出来的WAR包会把它们打进去，部署时会和Tomcat自带的类冲突，出现奇怪的ClassCastException。这个坑我见过不止一个学生踩过。

3. 系统功能模块设计与数据库建模

3.1 功能角色划分

农业信息管理系统按角色拆，通常分两种：管理员和普通用户（农户/访客）。两种角色的功能边界是：

管理员：登录后台、管理农业资讯（增删改查）、管理农产品信息（增删改查+审核）、管理用户（禁用/启用）、查看留言投诉、数据统计。

普通用户：注册登录、浏览农产品资讯、搜索农产品、发布供求信息、修改个人信息、提交留言。

3.2 数据库表设计

数据库命名建议用agri_db，字符集统一用utf8mb4，排序规则用utf8mb4_general_ci。这么做的好处是两个环境差异问题一次解决：一是避免中文乱码，二是避免表情符号写入失败。建库语句是：

CREATE DATABASE agri_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

整个系统最核心的表有5张：用户表、农产品表、资讯表、供求表、留言表。这里我把每一张表的关键结构列出来，并解释设计原因。

用户表t_user：

CREATE TABLE t_user ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(64) NOT NULL, nickname VARCHAR(50), phone VARCHAR(20), role TINYINT DEFAULT 0, -- 0普通用户 1管理员 status TINYINT DEFAULT 1, -- 1正常 0禁用 create_time DATETIME DEFAULT CURRENT_TIMESTAMP );

农产品表t_product：

CREATE TABLE t_product ( id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(100) NOT NULL, category VARCHAR(50), price DECIMAL(10,2), origin VARCHAR(100), description TEXT, image VARCHAR(255), -- 存储图片的相对路径 publish_user_id INT, -- 发布人ID status TINYINT DEFAULT 1, -- 1上架 0下架 create_time DATETIME DEFAULT CURRENT_TIMESTAMP, FOREIGN KEY (publish_user_id) REFERENCES t_user(id) );

资讯表t_news：

CREATE TABLE t_news ( id INT PRIMARY KEY AUTO_INCREMENT, title VARCHAR(200) NOT NULL, content TEXT NOT NULL, author VARCHAR(50), click_count INT DEFAULT 0, create_time DATETIME DEFAULT CURRENT_TIMESTAMP );

供求信息表t_supply_demand：

CREATE TABLE t_supply_demand ( id INT PRIMARY KEY AUTO_INCREMENT, type TINYINT, -- 1供应 2求购 title VARCHAR(200), content TEXT, contact_person VARCHAR(50), contact_phone VARCHAR(20), user_id INT, status TINYINT DEFAULT 0, -- 0待审核 1已发布 create_time DATETIME DEFAULT CURRENT_TIMESTAMP );

留言表t_message：

CREATE TABLE t_message ( id INT PRIMARY KEY AUTO_INCREMENT, content VARCHAR(500) NOT NULL, user_id INT, reply_content VARCHAR(500), create_time DATETIME DEFAULT CURRENT_TIMESTAMP );

这些表的设计遵循两个原则：

第一，状态字段全用TINYINT而不是VARCHAR。比如农产品是上架还是下架、供求信息是否审核通过，都用数字表示。不要觉得“上架”“下架”这种字符串看起来更直观，一旦量大，字符串字段的索引效率和存储冗余都比数字差得多。而且前端展示时用switch一个if判断就能映射成中文，并不复杂。

第二，凡是关联用户的表都加一个外键字段。比如农产品表的publish_user_id指向用户表。加外键字段，而不是加外键约束。这里有个经验：建表时可以定义逻辑外键，但不要加物理外键约束。因为毕设系统后续需要造测试数据、批量改数据，物理外键约束会导致你删数据时被“外键约束失败”的错误卡住，增加不必要的麻烦。但字段必须保留，因为答辩老师一定会问“你这张表怎么知道是哪个用户发布的”，你得有字段可以回答。

3.3 为什么数据库字段要留好冗余

这一点是很多学生容易忽略的。比如农产品表里我设计了origin（产地）和category（分类）两个字段，正常情况下你可以从其他地方计算出来，但我直接作为独立字段存下来了。为什么？

因为访问量大的页面是首页和列表页，这两个页面要展示的核心数据就这些。如果每次都要关联另一张表去查字段，查询压力会随数据量增大而成倍上升。虽然一个毕设系统的数据量不大，现在看不出性能问题，但好的设计习惯是——对展示频率高、变化不频繁的数据做冗余存储。你在做设计说明文档时，把这条理由写进去，比干巴巴地列表结构要加分得多。

4. 核心功能实现与代码解析

4.1 登录功能的Session处理

登录是几乎所有系统都有的功能，但能把登录写规范的学生不多。规范体现在三个方面：密码是否加密、Session如何存储、敏感操作是否校验登录状态。

密码加密这一块，我直接在代码里用MD5加盐处理：

public class MD5Util { public static String md5WithSalt(String input) { String saltStr = "agri_2024_salt"; // 固定盐值 String target = input + saltStr; StringBuilder sb = new StringBuilder(); try { MessageDigest md = MessageDigest.getInstance("MD5"); byte[] bytes = md.digest(target.getBytes("UTF-8")); for (byte b : bytes) { String hex = Integer.toHexString(b & 0xFF); if (hex.length() == 1) { sb.append("0"); } sb.append(hex); } } catch (Exception e) { e.printStackTrace(); } return sb.toString(); } }

加盐的目的，是为了避免两个用户密码相同导致数据库里的密文一样，这是最基础的密码存储安全实践。答辩时老师只要问到密码安全，你就能多聊几句。

登录成功后，一般把用户的关键信息放进Session，而不是把整个对象塞进去。我见很多初学者直接在Session里存完整的User对象，包括密码，这不太好。建议只存这三个信息：

HttpSession session = request.getSession(); session.setAttribute("loginUser", user); // 整个用户对象用于前台页面展示昵称 session.setAttribute("userId", user.getId()); // 单独存ID，后面业务用 session.setAttribute("role", user.getRole()); // 角色判断，权限控制用

至于登录状态的校验，写一个简单的过滤器（Filter），拦截所有需要登录才能访问的路径：

public class LoginFilter implements Filter { public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) throws IOException, ServletException { HttpServletRequest request = (HttpServletRequest) req; HttpServletResponse response = (HttpServletResponse) resp; HttpSession session = request.getSession(); Object loginUser = session.getAttribute("loginUser"); if (loginUser == null) { response.sendRedirect(request.getContextPath() + "/login.jsp"); return; } chain.doFilter(req, resp); } }

同时还要做一层角色过滤。管理员相关的页面，比如后台资讯管理的路径，普通用户是不能访问的。做法就是在过滤器里加一个判断：

String path = request.getRequestURI(); if (path.contains("/admin/")) { Integer role = (Integer) session.getAttribute("role"); if (role == null || role != 1) { response.sendError(HttpServletResponse.SC_FORBIDDEN); return; } }

这一套做完，权限控制的代码量不大，但结构完整，功能测试和答辩都挑不出毛病。

4.2 JDBC连接池的两种选择

数据库连接这一层，常见的写法有两种：直接用DriverManager.getConnection()，或者用连接池。毕设阶段如果你想简化代码，可以直接写一个工具类：

public class DBUtil { private static final String URL = "jdbc:mysql://localhost:3306/agri_db?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai"; private static final String USERNAME = "root"; private static final String PASSWORD = "123456"; static { try { Class.forName("com.mysql.jdbc.Driver"); } catch (ClassNotFoundException e) { e.printStackTrace(); } } public static Connection getConnection() throws SQLException { return DriverManager.getConnection(URL, USERNAME, PASSWORD); } public static void close(Connection conn, PreparedStatement ps, ResultSet rs) { try { if (rs != null) rs.close(); if (ps != null) ps.close(); if (conn != null) conn.close(); } catch (SQLException e) { e.printStackTrace(); } } }

注意URL里必须带characterEncoding=utf8和useSSL=false，前者防止中文乱码，后者是MySQL 5.7在本地通常没配SSL证书，不带这个参数会报警告但不出错，带着可以免去干扰日志。

如果你是给设计文档加分，可以直接换成Druid连接池。Druid是阿里开源的数据库连接池，配置也不复杂：

<dependency> <groupId>com.alibaba</groupId> <artifactId>druid</artifactId> <version>1.2.8</version> </dependency>

在web.xml里配置一个Druid的Servlet或者用Java Config方式初始化DruidDataSource，无论哪种选择，核心参数差不多：

initialSize=5 maxActive=20 maxWait=60000

连接池的核心价值，说白了就是：不要让每次数据库操作都新建物理连接，而是复用已经建好的连接。数据库连接的创建开销和销毁开销极高，连接池相当于维护了一批“随时可用”的数据库连路，程序来了请求直接拿一条用，用完归还而不是销毁。这个道理在面试里叫“资源复用”，在毕设答辩里就是“性能优化点”。

4.3 农产品信息的CRUD与分页

信息管理系统的重头戏是农产品信息的展示和检索，这里最亮眼的加分点是分页查询。分页不是很难，但思路要理清：

int pageSize = 8; // 每页显示8条 int currentPage = 1; // 默认第1页 String pageStr = request.getParameter("page"); if (pageStr != null && !pageStr.isEmpty()) { currentPage = Integer.parseInt(pageStr); } int offset = (currentPage - 1) * pageSize;

查询SQL带上LIMIT参数：

SELECT * FROM t_product WHERE status = 1 ORDER BY id DESC LIMIT ?, ?

PreparedStatement设参数时，注意偏移量是int类型，两个参数都要setInt：

ps = conn.prepareStatement(sql); ps.setInt(1, offset); ps.setInt(2, pageSize);

总页数需要先从数据库查总记录数：

String countSql = "SELECT COUNT(*) FROM t_product WHERE status = 1"; // 执行countSql获取totalCount int totalPages = (int) Math.ceil(totalCount * 1.0 / pageSize);

分页的边界条件必须处理：当前页小于1时置为1，大于总页数时置为总页数，否则用户手动改URL的page参数会造成页面上全是空白数据。这种边界防护是答辩时“细节控”老师最爱考的点。

列表页的前端，用JSTL的c:forEach遍历，分页导航用c:if判断上一页下一页的可点击状态。这样整个列表页的代码结构非常清爽，评委一看就知道你用了MVC的思想——JSP只负责展示，不写Java业务。

4.4 图片上传与保存路径问题

农产品信息基本都要配图，所以图片上传功能是绕不开的。Servlet 3.0的@MultipartConfig注解处理上传非常简单：

@MultipartConfig(maxFileSize = 1024 * 1024 * 2, maxRequestSize = 1024 * 1024 * 10) @WebServlet("/upload") public class UploadServlet extends HttpServlet { protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { Part part = request.getPart("file"); String fileName = extractFileName(part); String realName = UUID.randomUUID().toString().replace("-", "") + fileName.substring(fileName.lastIndexOf(".")); String uploadPath = getServletContext().getRealPath("/upload"); File dir = new File(uploadPath); if (!dir.exists()) { dir.mkdirs(); } part.write(uploadPath + File.separator + realName); // 返回给前端：/upload/文件名 } }

这里有三个非常关键的处理细节：

第一，文件名必须生成唯一名称。直接使用用户上传的原始文件名，有两个后果：其一，如果两个用户上传了同名的图片，后上传的会把先上传的覆盖；其二，原始文件名可能包含中文和特殊字符，存到服务器后会造成Tomcat访问乱码或404。所以我用UUID重命名，但保留原文件的扩展名，不然图片会打不开。

第二，不要把图片存进数据库。数据库里只存路径字符串，图片文件本身放服务器的/upload目录。原因很简单：数据库的BLOB字段写入读取都很慢，而且数据库文件体积会急剧膨胀。答辩老师问到这一点，你要能答上来“为什么不在库里存二进制”。

第三，getServletContext().getRealPath("/upload")返回的是Tomcat部署目录的绝对路径。有一个隐患是：每次重新部署项目时，Tomcat可能会重新创建整个部署目录，之前上传的图片就会被覆盖删除。所以很多思路比较细的学生会改成把上传目录放到Tomcat的webapps之外，在服务器配置一个虚拟路径映射。但毕设场景下，多数评委不会深究这个问题，把图片放到upload目录下并说明“这是一种简化方案”，是可以接受的。

4.5 农业资讯的富文本编辑

农业资讯是管理员后台的重要内容模块，它比农产品信息的难点在于内容长度。如果只是纯文本框，用户输入的换行符在页面显示时会消失，被迫显示成一大段没分隔的密集文字。

简单的方案是引入一个轻量级的富文本编辑器。我用得最多的是UEditor或wangEditor。以wangEditor为例，在需要编辑的内容页里引入几个静态文件：

<link href="/editor/wangEditor.min.css" rel="stylesheet"> <script src="/editor/wangEditor.min.js"></script> <script> var E = window.wangEditor; var editor = new E('#editor'); editor.create(); </script>

编辑器生成的HTML内容（比如<p>段落</p>）会在表单提交时作为一个隐藏域的value传到后端。存库时直接存HTML字符串，展示页用${news.content}加上escapeXml="false"来避免转义，这样才能正确渲染。

这里有一个安全坑要提醒：富文本编辑器默认允许用户嵌入任意HTML，如果管理员在其他地方把这个富文本功能开放给普通用户，用户是可以往里面插入<script>恶意脚本的，这就是XSS攻击的经典入口。毕设系统里，富文本编辑尽量只给管理员使用，普通用户的留言内容要设置为转义输出，不要当成HTML渲染。具体实现就是在JSP输出时，普通字段用默认的escapeXml="true"，只有管理员的资讯内容才允许关闭转义。

5. 完整实操过程与流程演示

5.1 从工程创建到能跑通“Hello登录”的步骤

我给你整理一份顺序清单，照着做能少走弯路：

1. 在IDEA中新建Maven项目，选择maven-archetype-webapp骨架。
2. 在pom.xml中补齐Servlet、JSP、MySQL、JSTL依赖。
3. 配置web.xml，设置欢迎页面为index.jsp，加上国际化编码过滤器（或自己写一个EncodingFilter）。
4. 写数据库建库建表脚本，在MySQL中执行，准备测试数据。
5. 写DBUtil工具类，测试数据库连接，写一个TestServlet在浏览器输出一行验证。
6. 创建登录页面login.jsp，表单提交到LoginServlet，Servlet里查询数据库校验账号密码。
7. 创建LoginFilter并配置拦截规则，把登录跳转和拦截串起来。
8. 分别开发农产品列表、资讯列表、后台管理等功能模块。

很多人一上来就建一堆包和类，结果连数据库都没连通。正确的做法是先把最小链路跑通——浏览器发请求到Servlet，Servlet查数据库，把结果显示在页面上。这条链路通了，系统的骨架就立住了，其他功能都是在这个骨架上的填充。这就是常说的“垂直切片开发”，而不是“水平分层开发”。

5.2 web.xml中核心配置

Servlet 3.0之后支持注解配置，但我建议在web.xml里也保留一份完整配置，方便查看全貌。尤其注意编码过滤器，不写的话中文乱码会追着你跑：

<filter> <filter-name>encodingFilter</filter-name> <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class> <init-param> <param-name>encoding</param-name> <param-value>UTF-8</param-value> </init-param> </filter> <filter-mapping> <filter-name>encodingFilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping>

注意这个<url-pattern>/*</url-pattern>和/的区别：/*会拦截所有请求，包括JSP页面；/只拦截非JSP的请求路径。如果不小心写成/，JSP页面的POST数据就不会经过编码过滤器，表单里的中文还是乱码。

如果不引入Spring的过滤类，你也可以自己写，逻辑就三行：

request.setCharacterEncoding("UTF-8"); response.setContentType("text/html;charset=UTF-8"); chain.doFilter(request, response);

核心的是第一行，它必须在读取请求参数之前执行。放在过滤器里做的好处是全局统一，不会漏。而第三行回应编码则是控制浏览器正确解析页面内容，避免网页一片问号。

5.3 后台管理端的日期处理与数据显示

农产品表里的create_time是DATETIME类型，但从数据库取出来时返回的是java.sql.Timestamp，直接输到页面上一长串格式不好看。建议在JSP里配合JSTL的fmt标签格式化：

<%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %> <fmt:formatDate value="${product.createTime}" pattern="yyyy-MM-dd HH:mm" />

如果用的是过旧版本的JSTL，value属性偶尔解析不了Timestamp类型，解决办法是实体类里的时间字段先用java.util.Date接收。很多老师讲JSP教材时会提到，“数据库层的类型”和“Java实体里的类型”和“JSP页面展示的类型”三者之间要做一层转换，就是这个原因。

5.4 数据验证的完整闭环

一个合格的信息管理系统不能只依赖前端校验，后端同样要校验。前端校验提升用户体验，后端校验才是安全底线。开发时，每个Servler入口我都建议加上参数校验：

String name = request.getParameter("name"); if (name == null || name.trim().isEmpty()) { request.setAttribute("errorMsg", "商品名称不能为空"); request.getRequestDispatcher("/product/add.jsp").forward(request, response); return; } // 价格校验：能转成数字且大于0 try { BigDecimal price = new BigDecimal(request.getParameter("price")); if (price.compareTo(BigDecimal.ZERO) <= 0) { throw new NumberFormatException(); } } catch (NumberFormatException e) { request.setAttribute("errorMsg", "价格格式不正确"); request.getRequestDispatcher("/product/add.jsp").forward(request, response); return; }

这段代码允许了请求转发的方式回显错误信息，而不是重定向到错误页。这种别小看，它就是MVC里“控制器决定视图”的体现：同一个form表单，正常填写提交成功跳转列表页，校验失败则转发回表单页，并带上错误提示。一套逻辑下来非常完整。

6. 常见问题与排查技巧实录

6.1 问题速查表

6.2 乱码排查的完整思路

中文乱码在JavaWeb里是个老大难，实际排查时我遵循一套三层检查法：

第一层：看数据库连接。JDBC URL有没有带characterEncoding=utf8。没带的话，SQL语句里写死的中文条件，比如WHERE name='苹果'，会被转成别的编码去匹配，查不到结果。

第二层：看Servlet和JSP的编码设置。检查response.setContentType("text/html;charset=UTF-8")有没有在每个Servlet写，JSP页面头部有没有<%@ page contentType="text/html;charset=UTF-8" %>。这是输出编码。

第三层：看请求编码。也就是request.setCharacterEncoding("UTF-8")有没有在读取参数之前调用，且过滤器是否对POST请求生效了。GET请求的参数是放在URL里的，在Tomcat 8.5之后的版本默认UTF-8解码，问题不大；POST请求则必须靠过滤器。

按这套思路排查下来，十有八九的乱码问题都能解决。

6.3 Tomcat端口占用与启动失败的应对

开发过程中最常见的意外是Tomcat启动失败，控制台报Port 8080 was already in use。Windows下最常见的处理方式：

netstat -ano | findstr 8080 taskkill /PID <进程号> /F

但治标的办法是改Tomcat端口。在conf/server.xml里找到Connector节点，把port="8080"改成port="8088"，避开和其他开发项目的冲突。我自己做多个项目时习惯把不同项目配不同端口，比如毕设系统用8088，其他小项目用8080，互不干扰。

注意：改端口后，你的数据库连接、前端接口调用里如果写死了端口，也要一并改。有些学生改了Tomcat端口，但前端页面里AJAX请求的URL还写8080，导致整个页面数据都加载不出来。

6.4 JSP页面调试的小经验

JSP页面的报错不像Java类那样定位到精确行，经常报一个“Unable to compile class for JSP”，却只给你看一大段莫名其妙的异常堆栈。我的经验是：先看JSP页面顶部有没有语法错误，尤其是<%@ page import="java.util.*" %>这种指令是否落在最前面；其次看EL表达式有没有写错，比如${product.name}在变量不存在时不会报错，但如果在某个循环中使用未定义的集合遍历变量，JSP可能直接抛异常。

更烦的还有一种：页面能打开，但数据不显示。这种情况要先确认后端Servlet是否真正往request里setAttribute了数据，以及JSP里实际拿到的是不是同名对象。推荐在关键的JSP里临时塞一行调试代码：

<!-- 临时调试：查看request里有什么属性 --> <%= request.getAttribute("productList") %>

或者直接用JSTL的c:out打印一个确定存在的值。发现问题后，如果是因为Servlet转发和重定向用反了——转发是request.getRequestDispatcher().forward()，重定向是sendRedirect()，一个是同一次请求内页面切换，一个是新的HTTP请求——会直接导致Attribute丢失。数据不显示往往就是这里出了问题。

7. 扩展方向与个人实操体会

整个系统做完以后，如果你还有时间和精力，有几个扩点点建议加进去，能让项目在答辩时更出彩：

• 图表统计：在后台首页引入Chart.js，用柱状图展示每月农产品发布数量，数据从数据库按月份分组统计。
• 导出功能：用POI把农产品列表导成Excel格式，这个功能在企业项目里很常见，写上能给项目加分。
• 信息检索升级：简单关键词LIKE查询升级为全文索引或直接引入Lucene，但成本较高，非必要不推荐。
• 数据备份：写一个定时任务，把数据库导出为SQL文件，这是运维层面的加分项。
• 响应式布局：把前端页面改成适配手机浏览器，农业信息的访问用户很多在田间地头，手机访问是真实场景。

我个人在实际操作中体会最深的一点是：做这种系统类毕设，最怕的不是功能多，而是把自己和“拖控件”绑定在一起。如果你只是下载一套现成代码，改改数据库和页面对话框，答辩时老师一追细节就穿帮。最稳的路子还是自己动手，每个模块都做一遍。做这个系统的过程，本质上是逼你理顺了“HTTP请求到Servlet再到数据库再返回页面”的完整闭环，这个闭环一旦在脑子里成型，对你之后的Spring Boot学习、实习面试都是直接受益的。

最后再分享一个小技巧：项目做完了，记得把数据库脚本、部署说明、测试账号这三样东西整理成一个README文件。一个是方便你自己后续复盘，另一个是万一评委现场要求“跑一下系统”，你拿着测试账号一键登录，流程顺畅无比。很多学生的项目功能是好的，就是输错一次账号导致登录失败，现场气氛瞬间僵硬，这种亏别再吃了。

这个内容后续还可以这样扩展：把JSP版本的代码按MVC思想重构成Spring MVC版，或者保留业务逻辑不变，只把数据源切换成MyBatis，都是不错的进阶练习路径。你先把这个系统吃透了，后面怎么走都不会慌。