简介这是一份面向JavaWeb初学者与课程设计者的网上商城实战项目源码以华为商城为业务原型帮助读者理解Servlet、JSP与JavaBean协同构建电商平台的完整流程。压缩包共2个文件包含1个rar源码包与1个sql数据库脚本整体约58.24MB前者涵盖Java类、配置文件、静态资源及依赖jar包后者用于快速创建表结构并填充初始数据导入MySQL即可还原配套数据环境。项目覆盖用户注册登录、商品浏览、购物车、订单处理等核心模块前端页面借助JSP与JSTL标签库实现动态展示后端通过Servlet处理HTTP请求是理解Web应用分层架构与数据库交互的典型范例。目前已有961人学习下载适合作为课程设计、毕业设计或自学练手素材读者可借此掌握从数据库建表到页面渲染的完整链路并对照源码梳理业务逻辑与排错思路。1. 从一份 JavaWeb 商城压缩包说起它到底能跑起来吗很多同学在课程设计或毕业设计阶段会拿到一个名为“javaweb华为商城.zip”的压缩包第一反应往往是双击解压然后对着满屏的文件夹发呆——这玩意儿到底能不能跑需要装什么数据库在哪后台管理员怎么进我见过太多人卡在第一步把项目导入 IDE 之后满屏红叉Tomcat 启动报 404数据库连不上最后只能换一个“看起来更简单”的题目。其实这类 JavaWeb 商城项目结构高度相似核心无非是 Servlet JSP JDBC MySQL 这套经典组合只要把环境对齐、数据库导入、路径改对跑起来并不难。这篇文章面向的是拿到类似压缩包却不知道从哪下手的同学也适合想拿它当二次开发底座的开发者。我会按“先看懂结构、再配环境、再导数据、再改配置、最后排错”的顺序把每一步的命令、参数和常见翻车点讲清楚让你能真正把它跑在自己机器上而不是停留在“解压即吃灰”。2. 拆开压缩包先别急着导入目录结构与技术栈判读2.1 一个典型 JavaWeb 商城项目的目录长什么样拿到压缩包后先别用 IDE 打开用系统自带的文件管理器或命令行看一眼顶层结构。常见的布局有两种一种是 Eclipse 风格的 Web 项目根目录下直接有WebContent、src、.classpath、.project另一种是 Maven 风格根目录下有pom.xml、src/main/webapp、src/main/java。你可以用下面这条命令快速列出两层目录判断它属于哪一种# Linux/macOS 下查看两层目录结构 find . -maxdepth 2 -type d | sort # Windows PowerShell 下查看两层目录 Get-ChildItem -Directory -Depth 1 | Select-Object FullName如果看到WebContent和.classpath说明它是老式 Eclipse 动态 Web 项目导入时需要选“Existing Projects into Workspace”如果看到pom.xml说明是 Maven 项目导入时选“Existing Maven Projects”。这一步判断错了后面依赖库全都不对会浪费大量时间。2.2 从 import 语句反推技术栈版本打开src下的任意一个 Servlet 或 DAO 文件看开头的 import。常见组合是javax.servlet.*配java.sql.*说明是原生 Servlet JDBC没有 Spring 全家桶。如果看到org.springframework.web.servlet那就是 SSM 架构配置复杂度高一个量级。数据库驱动看com.mysql.jdbc.Driver还是com.mysql.cj.jdbc.Driver前者对应 MySQL 5.x后者对应 MySQL 8.x。这个细节直接决定你后面 JDBC URL 要不要加时区参数。我一般会顺手在项目根目录建一个env-notes.md把判断结果记下来项目类型、Servlet 版本、MySQL 驱动版本、JDK 编译级别。别小看这几行字排错时能省半小时。2.3 依赖 jar 包在哪lib 目录与 Maven 坐标的取舍老式项目通常把 jar 包放在WebContent/WEB-INF/lib下你可以用ls或资源管理器数一下有多少个 jar。常见的有mysql-connector-java-x.x.x.jar、jstl.jar、standard.jar、servlet-api.jar。如果lib目录为空或缺失说明作者可能依赖了外部 Tomcat 的库或者项目本身不完整。Maven 项目则看pom.xml里的dependencies重点确认 MySQL 驱动、Servlet API、JSTL 的版本。如果pom.xml里 scope 写了provided说明这些包由 Tomcat 提供打包时不会带进去本地跑的时候要确保 Tomcat 的lib目录里有对应版本。这一步没确认启动时大概率报ClassNotFoundException。3. 把项目跑起来的最小闭环JDK、Tomcat、MySQL 三件套3.1 JDK 与 Tomcat 版本怎么选才不打架这类项目多数是 JDK 8 编译的用 JDK 11 或 17 跑可能遇到Unsupported class file major version或者反射相关的模块访问错误。稳妥做法是先装 JDK 8配置JAVA_HOME然后在 IDE 里把项目 SDK 和编译级别都设为 8。Tomcat 选 8.5 或 9.0不要用 Tomcat 10因为 Tomcat 10 把javax.servlet改成了jakarta.servlet老项目直接全军覆没。安装完 Tomcat 后在 IDE 里新建一个 Server 运行时指向 Tomcat 安装目录再把项目部署上去。下面是一个检查环境是否就绪的命令组合# 检查 JDK 版本 java -version # 检查 JAVA_HOME 是否指向 JDK 8 echo $JAVA_HOME # Linux/macOS echo %JAVA_HOME% # Windows CMD # 检查 Tomcat 版本查看 RELEASE-NOTES 或启动脚本 cat $CATALINA_HOME/RELEASE-NOTES | head -5如果java -version输出 1.8.0_xxx说明 JDK 没问题如果输出 11 或 17建议换回 8或者至少把项目编译级别降到 8 并加上--add-opens参数但后者麻烦得多新手不推荐。3.2 数据库导入SQL 文件里的建库语句与字符集陷阱压缩包里通常有一个sql文件夹或根目录下的.sql文件。先用文本编辑器打开看开头有没有CREATE DATABASE和USE语句。如果没有你需要手动建库库名一般能从 JDBC 配置里反推。导入命令如下# 登录 MySQL 并导入 SQL 文件 mysql -u root -p # 在 MySQL 命令行里执行 source /path/to/your_project.sql; # 或者直接在系统命令行导入 mysql -u root -p your_database_name /path/to/your_project.sql导入后执行SHOW TABLES;确认表数量。常见坑是 SQL 文件里用了utf8而你的 MySQL 默认是utf8mb4或者反过来导致中文乱码。建库时统一用CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci导入前在 SQL 文件开头加上SET NAMES utf8mb4;。如果导入报Unknown collation: utf8mb4_0900_ai_ci说明 SQL 文件来自 MySQL 8而你的服务器是 5.7需要把 collation 改成utf8mb4_general_ci再导入。3.3 改 JDBC 配置URL、用户名、密码、驱动类四个参数在src下搜索jdbc或db.properties找到数据库连接配置。常见形式是一个db.properties文件或者直接硬编码在DBUtil.java里。需要改的四个参数如下表参数常见值说明URLjdbc:mysql://localhost:3306/shop?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiMySQL 8 必须加时区否则报时区错误用户名root按你本地 MySQL 实际账号改密码123456改成你本地密码不要留空驱动类com.mysql.cj.jdbc.DriverMySQL 8 用 cj5.x 用com.mysql.jdbc.Driver改完后写一个最简单的测试类跑一下DriverManager.getConnection确认能连上再启动 Tomcat。这一步能过滤掉 80% 的“启动后 500 错误”。4. 启动之后才是真正的战场页面 404、500 与乱码排查4.1 404 先看访问路径和 web.xml 映射Tomcat 启动成功但访问http://localhost:8080/项目名/报 404先确认三件事项目部署后的 context path 是什么、web.xml里welcome-file-list配了什么、首页文件是否真实存在。在 IDE 的 Tomcat 配置里Deployment 选项卡会显示 Application context默认可能是/项目名或/。如果配成/访问时就不用加项目名。web.xml里常见 welcome-file 是index.jsp或login.jsp去WebContent下确认文件在不在。如果首页是 Servlet 映射的检查url-pattern是否写对。我习惯在浏览器里直接访问一个已知的 JSP 文件全路径比如/项目名/index.jsp能打开说明部署没问题打不开就是路径或文件缺失。4.2 500 错误看控制台堆栈的第一行 caused by500 错误信息在浏览器里往往只有一句“Internal Server Error”真正的线索在 IDE 控制台或 Tomcat 的logs/catalina.out里。从下往上找第一个Caused by:那才是根因。常见的有ClassNotFoundException: com.mysql.cj.jdbc.Driver驱动 jar 没放进WEB-INF/lib、NullPointerException某个对象没初始化多半是数据库没连上导致返回 null、SQLException: Access denied用户名密码错。不要被长长的堆栈吓到只看第一个 Caused by 和它下面一行基本就能定位。4.3 中文乱码请求、响应、数据库三处编码要统一乱码分三种页面显示乱码、表单提交后乱码、数据库里存的就是乱码。页面显示乱码改 JSP 开头的% page contentTypetext/html;charsetUTF-8 %表单提交乱码在 Servlet 里加request.setCharacterEncoding(UTF-8)且必须放在getParameter之前数据库乱码检查连接 URL 里的characterEncodingutf8和数据库、表的字符集。三处都统一成 UTF-8 或 utf8mb4基本能解决。如果还乱用SHOW VARIABLES LIKE character%;看 MySQL 服务端编码必要时改my.ini或my.cnf。5. 避坑与常见问题那些让我熬夜的配置细节5.1 坑一Tomcat 10 部署后所有 Servlet 报 404现象项目在 Tomcat 9 下正常换到 Tomcat 10 后所有 Servlet 访问都 404JSP 却能打开。原因是 Tomcat 10 把 Servlet API 的包名从javax.servlet迁移到了jakarta.servlet老项目里的import javax.servlet.*全部失效。解决办法是换回 Tomcat 9或者用迁移工具批量替换包名并升级依赖但后者工作量大不建议在课程设计阶段折腾。5.2 坑二MySQL 8 连接报“Public Key Retrieval is not allowed”现象JDBC URL 没加allowPublicKeyRetrievaltrue时连接 MySQL 8 报这个错。原因是 MySQL 8 默认用 caching_sha2_password 认证插件而老驱动或未开启 SSL 时无法完成密钥交换。解决办法是在 URL 后面加上allowPublicKeyRetrievaltrueuseSSLfalse同时确认驱动是mysql-connector-java-8.x.x。生产环境不要关 SSL本地开发图省事可以这么干。5.3 坑三导入 SQL 后表是空的但没报错现象source命令执行完没报错SHOW TABLES也有表但SELECT查不到数据。原因通常是 SQL 文件里INSERT语句被注释掉了或者导入时选错了数据库。先SELECT COUNT(*) FROM 某张表;确认再打开 SQL 文件搜索INSERT INTO看是不是被--或/* */注释了。还有一种可能是 SQL 文件用了CREATE DATABASE IF NOT EXISTS但后面没跟USE导致建表建到了默认库。5.4 坑四JSP 页面 EL 表达式不解析直接原样输出现象页面上显示${user.username}而不是实际值。原因是web.xml的 Servlet 版本太低2.3 或更低EL 默认不启用。解决办法是把web.xml的web-app版本改成 2.4 以上或者在该 JSP 开头加% page isELIgnoredfalse %。如果用了 JSTL 标签却报The absolute uri: http://java.sun.com/jsp/jstl/core cannot be resolved说明jstl.jar和standard.jar没放进WEB-INF/lib。5.5 坑五修改 Java 代码后重启 Tomcat 不生效现象改了 Servlet 或 DAO 里的代码重启 Tomcat 后行为没变。原因是 IDE 没有重新编译或者部署的是旧 class 文件。在 IDE 里执行Project Clean然后确认Build Automatically开着再重启。如果用的是 Maven执行mvn clean package重新打包。还有一种情况是 Tomcat 的work目录缓存了旧 JSP 编译结果删掉work/Catalina/localhost/项目名再启动。6. 从能跑到好用二次开发与验证的几个实用技巧把项目跑起来只是起点真正让它变成你自己的东西还得会改、会验、会加功能。我一般会先做三件事把数据库连接池从裸 JDBC 换成 Druid 或 HikariCP把重复的 DAO 代码抽成 BaseDao把前端 JSP 里的 Java 代码用 JSTL 和 EL 替换掉。这三步做完代码可维护性会明显提升。下面是一个用 HikariCP 替换裸 JDBC 的最小示例// 在 WEB-INF/lib 下放入 HikariCP 和 slf4j 的 jar // 新建 DBUtil.java import com.zaxxer.hikari.HikariConfig; import com.zaxxer.hikari.HikariDataSource; import javax.sql.DataSource; import java.sql.Connection; import java.sql.SQLException; public class DBUtil { private static final HikariDataSource dataSource; static { HikariConfig config new HikariConfig(); // 注意MySQL 8 的驱动类名和 URL 参数 config.setDriverClassName(com.mysql.cj.jdbc.Driver); config.setJdbcUrl(jdbc:mysql://localhost:3306/shop?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiallowPublicKeyRetrievaltrueuseSSLfalse); config.setUsername(root); config.setPassword(your_password); // 连接池核心参数最小空闲、最大池大小、超时时间 config.setMinimumIdle(2); config.setMaximumPoolSize(10); config.setConnectionTimeout(30000); config.setIdleTimeout(600000); config.setMaxLifetime(1800000); dataSource new HikariDataSource(config); } public static Connection getConnection() throws SQLException { return dataSource.getConnection(); } // 关闭连接实际是归还到池里不是真正关闭 public static void close(Connection conn) { if (conn ! null) { try { conn.close(); } catch (SQLException e) { e.printStackTrace(); } } } }这段代码的关键参数说明minimumIdle设 2 是为了本地开发不浪费连接maximumPoolSize设 10 对课程设计足够生产环境按数据库max_connections调整connectionTimeout30 秒是等待连接的最长时间超时说明池满了或数据库挂了maxLifetime30 分钟比 MySQL 默认的wait_timeout短避免拿到已被服务端关闭的死连接。改完之后原来的DBUtil.getConnection()调用方式不变但性能和稳定性会好很多。验证方面我习惯写一个简单的冒烟测试启动 Tomcat 后依次访问首页、登录页、注册页、商品列表页、购物车页每个页面确认三件事——HTTP 状态码 200、页面无乱码、控制台无异常堆栈。再用一个测试账号走一遍“注册→登录→加购→下单”的主流程数据库里确认订单表和订单详情表都有数据。这套流程走通说明项目基本可用。最后提醒一句改任何配置之前先备份原文件我吃过亏改崩了想回滚发现没留后悔药只能重新解压。希望帮到你。本文还有配套的精品资源点击获取