SSM+MySQL商城项目部署实战：从环境配置到前后台管理

简介基于SSMSpringSpringMVCMyBatis与MySQL开发的线上商城项目内置管理平台适合正在学习Java Web、准备课程设计或毕业设计的开发者。项目覆盖商品展示、购物车、订单管理、后台商品与分类维护等电商常见模块可帮助读者一次理解SSM三层架构与MyBatis持久化开发的完整协作方式。压缩包共341个文件大小仅1.71MB包含49个Java源文件、35个HTML页面、51个JS脚本与12个CSS样式其中还引入layui、layer、laydate等前端组件以及15个XML配置文件和1个SQL脚本另有129张GIF演示截图可直观查看运行效果。已有116人学习下载整体体量虽小但目录结构清晰前端页面与后台逻辑对应明确便于对照阅读。资源已配套一键启动脚本与前端样式文件导入开发工具即可快速运行非常适合用于课程设计、答辩演示或SSM框架实战入门。1. 这个SSMMysql商城项目能直接跑起来的前后台骨架该从哪看起如果你正在找一套能直接部署的SSM框架Mysql线上商城项目打开这个zip之前先记住一件事它不是某篇教程里的截图demo而是一份带管理平台的完整工程。解压后你会看到SpringSpringMVCMyBatis构成的Java后端、Mysql建库脚本以及基于Layui的前台商城和后台管理界面。它解决的主要是两件事一是让刚接触SSM的开发者有一条能跑通的下单链路可以照着抄二是给需要做毕业设计或内网演示的从业者省掉从零搭环境的功夫。适合有一点点Java基础、想尽快看到前后端联动效果的人。项目文件里的start.bat是启动入口那一堆css文件则对应Layui框架的样式依赖这两块理解透整个项目就立住了一半。2. 部署前先摸清这套骨架环境版本、解压结构、数据库导入与start.bat2.1 环境版本JDK、Tomcat、Mysql怎么配才不打架这个项目是典型的SSM组合后端用Spring管理BeanSpringMVC处理请求路由MyBatis操作Mysql。这类工程对版本并不挑但版本乱配是最容易翻车的地方。我一般会先按JDK 1.8 Tomcat 8.5 Mysql 5.7的组合走原因很简单SSM官方文档和大多数高赞教程都以这套组合为基准MyBatis的mysql驱动到8.x之后连接串和驱动类名都变了新手容易在这个黑匣子上卡住。组件推荐版本说明JDK1.8Spring 4.x/5.x都能兼容Tomcat 8.5默认支持Tomcat8.5.x占用低配置少和JDK1.8搭配最稳Mysql5.7.xInnoDB默认utf8mb4支持好驱动用5.1.49Maven3.6.3如果项目用Maven管理依赖用这个版本不建议一上来就用Mysql 8.x除非你已经准备把驱动换成com.mysql.cj.jdbc.Driver并且给连接串加上serverTimezone。Mysql 8默认的认证插件是caching_sha2_password旧的mysql-connector-java 5.x会出现Unable to load authentication plugin的报错。很多教程到最后就是栽在这个版本错配上。打开终端确认你的环境命令很简单java -version mysql --version mvn -v三条命令分别输出版本号。如果java版本是11或者17建议先装一个1.8如果mysql是8.x就把后面pom.xml里的驱动版本改成8.0.33并在jdbc.properties里写全时区参数。这里先记住一个原则让版本互相匹配再去谈启动否则后面报错会分不清是代码问题还是环境问题。提示老项目里如果同时出现多个Spring版本依赖用idea的依赖分析功能看冲突别手动删jar包。2.2 解压后的结构start.bat、layui样式和Java源码各自在哪打开这个zip之后你会看到它不是一个单一的源码目录而是带着部署脚本和前端资源一起打包的。项目正文里列出的start.bat、layui.css、main.css、layer.css、laydate.css、skin.css前一个是启动入口后面几个全部落在web前端的静态资源目录里多数情况是WebRoot或src/main/webapp/resources/layui下。这种布局很常见Java源码和网页资源分离管理平台复用同一套layui皮肤。一个典型的解压目录结构长这样shop-ssm/ │ start.bat # 一键启动脚本 │ pom.xml # Maven依赖 ├─ src/main/java/ # 后端Java源码 │ ├─ controller/ # SpringMVC控制器 │ ├─ service/ # 业务逻辑层 │ ├─ mapper/ # MyBatis数据访问接口 │ └─ model/ # 实体类 ├─ src/main/resources/ # 配置文件 │ ├─ jdbc.properties # 数据库连接配置 │ ├─ spring-mvc.xml # SpringMVC配置 │ └─ mybatis-config.xml # MyBatis配置 ├─ src/main/webapp/ │ ├─ WEB-INF/ │ │ ├─ views/ # JSP页面 │ │ └─ web.xml │ ├─ resources/ │ │ └─ layui/ # 这里就是layui.css、layer.css、laydate.css │ └─ index.jsp └─ sql/ └─ shop.sql # 建库建表脚本不要因为看到一堆css文件就觉得这个项目只管界面。SSM项目的前端资源本来就以静态文件形式放在webapp下layui系列文件负责的是页面组件和弹窗真正的业务逻辑还是在controller/service里。你甚至可以先用它的管理平台页面再替换成自己的接口。2.3 start.bat能一键启动什么脚本内容与改动建议start.bat是Windows环境下用来启动整个项目的脚本一般会做三件事设置JAVA_HOME、检查Mysql服务、调用Tomcat的startup.bat。不同作者的写法会有差异但大方向是省掉你手动开两个窗口的步骤。常见的start.bat长这样echo off title SSM 商城一键启动 set JAVA_HOMEC:\Program Files\Java\jdk1.8.0_202 set CATALINA_HOMED:\apache-tomcat-8.5.91 echo 正在启动 Mysql... net start MySQL echo 正在启动 Tomcat... call %CATALINA_HOME%\bin\startup.bat echo 启动完成请在浏览器访问 http://localhost:8080/ pause这里有两个参数要按你的实际环境改JAVA_HOME对应JDK安装路径CATALINA_HOME对应Tomcat解压路径。如果不改就直接双击最常见的现象是窗口闪一下就没了因为脚本调了一个不存在的路径。还有一点net start MySQL依赖Mysql在Windows服务里的名字如果你安装时把服务名改成了MySQL57这里也要跟着改成MySQL57。如果你的项目没有Maven目录而是直接放WAR包start.bat里可能还有把war复制到Tomcat webapps的步骤。遇到这种情况别急着双击先打开脚本看它调用了哪些外部路径把所有绝对路径替换成本机路径再考虑运行。这也是很多看起来能跑的项目突然翻车的根源。2.4 数据库初始化导入shop.sql这一步不要跳过数据库脚本是SSM项目里最容易被忽略的部分。很多人启动项目后看到页面报500或数据库连接失败回头一看sql文件根本没导入。这份资源既然标注了Mysql开发解压后的sql目录或根目录里一定会有建库脚本一般是shop.sql或db_shop.sql。把它导入Mysql的步骤很简单mysql -u root -p -e CREATE DATABASE IF NOT EXISTS shop DEFAULT CHARSET utf8mb4; mysql -u root -p shop shop.sql第一行先建库第二行把表结构和示例数据导入。如果你不想每条都输密码也可以登录Mysql后用source命令mysql -u root -p source /path/to/your/shop.sql;导入完成后用SHOW TABLES验证一下表是否齐全。至少会有user、category、goods、orders、order_item、admin这几张表如果只有一部分多半是sql文件没执行完要看是不是中途报错。接下来打开src/main/resources/jdbc.properties把连接信息改成你本机的jdbc.drivercom.mysql.jdbc.Driver jdbc.urljdbc:mysql://localhost:3306/shop?useUnicodetruecharacterEncodingutf8 jdbc.usernameroot jdbc.password123456这里唯一要改的是password。useUnicode和characterEncoding这两个参数建议保留否则中文字段容易出现乱码。如果照做之后Tomcat还是报连接错误把jdbc.driver改成com.mysql.cj.jdbc.Driver并给url加上serverTimezoneAsia/Shanghai基本能解决九成的时区问题。3. 前台购物与后台管理把这套商城拆成可复制的业务代码3.1 前台下单链路从商品列表到购物车再到订单一个能称为线上商城的项目前台至少要覆盖商品展示、加入购物车、提交订单这三步。这套工程的前台页面是基于layui写的商品列表就是一张响应式卡片网格点击加入购物车会弹出layer.confirm确认框。确认框只是交互真正的加购逻辑在controller里。你会在controller包里看到一个CartController它最核心的动作是把商品编号和数量写入session或订单临时表。常见做法是走session简化代码且不用频繁查库。我摘一段典型的购物车接口逻辑RequestMapping(/cart/add) ResponseBody public Result addCart(Integer goodsId, Integer count, HttpSession session) { if (goodsId null || count null || count 0) { return Result.error(参数异常); } MapInteger, Integer cart (MapInteger, Integer) session.getAttribute(cart); if (cart null) { cart new HashMap(); } cart.put(goodsId, cart.getOrDefault(goodsId, 0) count); session.setAttribute(cart, cart); return Result.success(已加入购物车); }这里的goodsId是商品表的主键count是加入数量session.getAttribute取出的cart是商品编号到数量的映射。getOrDefault是Java 8的写法如果之前没加过就默认0再加上本次购买数量。整个方法返回一个统一的Result对象前端layui可以直接用它的code字段判断操作是否成功。如果你觉得存session不够正规也可以把购物车落库。那就需要一张cart表包含user_id、goods_id、buy_count三个字段同样先查再插入。两种方式我都见过教学项目为了降低理解成本大多选session方案真实部署场景为了支持多设备同步购物车会选落库方案。你在阅读这个项目的源码时先看它用的是哪一种再决定要不要改。3.2 管理平台的功能闭环商品管理、订单管理、用户管理这个资源标题特别强调了带管理平台说明它不只是前台卖货还有一套后台管理界面。管理平台一般通过admin路径访问登录后能看到三块核心功能商品管理、订单管理、用户管理。商品管理负责上架下架、修改库存和价格订单管理负责查看订单状态、发货、取消订单用户管理负责禁用或启用账号。管理后台和前台最明显的区别是权限控制。它的菜单往往在左侧栏由layui的nav组件渲染点击不同菜单跳转到对应的JSP页面。后端配合一个登录拦截器防止有人绕过登录直接访问后台接口。一个标准的SpringMVC拦截器写法是public class AdminInterceptor extends HandlerInterceptorAdapter { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { Object admin request.getSession().getAttribute(loginAdmin); if (admin null) { response.sendRedirect(request.getContextPath() /admin/login); return false; } return true; } }然后在spring-mvc.xml里把它注册到 /admin/** 路径下mvc:interceptors mvc:interceptor mvc:mapping path/admin/**/ bean classcom.shop.interceptor.AdminInterceptor/ /mvc:interceptor /mvc:interceptors这样配置之后凡是路径以/admin/开头的请求都会先过拦截器。如果session里没有loginAdmin就强制跳回登录页。很多新手拿到项目后直接访问后台管理地址发现跳回登录页以为是项目坏了其实这就是权限拦截在起作用。3.3 数据表设计五个核心表的外键关系与字段说明SSM项目跑得稳不稳很多时候看表设计。这套商城项目里最核心的表有五张它们之间的关系是典型的电商模型。用SQL看比用文字说更直观CREATE TABLE t_user ( user_id INT PRIMARY KEY AUTO_INCREMENT, username VARCHAR(50) NOT NULL, password VARCHAR(200) NOT NULL, phone VARCHAR(20), status TINYINT DEFAULT 1 ); CREATE TABLE t_category ( cat_id INT PRIMARY KEY AUTO_INCREMENT, cat_name VARCHAR(100) NOT NULL, sort_order INT DEFAULT 0 ); CREATE TABLE t_goods ( goods_id INT PRIMARY KEY AUTO_INCREMENT, cat_id INT, goods_name VARCHAR(200) NOT NULL, price DECIMAL(10,2) NOT NULL, stock INT NOT NULL, image_url VARCHAR(255), is_on_sale TINYINT DEFAULT 1, KEY idx_cat (cat_id) ); CREATE TABLE t_order ( order_id INT PRIMARY KEY AUTO_INCREMENT, user_id INT NOT NULL, total_amount DECIMAL(10,2) NOT NULL, status TINYINT DEFAULT 0, create_time DATETIME, KEY idx_user (user_id) ); CREATE TABLE t_order_item ( item_id INT PRIMARY KEY AUTO_INCREMENT, order_id INT NOT NULL, goods_id INT NOT NULL, goods_name VARCHAR(200), price DECIMAL(10,2), buy_count INT );t_order_item表没有用复合主键是为了允许同一商品在多次订单中出现。t_goods的cat_id指向t_category的cat_idt_order的user_id指向t_user的user_id。price字段用DECIMAL(10,2)而不是DOUBLE是为了避免浮点运算导致金额误差。这些是现成的经验你在做自己的表时可以直接抄。3.4 前后台路径规划DispatcherServlet怎么区分商城主站和admin打开web.xml你会发现SpringMVC把*.do或/都交给DispatcherServlet处理。为了让商城首页和管理后台互不干扰常见做法是通过路径前缀区分。前台访问/index、/goods/list后台访问/admin/index、/admin/order/list这样在controller里也可以用类上的RequestMapping值来归类。一个典型的admin管理类会这样写Controller RequestMapping(/admin/order) public class AdminOrderController { Autowired private OrderService orderService; RequestMapping(/list) public String list(Model model) { ListOrder orders orderService.findAll(); model.addAttribute(orders, orders); return admin/order_list; } }注意返回的视图路径是admin/order_list对应webapp/WEB-INF/views/admin/order_list.jsp。和3.2节的拦截器配合起来整个后台就有了清晰的入口边界路径带/admin/的请求先进拦截器校验登录再进入AdminOrderController处理。如果你想把后台改到别的路径比如/manage/就要同步修改拦截器mapping和所有JSP里的链接。这里顺带提一个容易被忽略的点很多SSM项目的JSP里写链接用的是相对路径例如hrefadmin/order/list一旦当前页面URL层级变化相对路径就会失效。保险的做法是在每个JSP开头加上%request.getContextPath()%或者用c:set varctx value${pageContext.request.contextPath}/然后在所有href里用${ctx}/admin/order/list。这个习惯能帮你避免很多页面明明在链接就是404的坑。4. Layui资源文件css加载顺序、静态映射与主题替换4.1 解压出来的一堆css文件每个文件的职责项目正文里列出的layui.css、main.css、layer.css、laydate.css、skin.css正好覆盖了layui生态的主要产物。layui.css是核心样式包含基础组件、按钮、表格、导航、分页等。layer.css是弹层组件layer的样式和layer.js配套。laydate.css是日期控件laydate的样式如果页面里有下单时间选择器或后台的筛选日期就会用到它。main.css和skin.css通常是业务自己的定制样式main.css调整整个页面的布局和间距skin.css定义主题色和皮肤变量。这些文件在HTML里的加载顺序是有讲究的通常layui.css在最前面业务css放在后面这样后者能覆盖前者的默认样式。看一个页面头部的标准引入方式link relstylesheet href${ctx}/resources/layui/css/layui.css link relstylesheet href${ctx}/resources/layui/css/main.css如果你发现页面上的按钮变形或弹窗没有居中先回头检查是不是把main.css写到了layui.css前面。覆盖顺序错了样式就会互相打架。4.2 SpringMVC静态资源映射为什么css能直接访问SSM项目里如果你直接访问http://localhost:8080/resources/layui/css/layui.css发现404十有八九是spring-mvc.xml里没有配置静态资源映射。DispatcherServlet会拦截所有请求包括css和js如果不放行Tomcat会把它们当作controller路径去找。需要在spring-mvc.xml里加这段mvc:resources mapping/resources/** location/resources// mvc:annotation-driven/mvc:resources标签把URL中的/resources/前缀映射到webapp目录下的/resources/物理路径。mapping属性是对外访问的URL模式location是实际文件所在目录。加上这个配置后浏览器请求/resources/layui/css/layui.css时SpringMVC会直接把它转发到对应文件不再走controller逻辑。如果你把layui文件夹放在webapp的static下就把mapping改为/static/**location也改成/static/。这个配置直接影响所有静态资源的加载改了之后记得重启Tomcat。4.3 把默认皮肤改成你自己的主题用skin.css覆盖变量很多商城项目的管理平台默认是蓝色主题如果你想换成绿色或者深灰不需要改layui源码只需要在skin.css里覆盖关键颜色变量。layui的按钮、进度条、标签页等组件用的是全局CSS变量你可以在skin.css里重新赋值:root { --layui-color-primary: #16baaa; --layui-color-danger: #ff5722; } .layui-btn-primary { border-color: var(--layui-color-primary); }这段CSS的作用是把整个后台的主色调改成了青绿色同时保证危险操作按钮还是橙色系。不同版本的layui变量名会有差异如果项目中并没有使用CSS变量那就只能通过覆盖class的方式来做。比如给body加一个skin-green类再用.skin-green .layui-btn { background-color: #16baaa; } 去覆盖。无论是哪种方式skin.css都放在业务样式层目的是不动layui.css本体升级layui版本时不会冲突。4.4 浏览器缓存导致的样式失效改完CSS还是老样子这个坑非常隐蔽。明明把layui.css或skin.css里的颜色改了刷新页面后看到的还是以前的颜色于是怀疑文件没生效。其实文件已经更新是浏览器把css缓存住了。尤其用localhost直接访问Tomcat时资源响应头里经常带着Last-Modified浏览器下次会直接走本地缓存。处理办法有两种。第一种是在开发阶段按F12打开开发者工具在Network设置里勾选Disable cache然后刷新页面强制浏览器忽略缓存。第二种是给css引用加上版本参数link relstylesheet href${ctx}/resources/layui/css/skin.css?v20240501改到v20240502浏览器会当作一个新的URL重新请求。这个方法同样适用于js文件。我第一次改这个项目的样式时就是没加版本号反复刷新都看不到变化还以为是tomcat热部署没生效最后才发现是缓存问题。从那以后凡是要改静态资源我习惯顺手把版本号后面的日期改掉。5. 避坑从启动到跑通的六个典型问题与处理5.1 start.bat双击后窗口一闪而过现象双击start.bat黑框快速消失没有任何提示进程列表里也找不到java.exe。原因脚本里的JAVA_HOME或CATALINA_HOME指向了不存在的路径或者脚本本身缺少pause语句导致遇到错误后直接退出。这种闪退是最典型的SSM老项目启动问题。解决用文本编辑器打开start.bat在最后加一行pause然后检查所有绝对路径是否和你本机一致。改完再双击窗口会停住并显示具体错误信息。如果提示不是内部或外部命令说明系统PATH里没有Tomcat bin或JDK bin这时需要把这两个路径追加到系统环境变量然后再试试。5.2 Mysql连接报Access denied for user rootlocalhost现象Tomcat启动日志里出现Access denied页面无法访问数据库。原因jdbc.properties里的用户名或密码不对或者Mysql的root账号只允许localhost登录。解决先手动执行mysql -u root -p确认密码然后把jdbc.properties的username和password改成实际值。如果本地装了多个Mysql实例还要确认连接串里写的3306端口是你要连的那个实例。注意在Windows上如果Mysql服务没有启动也会报类似Communications link failure所以先检查服务状态再查账号密码。5.3 页面样式丢失layui.css返回404现象商城页面能打开但没有任何样式控制台里layui.css状态码404。原因spring-mvc.xml缺少mvc:resources静态资源映射或者jsp中的引用路径和实际物理路径不匹配。解决按4.2节补上静态资源映射。路径问题可以用浏览器直接访问css文件地址来排查如果404就是映射没生效如果200但样式不对才是加载顺序或覆盖问题。排查时多花一分钟看Network面板里的实际请求路径比对着代码瞎猜快得多。5.4 日期字段乱码订单create_time显示成???现象Layui的laydate选择日期后保存到Mysql页面回显问号。原因数据库表没有用utf8mb4或jdbc.url缺少characterEncoding参数。解决建库时统一用DEFAULT CHARSET utf8mb4jdbc.url里保留useUnicodetruecharacterEncodingutf8。如果已经建了库用下面这条SQL改表的字符集ALTER TABLE t_order CONVERT TO CHARACTER SET utf8mb4;改了之后记得重启Tomcat并确认所有页面的pageEncoding也是UTF-8。三层编码不统一乱码问题就会反复出现。5.5 页面链接带不上项目路径现象点击商品详情或后台菜单浏览器的地址栏变成localhost:8080/goods/detail没有项目名导致404。原因JSP里用了相对路径没有带上contextPath。解决在每个JSP顶部定义上下文路径变量并把前缀改成${ctx}/goods/detail。例如% taglib prefixc urihttp://java.sun.com/jsp/jstl/core % c:set varctx value${pageContext.request.contextPath}/之后所有链接都写${ctx}/goods/detail。如果一个页面里写死了绝对路径换部署环境时还需要重新改所以统一维护这个上下文变量是值得的。5.6 Maven依赖下载失败Spring核心包缺失现象用IDEA导入项目后所有类文件都标红运行时报NoClassDefFoundError。原因本地Maven仓库没有缓存依赖或者网络镜像源不可用。解决在pom.xml所在的目录执行mvn clean package -DskipTests让Maven重新下载。如果下载很慢在settings.xml里配置阿里云镜像源然后重新导入项目。这条对SSM项目尤其常见因为Spring相关依赖比较多缺失任何一个核心包都会导致启动失败。上面这六类问题是我拿这类项目复现时高频踩到的。每一类看起来都不一样但根子都是环境或路径问题和业务代码本身没多大关系。你按先环境后代码的顺序排查能省下不少时间。6. 进阶写个环境自检脚本让每次启动前都有后悔药把第5章的坑过一遍之后如果你连续启动三次都遇到不同的环境问题就该考虑把检查动作固化成脚本。我习惯在拿到任何SSM项目后先不急着跑start.bat而是多写一个check.bat放在项目根目录让它替我把环境、端口、资源路径都验证一遍。一个实用的check.bat思路如下echo off echo 检查JDK... java -version nul 21 echo [OK] JDK存在 || echo [ERROR] 缺少JDK echo 检查Mysql服务... sc query MySQL | findstr RUNNING nul echo [OK] Mysql运行中 || echo [WARN] Mysql未启动 echo 检查端口8080... netstat -ano | findstr :8080 | findstr LISTENING nul echo [WARN] 8080被占用 || echo [OK] 8080空闲 echo 检查layui.css... if exist src\main\webapp\resources\layui\css\layui.css echo [OK] layui.css存在这段脚本里的java -version和sc query MySQL只是检查命令是否返回成功不一定代表版本完全匹配但至少能在你启动前暴露最明显的错误。netstat那行检查的是8080是否被占用如果你Tomcat端口改成了8081把数字改掉即可。if exist这行是确认css文件真的在预期路径下而不是空有一个引用。有了这个脚本每次启动前我只要双击check.bat五秒钟就能看到哪个环节是坏的。这不光对这个商城项目有效你以后下载任何SSM或SpringBoot的zip资源都能套用同样的思路先把路径、端口、数据库列成一个检查清单。我从第一次被start.bat闪退折磨过后每次处理这类老工程都强制走一遍这个流程再没在启动阶段浪费过半小时。希望帮到你。本文还有配套的精品资源点击获取