简介面向微服务电商项目学习者的谷粒商城配套课件合集覆盖从入门到实战的完整知识链路尤其适合准备面试、做项目复盘或梳理分布式体系的开发者。内容按基础篇、高级篇、运维篇组织基础篇讲解项目环境搭建、SpringCloud组件、前端开发基础与商品服务高级篇深入接口幂等性、事务、缓存与分布式锁、ElasticSearch、RabbitMQ、支付、定时任务、ShardingSphere等高频考点运维篇补充K8S部署与DevOps实践。整套资源以PDF课件为主压缩包约33.51MB便于下载后在手机或电脑上按需查阅。已有2086人学习配合谷粒商城视频课程使用可快速定位知识点、补足薄弱环节既适合系统跟学也适合电商项目整体方案复盘。1. 从课件到能跑的谷粒商城这份资料到底该怎么用谷粒商城是 Java 后端学习者几乎绕不开的分布式电商项目B 站配套视频播放量常年排在前列。你手上的“谷粒商城资料整理课件.zip”大概率不是官方发布的压缩包而是某位学习者或培训机构把视频配套的 PPT、SQL 脚本、代码快照、部署文档甚至面试题整理到一起的二次打包。这类包的价值不在“看”而在“还原”你能不能在本地把课件里描述的商品分类、购物车、订单、秒杀这些模块跑起来。常见的情况是解压后目录结构混乱SQL 脚本过旧Redis 和 Elasticsearch 版本对不上或者课件讲了 Spring Cloud Alibaba 但本地 JDK 版本太新导致组件启动失败。本文按“解压识别 → 环境校准 → 数据库重建 → 服务编排 → 排错验证”这条路径把课件从静态资料变成可运行的项目。适合已经看完尚硅谷视频、想对照课件独立复现一遍的开发者也适合准备用这个项目写进简历、需要讲清楚每个模块启动顺序的求职者。文章只讲课件整理包里最常见的落地方式具体文件名以你实际解压结果为准。2. 解压与目录识别先弄清楚课件包里装的是什么拿到 zip 以后不要急着双击解压先用命令行看一眼压缩包的内部结构避免解压出一堆文件名乱码或者嵌套压缩包。这一步能帮你判断这份资料整理的完整度也决定了后面按照哪种方式还原项目。2.1 用 unzip 和 tree 快速摸清压缩包结构在 Linux 或 macOS 终端里先列出压缩包内容unzip -l 谷粒商城资料整理课件.zip | head -50这条命令只列出文件清单不实际解压。关键字眼包括高级篇、分布式中篇、基础篇、数据库、code、sql、docs等。如果清单里出现profile或环境配置目录说明这份课件附带环境安装说明对新手比较友好。确认结构后解压到当前目录unzip -q 谷粒商城资料整理课件.zip -d gulimall cd gulimall tree -L 2-q安静模式避免刷屏-d指定解压目标目录。tree -L 2只显示两层目录用来快速定位数据库初始化脚本、项目代码和课件PDF三个核心区域。提示Windows 用户直接用自带资源管理器解压没问题但遇到文件名乱码时用Bandizip或7-Zip选择 UTF-8 编码重新解压能解决大部分中文文件名问题。解压完成后90% 的谷粒商城资料包都会包含下面几类内容需要逐一确认目录/文件特征典型内容缺失时的影响sql/或*.sqlgulimall_admin.sql、gulimall_oms.sql、gulimall_pms.sql、gulimall_sms.sql、gulimall_wms.sql、gulimall_ums.sql无法初始化数据库项目启动即报错code/或项目源码gulimall-product、gulimall-order等微服务模块需要从 Git 仓库重新拉取课件/或md/pdf架构图、接口文档、部署文档不影响运行影响理解环境/或软件JDK、Maven、Nacos 安装包有则省去下载时间2.2 检查 Maven 与 JDK 版本课件项目最容易被卡死的第一关谷粒商城基于 Spring Cloud Alibaba课件对应的版本组合通常是 Spring Boot 2.x Spring Cloud Alibaba 2.1.x/2.2.x对 JDK 8 支持最好。如果你机器上只装了 JDK 11 或 17部分组件如nacos-config的旧版本会出现反射异常或IllegalArgumentException。在项目根目录查看pom.xmlgrep -E spring-boot|spring-cloud|spring-cloud-alibaba pom.xml | head -10看到版本号之后确认三件事自己本机java -version是否为 1.8建议 8u202 及以后版本。Maven 是否在 3.6.x 或以上。本地是否已安装 MySQL 5.7注意是 5.7不是 8.08.0 也能跑但serverTimezone和密码加密方式需要额外配置。如果本机 JDK 版本过高优先安装 JDK 8 并切换默认版本不建议强行在 JDK 11 上跑旧版 Spring Cloud Alibaba。切换版本在 macOS 上用export JAVA_HOME$(/usr/libexec/java_home -v 1.8)即可在 Linux 上用update-alternatives --config java。检查完 JDK 和 Maven下一步就要处理整个项目里最容易出问题的环节——数据库初始化。课件里的 SQL 脚本往往默认你是全新的 MySQL 5.7 实例如果之前装过别的项目库表冲突会直接导致启动失败。3. 五个数据库一次初始化SQL 脚本执行顺序与常见报错谷粒商城微服务拆分后每个服务对应一个独立的数据库分别为gulimall-admin后台管理、gulimall-pms商品系统、gulimall-oms订单系统、gulimall-sms营销系统、gulimall-ums会员系统、gulimall-wms库存系统。课件整理包里的 SQL 脚本顺序写错或者字符集没指定都会引发连锁报错。3.1 按依赖顺序导入 SQL 脚本优先导入gulimall_admin.sql因为它包含后台管理系统的菜单权限表和用户表其他业务库不依赖它但前端管理后台启动时会首先连接这个库。然后导入gulimall_pms.sql商品属性、分类、品牌、gulimall_ums.sql会员等级、成长值、gulimall_sms.sql优惠券、秒杀场次、gulimall_oms.sql订单、订单项、支付信息、gulimall_wms.sql仓库、库存、采购单。推荐用命令行导入避免图形化工具的字符集问题mysql -uroot -p --default-character-setutf8mb4 -e CREATE DATABASE IF NOT EXISTS gulimall_admin DEFAULT CHARSET utf8mb4; mysql -uroot -p --default-character-setutf8mb4 gulimall_admin sql/gulimall_admin.sql每条命令后面跟着的--default-character-setutf8mb4是为了防止课件脚本里的中文注释变成乱码。CREATE DATABASE语句先建库再导入表结构和数据顺序不能反。重复执行时IF NOT EXISTS保证不会报库已存在的错误但表不会自动跳过需要先手动DROP DATABASE再重来。其余五个库可以写成一个循环for db in pms ums sms oms wms; do mysql -uroot -p --default-character-setutf8mb4 -e CREATE DATABASE IF NOT EXISTS gulimall_${db} DEFAULT CHARSET utf8mb4; mysql -uroot -p --default-character-setutf8mb4 gulimall_${db} sql/gulimall_${db}.sql done循环里gulimall_${db}拼接出完整的库名重定向把文件内容喂给 mysql 客户端。执行过程中只要出现ERROR 1064语法错误或ERROR 1050表已存在先看报错行号再去对应 SQL 文件里查那一行前后的内容。多数情况是脚本里包含了USE语句或DROP TABLE IF EXISTS不影响整体导入。3.2 字符集与排序规则修改表字段避免中文乱码谷粒商城课件里的表结构如果直接按默认字符集导入插入中文数据时容易出现Incorrect string value错误。原因在于表的默认字符集是latin1而数据里包含中文。导入完成后统一修正字符集ALTER DATABASE gulimall_pms CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; SELECT TABLE_NAME FROM information_schema.TABLES WHERE TABLE_SCHEMA gulimall_pms;然后把该库下所有表都切换一遍SELECT CONCAT(ALTER TABLE gulimall_pms., TABLE_NAME, CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;) FROM information_schema.TABLES WHERE TABLE_SCHEMA gulimall_pms;这条 SQL 生成一批ALTER TABLE语句把结果复制出来执行即可。这里用CONCAT拼接字符串生成动态 SQL比手工逐表修改高效得多。information_schema.TABLES是 MySQL 系统库专门记录所有库表元数据凡是涉及到“把整个库的所有表批量改某个属性”都可以用这个思路生成 ALTER 语句。注意课件里的连接串如果写的是characterEncodingutf-8和utf8mb4并不冲突但 JDBC 驱动版本要对应 MySQL 5.7。如果是 MySQL 8.0需要在连接串后追加serverTimezoneAsia/Shanghai同时把驱动从com.mysql.jdbc.Driver改成com.mysql.cj.jdbc.Driver。数据库就绪后紧接着要处理所有微服务共用的注册中心、配置中心和远程调用组件。谷粒商城课件的核心架构是 Nacos 做注册和配置OpenFeign 做远程调用Sentinel 做熔断限流。这些中间件版本不匹配服务连不上注册中心后面的问题排查会非常痛苦。4. Nacos、Sentinel 与项目配置的版本对齐打开课件的docker-compose或环境配置目录大部分会写明 Nacos 1.4.x、Sentinel 1.8.x、MySQL 5.7、Redis 5.x 这一套组合。这个组合对应 Spring Cloud Alibaba 2.2.5.RELEASE是整个课件项目最稳定的一套版本矩阵。脱离这个矩阵自行升级到 Nacos 2.2 或 Spring Cloud Alibaba 2021会出现配置文件不兼容、服务注册不上注册中心等边界问题。4.1 用 Docker 一键拉起中间件手头有 Docker 的话推荐直接用容器方式运行 Nacos 和 Sentinel避免本机安装污染环境。在项目根目录新建docker-compose.ymlversion: 3 services: nacos: image: nacos/nacos-server:1.4.2 container_name: gulimall-nacos environment: MODE: standalone ports: - 8848:8848 - 9848:9848 sentinel: image: bladex/sentinel-dashboard:1.8.2 container_name: gulimall-sentinel ports: - 8858:8858 redis: image: redis:5.0 container_name: gulimall-redis ports: - 6379:6379启动命令docker-compose up -dMODE: standalone表示单机模式不依赖 MySQL 存储配置适合本地开发。ports左边的端口是宿主机端口右边是容器端口访问 Nacos 控制台用http://localhost:8848/nacos账号密码都是nacos。Sentinel 控制台地址是http://localhost:8858账号密码默认也是sentinel。如果课件里没有docker-compose.yml可以手动在 application.yml 里逐个配置中间件地址但记一下端口Nacos 8848、Sentinel 8858、Redis 6379、MySQL 3306。4.2 bootstrap.properties 五处必改配置项谷粒商城每个微服务模块的resources下都有bootstrap.properties这个文件优先于application.yml加载专门用于连接 Nacos 获取远程配置。总共要确认五个配置项spring.application.namegulimall-product spring.cloud.nacos.discovery.server-addr127.0.0.1:8848 spring.cloud.nacos.config.server-addr127.0.0.1:8848 spring.cloud.nacos.config.namespacea1b2c3d4-xxxx spring.cloud.nacos.config.groupDEFAULT_GROUPspring.application.name必须和 Nacos 配置中心的 Data ID 前缀保持一致否则拉不到远程配置。namespace填的是 Nacos 控制台里命名空间的ID不是名称课件库里通常已经导入了一份nacos_config.sql如果不小心导入了新的命名空间所有服务都拿不到配置。检查方法是在 Nacos 控制台“配置管理 → 配置列表”里看有没有gulimall-product.yml、gulimall-order.yml这些文件。group默认是DEFAULT_GROUP如果课件在老版本 Nacos 上导出配置时用了其他分组这里要对应改。全部中间件启动后进入源码构建阶段。课件附带的代码大多可以直接mvn install但依赖下载和模块编译顺序藏着不少坑值得单独捋一遍。5. 逆向工程与主工程启动按模块编译顺序排雷谷粒商城项目在课件里通常拆成两部分一部分是直接从 MyBatis-Plus 逆向工程生成的基础 CRUD 模块另一部分是手写的业务代码模块。先分清这两部分避免把逆向工程的代码和手写业务代码混在一起跑。逆向工程模块常见命名是gulimall-product、gulimall-order业务代码则在gulimall-ware等模块里通过service层扩展。5.1 先 install 公共模块再逐个启动课件里如果有gulimall-common或gulimall-gateway这类被其他模块依赖的基础包必须先装到本地 Maven 仓库否则产品服务会报程序包 com.atguigu.common.utils.R 不存在这类找不到类的错误。在项目根目录执行mvn install -pl gulimall-common -am -DskipTests-pl指定要构建的模块-am意思是同时构建该模块依赖的其他模块-DskipTests跳过测试用例加快编译速度。后续每个模块启动前都先确认它依赖的 common 包已经 install。公共模块安装完成后按下面的顺序启动服务:gulimall-gateway网关端口 88gulimall-product商品服务端口 10000gulimall-ware库存服务端口 11000gulimall-order订单服务端口 9000gulimall-member会员服务端口 8000这个顺序不是强制的因为 Nacos 注册中心本身允许服务乱序启动但网关后启动会减少前端请求 503 的概率。如果某个模块启动时报Nacos registry is starting先确认 Nacos 控制台能看到其他服务再排查网络或防火墙。5.2 内存分配本地跑全套服务的 JVM 参数建议谷粒商城完整启动至少需要 6 个 Java 进程加上 Nacos、Redis、MySQL默认的 JVM 堆内存会让电脑直接卡死。建议给每个服务都设置最大堆内存在 IDEA 的VM options里统一写-Xms256m -Xmx512m-Xms是初始堆大小-Xmx是最大堆大小设置成 256m/512m 对本地开发足够。如果你用的是 16G 内存的电脑可以放宽到-Xms512m -Xmx1024m。内存不够的典型表现是所有服务都能起来但第一次访问页面时 CPU 飙升GC 日志频繁出现Allocation Failure。启动完所有服务后进入验证环节。此时会暴露出大量“代码能跑但接口调不通”的问题集中在跨域、网关路由和 Redis 缓存这三块。6. 验证与排错商品接口返回空白或超时的三条检查路径服务全部注册到 Nacos 之后先从网关入口发起一次真实请求验证链路是否通。谷粒商城网关默认端口 88请求路径类似http://localhost:88/api/product/category/list/tree。如果返回空白或 500按下面三条路径排查。第一条路径是网关路由。查看gulimall-gateway模块里application.yml的路由配置确认StripPrefix是否设置为 1。谷粒商城的前端请求都带/api前缀网关需要把这个前缀剥离掉再转发给下游服务。常见错误是转发后下游服务收到/api/product/...而 Controller 的RequestMapping是/product/...导致 404。第二条路径是跨域配置。前端项目如果单独启动在http://localhost:8080而网关在 88属于跨域请求。网关里需要统一处理 CORSConfiguration public class GulimallCorsConfiguration { Bean public CorsWebFilter corsWebFilter() { CorsConfiguration config new CorsConfiguration(); config.addAllowedOrigin(*); config.addAllowedMethod(*); config.addAllowedHeader(*); UrlBasedCorsConfigurationSource source new UrlBasedCorsConfigurationSource(); source.registerCorsConfiguration(/**, config); return new CorsWebFilter(source); } }这段代码用的是 Spring Cloud Gateway 的响应式 APICorsWebFilter处理所有经过网关的跨域请求。addAllowedOrigin(*)允许任意来源生产环境要收紧addAllowedHeader(*)放行所有请求头否则前端自定义的token头会被拦截。第三条路径是 Redis 缓存导致的问题。谷粒商城分类菜单、首页轮播图都使用 Redis 做缓存预热。如果服务启动后第一次访问特别慢但刷新后正常是缓存未命中的正常现象如果一直超时去 Redis 里查缓存是否写入redis-cli keys gulimall*看到gulimall:category:level1这类 key 说明缓存已写入。如果keys结果为空查看商品服务日志确认Cacheable注解对应的 Redis 连接是否正常。谷粒商城用的 Redis 序列化器默认是 JDK 序列化Redis 里看到乱码是正常现象不要以为是数据损坏。6.1 单独启动前端项目时的代理转发验证课件附带的前端代码如果是gulimall-adminVue 2 Element UI本地启动端口在 1000 号左右。验证前端与后端连通性的最快方式是用浏览器开发者工具看 Network 面板里的请求。如果看到http://localhost:8080/api/...的请求返回 404而http://localhost:88/api/...能通说明前端的代理配置没生效。Vue 项目的vue.config.js里应该有类似下面的配置devServer: { proxy: { /api: { target: http://localhost:88, changeOrigin: true } } }changeOrigin: true会改写请求头里的Host让网关认为是同源请求。若修改后仍不通执行npm run dev重启前端服务再清一下浏览器缓存避免旧的 Service Worker 干扰测试。6.2 用 cURL 快速判断服务是否存活不想打开浏览器时直接在终端用 cURL 验证链路curl -X GET http://localhost:88/api/product/category/list/tree返回 JSON 数组说明链路通畅返回404 Not Found说明路由匹配失败返回500说明下游服务抛异常。看到 JSON 后再登录前端页面操作逐个保存数据触发写接口重点观察订单服务和库存服务有没有报数据库连接断开的错误。最后看一眼 Nacos 控制台的服务列表确认六个服务都处于健康状态再对照课件里的功能清单逐项勾选验证完成。本文还有配套的精品资源点击获取 谷粒商城本地部署全攻略：从课件到可运行微服务项目的完整实践
简介面向微服务电商项目学习者的谷粒商城配套课件合集覆盖从入门到实战的完整知识链路尤其适合准备面试、做项目复盘或梳理分布式体系的开发者。内容按基础篇、高级篇、运维篇组织基础篇讲解项目环境搭建、SpringCloud组件、前端开发基础与商品服务高级篇深入接口幂等性、事务、缓存与分布式锁、ElasticSearch、RabbitMQ、支付、定时任务、ShardingSphere等高频考点运维篇补充K8S部署与DevOps实践。整套资源以PDF课件为主压缩包约33.51MB便于下载后在手机或电脑上按需查阅。已有2086人学习配合谷粒商城视频课程使用可快速定位知识点、补足薄弱环节既适合系统跟学也适合电商项目整体方案复盘。1. 从课件到能跑的谷粒商城这份资料到底该怎么用谷粒商城是 Java 后端学习者几乎绕不开的分布式电商项目B 站配套视频播放量常年排在前列。你手上的“谷粒商城资料整理课件.zip”大概率不是官方发布的压缩包而是某位学习者或培训机构把视频配套的 PPT、SQL 脚本、代码快照、部署文档甚至面试题整理到一起的二次打包。这类包的价值不在“看”而在“还原”你能不能在本地把课件里描述的商品分类、购物车、订单、秒杀这些模块跑起来。常见的情况是解压后目录结构混乱SQL 脚本过旧Redis 和 Elasticsearch 版本对不上或者课件讲了 Spring Cloud Alibaba 但本地 JDK 版本太新导致组件启动失败。本文按“解压识别 → 环境校准 → 数据库重建 → 服务编排 → 排错验证”这条路径把课件从静态资料变成可运行的项目。适合已经看完尚硅谷视频、想对照课件独立复现一遍的开发者也适合准备用这个项目写进简历、需要讲清楚每个模块启动顺序的求职者。文章只讲课件整理包里最常见的落地方式具体文件名以你实际解压结果为准。2. 解压与目录识别先弄清楚课件包里装的是什么拿到 zip 以后不要急着双击解压先用命令行看一眼压缩包的内部结构避免解压出一堆文件名乱码或者嵌套压缩包。这一步能帮你判断这份资料整理的完整度也决定了后面按照哪种方式还原项目。2.1 用 unzip 和 tree 快速摸清压缩包结构在 Linux 或 macOS 终端里先列出压缩包内容unzip -l 谷粒商城资料整理课件.zip | head -50这条命令只列出文件清单不实际解压。关键字眼包括高级篇、分布式中篇、基础篇、数据库、code、sql、docs等。如果清单里出现profile或环境配置目录说明这份课件附带环境安装说明对新手比较友好。确认结构后解压到当前目录unzip -q 谷粒商城资料整理课件.zip -d gulimall cd gulimall tree -L 2-q安静模式避免刷屏-d指定解压目标目录。tree -L 2只显示两层目录用来快速定位数据库初始化脚本、项目代码和课件PDF三个核心区域。提示Windows 用户直接用自带资源管理器解压没问题但遇到文件名乱码时用Bandizip或7-Zip选择 UTF-8 编码重新解压能解决大部分中文文件名问题。解压完成后90% 的谷粒商城资料包都会包含下面几类内容需要逐一确认目录/文件特征典型内容缺失时的影响sql/或*.sqlgulimall_admin.sql、gulimall_oms.sql、gulimall_pms.sql、gulimall_sms.sql、gulimall_wms.sql、gulimall_ums.sql无法初始化数据库项目启动即报错code/或项目源码gulimall-product、gulimall-order等微服务模块需要从 Git 仓库重新拉取课件/或md/pdf架构图、接口文档、部署文档不影响运行影响理解环境/或软件JDK、Maven、Nacos 安装包有则省去下载时间2.2 检查 Maven 与 JDK 版本课件项目最容易被卡死的第一关谷粒商城基于 Spring Cloud Alibaba课件对应的版本组合通常是 Spring Boot 2.x Spring Cloud Alibaba 2.1.x/2.2.x对 JDK 8 支持最好。如果你机器上只装了 JDK 11 或 17部分组件如nacos-config的旧版本会出现反射异常或IllegalArgumentException。在项目根目录查看pom.xmlgrep -E spring-boot|spring-cloud|spring-cloud-alibaba pom.xml | head -10看到版本号之后确认三件事自己本机java -version是否为 1.8建议 8u202 及以后版本。Maven 是否在 3.6.x 或以上。本地是否已安装 MySQL 5.7注意是 5.7不是 8.08.0 也能跑但serverTimezone和密码加密方式需要额外配置。如果本机 JDK 版本过高优先安装 JDK 8 并切换默认版本不建议强行在 JDK 11 上跑旧版 Spring Cloud Alibaba。切换版本在 macOS 上用export JAVA_HOME$(/usr/libexec/java_home -v 1.8)即可在 Linux 上用update-alternatives --config java。检查完 JDK 和 Maven下一步就要处理整个项目里最容易出问题的环节——数据库初始化。课件里的 SQL 脚本往往默认你是全新的 MySQL 5.7 实例如果之前装过别的项目库表冲突会直接导致启动失败。3. 五个数据库一次初始化SQL 脚本执行顺序与常见报错谷粒商城微服务拆分后每个服务对应一个独立的数据库分别为gulimall-admin后台管理、gulimall-pms商品系统、gulimall-oms订单系统、gulimall-sms营销系统、gulimall-ums会员系统、gulimall-wms库存系统。课件整理包里的 SQL 脚本顺序写错或者字符集没指定都会引发连锁报错。3.1 按依赖顺序导入 SQL 脚本优先导入gulimall_admin.sql因为它包含后台管理系统的菜单权限表和用户表其他业务库不依赖它但前端管理后台启动时会首先连接这个库。然后导入gulimall_pms.sql商品属性、分类、品牌、gulimall_ums.sql会员等级、成长值、gulimall_sms.sql优惠券、秒杀场次、gulimall_oms.sql订单、订单项、支付信息、gulimall_wms.sql仓库、库存、采购单。推荐用命令行导入避免图形化工具的字符集问题mysql -uroot -p --default-character-setutf8mb4 -e CREATE DATABASE IF NOT EXISTS gulimall_admin DEFAULT CHARSET utf8mb4; mysql -uroot -p --default-character-setutf8mb4 gulimall_admin sql/gulimall_admin.sql每条命令后面跟着的--default-character-setutf8mb4是为了防止课件脚本里的中文注释变成乱码。CREATE DATABASE语句先建库再导入表结构和数据顺序不能反。重复执行时IF NOT EXISTS保证不会报库已存在的错误但表不会自动跳过需要先手动DROP DATABASE再重来。其余五个库可以写成一个循环for db in pms ums sms oms wms; do mysql -uroot -p --default-character-setutf8mb4 -e CREATE DATABASE IF NOT EXISTS gulimall_${db} DEFAULT CHARSET utf8mb4; mysql -uroot -p --default-character-setutf8mb4 gulimall_${db} sql/gulimall_${db}.sql done循环里gulimall_${db}拼接出完整的库名重定向把文件内容喂给 mysql 客户端。执行过程中只要出现ERROR 1064语法错误或ERROR 1050表已存在先看报错行号再去对应 SQL 文件里查那一行前后的内容。多数情况是脚本里包含了USE语句或DROP TABLE IF EXISTS不影响整体导入。3.2 字符集与排序规则修改表字段避免中文乱码谷粒商城课件里的表结构如果直接按默认字符集导入插入中文数据时容易出现Incorrect string value错误。原因在于表的默认字符集是latin1而数据里包含中文。导入完成后统一修正字符集ALTER DATABASE gulimall_pms CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; SELECT TABLE_NAME FROM information_schema.TABLES WHERE TABLE_SCHEMA gulimall_pms;然后把该库下所有表都切换一遍SELECT CONCAT(ALTER TABLE gulimall_pms., TABLE_NAME, CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;) FROM information_schema.TABLES WHERE TABLE_SCHEMA gulimall_pms;这条 SQL 生成一批ALTER TABLE语句把结果复制出来执行即可。这里用CONCAT拼接字符串生成动态 SQL比手工逐表修改高效得多。information_schema.TABLES是 MySQL 系统库专门记录所有库表元数据凡是涉及到“把整个库的所有表批量改某个属性”都可以用这个思路生成 ALTER 语句。注意课件里的连接串如果写的是characterEncodingutf-8和utf8mb4并不冲突但 JDBC 驱动版本要对应 MySQL 5.7。如果是 MySQL 8.0需要在连接串后追加serverTimezoneAsia/Shanghai同时把驱动从com.mysql.jdbc.Driver改成com.mysql.cj.jdbc.Driver。数据库就绪后紧接着要处理所有微服务共用的注册中心、配置中心和远程调用组件。谷粒商城课件的核心架构是 Nacos 做注册和配置OpenFeign 做远程调用Sentinel 做熔断限流。这些中间件版本不匹配服务连不上注册中心后面的问题排查会非常痛苦。4. Nacos、Sentinel 与项目配置的版本对齐打开课件的docker-compose或环境配置目录大部分会写明 Nacos 1.4.x、Sentinel 1.8.x、MySQL 5.7、Redis 5.x 这一套组合。这个组合对应 Spring Cloud Alibaba 2.2.5.RELEASE是整个课件项目最稳定的一套版本矩阵。脱离这个矩阵自行升级到 Nacos 2.2 或 Spring Cloud Alibaba 2021会出现配置文件不兼容、服务注册不上注册中心等边界问题。4.1 用 Docker 一键拉起中间件手头有 Docker 的话推荐直接用容器方式运行 Nacos 和 Sentinel避免本机安装污染环境。在项目根目录新建docker-compose.ymlversion: 3 services: nacos: image: nacos/nacos-server:1.4.2 container_name: gulimall-nacos environment: MODE: standalone ports: - 8848:8848 - 9848:9848 sentinel: image: bladex/sentinel-dashboard:1.8.2 container_name: gulimall-sentinel ports: - 8858:8858 redis: image: redis:5.0 container_name: gulimall-redis ports: - 6379:6379启动命令docker-compose up -dMODE: standalone表示单机模式不依赖 MySQL 存储配置适合本地开发。ports左边的端口是宿主机端口右边是容器端口访问 Nacos 控制台用http://localhost:8848/nacos账号密码都是nacos。Sentinel 控制台地址是http://localhost:8858账号密码默认也是sentinel。如果课件里没有docker-compose.yml可以手动在 application.yml 里逐个配置中间件地址但记一下端口Nacos 8848、Sentinel 8858、Redis 6379、MySQL 3306。4.2 bootstrap.properties 五处必改配置项谷粒商城每个微服务模块的resources下都有bootstrap.properties这个文件优先于application.yml加载专门用于连接 Nacos 获取远程配置。总共要确认五个配置项spring.application.namegulimall-product spring.cloud.nacos.discovery.server-addr127.0.0.1:8848 spring.cloud.nacos.config.server-addr127.0.0.1:8848 spring.cloud.nacos.config.namespacea1b2c3d4-xxxx spring.cloud.nacos.config.groupDEFAULT_GROUPspring.application.name必须和 Nacos 配置中心的 Data ID 前缀保持一致否则拉不到远程配置。namespace填的是 Nacos 控制台里命名空间的ID不是名称课件库里通常已经导入了一份nacos_config.sql如果不小心导入了新的命名空间所有服务都拿不到配置。检查方法是在 Nacos 控制台“配置管理 → 配置列表”里看有没有gulimall-product.yml、gulimall-order.yml这些文件。group默认是DEFAULT_GROUP如果课件在老版本 Nacos 上导出配置时用了其他分组这里要对应改。全部中间件启动后进入源码构建阶段。课件附带的代码大多可以直接mvn install但依赖下载和模块编译顺序藏着不少坑值得单独捋一遍。5. 逆向工程与主工程启动按模块编译顺序排雷谷粒商城项目在课件里通常拆成两部分一部分是直接从 MyBatis-Plus 逆向工程生成的基础 CRUD 模块另一部分是手写的业务代码模块。先分清这两部分避免把逆向工程的代码和手写业务代码混在一起跑。逆向工程模块常见命名是gulimall-product、gulimall-order业务代码则在gulimall-ware等模块里通过service层扩展。5.1 先 install 公共模块再逐个启动课件里如果有gulimall-common或gulimall-gateway这类被其他模块依赖的基础包必须先装到本地 Maven 仓库否则产品服务会报程序包 com.atguigu.common.utils.R 不存在这类找不到类的错误。在项目根目录执行mvn install -pl gulimall-common -am -DskipTests-pl指定要构建的模块-am意思是同时构建该模块依赖的其他模块-DskipTests跳过测试用例加快编译速度。后续每个模块启动前都先确认它依赖的 common 包已经 install。公共模块安装完成后按下面的顺序启动服务:gulimall-gateway网关端口 88gulimall-product商品服务端口 10000gulimall-ware库存服务端口 11000gulimall-order订单服务端口 9000gulimall-member会员服务端口 8000这个顺序不是强制的因为 Nacos 注册中心本身允许服务乱序启动但网关后启动会减少前端请求 503 的概率。如果某个模块启动时报Nacos registry is starting先确认 Nacos 控制台能看到其他服务再排查网络或防火墙。5.2 内存分配本地跑全套服务的 JVM 参数建议谷粒商城完整启动至少需要 6 个 Java 进程加上 Nacos、Redis、MySQL默认的 JVM 堆内存会让电脑直接卡死。建议给每个服务都设置最大堆内存在 IDEA 的VM options里统一写-Xms256m -Xmx512m-Xms是初始堆大小-Xmx是最大堆大小设置成 256m/512m 对本地开发足够。如果你用的是 16G 内存的电脑可以放宽到-Xms512m -Xmx1024m。内存不够的典型表现是所有服务都能起来但第一次访问页面时 CPU 飙升GC 日志频繁出现Allocation Failure。启动完所有服务后进入验证环节。此时会暴露出大量“代码能跑但接口调不通”的问题集中在跨域、网关路由和 Redis 缓存这三块。6. 验证与排错商品接口返回空白或超时的三条检查路径服务全部注册到 Nacos 之后先从网关入口发起一次真实请求验证链路是否通。谷粒商城网关默认端口 88请求路径类似http://localhost:88/api/product/category/list/tree。如果返回空白或 500按下面三条路径排查。第一条路径是网关路由。查看gulimall-gateway模块里application.yml的路由配置确认StripPrefix是否设置为 1。谷粒商城的前端请求都带/api前缀网关需要把这个前缀剥离掉再转发给下游服务。常见错误是转发后下游服务收到/api/product/...而 Controller 的RequestMapping是/product/...导致 404。第二条路径是跨域配置。前端项目如果单独启动在http://localhost:8080而网关在 88属于跨域请求。网关里需要统一处理 CORSConfiguration public class GulimallCorsConfiguration { Bean public CorsWebFilter corsWebFilter() { CorsConfiguration config new CorsConfiguration(); config.addAllowedOrigin(*); config.addAllowedMethod(*); config.addAllowedHeader(*); UrlBasedCorsConfigurationSource source new UrlBasedCorsConfigurationSource(); source.registerCorsConfiguration(/**, config); return new CorsWebFilter(source); } }这段代码用的是 Spring Cloud Gateway 的响应式 APICorsWebFilter处理所有经过网关的跨域请求。addAllowedOrigin(*)允许任意来源生产环境要收紧addAllowedHeader(*)放行所有请求头否则前端自定义的token头会被拦截。第三条路径是 Redis 缓存导致的问题。谷粒商城分类菜单、首页轮播图都使用 Redis 做缓存预热。如果服务启动后第一次访问特别慢但刷新后正常是缓存未命中的正常现象如果一直超时去 Redis 里查缓存是否写入redis-cli keys gulimall*看到gulimall:category:level1这类 key 说明缓存已写入。如果keys结果为空查看商品服务日志确认Cacheable注解对应的 Redis 连接是否正常。谷粒商城用的 Redis 序列化器默认是 JDK 序列化Redis 里看到乱码是正常现象不要以为是数据损坏。6.1 单独启动前端项目时的代理转发验证课件附带的前端代码如果是gulimall-adminVue 2 Element UI本地启动端口在 1000 号左右。验证前端与后端连通性的最快方式是用浏览器开发者工具看 Network 面板里的请求。如果看到http://localhost:8080/api/...的请求返回 404而http://localhost:88/api/...能通说明前端的代理配置没生效。Vue 项目的vue.config.js里应该有类似下面的配置devServer: { proxy: { /api: { target: http://localhost:88, changeOrigin: true } } }changeOrigin: true会改写请求头里的Host让网关认为是同源请求。若修改后仍不通执行npm run dev重启前端服务再清一下浏览器缓存避免旧的 Service Worker 干扰测试。6.2 用 cURL 快速判断服务是否存活不想打开浏览器时直接在终端用 cURL 验证链路curl -X GET http://localhost:88/api/product/category/list/tree返回 JSON 数组说明链路通畅返回404 Not Found说明路由匹配失败返回500说明下游服务抛异常。看到 JSON 后再登录前端页面操作逐个保存数据触发写接口重点观察订单服务和库存服务有没有报数据库连接断开的错误。最后看一眼 Nacos 控制台的服务列表确认六个服务都处于健康状态再对照课件里的功能清单逐项勾选验证完成。本文还有配套的精品资源点击获取