企业官网建设流程全解析

简介：这是一套基于SpringBoot+Mybatis+Thymeleaf+MySQL实现的完整购书商城系统源码，面向Java Web初学者与全栈开发入门者，解决在线图书浏览、购物车管理、订单下单及后台商品/用户/订单统一管控等核心电商场景问题。资源包共109个文件，涵盖35个Java业务与实体类（含Controller、Service、Mapper层）、10个Thymeleaf HTML模板页（如product.html、cart.html）、9个JS交互脚本、8个CSS样式文件（含weui.css、bootstrap.min.css等响应式布局支持）、6个XML配置文件（含Mybatis映射）、1个application.yml及1个初始化SQL脚本，整体压缩包仅4.81MB，轻量易部署。已有50人学习下载，适合快速理解MVC分层架构、数据库CRUD与前端模板渲染的协同逻辑。读者可直接导入IDE运行，获得含前后端交互、分类检索、购物车持久化、管理员后台等完整功能的可执行项目，并基于现有结构便捷扩展权限控制、搜索优化或支付集成。

1. 项目概述与核心价值

最近在整理过往项目时，翻出了一个几年前做的购书商城系统。这个项目麻雀虽小，五脏俱全，完整地走通了从商品展示、用户下单、购物车管理到后台订单处理的全链路。当时选型用的是 SpringBoot + Mybatis + Thymeleaf + MySQL 这套非常经典且生命力持久的 Java Web 技术栈。今天把它拿出来，不是要展示一个多么炫酷的“轮子”，而是想结合这个具体的案例，深入聊聊在构建这样一个典型电商业务系统时，技术选型背后的思考、开发中那些容易被忽略的细节，以及如何让这套组合拳发挥出最大的效能。无论你是刚学完 SpringBoot 想找个实战项目练手的新手，还是正在为团队技术栈选型纠结的开发者，相信这些从真实项目里踩坑总结出的经验，都能给你带来一些直接的参考。

这个项目本质上是一个 B2C 的在线图书销售平台。用户端提供了浏览图书、加入购物车、下单支付（模拟）、查看个人订单等功能；管理端则负责图书信息、用户订单、用户数据的管理。选择 SpringBoot 是为了快速搭建和免去繁琐的 XML 配置，Mybatis 作为数据访问层框架在灵活性和可控性上找到了平衡，Thymeleaf 作为模板引擎与 SpringBoot 集成度极高且语法自然，MySQL 则是关系型数据库中最稳妥的选择。接下来，我会从项目设计、技术细节、实操步骤到避坑指南，为你完整拆解这个项目。

2. 技术栈选型深度解析

2.1 为什么是 SpringBoot + Mybatis + Thymeleaf + MySQL？

在项目启动之初，面对琳琅满目的技术框架，做出一个合理且可持续的选择至关重要。我选择的这套组合，并非盲目跟风，而是基于以下几个核心考量：

SpringBoot 作为基石：它的核心价值在于“约定大于配置”和快速启动。对于一个商城系统，我们不需要从零开始配置 Spring MVC、事务管理器、数据源等一大堆 Bean。通过一个pom.xml引入spring-boot-starter-web,spring-boot-starter-thymeleaf,spring-boot-starter-jdbc等依赖，几乎就完成了基础框架的搭建。内嵌的 Tomcat 服务器让部署测试变得极其简单，application.properties或application.yml文件统一管理配置，极大地提升了开发效率。对于新手而言，它能让你避开复杂的配置沼泽，直击业务逻辑开发；对于有经验的开发者，其自动配置原理和 Starter 机制也值得深入研究。

Mybatis 的持久层权衡：在 ORM 框架的选择上，Hibernate 和 Mybatis 是两大主流。Hibernate 全自动，但复杂查询和优化有时会让人感觉“失控”。Mybatis 是半自动的，你需要自己编写 SQL，但这恰恰给了开发者最大的灵活性和控制力。对于商城系统，业务表结构相对固定但查询复杂多变（如多条件组合搜索图书、关联查询订单详情等），Mybatis 的动态 SQL 能力（<if>,<choose>,<foreach>等标签）和直接编写优化后 SQL 的能力，就显得非常趁手。同时，通过插件（如 PageHelper 分页插件）可以方便地扩展功能，保持了框架的简洁和强大。

Thymeleaf 作为视图层：在前后端分离大行其道的今天，为什么还要用服务端渲染的模板引擎？这取决于项目规模和团队结构。对于这个体量的项目，以及希望快速产出、SEO 友好、逻辑相对简单的场景，Thymeleaf 是一个优秀的选择。它语法自然，HTML 标签属性（如th:text,th:each,th:href）使得模板在浏览器中直接打开也能看到基本原型，对前端开发者友好。它与 SpringBoot 的集成是天衣无缝的，无需额外配置。相较于 Freemarker 或 JSP，Thymeleaf 在 Spring 生态中的支持度更高，功能也更现代。

MySQL 的稳妥之选：关系型数据库依然是这类交易型系统的首选，它能很好地保证事务的 ACID 特性。MySQL 凭借其开源、成熟、稳定、社区活跃、工具链完善的特点，成为不二之选。对于商城系统，我们主要利用其事务能力确保下单扣库存的一致性，利用索引优化商品列表分页查询、订单查询等性能。在项目初期，完全无需考虑分库分表，单实例 MySQL 足以支撑相当规模的业务。

注意：技术选型没有银弹。如果你的团队前端实力强劲，且项目需要复杂的交互和状态管理，那么采用 SpringBoot 只提供 RESTful API，前端使用 Vue/React 是完全合理甚至更优的。这里的选择是基于“个人或小团队快速构建全功能系统”的上下文。

2.2 项目架构与包结构设计

一个清晰的架构是项目可维护性的基础。虽然这是一个单体应用，但分层思想必不可少。我采用的是一种经典的三层架构，并在包结构上做了明确划分：

src/main/java/com/bookstore/ ├── BookstoreApplication.java // SpringBoot 主启动类 ├── config/ // 配置类包 │ ├── MybatisConfig.java // Mybatis 分页插件等配置 │ └── WebMvcConfig.java // 静态资源、拦截器等配置 ├── controller/ // 控制层，处理HTTP请求 │ ├── admin/ // 后台管理控制器 │ └── front/ // 前台用户控制器 ├── service/ // 业务逻辑层接口 │ └── impl/ // 业务逻辑层实现类 ├── dao/ // 数据访问层接口 (Mapper接口) ├── entity/ // 实体类，与数据库表对应 ├── dto/ // 数据传输对象，用于前后端交互 ├── vo/ // 视图对象，用于页面展示 └── util/ // 工具类包 src/main/resources/ ├── static/ // 静态资源 (css, js, images) ├── templates/ // Thymeleaf 模板文件 │ ├── admin/ // 后台管理页面 │ └── front/ // 前台用户页面 ├── mapper/ // Mybatis 的 XML 映射文件 │ ├── BookMapper.xml │ ├── OrderMapper.xml │ └── ... └── application.yml // 主配置文件

各层职责解析：

• Controller：薄薄的一层，只负责接收请求、调用 Service、返回视图或数据。应避免在此处编写复杂业务逻辑。
• Service：业务逻辑的核心所在地。事务注解（@Transactional）通常加在这一层的方法上，以确保业务操作的数据一致性。
• Dao/Mapper：纯粹的数据访问接口，通过 Mybatis 的注解或 XML 映射文件与数据库交互。
• Entity：使用 JPA 注解或 Mybatis 的简单 Java 对象，字段与数据库表列一一对应。这里我通常使用 Lombok 的@Data注解来减少 getter/setter 的样板代码。
• DTO/VO：这是容易被忽略但很重要的层。Entity是面向数据库的，而DTO用于在不同层之间传输数据（如接收前端参数的BookQueryDTO），VO则是专门为视图层组装的数据对象（如包含订单和订单项列表的OrderDetailVO）。严格区分它们能有效避免数据库字段暴露给前端，并让数据结构更贴合业务场景。

3. 核心模块设计与实现细节

3.1 数据库设计与关键表结构

数据库设计是系统的基石，良好的设计能事半功倍。对于购书商城，核心表包括用户表、图书表、购物车表、订单表和订单项表。

用户表 (user)

CREATE TABLE `user` ( `id` int(11) NOT NULL AUTO_INCREMENT COMMENT '主键', `username` varchar(50) NOT NULL COMMENT '用户名，用于登录', `password` varchar(255) NOT NULL COMMENT '加密后的密码', `email` varchar(100) DEFAULT NULL COMMENT '邮箱', `phone` varchar(20) DEFAULT NULL COMMENT '手机号', `avatar` varchar(500) DEFAULT NULL COMMENT '头像URL', `create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', `update_time` datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间', PRIMARY KEY (`id`), UNIQUE KEY `uk_username` (`username`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='用户表';

实操心得：密码字段务必使用varchar(255)，为使用 BCrypt 等强哈希算法留足空间。username设置唯一索引防止重复注册。utf8mb4字符集支持存储 Emoji 等特殊字符。

图书表 (book)

CREATE TABLE `book` ( `id` int(11) NOT NULL AUTO_INCREMENT, `title` varchar(200) NOT NULL COMMENT '书名', `author` varchar(100) NOT NULL COMMENT '作者', `publisher` varchar(100) DEFAULT NULL COMMENT '出版社', `isbn` varchar(20) DEFAULT NULL COMMENT 'ISBN号', `price` decimal(10,2) NOT NULL COMMENT '价格', `stock` int(11) NOT NULL DEFAULT '0' COMMENT '库存', `cover_image` varchar(500) DEFAULT NULL COMMENT '封面图片URL', `description` text COMMENT '图书描述', `category_id` int(11) DEFAULT NULL COMMENT '分类ID', `status` tinyint(4) DEFAULT '1' COMMENT '状态：1-上架，0-下架', `create_time` datetime DEFAULT CURRENT_TIMESTAMP, `update_time` datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (`id`), KEY `idx_category` (`category_id`), KEY `idx_title` (`title`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='图书表';

注意事项：价格使用DECIMAL(10,2)类型，精确存储货币。stock（库存）字段是后续实现高并发下单扣减的关键。为title和category_id建立索引，能大幅提升列表页和搜索页的查询速度。

订单表 (order) 与订单项表 (order_item)这是典型的一对多关系。订单表记录订单概要，订单项表记录购买的具体商品。

CREATE TABLE `order` ( `id` varchar(32) NOT NULL COMMENT '订单号，使用UUID或雪花算法生成', `user_id` int(11) NOT NULL COMMENT '用户ID', `total_amount` decimal(10,2) NOT NULL COMMENT '订单总金额', `status` tinyint(4) NOT NULL DEFAULT '0' COMMENT '状态：0-待支付，1-已支付，2-已发货，3-已完成，4-已取消', `address` varchar(500) NOT NULL COMMENT '收货地址', `create_time` datetime DEFAULT CURRENT_TIMESTAMP, `update_time` datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, PRIMARY KEY (`id`), KEY `idx_user_id` (`user_id`), KEY `idx_create_time` (`create_time`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='订单表'; CREATE TABLE `order_item` ( `id` int(11) NOT NULL AUTO_INCREMENT, `order_id` varchar(32) NOT NULL COMMENT '订单ID', `book_id` int(11) NOT NULL COMMENT '图书ID', `quantity` int(11) NOT NULL COMMENT '购买数量', `price` decimal(10,2) NOT NULL COMMENT '下单时的单价', `book_title` varchar(200) NOT NULL COMMENT '下单时的书名（快照）', PRIMARY KEY (`id`), KEY `idx_order_id` (`order_id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='订单项表';

核心设计点：

1. 订单号：不使用自增ID，而使用分布式ID（如UUID或雪花算法生成的字符串），避免信息泄露和便于分库分表扩展。
2. 数据快照：order_item表中存储了book_title和下单时的price。这是电商系统的通用做法，因为商品信息（如价格、书名）后续可能会变更，但订单历史必须保持下单时的原貌。
3. 索引：在order.user_id和order.create_time上建立索引，优化用户中心查询订单列表的性能。

3.2 Mybatis 的灵活运用与动态 SQL

Mybatis 的强大在于其动态 SQL 和灵活的映射。以图书多条件搜索为例，我们来看看如何编写BookMapper.xml。

首先，定义查询参数 DTO：

@Data public class BookQueryDTO { private String keyword; // 关键词（书名/作者） private Integer categoryId; // 分类ID private BigDecimal minPrice; // 最低价 private BigDecimal maxPrice; // 最高价 private Integer status; // 状态 // 分页参数 private Integer pageNum; private Integer pageSize; }

然后，在BookMapper.xml中编写动态 SQL：

<!-- BookMapper.xml --> <select id="selectByCondition" resultType="com.bookstore.entity.Book"> SELECT * FROM book <where> <if test="keyword != null and keyword != ''"> AND (title LIKE CONCAT('%', #{keyword}, '%') OR author LIKE CONCAT('%', #{keyword}, '%')) </if> <if test="categoryId != null"> AND category_id = #{categoryId} </if> <if test="minPrice != null"> AND price >= #{minPrice} </if> <if test="maxPrice != null"> AND price <= #{maxPrice} </if> <if test="status != null"> AND status = #{status} </if> </where> ORDER BY create_time DESC </select>

<where>标签会智能地处理AND前缀，如果其中所有if条件都不成立，则不会生成WHERE关键字；如果成立，它会自动去掉第一个AND。

关于#{}和${}的区别：这是一个经典面试题，也是安全性的关键。

• #{keyword}：Mybatis 会将其预处理为一个参数占位符?，能有效防止 SQL 注入。绝大多数情况下都应该使用#{}。
• ${keyword}：会直接进行字符串替换。例如ORDER BY ${orderBy}，如果你需要动态指定排序字段（且该字段是安全的、受控的），可以使用它。但绝不要用$来拼接用户输入的条件值，否则将产生严重的 SQL 注入漏洞。

分页处理：我推荐使用国人开发的 PageHelper 插件。配置简单，在 Service 层中只需两行代码：

// 在查询方法开始前调用 PageHelper.startPage(queryDTO.getPageNum(), queryDTO.getPageSize()); // 紧接着执行你的查询方法 List<Book> books = bookMapper.selectByCondition(queryDTO); // 查询结果会被包装成 PageInfo 对象，包含分页信息 PageInfo<Book> pageInfo = new PageInfo<>(books);

PageHelper 的原理是使用 Mybatis 的拦截器，在执行的 SQL 前后自动添加LIMIT语句和计算总数的语句，非常方便。

3.3 Thymeleaf 模板引擎的页面集成

Thymeleaf 让前后端协作变得顺畅。在application.yml中，通常只需要简单配置：

spring: thymeleaf: prefix: classpath:/templates/ # 模板文件位置 suffix: .html # 模板后缀 cache: false # 开发时关闭缓存，修改实时生效 mode: HTML # 模板模式

在前端页面（如templates/front/book/list.html）中，我们可以这样使用：

<!DOCTYPE html> <html xmlns:th="http://www.thymeleaf.org"> <head> <meta charset="UTF-8"> <title>图书列表</title> <link rel="stylesheet" th:href="@{/css/bootstrap.min.css}"> </head> <body> <!-- 引入公共片段，如导航栏 --> <div th:replace="fragments/header :: header"></div> <div class="container mt-4"> <!-- 迭代显示图书列表 --> <div class="row"> <div th:each="book : ${pageInfo.list}" class="col-md-3 mb-4"> <div class="card"> <img th:src="@{${book.coverImage}}" class="card-img-top" alt="封面"> <div class="card-body"> <h5 class="card-title" th:text="${book.title}">书名</h5> <p class="card-text text-muted" th:text="${book.author}">作者</p> <p class="card-text font-weight-bold text-danger" th:text="'¥' + ${#numbers.formatDecimal(book.price, 1, 2)}">价格</p> <a th:href="@{/book/detail/} + ${book.id}" class="btn btn-primary btn-sm">查看详情</a> <a th:href="@{/cart/add(bookId=${book.id})}" class="btn btn-success btn-sm">加入购物车</a> </div> </div> </div> </div> <!-- 分页组件 --> <nav aria-label="Page navigation"> <ul class="pagination justify-content-center"> <li class="page-item" th:classappend="${pageInfo.hasPreviousPage}? '' : 'disabled'"> <a class="page-link" th:href="@{/book/list(pageNum=${pageInfo.prePage})}" aria-label="Previous"> <span aria-hidden="true">&laquo;</span> </a> </li> <li th:each="pageNum : ${pageInfo.navigatepageNums}" class="page-item" th:classappend="${pageInfo.pageNum == pageNum}? 'active' : ''"> <a class="page-link" th:href="@{/book/list(pageNum=${pageNum})}" th:text="${pageNum}">1</a> </li> <li class="page-item" th:classappend="${pageInfo.hasNextPage}? '' : 'disabled'"> <a class="page-link" th:href="@{/book/list(pageNum=${pageInfo.nextPage})}" aria-label="Next"> <span aria-hidden="true">&raquo;</span> </a> </li> </ul> </nav> </div> <script th:src="@{/js/jquery.min.js}"></script> <script th:src="@{/js/bootstrap.bundle.min.js}"></script> </body> </html>

关键点解析：

• th:href="@{/path}"：Thymeleaf 的链接语法，@{}用于生成上下文相关的 URL，非常方便。
• th:text="${variable}"：替换标签内的文本内容。
• th:each：循环迭代，类似于 JSTL 的c:forEach。
• th:if/th:unless：条件判断。
• 表达式工具：如#numbers.formatDecimal用于格式化数字，#dates.format用于格式化日期等。
• 片段复用：th:replace或th:insert可以引入公共的页面片段（如页头、页脚），实现模块化。

4. 核心业务逻辑与事务控制

4.1 购物车与下单流程的实现

购物车功能通常有两种实现方式：基于 Session 或基于数据库。对于需要持久化（如用户登录后仍能看到购物车）的场景，我选择基于数据库。表结构可以很简单：id,user_id,book_id,quantity,create_time。

下单流程是商城系统的核心，也是最容易出并发问题的地方。其核心步骤和事务控制如下：

@Service public class OrderServiceImpl implements OrderService { @Autowired private CartMapper cartMapper; @Autowired private BookMapper bookMapper; @Autowired private OrderMapper orderMapper; @Autowired private OrderItemMapper orderItemMapper; @Transactional(rollbackFor = Exception.class) // 声明式事务管理 @Override public String createOrder(Integer userId, String address) { // 1. 校验用户和地址（略） // 2. 查询当前用户的购物车项 List<CartItem> cartItems = cartMapper.selectByUserId(userId); if (cartItems == null || cartItems.isEmpty()) { throw new RuntimeException("购物车为空"); } // 3. 计算总金额并校验库存（在事务内先校验） BigDecimal totalAmount = BigDecimal.ZERO; for (CartItem item : cartItems) { Book book = bookMapper.selectByIdForUpdate(item.getBookId()); // 使用悲观锁 if (book == null || book.getStatus() != 1) { throw new RuntimeException("商品[" + book.getTitle() + "]已下架或不存在"); } if (book.getStock() < item.getQuantity()) { throw new RuntimeException("商品[" + book.getTitle() + "]库存不足"); } totalAmount = totalAmount.add(book.getPrice().multiply(new BigDecimal(item.getQuantity()))); } // 4. 生成订单号（使用UUID） String orderId = UUID.randomUUID().toString().replace("-", ""); // 5. 创建订单主记录 Order order = new Order(); order.setId(orderId); order.setUserId(userId); order.setTotalAmount(totalAmount); order.setStatus(0); // 待支付 order.setAddress(address); orderMapper.insert(order); // 6. 创建订单项并扣减库存 for (CartItem item : cartItems) { Book book = bookMapper.selectById(item.getBookId()); // 创建订单项（快照） OrderItem orderItem = new OrderItem(); orderItem.setOrderId(orderId); orderItem.setBookId(item.getBookId()); orderItem.setQuantity(item.getQuantity()); orderItem.setPrice(book.getPrice()); orderItem.setBookTitle(book.getTitle()); orderItemMapper.insert(orderItem); // 扣减库存（乐观锁或直接扣减） int updateCount = bookMapper.reduceStock(item.getBookId(), item.getQuantity()); if (updateCount == 0) { // 扣减失败，库存可能已被其他请求修改，抛出异常触发事务回滚 throw new RuntimeException("商品[" + book.getTitle() + "]库存并发更新失败，请重试"); } } // 7. 清空当前用户的购物车 cartMapper.deleteByUserId(userId); return orderId; // 返回订单号，用于后续支付 } }

事务与并发控制详解：

1. @Transactional：该方法被此注解修饰，Spring 会为其开启一个事务。如果方法执行成功，事务提交；如果抛出RuntimeException或Error，事务回滚。rollbackFor = Exception.class指定了所有Exception也触发回滚，更为保险。
2. 库存扣减的并发问题：这是电商系统的经典难题。上述代码使用了“悲观锁”结合“乐观锁”的思路。
   • selectByIdForUpdate：在查询图书信息时使用了SELECT ... FOR UPDATE，这是数据库的悲观锁。它会锁住这行记录，直到当前事务结束，防止其他事务同时修改。这能保证在后续扣减前，库存值不被改变。但要注意，这会降低并发度，在高并发场景需谨慎使用。
   • reduceStock方法：在 Mybatis 的更新语句中，使用条件判断来实现乐观锁。

     <update id="reduceStock"> UPDATE book SET stock = stock - #{quantity}, update_time = NOW() WHERE id = #{bookId} AND stock >= #{quantity} <!-- 乐观锁条件：扣减时再次校验库存 --> </update>

     通过判断stock >= #{quantity}和updateCount == 0，我们可以知道扣减是否成功。如果失败，说明在FOR UPDATE之后、执行 UPDATE 之前，库存被其他操作修改了（虽然概率低，但可能发生），此时抛出异常，整个事务回滚，订单创建失败，用户需要重新下单。
3. 整个流程的原子性：由于所有数据库操作（查询购物车、校验库存、插入订单、插入订单项、扣库存、清购物车）都在同一个@Transactional事务内，它们要么全部成功，要么全部失败回滚。这保证了数据的一致性，不会出现“扣了库存却没生成订单”的脏数据。

4.2 用户认证与会话管理

对于简单的商城系统，使用 Spring Security 可能显得过重。我通常采用Session + 拦截器的方式来实现轻量级的登录认证。

登录逻辑：

@Controller public class LoginController { @PostMapping("/login") public String login(@RequestParam String username, @RequestParam String password, HttpSession session) { // 1. 根据用户名查询用户 User user = userService.findByUsername(username); // 2. 使用 BCrypt 验证密码（存储时也应使用 BCrypt 加密） if (user != null && BCrypt.checkpw(password, user.getPassword())) { // 3. 登录成功，将用户信息存入 Session session.setAttribute("loginUser", user); // 移除可能存在的错误信息 session.removeAttribute("loginError"); return "redirect:/index"; } else { // 4. 登录失败，返回错误信息 session.setAttribute("loginError", "用户名或密码错误"); return "redirect:/login"; } } @GetMapping("/logout") public String logout(HttpSession session) { session.invalidate(); // 使 Session 失效 return "redirect:/login"; } }

配置登录拦截器：

@Component public class LoginInterceptor implements HandlerInterceptor { @Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { HttpSession session = request.getSession(); Object user = session.getAttribute("loginUser"); if (user == null) { // 未登录，重定向到登录页 response.sendRedirect("/login"); return false; // 中断请求 } return true; // 放行 } }

在WebMvcConfig中注册这个拦截器，并配置需要拦截的路径（如/order/**,/cart/**,/user/center等），排除静态资源和登录注册页面。

安全提示：

1. 密码存储：绝对不要明文存储密码！使用BCryptPasswordEncoder进行哈希加密。它是专门为密码存储设计的，自带盐值，能有效抵御彩虹表攻击。
2. Session 安全：确保生产环境中 Session 的存储是安全且可扩展的（如使用 Redis 存储 Session）。同时，可以为 Session 设置合理的超时时间。
3. CSRF 防护：虽然这个简单项目可能没做，但在正式环境中，特别是使用 Thymeleaf 时，可以利用 Spring Security 或手动添加 CSRF Token 来防护。

5. 系统部署、优化与问题排查

5.1 从开发到生产部署

开发完成后，我们需要将 SpringBoot 应用打包部署。最常用的方式是打成可执行的 JAR 包。

1. 打包：在pom.xml中确保有spring-boot-maven-plugin插件。

   <build> <plugins> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> </plugin> </plugins> </build>

   在项目根目录下执行mvn clean package，会在target目录下生成bookstore-0.0.1-SNAPSHOT.jar。

2. 生产环境配置：使用application-prod.yml文件来覆盖开发配置。

   # application-prod.yml spring: datasource: url: jdbc:mysql://你的生产数据库IP:3306/bookstore?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai username: prod_user password: 强密码 hikari: maximum-pool-size: 20 # 连接池大小根据实际情况调整 thymeleaf: cache: true # 开启模板缓存，提升性能 server: port: 8080 # 日志配置 logging: level: com.bookstore: INFO file: name: /var/log/bookstore/app.log

   通过启动命令指定激活prod配置文件：java -jar bookstore-0.0.1-SNAPSHOT.jar --spring.profiles.active=prod

3. 后台运行与日志：在 Linux 服务器上，使用nohup命令让应用在后台运行，并输出日志到文件。

   nohup java -jar bookstore-0.0.1-SNAPSHOT.jar --spring.profiles.active=prod > app.log 2>&1 &

   使用tail -f app.log可以实时查看日志。

5.2 性能优化与常见问题排查

即使是一个小系统，也需要关注性能。以下是一些常见的优化点和问题排查思路：

1. 数据库连接池配置：SpringBoot 默认使用 HikariCP，它是目前性能最好的连接池之一。在生产环境中，需要根据数据库服务器性能和业务压力调整maximum-pool-size（通常建议在 10-50 之间），设置合理的connection-timeout和idle-timeout。

2. Mybatis 缓存问题：Mybatis 有一级缓存（SqlSession 级别）和二级缓存（Mapper 命名空间级别）。在大多数 Web 应用中，由于 SqlSession 生命周期与请求绑定，一级缓存作用有限且可能引起数据不一致。我通常建议显式关闭二级缓存，对于需要缓存的数据（如商品分类），使用 Redis 等专门的缓存中间件更为可控和强大。在mybatis.configuration.cache-enabled设置为false。

3. 慢查询监控与索引优化：开启 MySQL 的慢查询日志，定期分析。sql -- 在MySQL中设置 SET GLOBAL slow_query_log = 'ON'; SET GLOBAL long_query_time = 2; -- 超过2秒的查询 SET GLOBAL slow_query_log_file = '/var/log/mysql/slow.log';对于经常出现在慢日志中的查询，使用EXPLAIN分析其执行计划，检查是否缺少索引或索引失效。

4. 常见问题排查表

5.3 项目扩展思路

这个基础版本可以作为一个起点，根据需求进行多方向扩展：

1. 引入缓存：使用 Redis 缓存热点数据，如首页图书列表、分类信息，大幅减轻数据库压力。
2. 异步处理：使用 Spring 的@Async或消息队列（如 RabbitMQ）处理耗时操作，如发送订单确认邮件、生成订单报表等，提升请求响应速度。
3. 文件上传优化：将用户上传的头像、图书封面图片存储到对象存储服务（如阿里云 OSS、七牛云），减轻服务器磁盘 I/O 压力。
4. 微服务化拆分：如果业务增长，可以将用户服务、商品服务、订单服务、支付服务等拆分为独立的微服务，使用 Spring Cloud 生态进行治理。
5. 前端重构：保留后端 API，将 Thymeleaf 模板替换为 Vue.js 或 React 构建的单页面应用（SPA），实现前后端分离，获得更好的用户体验和开发体验。

回顾整个项目，从技术选型到数据库设计，从业务逻辑实现到事务并发控制，每一步都蕴含着对技术细节的思考和对业务逻辑的理解。SpringBoot+Mybatis+Thymeleaf+MySQL 这套组合之所以经典，正是因为它平衡了开发效率、灵活性、可控性和学习成本。在实现过程中，最深的体会是：清晰的架构分层和严谨的事务边界是系统稳定性的基石，而像库存扣减这样的核心业务点，必须结合悲观锁、乐观锁和事务机制来设计，任何侥幸心理都可能在高并发时带来灾难性后果。这个项目代码虽不复杂，但完整地串起了一个 Web 应用的核心环节，希望这份详细的拆解能帮助你不仅“跑通”代码，更能理解其背后的“所以然”。

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