企业官网建设流程全解析

简介：这是一套基于SpringBoot+MySQL+HTML开发的宠物商城管理系统，面向计算机专业本科生及Java初学者，专为毕业设计、课程设计与期末大作业打造。系统覆盖商品展示、订单管理、用户中心、库存维护等核心业务模块，采用前后端分离思路（后端SpringBoot+MySQL，前端HTML/CSS/JS），界面简洁、功能完整、部署即用，有效解决学生缺乏真实项目经验与毕设选题落地难的问题。压缩包共2个文件（1个ZIP源码包+1个SQL数据库脚本），总大小14.06MB；ZIP内含完整IDEA工程结构、可运行后端代码、静态前端页面及微信小程序对接基础；SQL脚本支持MySQL 5.7+一键建库建表，确保开箱运行。已有58人学习下载，资源经导师验收并获高分评价，附带清晰目录结构与配置说明，无需二次修改即可编译部署，是Java Web开发实践与毕业设计落地的理想参考方案。

1. 项目缘起与核心价值：为什么选择宠物商城作为毕业设计

又到了一年一度的毕业季，对于计算机、软件工程相关专业的同学来说，毕业设计这道坎是绕不过去的。选题选得好，答辩轻松过，简历还能添一笔亮色；选题选得烂，那就是给自己挖坑，熬夜掉头发不说，最后可能还得求爷爷告奶奶。我当年毕业设计做的就是类似的项目，后来也带过不少学弟学妹，发现“宠物商城管理系统”这个选题，是经久不衰的高分“潜力股”。它不像“图书管理系统”那么老套，也不像“电商平台”那么宏大空洞，正好卡在一个“有挑战性但又能驾驭”的甜点区。

为什么这么说？首先，业务场景清晰且贴近生活。宠物用品购买、宠物信息管理、订单处理，这些功能逻辑清晰，评委老师一听就懂，不需要你花大量篇幅去解释复杂的业务背景。其次，技术栈组合经典且实用。Spring Boot + MySQL + HTML（通常指代前端技术栈，如HTML/CSS/JS或Thymeleaf模板）是当前企业级Web开发最主流、最基础的组合。用这个组合做项目，意味着你掌握了从后端API开发、数据库设计到前端页面渲染的完整开发链路，技术深度和广度都足够支撑起一篇合格的毕业论文。最后，扩展性强，容易出亮点。基础的增删改查（CRUD）做完后，你可以很容易地加入购物车、订单状态流转、用户权限控制、简单的数据分析图表等模块，让项目显得更丰满、更“像”一个真实的系统。

所以，如果你正为毕业设计发愁，或者想找一个能扎实练手的全栈项目，“基于SpringBoot+MySQL+HTML的宠物商城管理系统”绝对是一个不会错的选择。接下来，我就以一个过来人和实践者的角度，带你从零开始，拆解这个项目的核心模块、技术选型背后的逻辑，以及那些能让你的项目脱颖而出、获得高分的实战细节和避坑指南。

2. 技术栈深度解析：为什么是Spring Boot + MySQL + HTML？

在开始敲代码之前，我们得先搞清楚手里这些“工具”到底强在哪里，以及为什么要这样组合。很多同学只是机械地跟着教程把框架搭起来，却说不清所以然，这在答辩时是大忌。

2.1 Spring Boot：告别繁琐配置，专注业务逻辑

Spring Boot的核心价值就四个字：约定大于配置。传统的Spring MVC项目，光是把各种XML配置文件、依赖包整明白，就能劝退一大半新手。Spring Boot通过内嵌Web服务器（如Tomcat）、提供一系列“starter”依赖和自动配置，让你几乎可以“开箱即用”。

对于宠物商城这个项目，我们最关心的是Web层、业务层和数据访问层。Spring Boot的spring-boot-starter-web依赖一次性引入了Spring MVC、Jackson（JSON处理）、内嵌Tomcat等所有必需品。spring-boot-starter-data-jpa或spring-boot-starter-mybatis则能帮你快速集成数据库操作框架。你不需要再手动配置数据库连接池、事务管理器，Spring Boot已经根据你引入的依赖和application.properties中的配置，帮你把这一切都安排妥当了。

实操心得：在pom.xml中，我强烈建议使用spring-boot-starter-parent作为父项目，它能统一管理所有依赖的版本，避免令人头疼的版本冲突。对于宠物商城，基础依赖通常包括：spring-boot-starter-web,spring-boot-starter-data-jpa,mysql-connector-java, 以及模板引擎如spring-boot-starter-thymeleaf（如果你用Thymeleaf）或前端分离时需要的依赖。

2.2 MySQL：关系型数据库的稳妥之选

为什么不用MongoDB或者SQLite？对于毕业设计而言，稳妥和通用是第一要义。MySQL作为最流行的开源关系型数据库，其生态、文档和社区支持都是最完善的。宠物商城的数据模型非常规整：用户、商品、订单、购物车，这些实体之间存在明确的关系（一对多、多对多），用关系型数据库来建模是最自然、查询效率也最有保障的。

在设计数据库时，你需要画出清晰的ER图。例如：

• 用户表 (user)：id, username, password, phone, address, role（用于区分普通用户和管理员）。
• 商品表 (product)：id, name, category（狗粮、猫砂、玩具等）, price, stock（库存）, description, image_url。
• 订单表 (order)：id, order_no（订单号）, user_id, total_amount, status（待付款、待发货、已发货、已完成等）, create_time。
• 订单详情表 (order_item)：id, order_id, product_id, quantity, price（下单时的单价）。这里为什么要把价格单独存一份？因为商品价格可能会变动，必须记录下单时的快照。

避坑指南：数据库设计时，一定要设置正确的主键、外键和索引。比如，在order_item的product_id和order_id上建立索引，能大幅提升关联查询速度。另外，密码字段务必使用加密存储（如BCrypt），切勿明文保存。在application.properties中配置数据库连接时，记得加上serverTimezone=Asia/Shanghai，避免时区问题导致的时间错误。

2.3 HTML与前端技术：简单直接 vs 前后分离

这里的“HTML”是一个泛指。在毕业设计语境下，通常有两种实现方式：

1. 服务端渲染（SSR）：使用Thymeleaf、FreeMarker等模板引擎，在后端生成完整的HTML页面。这种方式简单直接，所有逻辑都在后端，适合快速开发、逻辑不太复杂的管理系统（如后台管理模块）。
2. 前后端分离：后端（Spring Boot）只提供RESTful API，返回JSON数据；前端使用纯HTML/CSS/JS，或者Vue.js、React等框架，通过Ajax调用API。这种方式更现代，前后端职责清晰，适合交互复杂的用户端页面（如商品浏览、购物车）。

对于毕业设计，我推荐混合模式：管理后台用Thymeleaf做服务端渲染，开发效率高；用户商城页面用前后端分离（比如用Vue.js），体现你对现代Web开发的理解。这既能展示你的技术广度，又能让项目结构更清晰。

3. 系统核心模块设计与实现拆解

一个完整的宠物商城，绝不仅仅是几个表的增删改查。我们需要从用户视角和管理员视角，梳理出核心的业务流程和模块。

3.1 用户端核心功能流：从浏览到下单

用户端的体验直接决定了这个系统是否“像”一个商城。核心流程如下：

1. 首页与商品浏览：首页需要展示商品分类、热门商品、轮播图等。这里涉及Product和Category实体。前端通过API请求商品列表，后端需要实现分页查询（Pageable）和条件筛选（按分类、价格区间等）。

   // ProductController 示例 @GetMapping("/api/products") public Page<ProductDTO> getProducts(@RequestParam(required = false) Long categoryId, @RequestParam(required = false) String keyword, @RequestParam(defaultValue = "0") int page, @RequestParam(defaultValue = "10") int size) { // 调用Service层进行复杂查询，返回分页结果 return productService.findProducts(categoryId, keyword, page, size); }

2. 商品详情与购物车：用户点击商品进入详情页。购物车功能是关键，它通常有两种实现方式：

   • Session存储：简单，用户未登录也能用，但数据无法跨设备同步。
   • 数据库存储：与用户ID绑定，数据持久化，体验好。建议采用这种方式，需要设计Cart和CartItem表。 添加商品到购物车时，必须校验库存（product.getStock() >= quantity），这是一个典型的并发问题点，我们后面会讲。

3. 下单与支付流程：这是最复杂的部分。

   • 生成订单：从购物车结算，创建Order和多个OrderItem。这里必须是事务性操作！你需要在一个事务内完成：a) 锁定或校验库存；b) 创建订单；c) 清空用户购物车。Spring的@Transactional注解就是为此而生。
   • 模拟支付：对于毕业设计，通常不需要集成真实的支付网关（如支付宝、微信支付）。可以做一个“模拟支付”接口，调用后直接将订单状态改为“已支付”，并触发后续的“减库存”操作。
   • 状态流转：订单状态（待支付、已支付、已发货、已完成）的设计要清晰，并在数据库中用枚举或状态字段明确标识。

3.2 管理后台：数据与业务的中枢

管理后台是给系统管理员用的，功能要全，操作要稳。

1. 商品管理（Product Management）：这是后台最常用的功能。除了基本的CRUD，要特别注意图片上传的实现。通常的做法是：

   • 前端通过<input type="file">上传图片。
   • 后端（ProductController）用@RequestParam("file") MultipartFile file接收。
   • 将文件保存到服务器特定目录（如/static/uploads/），或者更推荐的做法是上传到云存储（如阿里云OSS、腾讯云COS），然后将返回的文件URL存入数据库的image_url字段。
   • 在Thymeleaf模板或前端页面中，通过<img src="${product.imageUrl}">来显示。

2. 订单管理（Order Management）：管理员需要查看所有订单，并能修改订单状态（如点击“发货”）。这里涉及一个权限控制问题。你必须确保这些敏感操作只有管理员能执行。最简单的实现是：

   • 用户登录后，将其角色信息（如ROLE_ADMIN,ROLE_USER）存入Session或JWT Token。
   • 在后台管理的Controller方法上，使用Spring Security的注解进行权限控制：@PreAuthorize("hasRole('ADMIN')")。

3. 用户管理与数据分析：可以查看用户列表，以及一些简单的数据统计，比如“今日订单数”、“热销商品Top 10”。这些功能能为你的毕业设计论文增加“系统分析”章节的素材。可以用JPA的查询语句或原生SQL来统计，结果用ECharts等图表库在前端展示，效果会非常好。

3.3 数据库事务与并发控制：躲不开的坑

这是体现你项目深度的关键部分，也是答辩时老师喜欢问的地方。

场景：商品A库存只剩1件，用户甲和用户乙同时点击购买。如果没有控制，系统可能会创建两个订单，导致超卖（库存变为-1）。

解决方案：

1. 悲观锁：在查询商品时就用SELECT ... FOR UPDATE锁定这行数据，直到事务结束。其他事务必须等待。这在JPA中可以通过@Lock(LockModeType.PESSIMISTIC_WRITE)注解实现。这种方式简单粗暴，但并发性能差。
2. 乐观锁：更推荐的方式。在商品表中增加一个版本号字段version（整数类型）。每次更新时，SET stock = stock - 1, version = version + 1 WHERE id = ? AND version = ?。如果更新影响的行数为0，说明版本号对不上（数据已被别人修改过），此时抛出异常，让上层逻辑（如前端）提示用户“库存已变化，请重新下单”。在JPA实体类中，只需要加一个@Version注解即可。

   @Entity public class Product { @Id @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id; private String name; private Integer stock; @Version // 乐观锁版本号字段 private Integer version; // ... getters and setters }

   在Service层减库存时，JPA会自动利用这个version字段进行乐观锁控制。

核心要点：在“下单”这个核心业务方法上，务必加上@Transactional注解，并将事务隔离级别至少设置为@Transactional(isolation = Isolation.READ_COMMITTED)，以保证数据的一致性。同时，结合乐观锁机制，就能较好地处理高并发下的超卖问题。

4. 项目实战：从环境搭建到功能实现

理论说再多，不如动手做一遍。我们抛开那些华而不实的理论，直接进入实战环节，我会把几个最容易卡住的关键环节给你讲透。

4.1 初始化项目与基础配置

我习惯使用 start.spring.io 来快速生成项目骨架。选择：

• Project: Maven Project (更通用)
• Language: Java
• Spring Boot: 选择最新的稳定版（如3.x.x）
• Project Metadata: 填好你的Group（如com.yourname）和Artifact（如pet-mall）
• Dependencies: 添加Spring Web,Spring Data JPA,MySQL Driver,Thymeleaf（如果做服务端渲染）,Lombok（强烈推荐，简化实体类代码）。

点击生成并下载，用IDEA或Eclipse打开。第一件事是配置src/main/resources/application.properties：

# 服务器端口 server.port=8080 # 数据库配置 spring.datasource.url=jdbc:mysql://localhost:3306/pet_mall?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai spring.datasource.username=root spring.datasource.password=yourpassword spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver # JPA配置 spring.jpa.hibernate.ddl-auto=update # 开发环境用update，自动建表。生产环境务必改为none或validate！ spring.jpa.show-sql=true # 控制台打印SQL，调试神器 spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL8Dialect spring.jpa.properties.hibernate.format_sql=true # 格式化打印的SQL # 文件上传大小限制（如果需要） spring.servlet.multipart.max-file-size=10MB spring.servlet.multipart.max-request-size=10MB

关键一步：别忘了先在MySQL中手动创建数据库pet_mall（字符集用utf8mb4，支持emoji和更多字符）。ddl-auto=update会在应用启动时，根据你的实体类自动创建或更新表结构，但这仅限于开发初期。当表结构基本稳定后，建议改为validate，让Hibernate校验实体与数据库是否一致，避免误操作导致数据丢失。

4.2 实体类(Entity)与数据访问层(Repository)设计

以Product实体为例，展示如何用JPA和Lombok优雅地建模：

package com.yourname.petmall.entity; import lombok.Data; import javax.persistence.*; import java.math.BigDecimal; import java.time.LocalDateTime; @Entity @Table(name = "product") // 指定表名 @Data // Lombok注解，自动生成getter, setter, toString等 public class Product { @Id @GeneratedValue(strategy = GenerationType.IDENTITY) // 主键自增 private Long id; @Column(nullable = false, length = 100) // 非空，长度限制 private String name; @ManyToOne // 多对一关联：多个商品属于一个分类 @JoinColumn(name = "category_id") private Category category; private BigDecimal price; // 用BigDecimal表示金额，避免精度丢失 private Integer stock; // 库存 @Column(columnDefinition = "TEXT") // 使用TEXT类型存储长文本 private String description; private String imageUrl; // 商品图片链接 @Version // 乐观锁版本号 private Integer version; private LocalDateTime createTime; private LocalDateTime updateTime; @PrePersist // 持久化前自动设置创建时间 protected void onCreate() { createTime = LocalDateTime.now(); updateTime = LocalDateTime.now(); } @PreUpdate // 更新前自动设置更新时间 protected void onUpdate() { updateTime = LocalDateTime.now(); } }

对应的ProductRepository接口就非常简单了，继承JpaRepository就能获得大量现成的CRUD方法：

package com.yourname.petmall.repository; import com.yourname.petmall.entity.Product; import org.springframework.data.domain.Page; import org.springframework.data.domain.Pageable; import org.springframework.data.jpa.repository.JpaRepository; import org.springframework.data.jpa.repository.Query; import org.springframework.data.repository.query.Param; import java.util.List; public interface ProductRepository extends JpaRepository<Product, Long> { // 根据分类ID查找商品（分页） Page<Product> findByCategoryId(Long categoryId, Pageable pageable); // 根据名称模糊查询 List<Product> findByNameContaining(String name); // 复杂查询示例：查找某个价格区间内，库存大于0的商品 @Query("SELECT p FROM Product p WHERE p.price BETWEEN :minPrice AND :maxPrice AND p.stock > 0") Page<Product> findAvailableProductsInPriceRange(@Param("minPrice") BigDecimal minPrice, @Param("maxPrice") BigDecimal maxPrice, Pageable pageable); }

JPA的强大之处在于，你只需要按照规则定义方法名（如findByCategoryId），它就能自动生成对应的查询SQL，极大地提高了开发效率。

4.3 业务逻辑层(Service)与控制器层(Controller)实现

Service层负责处理核心业务逻辑，是大脑。以“下单”这个最复杂的服务为例：

@Service @Transactional // 类级别声明事务，所有公共方法都受事务管理 @Slf4j // Lombok注解，自动提供log变量 public class OrderService { @Autowired private ProductRepository productRepository; @Autowired private OrderRepository orderRepository; @Autowired private CartService cartService; public Order createOrder(Long userId, List<CartItemDTO> cartItems, String shippingAddress) { // 1. 计算总金额，并再次校验库存（防止购物车页面停留过久库存变化） BigDecimal totalAmount = BigDecimal.ZERO; List<OrderItem> orderItemList = new ArrayList<>(); for (CartItemDTO item : cartItems) { Product product = productRepository.findById(item.getProductId()) .orElseThrow(() -> new RuntimeException("商品不存在: " + item.getProductId())); if (product.getStock() < item.getQuantity()) { throw new RuntimeException("商品库存不足: " + product.getName()); } // 2. 扣减库存（乐观锁在此生效） int updatedRows = productRepository.deductStock(product.getId(), item.getQuantity()); if (updatedRows == 0) { // 乐观锁失败，库存已被其他订单修改 throw new RuntimeException("商品库存已发生变化，请重新确认订单: " + product.getName()); } // 3. 构建订单项 OrderItem orderItem = new OrderItem(); orderItem.setProduct(product); orderItem.setQuantity(item.getQuantity()); orderItem.setPrice(product.getPrice()); // 记录下单时的价格 orderItemList.add(orderItem); totalAmount = totalAmount.add(product.getPrice().multiply(BigDecimal.valueOf(item.getQuantity()))); } // 4. 创建订单 Order order = new Order(); order.setUserId(userId); order.setOrderNo(generateOrderNo()); // 生成唯一订单号，如时间戳+随机数 order.setTotalAmount(totalAmount); order.setStatus(OrderStatus.PENDING_PAYMENT); // 初始状态：待支付 order.setShippingAddress(shippingAddress); order.setItems(orderItemList); // 设置关联的订单项 Order savedOrder = orderRepository.save(order); // 5. 清空购物车 cartService.clearCart(userId); log.info("订单创建成功，订单号: {}", savedOrder.getOrderNo()); return savedOrder; } private String generateOrderNo() { // 简单示例：时间戳 + 随机数 return "ORD" + System.currentTimeMillis() + (int)((Math.random() * 9 + 1) * 1000); } }

在ProductRepository中需要定义自定义的扣减库存方法，以利用乐观锁：

@Modifying // 声明为修改查询 @Query("UPDATE Product p SET p.stock = p.stock - :quantity, p.version = p.version + 1 WHERE p.id = :id AND p.stock >= :quantity") int deductStock(@Param("id") Long productId, @Param("quantity") Integer quantity);

Controller层则负责接收HTTP请求，调用Service，并返回响应。对于RESTful API，可以这样设计：

@RestController @RequestMapping("/api/orders") public class OrderController { @Autowired private OrderService orderService; @PostMapping public ResponseEntity<?> createOrder(@RequestBody OrderRequest request, HttpSession session) { // 从session中获取当前用户ID（假设登录后已存入） Long userId = (Long) session.getAttribute("userId"); if (userId == null) { return ResponseEntity.status(HttpStatus.UNAUTHORIZED).body("用户未登录"); } try { Order order = orderService.createOrder(userId, request.getCartItems(), request.getShippingAddress()); return ResponseEntity.ok(new OrderResponse(order.getId(), order.getOrderNo(), "订单创建成功")); } catch (RuntimeException e) { // 捕获业务异常，如库存不足 return ResponseEntity.badRequest().body(e.getMessage()); } } }

4.4 前端页面与后端交互：以商品列表为例

如果你采用Thymeleaf服务端渲染，Controller和页面会紧密耦合：

@Controller @RequestMapping("/admin/product") public class AdminProductController { @Autowired private ProductService productService; @GetMapping public String listProducts(@RequestParam(defaultValue = "0") int page, Model model) { Page<Product> productPage = productService.getAllProducts(page, 10); model.addAttribute("products", productPage); return "admin/product-list"; // 对应 templates/admin/product-list.html } }

对应的product-list.html（Thymeleaf模板）中，你可以直接使用后端传过来的数据：

<!DOCTYPE html> <html xmlns:th="http://www.thymeleaf.org"> <head> <meta charset="UTF-8"> <title>商品管理</title> <!-- 引入Bootstrap等CSS框架 --> </head> <body> <table class="table"> <thead> <tr> <th>ID</th> <th>商品名</th> <th>价格</th> <th>库存</th> <th>操作</th> </tr> </thead> <tbody> <tr th:each="product : ${products.content}"> <td th:text="${product.id}"></td> <td th:text="${product.name}"></td> <td th:text="${#numbers.formatCurrency(product.price)}"></td> <td th:text="${product.stock}"></td> <td> <a th:href="@{/admin/product/edit/{id}(id=${product.id})}">编辑</a> <a href="#" th:onclick="|confirmDelete(${product.id})|">删除</a> </td> </tr> </tbody> </table> <!-- 分页组件 --> <div th:if="${products.totalPages > 1}"> <span th:each="i: ${#numbers.sequence(1, products.totalPages)}"> <a th:href="@{/admin/product(page=${i-1})}" th:text="${i}"></a> </span> </div> </body> </html>

如果是前后端分离，前端（比如用Vue.js）会通过Axios调用后端的RESTful API获取JSON数据，然后动态渲染到页面上。这种方式下，后端Controller返回的是Product对象的JSON数组，而不是视图名称。

5. 项目优化与高分亮点打造

把基础功能跑通，只是一个及格线。要想拿高分，你必须展示出对项目更深层次的思考和优化。以下几个方向，能瞬间提升你项目的“高级感”。

5.1 安全性加固：不止于登录

1. 密码加密：前面提过，用BCryptPasswordEncoder加密存储密码，这是Spring Security提供的标准方案，比MD5安全得多。
2. SQL注入防护：使用JPA或MyBatis的参数化查询，已经天然避免了SQL注入。绝对不要用字符串拼接的方式组装SQL。
3. XSS攻击防护：如果使用Thymeleaf，它默认会对输出进行HTML转义，提供了基础防护。对于纯API项目，可以在全局或关键接口上，通过过滤器或拦截器对请求参数进行清理。Spring Boot也可以集成commons-text库的StringEscapeUtils来转义HTML。
4. CSRF防护：如果使用Thymeleaf和Spring Security，默认是开启CSRF保护的。对于前后端分离项目，如果使用JWT等无状态认证，可以酌情关闭CSRF（http.csrf().disable()），但必须确保API没有跨站请求伪造的风险。
5. API接口鉴权：管理员的API一定要加权限注解@PreAuthorize。对于用户相关的API（如查询自己的订单），必须在Service层或Controller层校验当前登录用户ID与请求的资源所属用户ID是否匹配，防止越权访问。

5.2 性能与体验优化

1. 数据库连接池：Spring Boot默认使用HikariCP，性能很好。你可以在application.properties中调整其参数，如spring.datasource.hikari.maximum-pool-size=10。
2. 静态资源缓存：商品图片、CSS、JS这些静态资源，应该设置HTTP缓存头，减少重复请求。Spring Boot可以通过配置WebMvcConfigurer来实现。
3. 前端异步加载与分页：商品列表、订单列表务必做分页，不要一次性查询所有数据。前端通过滚动加载或分页器按钮异步请求数据，提升页面响应速度。
4. 日志记录：使用@Slf4j注解，在关键业务节点（如创建订单、支付成功）记录日志。这不仅便于调试，也是线上排查问题的依据。配置logback-spring.xml文件，将日志按级别输出到不同文件。

5.3 为论文和答辩准备的“加分项”

你的毕业设计不止是代码，论文和答辩同样重要。系统里的一些设计，可以直接成为你论文中的章节。

1. 数据库设计章节：拿出你精心设计的ER图，详细说明每个表、每个字段的作用，以及表之间的关系（一对一、一对多、多对多）。解释为什么这样设计，比如“订单详情表冗余存储商品单价是为了记录历史价格”。
2. 系统架构图：画一张简单的架构图，说明前端、后端Spring Boot应用、MySQL数据库之间的关系。如果用了缓存（如Redis），也可以画上去。
3. 核心算法或流程说明：比如“订单编号生成算法”、“基于乐观锁的库存扣减流程”。用流程图或伪代码清晰地表达出来。
4. 测试章节：不要只写“进行了测试”。用Postman截图展示你测试的API接口和返回结果。甚至可以为核心的Service方法（如OrderService.createOrder）编写单元测试（JUnit），并把测试代码和覆盖率报告截图放到论文里。
5. 部署说明：如何将Spring Boot项目打包成JAR文件，如何在服务器上运行（java -jar pet-mall.jar）。可以简要提一下用Nginx做反向代理，或者用Docker容器化部署，这能体现你的工程化能力。

6. 常见问题排查与避坑实录

做项目的过程中，你一定会遇到各种奇奇怪怪的问题。这里我总结几个最常见的，帮你提前排雷。

6.1 数据库连接失败与时区问题

问题：项目启动时报错Communications link failure或者The server time zone value '...' is unrecognized。解决：

1. 检查MySQL服务是否启动。
2. 检查application.properties中的url,username,password是否正确。
3. 最关键的一步：在数据库连接URL后面加上?serverTimezone=Asia/Shanghai&useUnicode=true&characterEncoding=utf8。高版本的MySQL驱动对时区要求严格，不加这个参数大概率连不上。

6.2 JPA实体类与数据库表映射问题

问题：启动时报Table 'pet_mall.xxx' doesn't exist，或者字段映射错误。解决：

1. 检查实体类的@Entity和@Table(name="xxx")注解是否正确。
2. 检查字段名是否与数据库列名对应。默认规则是驼峰转下划线（如imageUrl映射到image_url）。如果不匹配，使用@Column(name = "xxx")显式指定。
3. 检查spring.jpa.hibernate.ddl-auto配置。开发时用update，但要注意它不会删除列。如果改了字段类型，可能需要先手动删表或修改数据库。

6.3 事务不回滚问题

问题：在Service方法里抛出了异常，但数据库的数据还是被修改了，事务没有回滚。解决：

1. 确保你的Service方法是public的。Spring AOP代理默认只对public方法生效。
2. 确保异常是RuntimeException或其子类。默认情况下，Spring只对运行时异常进行回滚。如果是受检异常（如IOException），需要在@Transactional注解中指定rollbackFor = Exception.class。
3. 确保异常被抛出到方法外部，而不是在方法内部被try-catch吞掉了。如果非要捕获，记得在catch块里手动抛出new RuntimeException(e)。

6.4 前端页面无法加载静态资源或模板

问题：访问页面时，CSS/JS/图片不显示，或者Thymeleaf模板找不到。解决：

1. 静态资源：Spring Boot默认从/static/,/public/,/resources/,/META-INF/resources/这些目录下找静态资源。把你的CSS、JS、图片放在src/main/resources/static/目录下，访问路径就是/css/style.css。
2. Thymeleaf模板：模板文件必须放在src/main/resources/templates/目录下。Controller返回的字符串"admin/product-list"，Thymeleaf会自动去templates/下找admin/product-list.html。
3. 检查pom.xml中是否引入了spring-boot-starter-thymeleaf依赖。

6.5 跨域问题（CORS）——前后端分离时必遇

问题：前端运行在localhost:3000，后端运行在localhost:8080，前端调用后端API时浏览器报错CORS policy。解决：在后端Spring Boot项目中，添加一个全局CORS配置类。

@Configuration public class CorsConfig implements WebMvcConfigurer { @Override public void addCorsMappings(CorsRegistry registry) { registry.addMapping("/api/**") // 针对所有/api开头的接口 .allowedOrigins("http://localhost:3000") // 允许的前端地址 .allowedMethods("GET", "POST", "PUT", "DELETE", "OPTIONS") .allowedHeaders("*") .allowCredentials(true); } }

把这个项目从想法到代码，再到优化和排坑的完整过程走一遍，你得到的不仅仅是一个能运行的毕业设计，更是一套扎实的、可复用的全栈开发经验。记住，代码质量、文档清晰、答辩时能讲清楚技术选型和设计思路，是获得高分的关键。最后，别忘了在GitHub上好好维护你的代码仓库，清晰的README和提交记录，本身就是一个加分项。

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