基于Spring Boot的宠物商城系统设计与实现

简介：基于SpringBoot的宠物商城网站源码包，面向计算机、电子信息工程等专业的毕业生与课程设计学习者，可无缝用于JavaWeb方向的高分毕业设计项目、课程设计或期末大作业。压缩包约20.83MB，内部是完整的SpringBoot+Maven工程结构，按后端控制器、业务服务层、MyBatis持久层与实体类分层组织，同时包含Vue相关的前端页面、静态资源以及Maven和application配置文件，导入IDEA、Eclipse或MyEclipse，配置JDK1.8、MySQL5.7和Tomcat8.0/9.0即可运行。代码经过严格测试，覆盖宠物分类展示、商品浏览、购物车、订单管理、后台维护等典型商城模块，适合分模块阅读学习，也能直接二次开发用于毕设答辩或课程展示。从数据库表设计到前端接口调用都有清晰脉络，能帮助理解SpringBoot与MyBatis在实际项目中的配合方式，同时可作为后续扩展的基础模板。已有299人学习下载，遇到环境配置或联调问题可随时与博主交流。

1. 宠物商城从零到一：为什么Spring Boot是毕业设计的最优解

做宠物商城这类B/S架构项目，最大的痛点不是功能写不出来，而是环境搭到一半就想放弃。JDK装完配Maven，Maven配完连MySQL，连完MySQL还要处理编码乱码，等把Tomcat跑起来，时间已经过去一周。这个基于Spring Boot的宠物商城代码，把上面这些环节全部压缩成一个可以直接跑起来的工程，适合计算机、电子信息工程等专业做毕业设计或课程设计，也适合想系统看一遍Java Web全链路的前端同学当后端范本。

Spring Boot在这个项目里的价值不只是免去了大量XML配置，而是让MyBatis、Ajax、Vue这些技术栈有了清晰的边界。Controller层管参数接收，Service层管业务规则，Mapper接口管SQL，前端页面通过Ajax异步拿JSON数据渲染，每一条链路都可以单独调试。接下来直接按「环境初始化 → 核心模块拆解 → 数据层设计 → 部署排错」的顺序，把代码里真正关键的部分过一遍。

2. 环境选型与工程初始化：先把技术栈边界划清楚

2.1 为什么是JDK 1.8 + Maven 3.6 + MySQL 5.7

这套代码锁定了JDK 1.8、Maven 3.6、MySQL 5.7，不是随便选的。JDK 1.8是Spring Boot 2.x系列最稳定的运行基座，lambda表达式和Stream API正好支撑Service层的集合操作；Maven 3.6对私服镜像的兼容性比新版本更稳，切换阿里云镜像后依赖下载速度提升明显；MySQL 5.7的InnoDB引擎在默认事务隔离级别（REPEATABLE READ）下，配合Spring的声明式事务可以避免大部分幻读问题，这对订单模块很重要。

环境变量的配置是新手最常卡住的地方。JDK装完后，JAVA_HOME指向JDK根目录，Path里追加%JAVA_HOME%\bin，Maven同样需要配MAVEN_HOME和Path。验证方式很简单，在命令行执行java -version和mvn -v，两个命令都能输出版本号就说明环境变量配置没问题。这个环节用IDEA开发时经常被忽略，因为IDEA内置了JDK和Maven，但一旦脱离IDE执行打包命令，环境变量就变成第一个拦路虎。

2.2 从pom.xml看依赖边界

打开pom.xml，核心依赖就六个。spring-boot-starter-web内置Tomcat和Spring MVC，是B/S架构的基石；mybatis-spring-boot-starter把MyBatis和Spring Boot的自动配置机制连接起来，省掉了SqlSessionFactory的手动创建；mysql-connector-java负责JDBC底层的网络通信协议；lombok用来消减实体类的getter/setter样板代码。

<parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>2.3.4.RELEASE</version> </parent> <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>org.mybatis.spring.boot</groupId> <artifactId>mybatis-spring-boot-starter</artifactId> <version>2.1.4</version> </dependency> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>5.1.49</version> </dependency> <dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <optional>true</optional> </dependency> </dependencies>

依赖版本是配合好的，直接使用不需要改动。spring-boot-starter-parent作为统一父工程管理了大部分依赖的版本号，所以web包不写version也不会报错。mybatis-spring-boot-starter的2.1.4版本适配Spring Boot 2.3.x，这个对应关系错了会出现Mapper接口无法注入的启动异常。

2.3 配置文件与数据库初始化

在application.yml中需要重点关注三块配置：数据源链接、MyBatis的XML映射路径、端口号。数据库连接串里characterEncoding=utf8必须加上，否则中文商户名和宠物名写入MySQL后会出现乱码，serverTimezone=Asia/Shanghai解决JDBC驱动与时区不一致导致的报错问题。

server: port: 8080 spring: datasource: driver-class-name: com.mysql.jdbc.Driver url: jdbc:mysql://localhost:3306/pet_shop?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false username: root password: 123456 mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.petshop.entity configuration: map-underscore-to-camel-case: true

mapper-locations指向resources/mapper/下的XML文件，这是MyBatis把Java接口和SQL语句关联起来的关键配置。map-underscore-to-camel-case开启后，数据库字段create_time可以自动映射到实体类的createTime，避免手写ResultMap的繁琐。

数据库初始化使用SQLyog或Navicat直接执行项目附带的pet_shop.sql脚本即可，但要注意MySQL 5.7的默认字符集。建表语句中DEFAULT CHARSET=utf8mb4比utf8多支持emoji字符，宠物商品名称里偶尔会带特殊符号，建议统一使用utf8mb4。

3. 宠物商品模块与检索：MyBatis动态SQL加Ajax异步交互

3.1 商品表的字段设计与状态位

宠物商城的核心表是宠物商品表，设计上有一个容易被忽略的点：用status状态位控制上下架，而不是物理删除数据。这样用户在浏览商品时通过WHERE status = 1过滤，管理员下架时只更新状态位。即使以后要恢复上架或者做操作日志回溯，数据都还完整在表里。

price字段用decimal(10,2)而不是double，这是涉及金额场景的硬性要求。double在MySQL里是近似值，计算0.1加0.2可能得到0.30000000000000004，而decimal是精确类型，Java侧的BigDecimal与之一一对应，订单金额计算时不会出现分位误差。

3.2 动态SQL实现多条件检索

商品列表页通常会提供分类筛选和关键字搜索两个入口，如果用固定SQL写死查询条件，每增加一个筛选维度就要新增一个Mapper方法。MyBatis的<where>和<if>标签能动态拼接SQL片段，一个方法覆盖所有查询组合。

<select id="searchPets" parameterType="map" resultType="com.petshop.entity.Pet"> SELECT id, pet_name, category, price, stock, image, status FROM pet <where> <if test="category != null and category != ''"> AND category = #{category} </if> <if test="keyword != null and keyword != ''"> AND pet_name LIKE CONCAT('%', #{keyword}, '%') </if> AND status = 1 </where> ORDER BY create_time DESC </select>

这段SQL的逻辑在于：分类过滤使用精准匹配，关键字搜索使用LIKE模糊匹配，两个条件互相独立。Mapper接口对应的Java方法签名是List<Pet> searchPets(@Param("category") String category, @Param("keyword") String keyword)，参数用@Param注解命名，和XML里的#{category}、#{keyword}一一对应。如果某个参数传了空值，<if>标签判断为false，对应的条件就不会拼进SQL。

3.3 Controller层到Ajax的数据链路

宠物商城的Controller层返回的是JSON不是页面，前后端的交互通过Ajax完成。前端Vue实例在mounted阶段发起请求，后端接口收到参数后走Service层查询数据库，最后以JSON格式把商品数据返回给浏览器渲染。

@RestController @RequestMapping("/pet") public class PetController { @Autowired private PetService petService; @RequestMapping("/search") public Result search(@RequestParam(required = false) String category, @RequestParam(required = false) String keyword) { List<Pet> petList = petService.searchPets(category, keyword); return Result.success(petList); } }

@RestController表示该类的所有方法返回值自动序列化为JSON，不需要在方法上加@ResponseBody。@RequestParam(required = false)声明两个参数都是可选的，前端不传时值为null，正好匹配动态SQL的空值判断。

Service层在Controller和Mapper之间做了一层缓冲，虽然当前代码可能只是直接透传，但保留这层设计的意义在于：如果以后需要加缓存、加权限校验、做数据权限过滤，都可以在Service层统一处理，不必改动Controller和Mapper的代码。前端Vue部分使用axios.get('/pet/search', {params: params})发送请求，params对象里的category和keyword会根据用户的操作动态组装。

4. 购物车到订单：事务边界与订单状态流转

4.1 购物车与订单的表关系

宠物商城的购物车表和订单表是两套独立的数据结构。购物车是用户未确认的意向商品集合，可以随时增删改；订单是已经确认并进入生命周期管理的正式数据。把购物车和订单分开设计，才能支持「用户把商品加入购物车几天后再下单」的真实场景。

订单表的字段需要覆盖完整的交易链路信息：订单号、用户ID、总金额、状态、收货地址、创建时间。订单明细表则记录订单里每一件宠物的快照信息——宠物名称、单价、数量、小计。快照的意思是即使后续商品改价或者下架，订单历史里的价格和名称保持下单时的数据不变。

4.2 事务控制下的库存扣减

下单的核心动作是「扣减库存 + 创建订单 + 创建订单明细」，这三个动作必须同时成功或者同时失败。如果在创建订单成功后扣库存失败，用户看到的是订单已生成但实际库存没减，后面发货时才发现库存不够，这就是典型的数据不一致。

@Transactional(rollbackFor = Exception.class) public Order createOrder(Integer userId, Integer petId, Integer quantity) { // 1. 检查库存是否充足 Pet pet = petMapper.selectByIdForUpdate(petId); if (pet.getStock() < quantity) { throw new RuntimeException("库存不足"); } // 2. 扣减库存 petMapper.reduceStock(petId, quantity); // 3. 创建订单 Order order = new Order(); order.setUserId(userId); order.setTotalPrice(pet.getPrice().multiply(BigDecimal.valueOf(quantity))); order.setStatus(0); orderMapper.insert(order); // 4. 写入订单明细 OrderItem item = new OrderItem(); item.setOrderId(order.getId()); item.setPetId(petId); item.setPetName(pet.getPetName()); item.setPrice(pet.getPrice()); item.setQuantity(quantity); orderItemMapper.insert(item); return order; }

@Transactional(rollbackFor = Exception.class)声明了事务边界，方法内任何一个环节抛出异常，前面的数据库操作全部回滚。rollbackFor = Exception.class要特意写出来，因为Spring默认只对RuntimeException回滚，检查异常不会触发回滚。selectByIdForUpdate使用悲观锁，在查询时对该行数据加排他锁，锁住之后到事务结束前其他事务不能再修改这条库存记录，从机制上避免超卖。

4.3 订单状态机的核心节点

订单状态建议用整数表示，而不是直接用字符串存储状态名称。整数的好处是占空间小、查询快、扩展方便，在代码里用常量或者枚举做映射。宠物商城的订单状态流转相对简单，核心节点是待付款、已付款、已发货、已完成，外加一个取消状态。

状态流转的校验逻辑放在Service层统一管理，不能在前端自由跳转。比如订单从待付款直接改成已发货是不允许的，必须有支付记录做支撑。更新时间字段update_time记录状态变更的时间点，配合操作日志表可以还原整个订单的时间轴。

5. 打包部署与排错：从IDEA到可直接演示的完整流程

5.1 一键打包与多环境运行

在IDEA的Terminal窗口里执行mvn clean package -DskipTests，Maven会先清理target目录，然后执行编译、资源复制、打包全流程。-DskipTests跳过测试代码的编译和执行，能明显缩短打包时间。打包完成后，target目录下会生成pet-shop-0.0.1-SNAPSHOT.jar，这个jar包就是Spring Boot内嵌Tomcat的可执行文件。

# 默认使用application.yml的配置启动 java -jar target/pet-shop-0.0.1-SNAPSHOT.jar # 指定外部配置文件启动 java -jar target/pet-shop-0.0.1-SNAPSHOT.jar --spring.config.location=/opt/config/application.yml # 指定端口启动 java -jar target/pet-shop-0.0.1-SNAPSHOT.jar --server.port=9090

日常开发在IDEA里直接运行启动类即可，但毕业设计答辩现场通常需要独立演示环境。这里建议打包前把项目里的application.yml复制一份到jar包同级的config目录，因为Spring Boot的配置加载优先级是外部config目录 > 外部根目录 > classpath内部，外部配置可以临时修改数据库地址或端口，不用重新打包。

5.2 三个高频异常排查顺序

启动时遇到java.sql.SQLException: Unknown database，先确认MySQL里是否执行了初始化SQL脚本，再检查database名称和连接串里的pet_shop是否完全一致，包括大小写。MySQL在Linux环境下对数据库名区分大小写，Windows下不区分，这个差异在跨平台部署时最容易踩坑。

遇到Invalid bound statement (not found)，表示Mapper接口和XML文件没有正确绑定。排查顺序是先确认application.yml里的mapper-locations路径和实际目录结构一致，再检查XML文件里的namespace是否和Mapper接口的全限定名完全一致。很多IDEA在复制包名时会把路径写错，导致namespace对不上。

# 常见目录结构 ├── main │ ├── java │ │ └── com/petshop/mapper/PetMapper.java │ └── resources │ └── mapper/PetMapper.xml

字段名映射不上时优先看map-underscore-to-camel-case配置是否开启。比如数据库字段pet_name默认映射到实体的petName，如果开启了驼峰转换仍然拿不到值，检查实体属性是否写了@Data注解，Lombok没有生效时实体类缺少getter/setter方法，MyBatis会反射失败。

5.3 用日志和接口工具验证模块完整性

部署完成后不要急着点页面，用Postman或浏览器开发者工具直接请求几个核心接口，能更快定位问题层级。先请求/pet/search不带任何参数，如果返回了商品列表，说明数据库连接、Mapper映射、Controller链路都通；收到404则看Controller类的@RequestMapping路径是否拼写完整。

# 查看Tomcat线程池与内存情况 jps -l jinfo -flags <pid>

启动时发现内存溢出类报错，在启动命令中追加-Xms256m -Xmx512m限制JVM堆内存。调整完参数后查看端口占用情况：netstat -ano | grep 8080确认没有其他进程抢占端口，最后用浏览器访问系统首页，走一遍「商品列表 → 详情 → 加入购物车 → 下单」的完整流程收尾。

本文还有配套的精品资源，点击获取