1. 先聊这个商城项目的真实份量做Java后端的朋友十有八九在某个阶段接触过电商系统这个经典场景。课题设计、毕业设计、个人作品集翻来覆去就是那几个品类图书、数码、生鲜、服饰。而玩具商城这个切入点恰恰是那种有点小特殊、又不至于让你焦头烂额的品类——它天然带儿童属性、节日属性、礼品属性商品维度足够丰富按年龄、按性别、按材质、按功能加上前台购物流程和后台订单管理都是电商系统的标准骨架作为学习和实战载体其实非常合适。这个项目的全称是基于javaweb和mysql的springboot前台后台玩具商城系统技术栈一眼扫过去就是典型的Java Web主线Java SSM SpringBoot HTML Thymeleaf Maven MySQL。说实话看到这套组合我很亲切因为这就是国内Java开发者在很长一段时间里最主流、最稳的配置。SSMSpring SpringMVC MyBatis负责业务层和持久层的基础框架SpringBoot统一装配并简化部署Thymeleaf作为服务端模板引擎渲染前台页面MySQL存业务数据Maven管依赖和构建。这篇文章不是教科书式的功能罗列而是把我自己从零做这类项目的完整思路、设计取舍、编码顺序、踩坑记录全部摊开讲。如果你正在做同类课题或者想通过一个完整项目把Java Web体系串起来可以直接照着这套思路落地。2. 技术选型为什么是SSMSpringBootThymeleaf而不是前后端分离2.1 SSM和SpringBoot为什么同时存在很多人第一次看到SSM SpringBoot会觉得矛盾SSM已经是一套完整框架SpringBoot不也整合了Spring生态吗怎么两个都写上实际上两者根本不是对立关系。SSM指的是Spring SpringMVC MyBatis三件套的组合方式而SpringBoot是一个让这三件套更好用的自动化装配容器。在传统SSM项目里你要手动配置web.xml、Spring容器、SpringMVC的DispatcherServlet、MyBatis的SqlSessionFactory光是配置文件就是一堆。SpringBoot则通过起步依赖和自动配置把这些繁琐的东西全部收编了——我只需要引入spring-boot-starter-web、mybatis-spring-boot-starter再用application.yml写几行数据库连接配置整个SSM框架就跑起来了。所以这个项目严格来说是基于SpringBoot整合SSM的架构各层职责非常清晰Spring负责对象管理、事务控制、依赖注入SpringMVC负责请求路由、参数绑定、视图解析MyBatis负责SQL映射和数据库操作SpringBoot负责自动配置、内嵌容器、简化装配Thymeleaf负责服务端页面渲染MySQL Maven数据存储和项目管理对做课题和毕设的同学来说这套组合有一个巨大的现实优势它既能体现你对SSM底层原理的掌握面试官爱问又能展示你用SpringBoot提升开发效率的能力企业更看重两头都能得分。2.2 Thymeleaf在当前环境下的取舍逻辑看标题里还有htmlthymeleaf这也是个值得展开的点。现在很多新项目张嘴就是Vue SpringBoot前后端分离为什么还要用Thymeleaf这种服务端渲染方案我的实际体感是商城类项目如果用前后端分离意味着你要同时维护一套前端工程、一套后端API、处理跨域、处理Token鉴权对单人开发的学习成本和工作量都是成倍上涨。而Thymeleaf直接让Java后端把数据塞进HTML模板页面刷新即获取数据逻辑链路短、部署简单、出问题容易排查非常适合单体系统和小团队项目。而且Thymeleaf的语法和HTML几乎天然兼容普通的HTML文件用浏览器直接打开能正常展示静态内容加上th:text、th:each、th:href这些属性后服务端渲染时才会动态替换。这种静态原型可预览、动态数据可注入的特性对前端设计稿和页面调试都特别友好。具体到本项目Thymeleaf承担的分工是这样的前台商品列表页用th:each循环渲染商品卡片商品详情页用th:text绑定商品名、价格、库存购物车页面遍历购物车条目动态计算总价后台管理页面渲染订单表格、用户列表、数据统计区块一句话选Thymeleaf不丢人它是单体Java Web应用里性价比最高的渲染方案。2.3 数据库与构建工具的角色补充MySQL没什么好多说的电商类业务首选的关系型数据库事务机制完善SQL生态成熟。值得注意的是在Windows本地开发和Linux服务器部署时可能出现配置差异后面我会专门讲。Maven则是贯穿整个项目生命周期的工具它的核心作用是管理依赖库SpringBoot版本、MyBatis版本、MySQL驱动版本之间的兼容性、执行项目构建、打包Deployable产物。有一个非常实在的点开发期本地使用mvn spring-boot:run启动项目生产期使用mvn clean package打包成jar两者配置可以无缝衔接这比传统的手动拷贝war包扔进Tomcat要方便得多。3. 系统设计与数据库建模先想清楚商城怎么转起来3.1 功能模块拆分动手写代码前我会把系统拆成两大块——前台用户端和后台管理端每一块再往下细分功能点。前台商城端面向普通用户用户注册、登录、个人信息维护首页轮播图展示、分类导航玩具商品浏览、按分类筛选、关键词搜索、商品详情查看加入购物车、修改购买数量、删除条目提交订单填写收获地址、选择数量、生成订单我的订单查看订单列表和订单状态后台管理端面向管理员管理员登录与前台用户表分离或同表加角色标记均可商品管理新增、编辑、上下架、库存调整分类管理一级/二级分类维护订单管理查看订单、发货、订单状态变更用户管理查看用户列表、禁用/启用账号基础统计商品数量、订单量、销售额的简单看板可以看到这其实就是一套标准电商闭环的最小可行版本。玩具商城相比图书商城区别主要在商品维度字段上年龄适配、品牌、材质、安全标准我会在表结构设计里体现。3.2 核心表结构设计数据库我建议以order、product、category、user这几类核心表为骨架再加购物车和轮播图。下面是完整的建表思路直接抄作业即可表名核心字段作用说明userid, username, password, phone, email, avatar, status, create_time用户表status用于封号禁用productid, category_id, name, subtitle, main_image, detail, price, stock, sales, status, is_hot, create_time商品表status控制上下架is_hot控制首页热门推荐categoryid, parent_id, name, sort_order分类表parent_id支持两级分类cart_itemid, user_id, product_id, quantity, checked, create_time购物车表checked对应是否选中结算orderid, order_no, user_id, total_price, receiver_name, receiver_phone, receiver_address, status, pay_time, delivery_time, finish_time, create_time订单主表订单号和状态字段是核心order_itemid, order_id, product_id, product_name, product_image, price, quantity, total_price订单明细表快照商品信息防止商品后续变动影响历史订单bannerid, image, url, sort_order, status首页轮播图几个容易忽略的设计细节分类表用自关联而不是单级字段。玩具品类下会长出积木拼插毛绒玩具益智早教这些二级类目用parent_id自关联可以统一结构后台管理时做递归树也方便。订单表和订单明细表必须分离。一个订单可能包含多个商品如果把商品明细直接塞在订单表里会导致大量重复信息而且没法支持一个订单追加商品。标准做法是表头存收货信息和总金额明细表逐条存每个商品。商品字段做快照。用户在A时刻下单时商品价格是50元B时刻后台改价为55元历史订单应保留A时刻的50元记录。所以order_item里price和product_name都要冗余存储而不是下单时去实时join商品表。这个细节如果你不做测试订单时可能看不出问题等真实使用就会出乱子。3.3 订单状态机的设计订单状态是整个电商系统的灵魂。我没用复杂的状态机框架直接在代码里定义常量用数字表示状态简单清晰状态值含义触发动作0待付款用户提交订单成功1待发货/已付款用户支付成功本项目可用模拟支付2已发货后台管理员发货3已完成用户确认收货或自动确认收货4已取消用户付款前取消或超时未支付自动取消状态流转约束要写到Service层里不允许任意跳转。比如只有待付款状态能取消已发货不能直接变成待付款。这种约束如果措辞不严谨后来测试时点击几下后台按钮状态就乱了。4. 前台商城链路从首页展示到订单提交4.1 用户注册登录模块的实现细节用户模块看上去简单其实有两个不能忽视的点。第一个是密码加密任何正经项目都不应该明文存密码Spring Security的BCryptPasswordEncoder或者MD5 盐都可以。如果嫌Spring Security引入后配置麻烦用spring-security-crypto只引入加密工具类是个很轻量的做法。第二个是登录状态保持单体Thymeleaf项目最方便的做法就是用Session保存登录用户加一个拦截器判断未登录用户访问购物车、下单接口时强制跳转登录页。登录接口的典型实现代码大致长这样PostMapping(/login) public String login(String username, String password, HttpSession session, Model model) { User user userService.login(username, password); if (user null) { model.addAttribute(msg, 用户名或密码错误); return user/login; } session.setAttribute(loginUser, user); return redirect:/; }提示生产环境请务必配合验证码防暴力破解、频率限制等机制。课题项目可以简化但自己心里要清楚哪里是简化的。4.2 商品浏览与搜索商品列表页是Thymeleaf发挥主力作用的地方。分类导航的数据来自category表按parent_id组织成一级分类和二级分类首页展示时只取顶级分类点击后进入该分类下所有商品列表。搜索功能基于商品名称和描述字段做模糊查询select idselectByKeyword resultMapProductResultMap SELECT * FROM product where if testkeyword ! null and keyword ! AND (name LIKE CONCAT(%, #{keyword}, %) OR subtitle LIKE CONCAT(%, #{keyword}, %)) /if /where ORDER BY create_time DESC /select这里有个很实际的点LIKE查询在玩具商城这个数据规模几千条商品下完全够用不用一开始就上Elasticsearch或者全文索引。很多初学者一上来就想用复杂的搜索引擎其实先算算数据量大多数课题项目MySQL一个表几万条以内加个索引一秒钟就能搜出来。别过度设计。分页组件用PageHelper就行集成非常简单在pom.xml加依赖后配置一个拦截器插件Mapper查询自动分页。需要注意PageHelper的分页是物理分页自动往SQL后面拼LIMIT这样在数据量大时也不会内存溢出。4.3 购物车Session还是数据库这是做商城项目第一个让我犹豫过的设计问题。购物车数据存哪两种方案各有利弊存Session不建表实现简单但用户换设备就丢且Session有有效期存数据库cart_item表用户体验好随时同步但每次操作都要查库我最终选择存数据库因为表结构里本来就有cart_item实现成本并不高。用户体验角度来说用户A在手机上加购物车回家在电脑上登录希望还能看到同一份购物车这是很合理的预期。数据库实现后购物车操作就变成了对cart_item表的增删改查public void updateQuantity(Integer userId, Integer productId, Integer quantity) { if (quantity 0) { cartItemMapper.deleteByUserIdAndProductId(userId, productId); } else { cartItemMapper.updateQuantity(userId, productId, quantity); } }购物车列表页用th:each渲染每一条数据前端动态计算合计金额。这里有一个操作体验细节每一行的价格乘数量后可以用Thymeleaf的内联表达式或者后端封装一个CartItemVO把itemTotalPrice直接算好放进Model不要指望在HTML里写复杂的运算逻辑。4.4 下单流程事务是底线保障提交订单是整个链路里最关键的一段涉及多张表的写操作。用户点击结算后后端要做的事情包括校验购物车里选中的商品是否存在、库存是否充足生成唯一的订单号创建订单主表记录保存收货人信息创建订单明细记录逐个商品写入快照扣减商品库存、增加商品销量清空购物车中已下单的商品跳转到支付页面本项目可以模拟支付成功简化支付回调逻辑这七步必须放在同一个事务里任何一个环节失败所有操作全部回滚。否则会出现订单生成了但库存没扣或者库存扣了但订单明细缺失的数据不一致问题。Transactional(rollbackFor Exception.class) public Order createOrder(Integer userId, ListInteger cartItemIds, AddressVO address) { // 1. 检查库存 // 2. 生成订单号 // 3. 插入订单主表 // 4. 插入订单明细 // 5. 扣库存加销量 // 6. 删除购物车条目 // 7. 返回订单对象 }订单号生成我用的简单方案是时间戳 用户ID 随机数比如202501152030151234够用且不会重复。复杂的分布式ID生成方案对单体项目没有意义。5. 后台管理端商品、订单、权限一把抓5.1 后台与前台的角色隔离后台管理端的管理员我选择独立放在user表里通过role字段区分1代表管理员0代表普通用户登录时校验角色后台接口全部加拦截器。相比单独建一张admin表单表加角色的方式在代码实现上更省事对于这个体量的系统完全足够。后端拦截器实现思路public class AdminInterceptor implements HandlerInterceptor { Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { User user (User) request.getSession().getAttribute(loginUser); if (user null || user.getRole() ! 1) { response.sendRedirect(/admin/login); return false; } return true; } }注册拦截器时只拦截/admin/**路径不影响前台端点。5.2 商品管理图片上传与库存联动商品管理页面的难度集中在两块图片上传和库存操作。图片上传我推荐本地存储方案配置一个虚拟路径映射把/upload/**映射到磁盘目录。SpringBoot里用WebMvcConfigurer配置资源映射Override public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler(/upload/**) .addResourceHandler(file: uploadPath /); }前端表单用multipart/form-data后端接收MultipartFile并转存到指定目录。数据库里存的是相对路径比如/upload/product/20250115/xxx.jpg页面通过th:src拼接完整URL渲染。库存方面后台修改商品信息时可以同步修改库存。注意当库存为0时前端商品详情页要显示暂时缺货并禁止加购物车操作。这个校验不能只在前端做后端在下单逻辑里还会再查一遍库存双重校验。5.3 订单管理让后台操作带动状态流转后台订单管理是对前台购物流程的闭环支撑。管理员在后台看到订单列表可以根据订单状态进行相应操作未付款订单可查看不可发货已付款订单点击发货状态改为已发货已发货订单可查看物流信息本项目简化为填一个物流单号字符串已完成订单可查看可做数据统计这里要注意的是状态变更按钮要按当前状态动态渲染。Thymeleaf可以做条件判断th:block th:if${order.status 1} a th:href{/admin/order/deliver/{id}(id${order.id})}发货/a /th:block另一个值得做的功能是订单筛选。按状态、按时间范围、按订单号搜索这个在后台很常用基本就是Example条件查询或where动态SQL实现起来不复杂但能显著提升后台使用的便利性。5.4 数据统计看板后台首页放几个统计卡片会让整个系统完成度提高很多。用Mapper做聚合查询就能搞定商品总数SELECT COUNT(*) FROM product用户总数SELECT COUNT(*) FROM user今日订单量SELECT COUNT(*) FROM order WHERE create_time CURDATE()总销售额SELECT SUM(total_price) FROM order WHERE status IN (1, 2, 3)把这些数据塞进一个Map或VO对象里首页展示即可。不需要引入ECharts等图表库除非你想加分。可以后续扩展每日订单趋势图但作为一期功能数字卡片已经够用。6. 联调与避坑记录我替你们提前踩过的雷6.1 Thymeleaf页面渲染的常见翻车点使用Thymeleaf最容易遇到两个问题都是新手高频踩坑。第一个是静态资源路径错误。SpringBoot的默认静态资源路径是classpath:/static/所以JS、CSS、图片要放在src/main/resources/static下页面里引用用th:href{/css/common.css}。如果你把common.css放到了templates目录里运行时必然404而且浏览器控制台报错信息不够直观排查起来很困惑。第二个是Thymeleaf表达式写错导致页面500。常见错误包括用${user.name}访问了空对象user、用#strings工具类时方法名写错、th:each遍历变量作用域没搞清楚。我的经验是先写一个最简单的页面跑通再逐步加复杂逻辑不要一上来就在模板里写大段嵌套逻辑。页面渲染涉及复杂运算尽量放到Controller里做好模板里只做循环输出。6.2 MyBatis的Mapper映射和SQL问题MyBatis使用过程中几个容易踩的坑下划线字段与驼峰属性的自动映射。数据库字段create_timeJava属性createTime如果没开启驼峰映射查询结果会是null。解决方案是在application.yml中配置mybatis: configuration: map-underscore-to-camel-case: true开了之后一条配置解决所有字段映射问题别在XML里手动写几百个resultMap。动态SQL的if test判断条件。整数类型判断非null和非空时很多新手会写if teststatus ! 这在status是Integer时会因为类型比较报错。正确写法是if teststatus ! null。#{}和${}的区别。#{}是预编译占位符防SQL注入必须用于值传递${}是字符串拼接只用于表名、列名等结构不可预编译的场景。绝大多数情况下参数传递必须用#{}。这个原则记死就不会出大问题。6.3 版本兼容性SpringBoot和MyBatis别乱配SpringBoot整合MyBatis时版本是一个很现实的坑。总结一下我试验过的稳定组合组件推荐版本说明SpringBoot2.7.x稳定且教程多避免用3.x导致javax/jakarta命名空间变化MyBatis SpringBoot Starter2.3.x与SpringBoot 2.7是官方匹配组合MySQL Connector/J8.0.x支持MySQL 5.7/8.0Thymeleaf Starter由SpringBoot parent管理不用单独指定版本Maven Compiler1.8项目JDK保持1.8或11即可特别提醒SpringBoot 3.x把javax.servlet迁移到了jakarta.servlet大量旧教程、旧代码、旧拦截器写法会不兼容如果你不是想折腾新特性做项目求稳就用2.7.x。版本不是越高越好稳定压倒一切。6.4 数据库连接池和时区问题连接池使用SpringBoot默认的HikariCP即可性能非常好。配置时注意几个参数spring: datasource: url: jdbc:mysql://localhost:3306/toy_mall?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: xxxserverTimezoneAsia/Shanghai这个参数在MySQL 8.0以上版本是必须的否则会报The server time zone value Öйú±ê׼ʱ¼ä is unrecognized之类的错误。characterEncodingutf8保证中文不乱码这两个参数每次新建项目我都会直接加上宁可多写也不要让环境给我上眼药。6.5 本地IDEA运行配置用IDEA开发SpringBoot项目运行配置其实非常简单直接找到主启动类ToyMallApplication右键Run即可。不需要配置Tomcat因为SpringBoot内嵌了容器。如果你改了端口想自定义在application.yml里写server: port: 8080如果你搜索idea运行javaweb项目配置时习惯性地想配置外部Tomcat那只针对传统war包项目。SpringBoot单体项目直接跑main方法就完事。7. 项目打包与部署从本地开发机到服务器7.1 Maven打包方式选择单体项目部署有两种方式我建议直接用jar包方式。执行mvn clean package -DskipTests打包产物在target/目录下是一个可执行的jar文件。部署时服务器只需要有JDK环境java -jar toy-mall-0.0.1-SNAPSHOT.jar后台运行用nohupnohup java -jar toy-mall-0.0.1-SNAPSHOT.jar app.log 21 还有一种war包方式需要部署到外部Tomcat从SpringBoot实战角度已经很少用了除非是学校要求必须放Tomcat webapps目录。如果是那种要求记得主启动类继承SpringBootServletInitializer并重写configure方法打包方式改成war。这个细节差别很容易影响结果要先问清楚验收要求。7.2 配置文件多环境切换开发环境数据库密码、线上环境数据库密码不相同不应该每次打部署包前手动改application.yml。SpringBoot的Profile机制可以优雅解决application.yml公共配置application-dev.yml本地开发环境配置application-prod.yml线上环境配置启动时指定Profilejava -jar toy-mall.jar --spring.profiles.activeprod实际项目我还会把数据库密码放在环境变量里读取比硬编码在配置文件里更安全。7.3 部署时MySQL的注意事项服务器上的MySQL有几个点容易出问题字符集设置。建库时务必将库和表的字符集设为utf8mb4而不是utf8。因为utf8在MySQL里是utf8mb3不支持四字节的Emoji字符用户昵称或收货地址里一旦出现EmojiSQL写入就会报错。CREATE DATABASE toy_mall DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;端口放行。云服务器安全组、防火墙都需要放行3306和SpringBoot应用端口默认8080。这个排查起来最坑明明是本地一切正常、线上连不上数据库一半的可能是端口没放行。备份保护。上线前用mysqldump导一份初始数据后续每次大变更前也备份防止手滑删表。命令很简单mysqldump -u root -p toy_mall backup_$(date %Y%m%d).sql8. 这套系统的扩展空间玩具商城一期做完之后后续可升级的路线其实很清楚。最自然的扩展第一个是支付模块当前是模拟支付接真实支付支付宝/微信无非是生成支付参数、配置回调地址、验签处理核心的订单状态机已经预留了接口。第二个是秒杀或优惠活动玩具品类在六一儿童节、寒暑假都是营销高峰可以加限时折扣、满减券、优惠券系统。第三个是搜索升级当商品数据达到一定量级后引入Elasticsearch做全文检索正好可以补齐商品关键词搜索的短板。数据库层面如果订单量涨上来了可以按用户ID分表或者引入读写分离。但这些都是后话对于交付一个完整可运行的玩具商城系统当前这套架构已经覆盖了从用户浏览到后台管理的完整闭环而且每一层的技术点都是Java Web项目面试里最喜欢问的东西。如果你按这套思路从头做一遍收获的不只是一个能跑的系统而是把Spring容器管理、MyBatis动态SQL、Thymeleaf模板渲染、事务处理、Maven构建、Linux部署这一整条技术链真正串了起来。最后分享一个我个人的习惯做这类全栈单体项目时一定先画清楚状态流转图和表关系再写代码。我在做这个玩具商城时因为订单状态机的逻辑从一开始就理得清晰后续开发过程中几乎没有返工。你把订单流程、退货退款流程提前想清楚整个项目开发会顺畅很多。