简介面向JavaWeb初学者的简易购物车源代码完整演示了基于服务器端Servlet与JSP技术结合Session会话跟踪、JDBC数据库访问以及MVC分层思想的经典电商业务流程适合正在学习Web开发、准备课程设计或毕业设计的学生参考。压缩包共54个文件以14个Java源码、6个JSP页面和14个class编译文件为核心另含配置文件、数据库设计说明、安装说明与开发笔记整体仅1.58MB但结构清晰便于按模块拆解学习。已有4125人浏览学习是入门JavaWeb时值得参考的基础项目。除可运行代码外还附带详尽的笔记资料逐一讲解商品列表展示、加入购物车、修改数量、删除商品、会话状态保持及订单结算等功能的实现逻辑同时给出数据库表结构设计、JDBC增删改查要点和常见异常处理思路。读者不仅能从源码中理解HTTP请求与响应的处理过程还能借助注释和文档快速搭建同类业务系统对有课程设计或实训需求的人尤其实用。1. 拿到这份 javaWeb 购物车源代码先搞清楚它能替你省多少事不少刚学完 Servlet 和 JSP 的人卡在第一步看懂了语法却不知道怎么把登录、商品列表、加入购物车、结算这些模块串成一个能跑的完整项目。这份 javaWeb 简易购物车源代码做的就是这件事。它不是一个教学 PPT也不是一堆零散的类文件而是一套可以直接导入 IDEA、连上 MySQL 就能跑起来的前后端一体小项目。核心逻辑围绕购物车展开用户登录后浏览商品、加入购物车、修改数量、删除条目、模拟结算后端用 JSPServletJavaBean 实现数据库脚本已经备好你不需要自己建表。适合两类人一是做课程设计或毕业设计的学生拿它当骨架改改就能交二是刚开始接触 javaWeb 完整项目、想搞明白 request、session、转发重定向在真实项目里怎么配的人。先说结论这资源最大的价值不是“能跑”而是每个类都短小、命名直白代码追踪起来不需要在十几个文件之间跳来跳去这对新手极其友好。接下来我带你把它拆开从环境配置到表设计再到核心代码和常见坑一条线走完。2. 开发环境与启动配置IDEA 里跑通 javaWeb 项目的第一步要复现这份源码先把运行环境对齐。购物车项目用的是传统 javaWeb 技术栈前端 JSP 页面后端 Servlet 处理请求JavaBean 做数据封装数据库用 MySQL服务器用 Tomcat。这套组合现在看起来“老”但课程设计和很多企业老项目还在用而且它足够简单——对理解 HTTP 请求如何被容器分发给 Servlet 很有帮助。2.1 JDK、Tomcat、IDEA 的版本搭配思路环境版本是最容易翻车的地方。常见做法是 JDK 8 Tomcat 8.5 或 9.x IDEA 2020 以上MySQL 看你的习惯5.7 或 8.0 都行但连接驱动和 URL 写法略有区别。首次导入项目时我一般这样操作IDEA 里选择 File - New - Project from Existing Sources找到项目根目录选 Import project from external model再选 Eclipse 或 Maven。如果项目里带 pom.xml选 Maven 一步到位如果只有 .classpath 和 .project 文件说明是 Eclipse 工程结构选 Eclipse 导入后 IDEA 会自动转成自己的工程格式。导入完成后重点检查三件事Project Structure 里的 Project SDK 是否指向 JDK 8Libraries 里是否已经引入项目 lib 目录下的 jar 包Artifacts 里是否生成了 war exploded 包并且 Output Layout 里有 WEB-INF/lib 和 WEB-INF/classes。这三项不配好运行时会报 ClassNotFoundException 或 404。提示如果项目里没有 pom.xml而是手动管理 jar 包记得确认 lib 目录下的 mysql-connector-java、jstl 等 jar 已经被 Add to Libraries。一个常见错误是只把 jar 放进了磁盘目录IDEA 里没引入结果编译能过、运行时报找不到驱动。2.2 部署 Tomcatwar exploded 模式与热部署设置在 IDEA 里点击 Run - Edit Configurations左上角加号选 Tomcat Server - Local。在 Deployment 页签点击加号选择 Artifact优先选 war exploded 模式。这个模式不会把项目打包成 war 文件再解压而是直接把编译产物和资源文件映射到 Tomcat 的 webapps 下好处是修改 JSP、Java 文件后热部署能立即生效调试效率比 war 包模式高一倍。Application context 建议改成/cart这样访问路径就是http://localhost:8080/cart而不会带那一长串默认路径。改完之后在 Server 页签里把 On frame deactivation 设为 Update classes and resources勾选 Open browser 里的 After launch浏览器选了 Chrome。这样每次改完 Java 代码只要 IDEA 窗口失焦它就会自动重新编译并发布刷新浏览器就能看到效果。2.3 MySQL 初始化先跑脚本再连项目数据库是购物车项目的重头戏。项目里一般会附带一个 cart.sql 或 init.sql 文件通常在src/com/.../db目录下或者放在项目根目录。不要自己手动建表直接执行脚本表结构和几条测试商品数据一次性到位。执行后建议马上验证两件事。第一脚本里是否创建了 user 表、product 表、cart_item 表。第二测试账号是否可用——很多这类项目里默认用户是 admin / 123456 或 user / 123456只要你导入了脚本查看数据就能确认用不着一通乱猜。在项目里找到数据库连接配置文件db.properties或DBUtil.java检查里面的是数据库用户名和密码。这里有个很现实的问题如果作者开发时用的是 root/123456你的 MySQL 密码是 root/root启动项目后访问商品列表会立刻抛数据库连接异常。这种异常会在 IDEA 控制台里刷出一长串堆栈顶部写着Access denied for user或Communications link failure。2.4 启动后页面 404 或空白按这三步查我第一次跑这个项目时也遇到过 404后来总结出一个稳定的排查顺序。第一步看 IDEA 控制台有没有报异常如果 Tomcat 启动日志正常、没有红色堆栈问题通常在访问路径上。第二步看浏览器地址是不是http://localhost:8080/cart/把端口号和 context path 都对一遍——我见过因为 Application context 里多了个空格导致 404 的情况这类错误隐藏很深。第三步看 WEB-INF 下的 web.xml确认欢迎页配置的是 index.jsp 还是跳转到某个 Servlet如果欢迎页配置的是/index.jsp但 JSP 文件实际放在别处也会白屏。注意如果启动时 IDEA 控制台提示Port 8080 is already in use说明端口被占用了。常见原因是上次 Tomcat 没正常关闭。解决方式是去logs目录下看 Tomcat 的日志或者直接换个端口比如 8081——Tomcat 的 server.xml 里把 Connector 端口改掉就行一行配置的事。3. 库表结构与连接层购物车数据流的地基购物车的核心数据关系其实不复杂用户、商品、中间状态。难点在于“加入购物车”这个动作怎么映射到表设计里——是该往购物车表里插一条新记录还是把相同商品的购买数量累加这不只是增删改查的问题它会直接影响代码层的判断逻辑和 SQL 写法。3.1 三张表的设计逻辑与字段取舍标准做法是建三张表user、product、cart_item。user 表字段一般是id、username、password有项目会加上nickname或create_time。这张表就一个作用登录校验后拿到用户身份方便后续查询“这个用户购物车里有什么”。product 表是商品信息id、name、price、pnum库存数量、image、desc。注意 price 字段要选 decimal 类型不要用 float 或 double——浮点数计算价格在 Java 里会出现 0.1 加 0.2 不等于 0.3 的问题这在购物车数量合计和金额计算场景下很容易被忽略等用户问“为什么总价差一分钱”时你已经搭进去了。课程设计级别用 decimal(10,2) 最稳。cart_item 表是连接用户和商品的桥梁字段包括id、user_id、product_id、quantity有的项目会加create_time。这张表在动手写 SQL 之前先想明白一个问题同一个用户往购物车加同一个商品是插入一条新记录还是把已有记录的 quantity 加 1我的建议是后者不然同一个商品会重复出现在购物车列表里看起来像是两份结算逻辑还要去重。实际编码时先SELECT * FROM cart_item WHERE user_id? AND product_id?查到了就UPDATE quantityquantity1查不到才INSERT。3.2 DBUtil 连接层DriverManager 和连接池的取舍这份源码里大概率用的是简单 JDBC DriverManager 方式。它长这样public class DBUtil { private static final String URL jdbc:mysql://localhost:3306/cartdb?useSSLfalsecharacterEncodingutf8; private static final String USER 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, USER, PASSWORD); } }这段代码是传统写法逻辑上分两层static 块里加载驱动类getConnection 每次调用都会创建一个新连接。useSSLfalse是为了避免 MySQL 8 在连接时对 SSL 证书做校验而characterEncodingutf8保证中文商品名写入数据库时不会变成乱码。注意如果你的 MySQL 是 8.x驱动类名要改成com.mysql.cj.jdbc.Driver而且 URL 里还要加一个serverTimezoneAsia/Shanghai参数。MySQL 8 对时区校验很严格不加这个参数会直接抛The server time zone value Öйú±ê׼ʱ¼ä is unrecognized的异常。这个问题也出现在项目采用了新的驱动包但连接串还是 5.x 写法时。3.3 商品列表与购物车数据流从数据库到 JSP 页面商品列表的查询逻辑很简单一个 Servlet 调 DAO 从 product 表查出所有商品放进 request 域再用RequestDispatcher.forward()转发到 product_list.jsp。这里要理解为什么用转发而不是重定向转发是服务端内部跳转request 对象里的商品数据能直接带到 JSP重定向是两次请求request 里的数据就丢了。购物车列表的数据流稍微绕一点先根据当前登录用户查 cart_item 表拿到所有商品 id 和数量再拿这些 id 去 product 表查商品详情最后把两个结果拼在一起。这种数据在 Java 里常用CartItem对象封装比如product和quantity两个字段。是的这个类和数据库的 cart_item 表对应但如果你把查出来的商品名、单价也放进去页面展示就能少做一次嵌套循环。3.4 IDEA 里运行 javaWeb 项目时数据库中文乱码的三个检查点中文乱码是这类项目的高频问题本质是三层编码不一致数据库表、JDBC 连接、JSP 页面。我的习惯是依次检查JSP 页面顶部有没有写% page contentTypetext/html;charsetUTF-8 languagejava %数据库连接 URL 里有没有characterEncodingutf8MySQL 表本身的编码是不是 utf8mb4——这是最容易漏的表建错了其他层全部正确也白搭。在 Navicat 里右键表看字符集设置。如果已经建好了表且数据已经有乱码可以执行alter table product convert to character set utf8mb4;修改表级编码。但要注意修改表编码只对后续写入生效已经存在的乱码数据需要删掉重录。4. 购物车核心功能拆解加入、更新、删除与结算前面配置和表结构理清楚之后接下来就是整个项目的主体购物车模块的四个核心功能。它们分别是加入购物车、修改购买数量、删除条目和结算。每个功能本质就是一次请求-处理-响应流程但有几个细节踩过坑的人才会懂这里我会把每个功能的完整代码骨架和参数说明写出来。4.1 加入购物车查重是避免商品重复的关键先看点击“加入购物车”按钮后发生了什么。前端按钮通常是这样的a href${pageContext.request.contextPath}/AddCartServlet?productId${product.id}quantity1加入购物车/a用户点击后浏览器向 AddCartServlet 发送 GET 请求携带商品 id 和数量。Servlet 中先判断用户是否已登录从 Session 中取然后调用 DAO。加入购物车的核心代码如下protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { // 从请求中获取商品 id 和数量productId 用于定位商品quantity 表示本次加入的数量 int productId Integer.parseInt(req.getParameter(productId)); int quantity Integer.parseInt(req.getParameter(quantity)); // 从 Session 中获取当前登录用户若用户未登录则跳转登录页 User user (User) req.getSession().getAttribute(loginUser); if (user null) { resp.sendRedirect(login.jsp); return; } // 核心逻辑先查购物车是否已有该商品有则更新数量无则新增记录 boolean exists cartDao.exist(user.getId(), productId); if (exists) { cartDao.updateQuantity(user.getId(), productId, quantity); } else { cartDao.addItem(user.getId(), productId, quantity); } resp.sendRedirect(CartServlet); }这里有两个关键点exist查询和updateQuantity必须是一个数据库事务吗答案是在这个场景下可以不那么严格。但如果你的 DAO 里exist和updateQuantity两步合不成一个方法并发请求时可能出现一条记录变成了两条。更稳妥的做法是写一个INSERT ... ON DUPLICATE KEY UPDATE语句利用 user_id 和 product_id 的唯一索引一步完成“存在则更新不存在则插入”。你只要在建表时给 cart_item 加一个UNIQUE KEY uk_user_product(user_id, product_id)这条 SQL 就完全够用。4.2 购物车列表展示与金额计算避免 JSP 里写死逻辑加入购物车后展示购物车通常由 CartServlet 完成。逻辑简单查出当前用户的 cart_item 记录再逐条关联 product 表信息封装成一个 CartItem 列表放进 request 域转发到 cart.jsp。在 JSP 里用 JSTL 循环输出。虽然项目可能使用了 scriptlet但这里请你尽量用c:forEach因为 scriptlet 在页面里会造成 Java 代码与 HTML 混合改需求的时候很痛苦维护成本高。购物车总金额的计算建议放在 Servlet 或 JavaBean 完成不要在 JSP 里用% %去算。否则页面代码会变成一锅粥。一个清淅的写法是在 Servlet 里先遍历所有 CartItem用BigDecimal累加价格乘数量再把结果setAttribute(totalPrice, totalPrice)传到页面。这里再次强调用BigDecimal的原因——直接用 double 计算累加多个商品金额时会出现精度偏差这是我在一个复用他人代码的项目里亲测翻车过的。4.3 修改购物车数量数量为 0 时是清空还是保留修改数量的事件由页面上的加减按钮触发——每点击一次就向 UpdateCartServlet 发送一个参数。在执行更新前Servlet 会判定数量是否小于 1。下面是更新逻辑的常见写法// 当数量为 0 时直接把该条目从购物车删除而不是保留数量为 0 的空壳 int quantity Integer.parseInt(req.getParameter(quantity)); if (quantity 0) { cartDao.deleteItem(userId, productId); } else { cartDao.updateQuantity(userId, productId, quantity); }总体上用 Ajax 局部刷新更好因为传统的同步提交会在每次加减数量时刷新整个购物车页面用户加了三件商品页面就闪三次。如果项目里用到 jQuery就可以让按钮发送异步请求返回 JSON 更新该行的小计和底部总价。我不建议在 Servlet 中绕过前端直接返回一个 JSP会造成代码混乱。4.4 删除与清空SQL 语句的两种参数形态删除购物车单项在 DAO 层就是一个简单的DELETE FROM cart_item WHERE user_id? AND product_id?。另一种“清空购物车”则不需要指定商品 id只需DELETE FROM cart_item WHERE user_id?。这两个方法的参数个数不同如果你把它们合并成一个方法用可选参数去判断写出来的 SQL 往往会因为参数位置错位产生难以复现的 bug。4.5 结算逻辑校验库存而不是直接下单成功购物车项目的收尾是“结算”。课程设计里结算动作通常不会对接支付接口而是跳到一个确认页面显示总金额后提示下单成功。新手容易在这里犯的错误查了一下库存就直接跳转成功页根本没有更新 product 表的 pnum 库存字段也没有做“库存不足”判断。合理业务链是这样的UPDATE product SET pnum pnum - 1 WHERE id ? AND pnum 1注意这个 SQL 有一个很有用的特性它在一条语句里完成了“检查库存”和“扣减库存”。如果 pnum 已经是 0这个更新会影响 0 行——这样在 Java 端检查受影响行数就能确定到底是库存不足还是下单成功。这种写法代替了“先 select 查库存再 update”的两步操作从头避开了并发下超卖的风险。首次执行时最好把受影响行数打印出来看看实际效果可以避免隐性 bug。5. 避坑专题javaWeb 购物车运行中最容易翻车的六个坑从 IDEA 导入到功能跑通这一路会遇到不少藏得很深的坑。我把这几年帮人调试类似项目积累的经验压成六条每一条都是“现象-原因-解决”的完整结构。5.1 IDEA 里找不到 Artifacts 配置项目发布不进去现象Run 面板里没有 Tomcat 可选或者 Artifacts 列表是空的点运行提示“No artifacts marked to deploy”。原因导入项目时选择结构类型不对或者 IDEA 没有识别到 Web 目录结构。解决在 Project Structure - Facets 里手动添加 Web。把 Web Resource Directory 指向项目的 webapp 目录或 WebContent然后把 Artifact 生成方式改为 Web Application Exploded。之后到 Deployment 配置里再去选就有了。我把这一步称为“手动给项目上户口”。5.2 启动后报 ClassNotFoundExceptioncom.mysql.jdbc.Driver现象Tomcat 启动正常但一访问商品列表页面直接报 500控制台堆栈显示找不到 MySQL 驱动类。原因项目里 lib 目录下有驱动 jar但 IDEA 的 Artifact 没有把它打进发布包里。解决打开 Project Structure - Artifacts选中输出根节点下的 WEB-INF右键 - Create Directory 建 lib 文件夹然后把 Jar 文件拖进去。注意这一步是往发布包里加不是往 Libraries 里加。验证方法去看 Tomcat 的 webapps 目录展开对应项目的 WEB-INF/lib确认 mysql 驱动 jar 确实在里面。5.3 MySQL 8 连接失败The server time zone value is unrecognized现象项目在别人电脑上能跑到了你的电脑上启动后访问数据库相关功能立即报错堆栈提示不认识服务器的时区值。原因MySQL 8 默认使用系统时区而 JDBC 驱动要显式指定 serverTimezone 参数否则双方校验不一致。解决数据库连接 URL 改成jdbc:mysql://localhost:3306/cartdb?useSSLfalsecharacterEncodingutf8serverTimezoneAsia/Shanghai。如果项目里多处写了连接字符串记得全部替换。5.4 JSP 页面中文全是问号或乱码现象商品名、用户昵称在页面上显示为???或者是一堆 Unicode 转义。原因响应编码或存储编码不对。最常见的是 MySQL 连接 URL 缺少 characterEncodingutf8或者 JSP 页面没有设置 contentType 编码。解决先修连接 URL再改 JSP 页面。操作正确后重新启动 Tomcat 再测试。如果还乱码看 MySQL 表结构确认表和字段是 utf8mb4 编码。部署在 Linux 上时站点乱码一般就是这里说的三层可以把它们按顺序排查。5.5 同一个商品在购物车里出现多行数量却不合并现象连续点击同一件商品的“加入购物车”购物车列表里出现了两行一模一样的数据。原因加入购物车时的代码只是无条件 INSERT没有先判断购物车表中是否已有该商品。解决按 4.1 中做法修改加入前先查 cart_item 表或者更稳的方案是给表加UNIQUE KEY(user_id, product_id)然后改用INSERT ... ON DUPLICATE KEY UPDATE quantity quantity VALUES(quantity)从数据库层面杜绝了重复插入的可能。5.6 点击“加入购物车”后总是跳回登录页现象明明登录成功了访问购物车相关功能却反复跳到 login.jsp。原因Servlet 里从 Session 中取用户信息但登录接口里写入 Session 的 key 与 Servlet 里读取的 key 不一致最常见的是前面写loginUser后面读user。解决全文搜索setAttribute和getAttribute两处统一 key 名称。我习惯在一处定义常量比如public static final String LOGIN_USER loginUser;Servlet 和 JSP 全部引用这个常量杜绝手写不一致的问题。6. 进阶把购物车从“能跑”改成“好维护”的三个改动项目能跑通只是第一步。如果你打算拿它交课程设计或者作为后续框架学习的起点有几个改动性价比极高。它们不改变项目整体结构但会让代码质量上一个台阶。第一个改动是彻底清除 JSP 里的 Java 脚本片段。很多旧式项目会在 JSP 页面里直接写% %循环和判断把数据库查出来的数据在页面上加工。我先做过一个明确的决定所有数据加工搬到 Servlet 或 DAO 层完成JSP 里只留 JSTL。具体操作很简单页面顶部导入 jstl 和 standard 的 jarlib 下已有然后把 scriptlet 替换成c:forEach和c:if。改动完成后 JSP 变得整洁前端页面美化的难度也会明显降低。第二个改动是把 DAO 层从“每个方法写一遍连接”改成“单例连接 预处理语句”。常见做法是加一个ConnectionManager管理数据库连接的获取和关闭。这个项目里用的是 DriverManager可以加一个 ThreadLocal 方式的连接绑定让它保持事务性。第三个改动也是最能直观验证购物车逻辑的方式是写一个简单的请求日志过滤器。定义一个 Filter拦截所有/cart/*和/AddCartServlet请求记录每个请求的 URL、参数和用户 Session ID。这个在调试购物车数量不同步时非常有效。下面是一个最小可用版本public class LogFilter implements Filter { Override public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException { HttpServletRequest req (HttpServletRequest) request; long start System.currentTimeMillis(); System.out.println([CartLog] 用户 req.getSession().getAttribute(loginUser) 请求 req.getRequestURI() 参数 req.getQueryString()); chain.doFilter(request, response); long cost System.currentTimeMillis() - start; System.out.println([CartLog] 耗时 cost ms); } }这个 Filter 的核心价值不在于记录耗时而是把“用户是谁、发了什么参数、请求到了哪里”完整串起来。当出现“同一用户购物车数量被覆盖”的 bug 时日志能直接告诉你问题出在哪个 Servlet。在 web.xml 里注册 Filter 时注意url-pattern填/cart/*和/AddCartServlet两个映射或者干脆填/*全部拦截但这样会连静态资源也拦截日志里会比较吵。最后一个值得做的改动是给购物车页面的加减按钮换成 iconfont 图标。这篇源码对应页面里如果用的是文字链接“1”你可以去阿里巴巴矢量图标库选一对加减号图标替换掉原按钮文字。这不只是好看图标按钮配合 Ajax 局部刷新是购物车交互的常见做法。你需要把 iconfont 的字体文件放到 webapp 的 fonts 目录下在 CSS 里引入并定义iconfont类然后用i classiconfont icon-jian和i classiconfont icon-jia替换原来的链接文字。跑购物车项目最深的教训是“数据格式不一致是万恶之源”。从那以后我每次启动这种带数据库的 web 项目第一件事就是写一个自检清单表是否导入、编码是否 utf8mb4、连接 URL 是否带时区参数、Session 里用户 key 是否统一。这套习惯帮我少加了很多班希望也能帮到你。本文还有配套的精品资源点击获取