Spring Boot文旅文创电商平台毕业设计实战：从建模到部署

一个河南文旅文创的电商平台用 Spring Boot 做后端毕业设计里最常见也最容易出彩的选题之一。这个项目的完整名字是“springboot河南文旅文创产品电子商务平台 毕业设计---附源码93886”从标题就能看出三个关键信息技术栈是 Spring Boot业务方向是文旅文创形态是电子商务系统。这篇文章我会从项目立项、数据建模、核心功能实现到最终部署完整复盘我做这个项目的全过程重点讲清楚每一步的设计理由和实际操作给正在做类似毕设或者想自己上手电商类项目的同学一个可以直接参考的路线。先说结论这个项目适合 Java 后端基础一般、想在毕业设计里体现完整业务闭环的人。它不要求你懂高并发、不要求微服务只要把 Spring Boot、MyBatis-Plus、MySQL、Redis 这几个基础组件吃透再配合一套干净的前端页面就足以拿到不错的评价。更重要的是文旅电商这个方向本身自带文化属性和场景温度比单纯做一个“xx管理系统”更容易在答辩时讲出亮点。1. 项目定位与技术选型为什么是Spring Boot1.1 文旅电商这个选题的核心价值河南是文旅资源大省从洛阳的龙门石窟到开封的清明上河园从郑州的商都文化到安阳的殷墟甲骨文每一处都有大量的文化符号可以转化为实体文创产品。但问题在于这些文创商品长期分散在线下景区商店和零散的淘宝店铺里游客在旅行结束后想复购很难找到一个集中的官方渠道。所以这个项目的第一层价值是做了一个垂直领域的商品聚合平台。第二层价值在于电商系统本身是典型的 CRUD 业务场景非常适合作为毕业设计来展示完整的工程能力。它天然包含用户管理、商品管理、购物车、订单流转、支付、库存扣减、后台管理等功能每一个模块都能对应到一套标准的开发规范做完一个项目相当于把所有 Java 后端开发的核心知识点全部串了一遍。1.2 Spring Boot做毕设的真实优势先说一句实在话现在毕业设计如果用 SSHStrutsSpringHibernate那种老框架写答辩老师大概率会质疑你的技术更新意识。Spring Boot 是目前企业级开发中复用率最高的框架之一它解决了传统 Spring 项目大量 XML 配置的痛点通过自动配置让开发者可以用极少的代码跑起一个 Web 服务。选它的理由可以归纳为三点。第一是“约定优于配置”Spring Boot 默认帮我们配置好了内嵌 Tomcat、数据源、自动扫描规则我只需要在application.yml里写几行核心参数就能启动项目第二是生态成熟无论是数据库操作、Redis 缓存还是文件上传都有非常成熟的 starter 包可以用第三是部署简单最终打成一个可执行的 jar 包服务器上只要有 JDK 环境就能直接运行对毕业设计演示或答辩场景非常友好。我在设计这个项目时参考了当下主流的“前后端分离”模式前端用 Vue 或者原生 HTMLJavaScript后端统一提供 RESTful API。前端不直接连数据库所有请求走 HTTP 接口这样既符合企业实际开发流程也让项目结构更清晰方便后续扩展小程序端或者 App 端。提示如果你的前端基础一般可以先用 Spring Boot 的模板引擎Thymeleaf做一个服务端渲染版本功能实现优先于技术炫技。等系统运行稳定后再升级为前后端分离降低开发风险。2. 数据库设计与业务模型落地2.1 文旅文创商品的特殊字段设计电商平台的商品表没什么神秘的基础字段无非是商品名称、价格、库存、图片、详情描述。但文旅文创商品有自己的一些特性需要额外考虑。第一个特性是“文化属性标签”。比如一件商品属于哪个文化 IP——是殷墟青铜器主题、洛阳牡丹主题还是少林禅意主题又比如商品类别是工艺品、文具、服饰配饰还是数字藏品。我设计了一个category字段同时增加一个cultural_tag字段用于打上类似“非遗”“大师联名”“景区限定”等标签。这些标签在后期做筛选和推荐时非常有用也让系统看起来更有业务深度。第二个特性是“产地/景区关联”。用户在浏览商品时往往会想知道这个文创产品是来自哪个城市、哪个景区。所以我在商品表里增加origin_place和scenic_spot字段存储类似“河南省洛阳市”“龙门石窟”这样的信息。这样首页就能实现“按城市逛文创”的分区展示比如进入“洛阳专区”看到的全是洛阳相关的文创产品。商品表的完整字段设计大致如下CREATE TABLE product ( id bigint(20) NOT NULL AUTO_INCREMENT, product_name varchar(128) NOT NULL COMMENT 商品名称, sub_title varchar(255) DEFAULT NULL COMMENT 副标题/卖点描述, category_id bigint(20) DEFAULT NULL COMMENT 分类ID, cultural_tag varchar(64) DEFAULT NULL COMMENT 文化标签非遗/大师联名/景区限定, origin_place varchar(64) DEFAULT NULL COMMENT 原产地/城市, scenic_spot varchar(64) DEFAULT NULL COMMENT 关联景区, price decimal(10,2) NOT NULL COMMENT 价格, stock int(11) NOT NULL COMMENT 库存, main_image varchar(255) DEFAULT NULL COMMENT 主图, detail_html text COMMENT 商品详情富文本, status tinyint(4) DEFAULT 1 COMMENT 状态1上架0下架, create_time datetime DEFAULT NULL, update_time datetime DEFAULT NULL, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;2.2 订单与库存核心表结构订单设计是整个电商系统的灵魂。我在设计时把订单拆成了两张表orders主表和order_item子表。主表记录订单的全局信息——订单号、用户 ID、总金额、状态、收货信息、创建时间子表记录订单明细——每个商品买了多少件、当时的成交单价是多少。订单状态这里我采用了电商通用的状态机待付款、待发货、待收货、已完成、已取消。用数字0/1/2/3/4存储状态值配合status字段在代码中做状态流转控制。之所以用数字而不用中文字符串是为了节省存储空间、查询效率更高同时避免多语言环境下的兼容问题。库存扣减是电商中最容易出问题的地方。我在代码里使用乐观锁配合数据库行锁来实现扣库存Update(UPDATE product SET stock stock - #{quantity} WHERE id #{productId} AND stock #{quantity}) int deductStock(Param(productId) Long productId, Param(quantity) Integer quantity);这条 SQL 的含义是只有当库存大于等于购买数量时才执行扣减。如果返回值小于 1说明库存不足直接抛出业务异常从源头避免了超卖。2.3 MyBatis-Plus与数据初始化经验持久层我选了 MyBatis-Plus而不是原生 MyBatis。原因很简单MyBatis-Plus 提供了内置的 BaseMapper 通用方法selectById、insert、updateById等单表操作完全不用手写 XML可以把精力集中在多表联查和复杂业务逻辑上。项目里我写了几个自定义 SQL 用于首页聚合查询比如查询“每个分类下的热销商品前 4 件”用窗口函数实现SELECT * FROM ( SELECT p.*, ROW_NUMBER() OVER (PARTITION BY category_id ORDER BY sales_count DESC) AS rn FROM product p WHERE p.status 1 ) t WHERE t.rn 4;数据初始化方面我建议在项目启动时通过CommandLineRunner自动插入一份演示数据。这样评审老师打开项目不需要手动导入 SQL 就能看到一个商品类别丰富、订单记录完整的系统。我准备了 10 个分类、50 个商品、若干个模拟用户的初始化脚本保证前端页面打开就有内容可看。3. 核心功能模块实现与关键代码3.1 用户登录与拦截鉴权这个项目我实现了两种用户角色普通会员和管理员。普通会员通过手机号验证码演示时用固定验证码 123456或者用户名密码登录管理员使用独立账号登录后台。登录的核心是基于 Token 的鉴权机制。用户登录成功后后端生成一个带过期时间的 Token我用的 UUID没引入 JWT其实 JWT 更规范但 UUID 对新手更友好也不涉及密钥管理存到 Redis 里并设置过期时间然后返回给前端。前端拿到 Token 后存放在 localStorage每次请求时在请求头里带上Authorization字段。我在 Spring Boot 中通过拦截器HandlerInterceptor统一校验 Token代码如下Component public class AuthInterceptor implements HandlerInterceptor { Autowired private StringRedisTemplate redisTemplate; Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { // 放行登录接口 String uri request.getRequestURI(); if (uri.contains(/user/login) || uri.contains(/user/register)) { return true; } String token request.getHeader(Authorization); if (StringUtils.hasText(token) Boolean.TRUE.equals(redisTemplate.hasKey(token: token))) { Long userId Long.valueOf(redisTemplate.opsForValue().get(token: token)); request.setAttribute(userId, userId); return true; } response.setStatus(401); response.setContentType(application/json;charsetUTF-8); response.getWriter().write({\code\:401,\msg\:\未登录或登录已过期\}); return false; } }拦截器需要在 WebMvcConfigurer 里注册指定拦截路径为/**排除掉静态资源路径。这里有个容易踩坑的地方如果前端页面和后端是同一个服务部署的一定要排除/static/**和/templates/**否则页面本身都会被拦截导致白屏。3.2 商品浏览与分类筛选实现首页是用户进入系统后看到的第一屏直接影响项目印象分。我的首页结构做了四个区块顶部导航、轮播图、分类快捷入口、商品瀑布流然后在商品列表页支持按分类、按文化标签、按价格区间、按城市筛选。商品查询接口我封装了一个组合条件查询利用 MyBatis-Plus 的LambdaQueryWrapper动态拼装条件public PageProductVO queryProductPage(ProductQuery query) { PageProduct page new Page(query.getPageNum(), query.getPageSize()); LambdaQueryWrapperProduct wrapper new LambdaQueryWrapper(); wrapper.eq(StringUtils.hasText(query.getCategoryId()), Product::getCategoryId, query.getCategoryId()) .eq(StringUtils.hasText(query.getCulturalTag()), Product::getCulturalTag, query.getCulturalTag()) .eq(StringUtils.hasText(query.getOriginPlace()), Product::getOriginPlace, query.getOriginPlace()) .eq(StringUtils.hasText(query.getScenicSpot()), Product::getScenicSpot, query.getScenicSpot()) .ge(query.getMinPrice() ! null, Product::getPrice, query.getMinPrice()) .le(query.getMaxPrice() ! null, Product::getPrice, query.getMaxPrice()) .eq(Product::getStatus, 1) .orderByDesc(Product::getCreateTime); return productMapper.selectPage(page, wrapper); }这种写法比手写 SQL 拼接安全得多LambdaQueryWrapper是类型安全的不会出现字段名写错导致的运行时异常。而且支持条件为空时自动忽略前端传什么就按什么过滤一套接口通吃多个页面。3.3 购物车与订单提交流程购物车设计我采用的是“Redis 缓存 数据库落库”的组合方案。用户未登录时购物车数据存本地登录后每次加入购物车就同步到 Redis使用 Hash 结构key 是cart:{userId}field 是商品 IDvalue 是商品数量。这种设计的好处是读写都非常快而且量小的时候完全够用。下单流程是核心链路我画了清晰的步骤前端点击结算 → 请求下单接口 → 后端校验库存 → 生成订单和订单明细 → 扣减库存 → 清空购物车对应商品 → 返回订单号和支付金额。创建订单的接口代码大概长这样Transactional(rollbackFor Exception.class) public Long createOrder(Long userId, ListCartItemDTO items, AddressDTO address) { // 1. 计算总金额 BigDecimal totalAmount BigDecimal.ZERO; for (CartItemDTO item : items) { Product product productMapper.selectById(item.getProductId()); if (product null || product.getStatus() ! 1) { throw new BizException(商品不存在或已下架); } totalAmount totalAmount.add(product.getPrice().multiply(BigDecimal.valueOf(item.getQuantity()))); } // 2. 创建订单主表记录 Orders order new Orders(); order.setOrderNo(generateOrderNo()); order.setUserId(userId); order.setTotalAmount(totalAmount); order.setStatus(0); // 待付款 order.setReceiverName(address.getReceiverName()); order.setReceiverPhone(address.getReceiverPhone()); order.setReceiverAddress(address.getReceiverAddress()); ordersMapper.insert(order); // 3. 创建订单明细并扣减库存 for (CartItemDTO item : items) { OrderItem orderItem new OrderItem(); orderItem.setOrderId(order.getId()); orderItem.setProductId(item.getProductId()); orderItem.setQuantity(item.getQuantity()); // 查询实时价格快照 Product product productMapper.selectById(item.getProductId()); orderItem.setPrice(product.getPrice()); orderItemMapper.insert(orderItem); int result productMapper.deductStock(item.getProductId(), item.getQuantity()); if (result 0) { throw new BizException(商品库存不足); } } return order.getId(); }这里有两个非常重要的点。第一Transactional必须加在从创建订单到扣减库存的整条链路上任何一个环节异常整个事务回滚不会出现订单创建了但库存没扣或者库存扣了但订单没建成的情况。第二订单明细中的价格必须是商品表的实时价格快照不能直接信任前端传过来的价格否则用户可以篡改支付金额。这个坑很多新手会踩切记。3.4 支付模块设计与模拟支付方案真实对接微信支付、支付宝需要商户号和相关资质对毕业设计来说实现一套完整可用的“模拟支付”方案是最稳妥的选择。我的模拟支付流程是这样的订单创建成功后跳转到收银台页面用户点击“确认支付”弹出一个伪装成支付界面的弹窗提示输入支付密码演示环境任意 6 位数字即可点击确认后后端把订单状态从待付款改为待发货并记录支付时间。但我在设计中预留了真实支付的扩展点。模拟支付接口和真实支付接口共用同一个业务入口区别只在于支付回调的触发方式。真实支付走的是异步回调由第三方支付平台通知后端模拟支付则是前端直接调用支付确认接口。这样以后想升级成真实支付只需要增加一个 controller 处理回调即可。支付完成后的订单状态流转代码如下public void confirmPayment(Long userId, Long orderId, String payPassword) { Orders order ordersMapper.selectById(orderId); if (order null || !order.getUserId().equals(userId)) { throw new BizException(订单不存在); } if (order.getStatus() ! 0) { throw new BizException(订单状态异常); } // 模拟校验支付密码 if (!StringUtils.hasText(payPassword) || payPassword.length() ! 6) { throw new BizException(支付密码格式错误); } order.setStatus(1); // 待发货 order.setPayTime(LocalDateTime.now()); ordersMapper.updateById(order); }4. 项目打包部署与运行避坑要点4.1 本机运行环境配置项目跑起来需要的环境很简单JDK 1.8 或 11、Maven 3.6、MySQL 5.7、Redis 5.0。如果你的机器上已经装了这些那直接打开 IDEA导入项目等待 Maven 下载依赖即可。但这里有个很实际的坑就是依赖下载慢。国内网络环境下Maven 中央仓库的下载速度很慢我强烈建议在settings.xml里配置阿里云镜像mirror idaliyunmaven/id mirrorOfcentral/mirrorOf name阿里云公共仓库/name urlhttps://maven.aliyun.com/repository/public/url /mirror配置完成后重新导入项目下载速度会有质的提升。另外别忘了在application.yml里修改数据库账号密码和 Redis 连接信息这个不改的话启动直接报连接失败。4.2 Spring Boot 版本选择与依赖冲突Spring Boot 版本的选择会直接影响后续能否顺利启动。我建议使用Spring Boot 2.7.x这个版本线原因有三个一是它对 JDK 1.8 的兼容性最好二是绝大多数教程和开源项目都基于这个版本遇到问题容易搜到解决方案三是配套的 Spring Cloud、Redis、MyBatis-Plus 等组件都有对应的稳定版本。Spring Boot 3.x 虽然已经是主流但它强制要求 JDK 17并且部分第三方组件的 starter 命名方式发生了变更比如javax变成了jakarta。如果你的 JDK 是 1.8直接用 Spring Boot 3.x 连启动都会报错。所以如果你不确定自己的环境请先查看java -version的输出。依赖冲突方面常见的问题是引入多个 XML 解析库或日志框架。MyBatis-Plus 依赖了 mybatis-spring如果同时手动引入了mybatis-spring-boot-starter就会导致 Bean 初始化冲突。解决方案是只保留一个依赖来源推荐保留 MyBatis-Plus 的mybatis-plus-boot-starter。4.3 前端静态资源映射配置很多同学做完前后端分离项目后会遇到一个尴尬情况后端 API 能通但前端页面不知道怎么整合进 Spring Boot 项目里。我的方案是把前端打包好的 dist 目录直接复制到 Spring Boot 的src/main/resources/static目录下这样一个服务就能同时提供页面和接口演示时一条命令启动不需要额外部署 Nginx。但这里有个细节前端路由如果是 history 模式路由路径不带#刷新页面时会出现 404因为后端不知道/product/123这个路径应该返回index.html。解决方法是加一个路由回退配置Configuration public class WebMvcConfig implements WebMvcConfigurer { Override public void addViewControllers(ViewControllerRegistry registry) { registry.addViewController(/{path:[^\\.]*}).setViewName(forward:/index.html); } }这段配置的意思是所有不包含点号的单层路径统一转发到index.html交给前端路由解析。这个方法在打包部署到服务器时尤其有用。5. 常见问题与排查技巧实录5.1 数据库连接报错启动时报Access denied for user rootlocalhost或者Unknown database十有八九是application.yml里数据库配置没改对。检查顺序是用户名密码是否正确、数据库名是否存在、MySQL 服务是否启动、数据库端口是否为 3306。排查命令用这一条就能快速定位mysql -u root -p -h localhost -P 3306如果连接成功再执行show databases;查看数据库列表。有时候还会遇到时区问题报The server time zone value Öйú±ê׼ʱ¼ä is unrecognized在连接串后面加上serverTimezoneAsia/Shanghai即可解决。5.2 MyBatis-Plus字段映射问题用 MyBatis-Plus 时如果字段命名不规范很容易出现查询结果中某些字段为 null。MyBatis-Plus 默认开启了驼峰命名映射mapUnderscoreToCamelCase默认为 true所以数据库字段create_time能自动映射到 Java 实体类的createTime。但是如果你在数据库里用了createTime这种不带下划线的命名而 Java 字段名也是createTime默认情况下反而映射不上。解决方案有两种一是把数据库字段全部改成下划线风格二是在实体字段上加TableField(createTime)注解。我建议采用统一的下划线风格前端展示层再做转换这样最干净。5.3 跨域与鉴权问题前后端分离部署时前端页面在 8080 端口后端接口在 8081 端口直接请求接口会出现跨域错误。CORS 配置是一个常见的坑Nginx 转发能解决但更简单的是在后端直接配置跨域可以在配置文件中这样设置cors: allowed-origins: * allowed-methods: * allowed-headers: *或者在配置类中注册CorsFilter。我推荐使用后者因为可控性更高可以精确限制允许的来源地址避免任意站点都能调用你的接口这也是一种安全习惯。5.4 端口占用与内存不足启动时报Port 8080 was already in use说明有程序占用了 8080 端口。查看占用进程的命令netstat -tlnp | grep 8080找到 PID 后 kill 掉或者直接改 application.yml 里的server.port换一个端口。如果是 IDEA 里反复重启导致端口没有完全释放等几秒再启动即可。内存不足的问题常见于本机运行多个服务比如 MySQL、Redis、IDEA、前端 Node 服务同时开启机器开始卡顿。建议关闭不需要的软件IDEA 里分配适当的内存参数或让 MySQL 占用更小的内存配置。5.5 Redis缓存引发的坑如果启动项目时 Redis 没有启动很多依赖 Redis 的接口会直接报连接异常。解决方案是在本地装一个 Redis 服务Windows 用户可以使用 Memurai 或者直接跑 Docker 容器启动 Redis写 Docker 启动脚本时要注意版本一致我常用的是 Redis 7.x 的镜像确保本地版本兼容再上生产或答辩演示环境。6. 源码结构与答辩准备的个人建议最后分享一下我对源码组织和答辩准备的看法。这个项目的源码要按模块分包清晰一个典型的包结构可以这么设计controller、service、mapper、entity、dto、vo、config、common通用返回结果、异常处理、interceptor。包结构清晰本身就是加分项答辩时老师让你介绍代码结构你直接按包名讲一遍思路就非常清晰。答辩时一定要准备几张核心图表业务流程图、订单状态流转图、数据库 ER 图。不需要非常专业但逻辑要能说通。我的建议是拿着笔在纸上画一遍确保自己能不看稿子就讲明白整个流程——登录后怎么浏览商品、怎么加购、怎么下单、怎么支付、支付后库存如何变化——这条链路能讲流畅项目答辩基本稳了。有一点我想特别提醒代码里的注释不要写成流水账重点注释业务逻辑的关键判断例如为什么这里要加事务、为什么这里要校验库存、为什么这个字段用快照价格。老师看代码时一眼就能看出你是真懂业务逻辑还是只是抄的代码注释是很好的一种能力展示方式。最后再分享一个自己的经验这个项目我前后迭代了三版第一版只做基本的 CRUD 和登录注册第二版加入了购物车和订单流转第三版才补充了库存扣减优化、支付模拟、分类筛选和 Redis 缓存。每一版都踩了不少坑但也正是这些坑让我真正理解了一个电商系统的底层逻辑。如果你在做类似的选题建议先把主流程跑通再逐渐叠加功能不要一上来就追求大而全。