基于Servlet的织金砂锅特产电商平台：Java Web全栈实战与部署解析

最近在整理一套基于 Servlet 的家乡特产织金砂锅推广平台源码，包号 32911，刚好赶上项目收尾阶段，我把整个项目从功能拆解、数据库设计、核心代码到部署运行完整过了一遍。这套东西给我的第一感觉是：它不是一个只为了交差演示的“玩具项目”，而是把地方特产展示、在线下单、后台管理这几条线都打通了的完整 Java Web 应用。对于正在做 Java 课程设计、毕业设计，或者想快速搭一个轻量级电商网站的初级开发者来说，直接拿这套 Servlet 项目来改一改，比从零开始写省太多事了。

它的技术栈非常“经典”：Servlet + JSP + JSTL + MySQL + Tomcat，没有 Spring 全家桶那些复杂概念，每一个请求怎么进来、数据怎么查出来、页面怎么渲染，全程都是透明可见的。也正因为它足够简单，你反而能看清 Java Web 最基本的运行逻辑。这篇文章我打算把整个项目的设计思路、核心代码、部署步骤和踩坑经验全部摊开讲一遍，保证你看完不只是会运行源码，还能明白为什么这么写。

1. 项目拆解：织金砂锅推广平台到底要做什么

1.1 织金砂锅的商业痛点与网站定位

织金砂锅是贵州织金一带的传统手工艺品，用当地特有的无烟煤砂泥手工制作，耐高温、透气性好，炖汤煮粥都特别香。但这类地方特产有个通病：东西好，却缺少稳定的线上销售渠道。大部分卖家只能靠着线下游客、熟人介绍出货，外地人想买找不到正规入口，本地人又不懂怎么做推广，供需两端完全断开了。

所以这套推广平台的核心定位很清晰：把织金砂锅的文化故事、产品展示和在线购买流程搬到网上。它不是一个大而全的电商系统，不需要拼多多那样复杂的营销体系，而是要解决三个基本问题——让外地人知道织金砂锅是什么、在哪里能买到、怎么下单付款。围绕这三个问题，网站只需要做好四件事：商品分类展示、用户注册登录、购物车结算、后台订单管理。别看功能少，把这四件事用 Servlet 做扎实，已经能覆盖一个小型特产商城 80% 的业务场景。

我特别想强调一点：这个项目选择的是 B2C 模式里的“企业展示 + 在线购物”混合体。前台是面向消费者的商品浏览页，后台是面向管理员的商品和订单管理页，两套操作逻辑完全分开。这种设计在真实的地方特产网站里太常见了，所以它的业务模型非常贴近实际，不是那种为了凑功能硬塞的“空中楼阁”。

1.2 为什么用 Servlet 而不是 Spring Boot

我知道很多人一看到 Servlet 就皱眉头，觉得这技术“太老了”。但放在这个项目里，Servlet 恰恰是最合适的选择。原因不复杂：这套系统复杂度不高，无非是增删改查、页面跳转、会话管理，Servlet 写这些任务完全够用，而且没有任何额外依赖，部署到一个 Tomcat 就能跑。相比之下，Spring Boot 虽然开发效率高，但它引入了 IOC 容器、自动配置、starter 依赖这一堆概念，对于刚学完 Java 基础、想搞懂 Web 原理的新手来说，反而容易一头扎进“复制粘贴”的坑里。

还有一个实际原因：很多学校课程设计和毕业设计对技术选型有严格要求，指定用 JSP + Servlet 的比比皆是。不是老师守旧，而是 Servlet 是 Java Web 的地基，你用它写过一个电商系统之后，再去看 Spring MVC、Spring Boot 的源码，会发现它们的请求分发逻辑和 DispatchServlet 本质上就是在 Servlet 之上封装了一层。我当年先做了 Servlet 项目，后面学 Spring MVC 的时候感觉像是“旧友重逢”，一点都不陌生。

另外，Servlet 项目调试起来直来直去。一个请求从浏览器进来，命中哪个 Servlet、调用了哪个方法、返回了哪个 JSP，都清清楚楚写在 web.xml 和代码里，出问题随手加个 System.out 就能定位。Spring Boot 里一个 Bean 注入报错可能绕半天，在这个项目里几乎不存在这种问题。对你理解 HTTP 协议、请求响应周期、Session 机制来说，这反而是最生动的教材。

2. 平台功能模块与数据库设计

2.1 前台功能：商品浏览、用户登录、购物车与订单

前台是消费者能直接看见的部分，整个流程可以概括成一条线：逛商品 → 注册/登录 → 加购物车 → 提交订单 → 查看订单状态。这套源码把这条线完整实现了。

商品浏览模块包括首页轮播图、热门商品区、分类列表。首页通常展示几件推荐商品，点击进入商品详情页后能看到大图、价格、库存、商品描述。这里的实现思路很简单，商品数据从数据库查出来放到 request 域里，JSP 页面用 JSTL 的<c:forEach>循环展示。

用户模块最关键的是注册和登录的状态管理。注册时一般处理用户名重复校验、密码 MD5 加密；登录成功后把用户对象放进 session，同时更新用户表里的最近登录时间。这里要特别注意退出登录的按钮，它的 Servlet 里得执行session.invalidate()，把整个 session 作废，否则用户按了退出，其他人依然能用这台电脑上的旧 session 冒充他操作。

购物车模块是前台的灵魂。这里有两种主流方案：一种是把购物车数据存到 session 里，用 Map 保存商品 ID 和数量；另一种是建一张购物车表，把购物车数据持久化到数据库。这套源码采用的是 session 方案，理由很简单——购物车本来就是临时性的，用户没下单之前，让数据库存着一堆半成品数据意义不大。session 方案处理流程是：点击“加入购物车” → 把商品 ID 和购买数量封装进 CartItem 放到 session → 购物车页面读取 session 里的商品列表并计算总价。

订单模块则把 session 里的购物车数据清空，生成一条订单记录插入数据库。提交订单时往往要做一个库存扣减的操作，但要注意必须先判断库存是否充足，否则可能出现超卖。另外，订单表要记录下单时间、订单总金额、收货人信息、订单状态（待付款 / 已付款 / 已发货 / 已完成），状态字段用数字表示比较方便扩展。

2.2 后台管理：商品管理、订单管理与公告管理

后台页面和前台是完全分离的。管理员先通过一个单独的后台登录入口验证身份，然后才能进入管理界面。很多学生项目在这个环节有个通病：只验证用户是不是登录了，没验证是不是管理员，导致注册一个普通账号就能跑到后台乱改数据。这套源码在后台过滤器中做了权限校验，非管理员请求会被拦截跳回登录页，这个细节非常值得学习。

商品管理模块提供商品列表、新增商品、编辑商品、上架/下架、删除商品几个操作。新增和编辑都涉及图片上传，Servlet 获取上传文件之后，需要把图片保存到服务器指定目录（比如upload/文件夹），再把访问路径存入数据库。这里要特别注意中文文件名乱码，后面我会专门讲。

订单管理模块通常包含订单列表、订单详情、修改订单状态、删除订单。订单列表要支持按状态筛选、按时间排序。管理员的操作面板上最好显示“待发货数量”这种统计数据，让管理员打开后台一眼就知道今天要处理哪些单。这部分虽然只是简单的 SQL 查询，但统计的逻辑写好了，后台体验会提升一个档次。

公告管理模块用来发布首页公告和新闻动态。地方特产网站很适合加这个模块，可以用来发布砂锅文化介绍、促销活动、物流说明等内容。公告表结构也很简单，就是标题、正文、发布时间、是否置顶。

2.3 数据库表结构与关键字段

我从这套源码里提炼出一套最精简的数据库结构，直接照着建表就行。核心表一共七张：用户表、商品分类表、商品表、购物车表（可选）、订单表、订单明细表、公告表。如果还想做商品评论，可以再加一张评论表，但基础版用不到。

用户表关键字段：id、username、password、phone、address、role、create_time。其中role字段用0表示普通用户，1表示管理员，这个设计在登录判断时比再去查一张角色表简单得多。

商品分类表关键字段：id、name、description。商品表关键字段：id、category_id、name、subtitle、price、stock、image、description、status。status用1表示上架、0表示下架，商品列表只查status=1的数据。

订单表关键字段：id、order_no、user_id、total_price、consignee_name、consignee_phone、consignee_address、status、create_time。订单明细表关键字段：id、order_id、product_id、product_name、product_image、product_price、quantity、subtotal。

注意到没有，订单明细表里把商品名称、图片、价格这些“快照”数据也存了一份，而不是只存商品 ID。这是非常重要的设计：如果商品后来改价了、删除了，历史订单里的金额和商品名称仍然能保持当时的下单状态，不会跟着商品表一起变。很多新手在设计订单时只存了商品 ID，最后订单详情页查不出商品名称，还得去关联商品表，商品一旦删了订单就变成“小黑人”。这里把快照存进去才是电商系统的常规玩法。

下面我画一个简化版的数据库关系说明表格，方便你对字段心里有数：

3. 核心代码实现解析

3.1 Servlet 控制层设计：请求分发与参数处理

这套源码的 Servlet 没有用任何框架，完全靠继承HttpServlet并重写doGet()和doPost()来实现。但它的类设计有一个明显的特点：不是每个小功能写一个 Servlet，而是按业务模块聚合。比如商品模块只有一个ProductServlet，通过action参数来区分list、detail、add、update、delete等操作。请求进来之后，Servlet 先获取action参数，再用switch语句分发到不同的方法。这样既减少了类的数量，也让代码的归属感更强。

这种写法的好处是：当你看到一个请求product?action=detail&id=8，你马上能在ProductServlet的switch (action)里找到对应分支，不用在几十个 Servlet 类里翻找。对于只有几十个接口的小项目来说，一个模块一个 Servlet 的组织方式比一个功能一个 Servlet 更清晰。当然，等以后项目大起来了，一个 Servlet 里塞十几个 action 方法会变得臃肿，那就该考虑引入 Spring MVC 的注解路由了。在现阶段，这套代码的逻辑是合理的。

处理请求时有个细节要注意：如果前台用的是表单提交，提交按钮是 POST 方法，但页面链接跳转是 GET 方法，所以 Servlet 里通常会把doGet和doPost都指向同一个process方法，保证两种请求方式都能正确处理。别小看这个操作，很多初学者因为只写了doPost，结果在浏览器地址栏直接访问 Servlet 链接时报 405 错误，一脸懵。

3.2 JSP 页面与 Session 状态管理

JSP 在项目里同时承担了“模板”和“页面逻辑”两个角色。为了减少重复代码，页面通常会把头部导航、底部版权声明封装成单独的 JSP 片段，再用<jsp:include>引入。比如每个页面都要显示“欢迎你，XXX”以及购物车数量，这段逻辑放在头部公共片段里，主页面就不用重复写了。

Session 状态管理是这套系统的核心。用户登录成功后，把User对象放进 session，后面的每个请求都能通过session.getAttribute("user")获取当前用户。在 JSP 页面里，可以用 JSTL 的${sessionScope.user.username}直接输出用户名。判断用户是否登录，就用<c:if test="${empty sessionScope.user}">来区分，未登录时显示登录按钮，已登录时显示用户中心。

这里有个很重要的安全细节：千万不要把用户 id 直接通过 URL 参数传递，比如/order/delete?userId=2这种。如果后台逻辑里拿到的 userId 是 URL 传的，别人随便改参数就能操作别人的订单。正确的做法是从 session 里取当前登录用户的 id，然后用 SQL 的 where 条件限制只能操作属于当前用户的数据。这套源码在订单列表查询时就是这么做的，这是很多学生项目会漏掉的地方。

Session 还有一个隐性问题：HTTP 协议本身是无状态的，Session 依赖 Cookie 里携带的 JSessionID 来识别用户。如果在 JSP 里出现了<c:out>和 HTML 结构混写的情况，要留意 Cookie 是不是被禁用了。不过现在的浏览器默认都开着 Cookie，这个坑出现的概率极低，了解一下原理就行。

3.3 购物车与订单生成的业务逻辑

购物车模块是最容易出现“假逻辑”的地方。我见过不少项目点“加入购物车”以后就是弹个窗，刷新下数据其实并没有真正加进去。这套源码的购物车实现比较实在：使用HttpSession存一个Map<Integer, Integer>，key 是商品 ID，value 是数量。每次加入购物车时，先检查 Map 里有没有这个 key，有就在原数量上加一，没有就放一条新记录。在购物车页面，遍历 Map 的 keySet，逐个从数据库查商品最新价格，再累加总价。

生成订单的过程必须是一个“扣库存 → 插入订单 → 清空购物车”的完整链路。代码里要注意执行顺序：先把订单主表插进去拿到自增 id，再把购物车里的每一项转换成订单明细记录插入订单明细表，最后把对应商品的库存减掉。如果中途任何一步失败，都应该通过事务回滚，保证数据一致。但这对纯 Servlet 项目来说有点麻烦，你可以选择在 MySQL 里把这三件事包在一个存储过程里，或者用 JDBC 的setAutoCommit(false)手动控制事务。这套源码本身没有用完整事务，我建议你有精力还是要把这块补上，防止高并发场景下库存扣了订单没生成、或者订单生成了库存没扣的情况。

订单编号生成也值得一提。直接用数据库自增 id 当订单号太容易暴露销量，一般会生成一个yyyyMMddHHmmss + 随机数的字符串，比如202506121030156278。这样既保证唯一，也方便后台按时间查询。

3.4 图片上传与本地存储方案

商品图片上传是后台必做的功能。Servlet 3.0 之后，上传文件可以用@MultipartConfig注解配合request.getPart("file")来接收文件，不用再去解析二进制流了。代码大致是：先判断上传目录存不存在，不存在就创建；然后用 UUID 重命名文件，避免中文名或重复文件名；最后把文件写入服务器磁盘，把访问相对路径存到数据库。

这里有两个关键点。第一，重命名时千万别保留原文件名，否则用户一旦上传一个名字叫1.jpg的图片，第二次上传的同名文件就会覆盖第一次的；用UUID.randomUUID().toString()生成的新文件名几乎不会重复。第二，上传目录的物理路径要动态获取，不能用写死的绝对路径。常见做法是request.getServletContext().getRealPath("/upload")，这样无论 Tomcat 部署在哪个磁盘，都会找到项目根目录下的 upload 文件夹。

还有一个容易被忽略的坑：JSP 页面里显示图片用的是数据库存的路径，比如/upload/abc.jpg，这个一定要以项目上下文路径开头。如果项目部署后路径变了（比如项目名改成了另一个），这些写死的路径会全部失效。稳妥做法是在 JSP 里用${pageContext.request.contextPath}/upload/abc.jpg拼接上下文路径，这样哪怕项目改了个名字，图片也能正常显示。这一点代码里如果能统一处理，后台商品图片展示就不会出现一片红叉了。

4. 源码导入与运行教程

4.1 环境准备与工具版本选型

先把运行这个项目需要的环境工具列个清单。JDK 版本建议用 1.8，与老项目的兼容性最好，Tomcat 也用 8.5 或 9.0，这两个版本搭配 Servlet 3.1/4.0 非常稳定。MySQL 用 5.7 或 8.0 都行，注意如果 MySQL 8.0，数据库驱动要用com.mysql.cj.jdbc.Driver，连接字符串要加serverTimezone=Asia/Shanghai，否则 JDBC 连接会报时区错误。

开发工具方面，Eclipse 的 Java EE 版和 IntelliJ IDEA 都行。如果你还是在校学生，我更推荐 Eclipse，因为它对 Tomcat 的集成方式更直白，添加服务器、部署 Web 项目都是傻瓜式操作，适合新手。IDEA 虽然好用，但它的 Web 项目部署依赖 Artifact 和外部服务器配置，第一次上手容易懵，弄错一步就启动不了。

数据库工具直接用 Navicat 或者 MySQL Workbench，建议用 Navicat 的“运行 SQL 文件”功能把附带的sql文件一次性导入，省去手动建表的麻烦。源码包里一般都会附带数据库初始化文件，名字类似db_zhijin_shop.sql。如果没找到，你就按我上面给出的表结构自己手工建表，再把几条测试数据 insert 进去也能跑起来。

4.2 导入 Eclipse / IDEA 并配置 Tomcat

不同工具导入项目的方式略有差异。在 Eclipse 里，打开菜单File → Import → General → Existing Projects into Workspace，选择源码根目录，Eclipse 会自动识别出 Web 项目（.project文件）并导入。导入后你要检查项目结构的 build path 是否包含了 Tomcat 依赖和 JDK 库，如果没包含，右键项目 →Properties → Targeted Runtimes勾选 Apache Tomcat，再在Java Build Path里把原来的错误引用删掉，换成 Server Runtime 里的 Tomcat。

IDEA 的话，操作是File → Open直接选择源码文件夹，弹出来的窗口选择“Trust Project”。IDEA 导入传统 Web 项目时会提示是否创建 Facets，你需要在Project Structure里设置好 Web 模块的 Web Resource Directory 为WebContent或webapp，再添加 Artifact（类型选 Web Application Exploded），最后点运行按钮选择 Tomcat 服务器。这里麻烦，我强烈建议第一次跑 Servlet 项目的同学用 Eclipse，省下的时间够你多调试两遍代码。

4.3 配置数据库连接与 Tomcat 部署

数据库连接信息一般集中在src/db.properties文件里。打开后你会看到类似下面的内容：

driver=com.mysql.jdbc.Driver url=jdbc:mysql://localhost:3306/zhijin_shop?useSSL=false&characterEncoding=utf8&serverTimezone=Asia/Shanghai username=root password=yourpassword

把username和password改成你本机的数据库账号密码即可。url里的zhijin_shop是数据库名，要和你导入的 SQL 数据库名保持一致。注意如果 MySQL 版本是 8.0 以上，driver要写成com.mysql.cj.jdbc.Driver，否则运行时提示ClassNotFoundException。

数据库连好之后，在 Eclipse 里右键项目选择Run As → Run on Server，选择本地 Tomcat 实例，项目就会自动部署到 Tomcat 的 webapps 目录下。启动成功后，浏览器访问http://localhost:8080/项目名/，比如http://localhost:8080/zhijin_shop/。默认管理员账号通常在 README 里写了，或者在初始化 SQL 里能看到，一般是admin / admin之类。

4.4 常见部署报错排查速查表

我整理了一份这套项目运行最常见的报错及解决办法，按出现概率排序：

这几个问题我基本都在实际运行中遇到过。特别是数据库连接这一关，十个新手有八个栽在driver版本和serverTimezone上，照着表格改完基本就通了。

5. 我在实际项目中的经验与避坑建议

5.1 JDBC 必须用 PreparedStatement

这项目里所有数据库操作都是 JDBC 写的，很多代码片段里居然还出现了 Statement + 字符串拼接 SQL 的情况。我知道这是相当大一部分 Servlet 项目的通病，但我还是要强调：直接用Statement执行拼接 SQL，不但容易被 SQL 注入，还特别容易因为引号、单引号、空格问题写错。改成PreparedStatement之后，参数用?占位，再通过setString、setInt赋值，既安全又不用费劲去拼接引号，代码可读性也上一个档次。

举个例子，写商品列表查询：

String sql = "SELECT * FROM product WHERE category_id = ? AND status = 1 ORDER BY id DESC"; PreparedStatement ps = conn.prepareStatement(sql); ps.setInt(1, categoryId); ResultSet rs = ps.executeQuery();

看着只改了两三行，但这一改，解决了用户输入1' OR '1'='1这类注入问题。对于一个练手项目来说，这可能是你最早接触到“安全编程”的机会，别让简单字符串拼接把这个机会浪费掉。

5.2 编码统一一下，少掉一半头发

这套源码如果出现乱码，大部分是因为 JSP、Servlet、数据库、页面显示四层的编码没统一。我的建议非常简单：所有 JSP 页面统一加pageEncoding="UTF-8"；Servlet 里在方法开头加request.setCharacterEncoding("UTF-8")；JDBC 连接 URL 加characterEncoding=utf8；MySQL 建库时统一用utf8mb4。上中下三层全部 UTF-8，基本不会乱。

还要注意 Tomcat 8 之后 URI 编码默认就是 UTF-8，一般不用再改 connector。如果你用的是 Tomcat 7 或更早版本，那还得去 server.xml 里给 Connector 加一个URIEncoding="UTF-8"的属性，否则地址栏里的中文参数必乱。现在大家都用 8.5 了，这个坑稍微少一点，但万一你电脑上装的还是老版本，这个配置就要检查一下。

5.3 项目后续还能怎么扩展

这个推广平台如果真想上线并用起来，我觉得有几个方向值得扩展。第一，把购物车从 Session 改成数据库表，用户换电脑购物车也不丢；第二，加上支付宝沙箱或微信支付（至少能模拟下单），订单状态才能真正自动流转；第三，商品加一个库存下限提醒，库存低于 5 件时后台飘红；第四，给商品加多图轮播和热门搜索词；第五，接入百度统计或者 CNZZ，看看访客主要来自哪个地区，这样才知道推广得往哪边使劲。

我还特别建议把“织金砂锅文化”单独做成一个栏目页面，放图片、文字、甚至视频链接，用故事来带动产品销售。地方特产的核心竞争力就是文化和手工，光靠普通商品列表很难让人下单，加一段“砂锅是怎样炼成的”页面转化率可能会明显提升。这个项目底子已经有了，花一个周末扩展成个小而美的特产电商完全做得到。

最后再分享一个小技巧：我在运行这套源码时，习惯先把所有 Servlet 的doGet/doPost入口打一行日志System.out.println("访问了 " + request.getRequestURI())，调试的时候看控制台就能知道请求到底到没到 Servlet、卡在哪一步。项目小，日志随便打；项目大了再换 log4j。这也是我大学时代调试 Servlet 项目用的笨办法，但至今觉得特别好用。

这套织金砂锅推广平台源码，代码量不大，但把 Java Web 最核心的几个模块——请求分发、会话管理、数据操作、文件上传——全部串起来了。如果你正在学 Servlet，建议不要停留在运行层面，亲手把购物车逻辑改一遍、给后台加一个字段、再跑一次完整流程，收获会比看十篇教程都大。