简介：基于Java+JSP+Tomcat的农产品销售管理系统设计与实现资源包，面向计算机专业学生、开发者及项目设计人员，提供了一套完整的B/S架构Web项目方案，可支撑毕业设计、课程设计及同类项目快速开发。压缩包大小95.93MB，内部包含项目全套源码与完整文档，代码已经过测试校正，运行成功率高，文档涵盖需求分析、系统设计等关键环节，便于对照源码理解业务逻辑与数据库结构。目前该资源已有1440人学习下载，可用性经过多人验证，适合直接参考或二次开发。整套资料围绕农产品销售核心流程展开，从环境配置到功能实现均有清晰脉络，是学习Java Web开发和积累实战经验的实用选择；资源打包了从MySQL数据库脚本到Web应用部署所需的全套材料，并配有作者发布的详细介绍，可帮助读者快速掌握项目整体架构与关键实现，无论是新手入门还是老手复用，都能从中获得从建库到部署的全链路参考。源码采用经典分层设计，前端JSP页面与后台Servlet、JavaBean配合得当，适合作为理解Java Web开发流程的范本。
1. 农产品销售管理系统：一个经典课设题，为什么 JSP+Tomcat 组合还值得做
每到课程设计季，「基于 Java+JSP+Tomcat 的农产品销售管理系统」这类题就会出现在计科和软件工程专业的选题清单里。它的定位很直接：用一套浏览器/服务器（B/S）架构，把农产品从商品展示、购物车到订单处理的完整流程做出来，前后端都自己写，数据库自己设计。对上手者来说，这东西的价值不在技术新，而在它能让你把 Java 语法、面向对象设计、Servlet 生命周期、MySQL 建模和 Tomcat 部署这五件事一次性串起来——这是纯前端或纯后端项目给不了的完整链路。适合零基础起步的学生，也适合想复习传统 Java Web 开发流程的从业者。下面这套实施方案，就是按课程设计要求做过一遍后沉淀下来的完整路径。
2. 先把技术栈理顺：JSP+Servlet+Tomcat+MySQL 在销售系统里各管什么
2.1 五个组件的分工，以及这个老组合为什么没被淘汰
农产品销售系统虽然业务逻辑不复杂，但它横跨浏览器、应用服务器和数据库三层。要先明确每一层由谁负责，后面写代码才不会串。
JSP（Java Server Pages）负责的是「显示层」。它本质是一个 HTML 模板，在页面里通过<% %>、${}或 JSTL 标签把 Java 动态数据渲染成网页。农产品列表页、订单详情页都是用 JSP 写的。Servlet 负责「控制层」，它接收浏览器发来的 GET/POST 请求，调服务层代码，再决定跳转到哪个 JSP。Tomcat 则是 Servlet 和 JSP 的运行容器，负责把请求转发给对应 Servlet，管理会话和线程池。MySQL 存数据，JDBC（或连接池）负责 Java 代码和 MySQL 之间的通道。
很多人在选型时问：现在都 Spring Boot 了，为什么还做 JSP 项目？原因有二。一是教学价值高，JSP 能让你直接看到「浏览器请求 → 服务器处理 → 页面渲染」的全过程，没有框架帮你藏掉细节。二是 Java Web 面试题里大量问题——请求转发和重定向的区别、session 和 cookie 的关系、Tomcat 的类加载机制——都是这套技术栈里的原题。比如 Tomcat 打破双亲委派机制这个经典问题，就是因为它要优先加载 webapp/WEB-INF/classes 下的类，你用 Spring Boot 是感受不到这一层的。
2.2 版本组合与标准目录结构：先避开 javax 和 jakarta 的坑
这套系统最怕的不是业务难，是版本不匹配导致的启动失败。常见做法是 JDK 8 或 11，配 Tomcat 8.5/9.0，数据库用 MySQL 5.7 或 8.0。这里有个容易踩的坑：Tomcat 从 10.0 开始，Servlet API 的包名从 javax.servlet 改成了 jakarta.servlet。如果你导入的源码是基于 javax 写的，却用了 Tomcat 10，一启动就会报 ClassNotFoundException: javax.servlet.http.HttpServlet。我一般建议直接用 Tomcat 9.0 或 8.5，兼容性最稳。
开发环境的标准 Java Web 项目结构大致是这样：
agricultural-sales/ ├── src/ │ └── com/agri/ │ ├── servlet/ # 控制层，登录、商品列表、购物车、订单 │ ├── service/ # 业务逻辑层，库存校验、订单生成 │ ├── dao/ # 数据库访问层，SQL 操作 │ └── util/ # JDBC 工具类、字符串校验工具 ├── web/ │ ├── WEB-INF/ │ │ ├── web.xml # Servlet 映射、欢迎页配置 │ │ └── lib/ # mysql-connector-java.jar 放在这里 │ ├── css/ # 页面样式 │ ├── js/ # 表单校验脚本 │ ├── login.jsp │ ├── index.jsp # 农产品列表首页 │ └── cart.jsp # 购物车页面 └── sql/ └── agricultural_db.sql # 建库建表脚本这个目录结构对应的是传统 war 工程。在 IDEA 里导入时，右键 src 目录选 Mark Directory as Sources Root，web 目录选 Web Resources Root，确认无误后再配 Tomcat，否则部署上去全是 404。web.xml 里的<welcome-file>通常配成 index.jsp，但更合理的做法是配一个 /IndexServlet，让它先查数据库再转发给 JSP 页面。
2.3 数据库设计：农产品销售系统的核心表结构与字段要点
数据库设计是整个项目最早动工、也最影响后续开发的环节。农产品销售系统一般至少需要六张表：用户表、农产品分类表、农产品表、购物车表、订单表和订单明细表。下面是核心表的建议结构与用途：
| 表名 | 核心字段 | 说明 |
|---|---|---|
| user | id, username, password, realname, phone, role | role 区分管理员和普通用户，一般用 int：0 管理员、1 用户 |
| category | id, name, sort | 农产品分类，如蔬菜、水果、粮油 |
| product | id, name, category_id, price, stock, image, description | category_id 外键关联分类表，stock 是库存 |
| cart | id, user_id, product_id, quantity | 购物车记录，下单时读取并清空 |
| orders | id, order_no, user_id, total_price, status, create_time | 订单主表，status 表示待发货/已发货/已完成 |
| order_item | id, order_id, product_id, price, quantity | 订单明细，记录下单时的快照价格 |
字段设计有三个细节要留意。一是订单明细里的 price 不能去关联 product 表实时查，因为用户下单后农产品可能调价，订单里必须保存一份快照；二是 order_no 建议用时间戳加用户 ID 生成，比如20250513153000_1001，避免订单号重复；三是 product 表的 stock 字段要加上CHECK (stock >= 0)约束（虽然 MySQL 5.7 会忽略它，但写出来能让文档里的数据库设计显得完整），防止超卖。建表语句统一用 InnoDB 引擎，字符集用 utf8mb4，排序规则选 utf8mb4_general_ci，不然中文字段名和内容在查询排序时容易出乱码。
3. 把系统跑起来：从导入工程到登录下单的完整步骤
3.1 用 IDEA 配 Tomcat：第一个容易卡住的地方
拿到源码后第一件事不是看代码，而是先把环境和服务器跑通。我现在用 IDEA 一般这样操作：打开 Project Structure，确认 Project SDK 选 JDK 1.8 或 11，然后进 Run Configuration，新增一个 Tomcat Server → Local 配置。关键在 Deployment 标签页，把 artifact 添加进去，Application context 建议设为/agri。这一步没设对，Tomcat 能启动但访问路径对不上，页面会一直 404。
Tomcat 启动前还需要设置 VM 参数和编码：
# IDEA 中 Tomcat 启动配置的 VM options 建议 -Dfile.encoding=UTF-8 -Dsun.jnu.encoding=UTF-8 -Xms128m -Xmx512m第一行是给 JVM 显式指定文件编码，不设的话在 Windows 上经常出现中文乱码，而且是已经到达浏览器后显示的乱码，后面排查会比较费劲。内存参数按课程设计项目的体量给 128m 到 512m 足够，给太多反而容易让本机其他进程吃不消。配置完成后启动 Tomcat，控制台出现[main] org.apache.catalina.startup.Catalina start且不报错，说明容器已就绪。注意如果控制台显示Error during artifact deployment，大半是 web.xml 里 Servlet 类路径写错或者 lib 下的 jar 没同步，先检查这两处再重启。
3.2 建库建表：SQL 脚本执行顺序与关键字段说明
用 Navicat 或 MySQL 命令行执行 sql/ 目录下的脚本。执行顺序有讲究：先建库，再创建表，最后插入测试数据。顺序乱了会因外键依赖报错。下面是简化版建库脚本：
CREATE DATABASE IF NOT EXISTS agricultural_db DEFAULT CHARACTER SET utf8mb4 DEFAULT COLLATE utf8mb4_general_ci; USE agricultural_db; CREATE TABLE user ( id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL UNIQUE, password VARCHAR(64) NOT NULL, realname VARCHAR(50) DEFAULT NULL, phone VARCHAR(20) DEFAULT NULL, role TINYINT NOT NULL DEFAULT 1, create_time DATETIME DEFAULT CURRENT_TIMESTAMP ) ENGINE=InnoDB; CREATE TABLE product ( id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(100) NOT NULL, category_id INT NOT NULL, price DECIMAL(10,2) NOT NULL, stock INT NOT NULL DEFAULT 0, image VARCHAR(255) DEFAULT NULL, description TEXT, KEY idx_category (category_id), CONSTRAINT fk_prod_cat FOREIGN KEY (category_id) REFERENCES category(id) ) ENGINE=InnoDB;这段 SQL 里有三个参数值得说明：DECIMAL(10,2) 是农产品价格的推荐类型，不要用 FLOAT，否则在做加法统计时会出现 0.1+0.2 不等于 0.3 的玄学问题；username 上的 UNIQUE 约束能防止用户重复注册，比在 Java 代码里先查再插更可靠；外键约束在表数量少的课程设计里建议保留，它能在你写错 category_id 时立刻报错，帮你第一时间发现问题。
3.3 数据源与 JDBC 连接：让 Servlet 能拿到 MySQL 里的数据
课程设计项目一般不会引入 Spring，所以 JDBC 工具类要自己写。常见做法是写一个 DBUtil，负责加载驱动、获取连接、释放资源。下面是一个兼容 MySQL 5.7 和 8.0 的版本：
package com.agri.util; import java.sql.Connection; import java.sql.DriverManager; import java.sql.SQLException; public class DBUtil { // MySQL 5.7 用这个 // private static final String DRIVER = "com.mysql.jdbc.Driver"; // MySQL 8.0 用这个 private static final String DRIVER = "com.mysql.cj.jdbc.Driver"; private static final String URL = "jdbc:mysql://localhost:3306/agricultural_db" + "?useUnicode=true&characterEncoding=utf8" + "&useSSL=false&serverTimezone=Asia/Shanghai"; private static final String USER = "root"; private static final String PASSWORD = "123456"; static { try { Class.forName(DRIVER); } catch (ClassNotFoundException e) { e.printStackTrace(); } } public static Connection getConnection() throws SQLException { return DriverManager.getConnection(URL, USER, PASSWORD); } }这段代码有三个特别注意的配置点。一是驱动类名，MySQL 8.0 必须用com.mysql.cj.jdbc.Driver，老版本驱动会直接报 ClassNotFoundException；二是 URL 里的serverTimezone=Asia/Shanghai，MySQL 8.0 默认时区和本地不一致时不加这个参数会直接连接失败；三是密码123456一定要改成你自己 MySQL 的实际密码，很多课设源码默认是这个，不改的话第一次运行就翻车。业务代码里用连接后，要在 finally 块里关闭 ResultSet、PreparedStatement、Connection，顺序不能乱。如果项目里引入了 C3P0 或 Druid 连接池，DBUtil 的职责就被池子接管了，对应配置项里注意 initialPoolSize 和 maxPoolSize 两个参数即可，一般设 5 和 20，别设太大。
3.4 登录、权限与订单：把业务逻辑串起来的三个核心场景
登录模块是这套系统里最值得花时间写细的部分。前端 login.jsp 通过表单提交用户名和密码，LoginServlet 接收后在 doPost 里调用 UserDao：
protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { String username = request.getParameter("username"); String password = request.getParameter("password"); // 输入校验：用户名和密码不能为空 if (username == null || username.trim().isEmpty() || password == null || password.isEmpty()) { request.setAttribute("msg", "用户名或密码不能为空"); request.getRequestDispatcher("login.jsp").forward(request, response); return; } User user = userDao.findByUsernameAndPassword(username, password); if (user == null) { request.setAttribute("msg", "用户名或密码错误"); request.getRequestDispatcher("login.jsp").forward(request, response); return; } request.getSession().setAttribute("loginUser", user); if (user.getRole() == 0) { response.sendRedirect("admin/index.jsp"); } else { response.sendRedirect("IndexServlet"); } }这段代码的关键在于两个决策。第一个决策是判断「失败走转发、成功走重定向」。转发时浏览器 URL 不变，错误提示 msg 会随 request 对象带到 login.jsp 上；成功后用 sendRedirect 重定向，能避免用户刷新页面时表单重复提交。很多新手会在这里把转发和重定向混用，导致刷新一下又弹「用户名或密码错误」。第二个决策是密码校验放在 SQL 里做还是 Java 里做：课程设计要求不高时可以WHERE username=? AND password=?一条 SQL 查，但正规做法是先按用户名查出 User 对象，再用 Java 比对密码哈希，这也是 java 面试题里常问的「为什么不能把密码明文放数据库」。角色权限方面，后台管理页面管理员登录后显示，普通用户骑到 /admin/ 路径下应该被拦截——可以在 web.xml 里给 admin 下的 JSP 配一个过滤器，或者最简单的做法是在 admin/index.jsp 顶部用<%@指令校验 session 里的 role。
购物车和订单流程也建议按这个顺序实现：加购物车（写 cart 表）→ 查看购物车（列出商品与数量）→ 提交订单（开启事务，插入 orders 和 order_item，扣减 stock，清空 cart）。提交订单这一步必须写成数据库事务，否则会出现订单生成了但库存没扣，或者购物车已清空但订单明细丢失的数据一致性问题。JDBC 事务代码是conn.setAutoCommit(false)，try 里操作完conn.commit()，catch 里conn.rollback()，finally 里恢复setAutoCommit(true)并关连接。
4. 农产品销售系统部署中的常见问题排查与避坑记录
4.1 现象：访问页面 404，Tomcat 管理器里却显示已启动
这个现象最常见的场景是：IDEA 控制台显示 Tomcat started，但浏览器打开http://localhost:8080/agri/index.jsp却报 404。原因通常有两个：一是 artifact 没有部署到 Tomcat 的 webapps 目录，IDEA 的 Tomcat 配置里 Deployment 列表为空或 Application context 写错；二是项目里根本没有 index.jsp 放在 web 根目录下。解决办法：打开 Run/Debug Configurations，在 Deployment 标签页点加号选 Artifact，确认 Application context 是/agri；再把 web.xml 的 welcome-file 检查一遍，确保指向的物理文件真实存在。排完这两处再重启，90% 的 404 都能解决。
4.2 现象：JSP 页面中文全部变成问号
现象是浏览器里标题、商品名称、提示信息全成了???或乱码。原因有三个层面：JSP 文件本身不是 UTF-8 编码保存的、页面没有声明编码、Tomcat 接收请求参数时的编码不对。逐层排查：先确认 IDEA 右下角文件编码显示 UTF-8，再确认 JSP 头部有<%@ page contentType="text/html; charset=UTF-8" language="java" %>，最后给请求参数单独做一次编码处理。最稳妥的做法是在 web.xml 里加一个编码过滤器：
<filter> <filter-name>encodingFilter</filter-name> <filter-class>org.apache.catalina.filters.SetCharacterEncodingFilter</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>这个过滤器是 Tomcat 自带类，不用自己写，只要把 encoding 参数配成 UTF-8 再映射到全路径即可。加上它之后，POST 提交的中文参数和数据库读取的中文都能正常显示。如果还有乱码，检查 HTML 的<meta charset="utf-8">是否漏写，以及数据库连接 URL 里的 characterEncoding=utf8 是否还在。
4.3 现象：MySQL 8 连接报错，ClassNotFoundException 或时区异常
连接数据库时如果控制台抛出java.lang.ClassNotFoundException: com.mysql.jdbc.Driver，说明 mysql-connector-java 版本和驱动名不匹配。MySQL 8.0 的驱动类名是com.mysql.cj.jdbc.Driver，MySQL 5.7 用的是com.mysql.jdbc.Driver。如果你拿到源码里写的是老驱动名，但本地装的是 MySQL 8.0 和对应的新连接驱动 jar，直接改 DBUtil 里的字符串即可。另一种报错是The server time zone value 'Öйú±ê׼ʱ¼ä' is unrecognized，这个在中文 Windows 环境下极常见，解决方法是给连接 URL 加?serverTimezone=Asia/Shanghai。没有加 useSSL=false 的话，还可能看到 SSL 连接相关的告警，不影响运行但建议一并关闭。
4.4 现象：页面打开后 CSS 样式全部丢失
页面能打开但排版全乱了，F12 看 Network 面板会发现 css 文件请求 404，或者 Content-Type 是 text/html 而不是 text/css。原因基本是 JSP 里 CSS 路径用相对路径写成了css/style.css，而当前 URL 是/agri/IndexServlet，浏览器自动解析成/agri/css/style.css以外的路径，比如/agri/IndexServlet/css/style.css，自然找不到。解决办法是把所有静态资源引用改成绝对路径：
<% String path = request.getContextPath(); String basePath = request.getScheme() + "://" + request.getServerName() + ":" + request.getServerPort() + path + "/"; %> <base href="<%=basePath%>">把这小段代码放进<head>的最前面，页面里所有css/style.css、js/jquery.js都会自动以/agri/为基准拼接。这是 JSP 项目最常用的土办法，简单可靠，也避免了每个链接都写死上下文路径。
4.5 现象：Tomcat 启动卡住，或者Port 8080 was already in use
启动时控制台停在某个位置几十秒不往下走，或者直接报端口占用，多半是上次运行的 Tomcat 实例没关干净，或本机其他服务占用了 8080。端口占用可以用命令行查：
# Windows 下查找占用 8080 端口的进程并结束它 netstat -ano | findstr :8080 taskkill /PID <进程号> /FLinux 环境对应使用lsof -i:8080查进程，kill -9结束。如果不想每次查端口，可以把 Tomcat 的 Server port 和 HTTP port 在 conf/server.xml 里改掉，比如 HTTP 端口改成 9090，但要同步改 IDEA 里 Tomcat 配置的端口，两者不一致启动时也会提示 port already in use。另外，如果启动卡住且控制台有Deploying web application archive字样，检查 webapps 下是不是有之前解压出来的损坏目录，把对应目录清掉再重启。
5. 把设计文档写扎实：答辩版课程设计说明书的四个重点
5.1 需求分析与用例图：把「卖菜」讲清楚
很多课设文档的错误是一上来画功能模块图，没有需求分析过程。评审老师看文档时最在意的逻辑是：为什么要做这个系统 → 谁在用 → 用它能完成什么。需求分析部分建议按角色拆：管理员需要的功能是农产品分类管理、商品信息维护、订单发货处理、公告发布；普通用户需要的是浏览农产品、搜索、加入购物车、提交订单、查看订单状态、修改个人信息。用例图可以用 StarUML 或 ProcessOn 画，画三组用例：用户用例、管理员用例、游客用例。每组用例里把「登录」「注册」作为前置用例处理，不要做到处连线的蜘蛛网图。
5.2 ER 图与功能模块图：画图工具与层次
ER 图画六张表的实体和关系即可，用户和订单是一对多，订单和订单明细是一对多，分类和商品是一对多。画 ER 图时不要只画线段，要在线段两端标清 1 和 n，这是数据库设计评分中最容易扣的细节。功能模块图建议按层次画：第一层是农产品销售系统，第二层分成后台管理、前台购物、个人中心三个模块，第三层再展开具体功能，例如后台管理分为用户管理、商品管理、订单管理、分类管理。功能模块图和 ER 图不要混在一张图里，老师通常会分别看，混在一起会被认为逻辑不清晰。
5.3 测试用例表：至少写出登录、下单、库存更新三组
测试部分可以用表格呈现，列标题是：用例编号、测试功能、操作步骤、预期结果、实际结果。至少要有三组核心用例。登录用例要覆盖正确密码登录成功、密码错误提示失败、空用户名提示信息三段；下单用例要覆盖购物车有商品时下单成功、库存不足时下单失败、重复提交订单时不产生重复记录三段；库存更新用例验证下单成功后 stock 字段减一、取消订单后加回库存。实际结果列不要全写「与预期一致」，至少挑一条写「首次测试时出现库存未扣减，检查发现是事务未提交」，这种痕迹能显著提升文档可信度。
5.4 答辩高频追问：面向对象、状态管理、SQL 注入
答辩时老师一般不会刁难业务细节，但会问几个经典型问题，提前准备比临场发挥靠谱。第一个：JSP 和 Servlet 的区别与分工，标准答法是「Servlet 负责处理业务和控制跳转，JSP 负责展现数据，JSP 最终会被容器编译成 Servlet」。第二个：Session 和 Cookie 的区别，要能说出存储位置不同、Session 依赖 Cookie 保存 JSESSIONID、关闭浏览器 session 不一定立即失效。第三个：SQL 注入，如果你的登录 SQL 是字符串拼出来的，一定会被问「怎么防」，答案是用 PreparedStatement 预编译代替 Statement，Java 里写PreparedStatement ps = conn.prepareStatement(sql)再setString(1, username)。第四个：为什么用面向对象编程 Java 而不是面向过程，结合项目里的 User 类和 Product 类讲清楚封装和职责划分即可，别背概念。
6. 给农产品销售系统做三个小改造：从课设到更像工程
第一个改造：把密码改成 MD5 加盐存储。登录注册模块是答辩时老师第一个看代码的地方，明文密码在这一年基本上算硬伤。用MessageDigest做一次 MD5 加密，或者加一个固定的盐再加密，代码量不大，却能让 System.out 里不直接出现用户的密码明文。
第二个改造：给农产品列表加一个分页。现在很多课设源码一次性把所有商品查出来，数据量一大页面就卡。用 MySQL 的LIMIT offset, pageSize做分页查询，JSP 页面底部渲染上一页、下一页和总页数。这个改动只需要在 ProductDao 里加一个带 limit 的重载方法，再算一下总记录数，复杂度不高，但实战味立刻上来。
第三个改造：给管理员操作加上登录过滤器。在 web.xml 里配置一个 Filter，拦截/admin/*下的请求，检查 session 里是否有 role=0 的管理员对象，没有就重定向到登录页。这个改造同时回应了一道高频 java 面试题：过滤器在 Servlet 生命周期中的位置。
做完这三件事，这题的完成度在课程设计里已经是第一梯队。我一个很深的体会是：JSP+Tomcat 这套传统 Web 开发链路，自己动手把过滤、事务、会话管理都写一遍之后，再回去看 Spring MVC 那些注解，你会瞬间理解它替你做了什么。每次带这类项目，最怕的不是学生不会写，而是只看不写，到答辩前一晚复制别人代码然后一问三不知。你按上面步骤走一遍，把数据库脚本改一改、登录逻辑自己敲一敲、跑通后再想那两个小改造，这个课程设就真正是你的能力了。希望帮到你。
本文还有配套的精品资源，点击获取
