简介这份资源是黑马程序员「苍穹外卖」Java SpringBoot 项目的完整开发资料合集面向正在学习或准备实战该项目的开发者覆盖从需求分析、系统设计到前后端实现的全流程。包内共约2000个文件以png、svg图片与js脚本为主另有140个java源码、46个vue组件、58个html页面、75个css样式及50个json接口文件并包含sql脚本、md讲义、产品原型与数据库设计文档压缩包约69.96MB。资源从理论到实践一应俱全md讲义梳理需求与技术选型sql脚本与数据库设计支撑数据持久化前端代码构建用户界面SpringBoot后端代码实现业务逻辑json接口定义前后端数据交互格式产品原型则帮助理解功能布局与交互流程。目前已有2537人学习下载适合希望系统掌握该项目架构、对照实操与查漏补缺的Java学习者。1. 苍穹外卖这套 Java 全栈资源到底适合谁在什么阶段拆如果你正在找一个能写进简历、又能扛住面试官追问的 Java 全栈项目苍穹外卖大概率已经被你刷到过好几次了。它是一套基于 SpringBoot MyBatis-Plus Redis MySQL 的外卖业务系统覆盖了管理端和用户端两条完整链路从菜品管理、套餐配置、购物车、下单、支付回调到订单状态流转业务闭环是完整的。这套资源里通常包含后端源码、前端源码、数据库脚本、接口文档以及部署说明属于那种「拿过来能跑、拆开能学、改完能讲」的类型。适合已经学完 SSM 或 SpringBoot 基础、想找一个真实业务场景把知识点串起来的人也适合工作一两年、想补一补全栈视角的初中级开发。不适合完全没写过 Controller 的新手直接硬啃因为它的业务分支和状态机足够让你在第一天就卡住。2. 环境搭建与数据库初始化从零把项目跑起来2.1 技术栈版本对齐与依赖检查拿到源码包之后第一件事不是急着mvn spring-boot:run而是先把版本对齐。苍穹外卖常见的组合是 JDK 8 或 JDK 11、SpringBoot 2.7.x、MyBatis-Plus 3.5.x、MySQL 8.0、Redis 6.x、Maven 3.6。版本不对齐是新手翻车最集中的地方比如 JDK 17 跑老版本 SpringBoot 会在启动时直接抛Unsupported class file major versionMySQL 5.7 导入 8.0 的脚本又会在字符集和utf8mb4_0900_ai_ci上卡住。我一般会先看pom.xml里的 parent 版本和java.version属性再确认本机java -version和mvn -v的输出。如果本机装的是 JDK 17最省事的做法是装一个 JDK 8 或 11 并在 IDE 里单独配置项目 SDK而不是去改 pom 里的版本号因为改版本号会连带触发一堆依赖冲突。# 检查本机环境三个命令的输出要能对上项目要求 java -version mvn -v mysql --version redis-server --version这段命令的作用是快速建立环境基线。java -version看主版本mvn -v看 Maven 用的 JDK 是不是和项目一致Maven 有时会用自己的 JAVA_HOMEmysql --version和redis-server --version确认中间件版本。参数上没什么可调的重点是输出结果要和项目文档里的要求逐条比对任何一条对不上都先解决再往下走。2.2 数据库脚本导入与连接配置数据库这一步是血泪经验最多的地方。苍穹外卖的 SQL 脚本一般包含建库、建表、初始化数据三部分导入顺序不能乱。常见做法是先建库再导表最后导数据因为部分脚本里带了外键或索引依赖。-- 建库时显式指定字符集避免中文乱码 CREATE DATABASE sky_take_out DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; -- 导入顺序先结构后数据 -- mysql -u root -p sky_take_out sky_take_out.sql建库语句里utf8mb4和utf8mb4_general_ci是关键参数。用utf8会在存 emoji 或部分生僻字时出问题用utf8mb4_0900_ai_ci在 MySQL 5.7 上又不认。general_ci是兼容性最好的选择。导入命令用重定向而不是复制粘贴是因为脚本里可能有几千行初始化数据粘贴容易截断。导完之后要改application.yml或application-dev.yml里的数据源配置spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/sky_take_out?serverTimezoneAsia/ShanghaiuseUnicodetruecharacterEncodingutf-8zeroDateTimeBehaviorconvertToNulluseSSLfalseallowPublicKeyRetrievaltrue username: root password: 你的密码 redis: host: localhost port: 6379 database: 0serverTimezoneAsia/Shanghai不加会在时间字段上差 8 小时useSSLfalse和allowPublicKeyRetrievaltrue是 MySQL 8 连接必须的少了会报Public Key Retrieval is not allowed。Redis 的database参数建议单独用一个库比如 0 号库留给项目避免和你本机其他项目的缓存互相覆盖。2.3 启动顺序与首次运行验证启动顺序建议是MySQL → Redis → 后端 → 前端。后端启动类一般在sky-server模块下找到带SpringBootApplication的类直接运行。启动日志里重点看三行Tomcat 端口、数据源初始化、Redis 连接。任何一行报错都别急着往下走。# 后端启动后用 curl 验证接口是否通 curl -X POST http://localhost:8080/admin/employee/login \ -H Content-Type: application/json \ -d {username:admin,password:123456}这个请求验证的是管理端登录接口。返回体里如果有code: 1和data.token说明数据库连接、MyBatis 映射、JWT 签发这条链路是通的。如果返回code: 0先看后端控制台的 SQL 日志大概率是账号密码在数据库里对不上或者密码加密方式不匹配。前端启动后如果页面空白优先看浏览器控制台的接口请求地址是不是指向了localhost:8080跨域问题在开发阶段一般由后端 CORS 配置解决。3. 核心业务链路拆解从登录鉴权到订单状态流转3.1 JWT 鉴权与拦截器配置苍穹外卖的鉴权用的是 JWT 拦截器方案。登录成功后后端签发 token前端存起来后续请求在 header 里带token字段拦截器统一校验。这套方案的好处是无状态、易扩展坑在于 token 过期处理和拦截路径配置。// JwtTokenAdminInterceptor 核心逻辑 public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) { // 非 Controller 方法直接放行 if (!(handler instanceof HandlerMethod)) { return true; } String token request.getHeader(token); try { Claims claims JwtUtil.parseJWT(jwtProperties.getAdminSecretKey(), token); Long empId Long.valueOf(claims.get(empId).toString()); BaseContext.setCurrentId(empId); return true; } catch (Exception e) { response.setStatus(401); return false; } }preHandle里先判断handler类型是为了放行静态资源和错误页不加这个判断会在访问 swagger 或 favicon 时报 401。BaseContext用的是 ThreadLocal请求结束后必须在afterCompletion里调remove()否则线程池复用时会串数据这个坑在并发测试时才暴露属于典型的玄学问题。jwtProperties里的密钥和过期时间建议放在配置文件中不要硬编码。3.2 订单状态机与微信支付回调订单模块是整个项目业务最厚的地方。状态流转大致是待付款 → 待接单 → 已接单 → 派送中 → 已完成中间还夹着取消和退款分支。每个状态变更都涉及数据库更新和可能的 WebSocket 推送。// 订单状态流转的核心更新逻辑 LambdaUpdateWrapperOrders wrapper new LambdaUpdateWrapper(); wrapper.eq(Orders::getId, ordersId) .eq(Orders::getStatus, Orders.PENDING_PAYMENT) .set(Orders::getStatus, Orders.TO_BE_CONFIRMED) .set(Orders::getCheckoutTime, LocalDateTime.now()); boolean success ordersMapper.update(null, wrapper) 0; if (!success) { throw new OrderBusinessException(订单状态已变更请刷新后重试); }这里用LambdaUpdateWrapper而不是先查再改是为了用数据库的行锁保证状态变更的原子性。eq(Orders::getStatus, PENDING_PAYMENT)这个条件不能省省了会出现两个请求同时把同一订单改成不同状态的并发问题。update返回影响行数为 0 说明状态已经被别人改过直接抛业务异常让前端刷新。支付回调这块项目里一般用模拟回调或者微信支付沙箱。回调接口要做三件事验签、幂等、更新状态。幂等靠订单号加唯一索引或者 Redis 分布式锁实现重复回调不能重复加积分或重复改状态。3.3 Redis 缓存与购物车实现购物车用 Redis 的 Hash 结构存储key 是cart:userIdfield 是菜品或套餐 IDvalue 是数量。选 Hash 而不是 String 是因为购物车需要频繁增减单个商品Hash 的HINCRBY是原子操作比读出来改再写回去安全。// 添加购物车 String key cart: userId; HashOperationsString, Object, Object ops redisTemplate.opsForHash(); ops.increment(key, dishId.toString(), 1); redisTemplate.expire(key, 7, TimeUnit.DAYS);increment的第二个参数是 field第三个是增量。每次操作后重设过期时间是常见做法避免购物车数据永久堆积。expire放在increment之后是因为如果 key 不存在increment会先创建再设值此时设过期才生效。菜品和套餐要分开存或者用前缀区分否则 ID 冲突时数量会加错。4. 避坑与排查部署和联调阶段最容易翻车的五个点4.1 启动报错 Port 8080 was already in use现象是后端启动直接失败日志第一行就是端口占用。原因是本机有其他服务占了 8080或者上一次启动的进程没退干净。解决方式是先查占用进程再决定是杀进程还是换端口。# Windows netstat -ano | findstr :8080 taskkill /PID 进程号 /F # Linux / Mac lsof -i:8080 kill -9 进程号换端口的话改application.yml里的server.port但要注意前端配置的接口地址也要同步改否则前端会 404。4.2 数据库连接报 Access denied for user现象是启动时数据源初始化失败报Access denied。原因通常是application.yml里的用户名密码和本机 MySQL 实际的不一致或者 MySQL 8 的caching_sha2_password认证插件和旧驱动不兼容。解决方式是先用命令行登录验证账号密码能登进去再检查驱动版本MySQL 8 要用mysql-connector-java 8.0.x以上。4.3 前端请求跨域被浏览器拦截现象是页面能打开但所有接口请求报 CORS 错误。原因是前后端端口不同浏览器同源策略拦截。解决方式是在后端加 CORS 配置或者用 Nginx 做统一入口。开发阶段我一般直接在配置类里加addCorsMappings允许localhost的常见端口。4.4 订单状态更新影响行数为 0现象是接口返回业务异常「订单状态已变更」。原因是并发场景下两个请求同时操作同一订单或者前端重复提交。解决方式是前端做按钮防抖后端用乐观锁或状态条件更新。上面 3.2 里的eq(status)就是最轻量的乐观锁实现。4.5 Redis 连接超时或序列化乱码现象是启动时报Unable to connect to Redis或者存进去的数据在 redis-cli 里看是乱码。连接问题先确认 Redis 服务是否启动、端口是否对、有没有设密码。乱码是序列化器配置问题RedisTemplate默认用 JDK 序列化存出来的 key 带二进制前缀。解决方式是手动配置StringRedisSerializer和GenericJackson2JsonRedisSerializer。Bean public RedisTemplateString, Object redisTemplate(RedisConnectionFactory factory) { RedisTemplateString, Object template new RedisTemplate(); template.setConnectionFactory(factory); template.setKeySerializer(new StringRedisSerializer()); template.setValueSerializer(new GenericJackson2JsonRedisSerializer()); template.setHashKeySerializer(new StringRedisSerializer()); template.setHashValueSerializer(new GenericJackson2JsonRedisSerializer()); return template; }四个序列化器都要设只设 key 不设 value 一样会乱码。GenericJackson2JsonRedisSerializer会在 JSON 里带类信息反序列化时能还原成原对象代价是存储体积略大。5. 部署到 Linux 与接口文档验证把项目从本机搬到服务器5.1 打包与服务器环境准备本机跑通之后下一步常见诉求是部署到 Linux。打包用mvn clean package -DskipTests产物在target目录下的 jar 包。服务器上要提前装好 JDK、MySQL、Redis版本和本机保持一致。# 服务器上后台启动 jar日志输出到文件 nohup java -jar sky-server-1.0-SNAPSHOT.jar \ --spring.profiles.activeprod \ sky.log 21 nohup保证终端断开后进程继续跑--spring.profiles.activeprod指定生产配置 sky.log 21把标准输出和错误都重定向到日志文件。是后台运行。启动后用tail -f sky.log看日志看到 Tomcat started on port 才算成功。生产配置里的数据库地址要改成服务器内网地址不要写 localhost。5.2 接口文档与前后端联调验证苍穹外卖一般带 Swagger 或 Knife4j 接口文档启动后访问/doc.html或/swagger-ui.html。验证顺序建议是先测登录拿 token再用 token 测带鉴权的接口最后测业务链路。验证项请求方式关键参数预期结果管理端登录POSTusername/password返回 token菜品分页查询GETpage/pageSize/name返回分页数据新增套餐POST套餐 JSON tokencode1用户端下单POST购物车数据 token返回订单号订单状态查询GETorderId返回当前状态表格里的验证顺序不能跳登录是后面所有接口的前提。如果某个接口返回 401先检查 header 里 token 字段名是不是和拦截器里取的一致大小写敏感。如果返回 500看后端日志的异常栈大概率是 SQL 映射或者空指针。5.3 一个容易被忽略的验证技巧部署到 Linux 之后时区问题会比本机更明显。服务器默认 UTC 时区时订单时间会比实际少 8 小时。解决方式是在启动参数里加-Duser.timezoneAsia/Shanghai或者改服务器时区。# 启动时指定时区 nohup java -Duser.timezoneAsia/Shanghai -jar sky-server-1.0-SNAPSHOT.jar sky.log 21 这个参数要放在-jar之前放在之后会被当成程序参数传给 main 方法而不是 JVM。从那以后我每次部署 Java 服务都强制走一遍「时区 字符集 日志路径」三件套检查因为这三个问题在本机开发时几乎不会暴露一到服务器就集中爆发。希望帮到你。本文还有配套的精品资源点击获取 苍穹外卖Java全栈项目实战：环境搭建、核心链路与部署避坑指南
简介这份资源是黑马程序员「苍穹外卖」Java SpringBoot 项目的完整开发资料合集面向正在学习或准备实战该项目的开发者覆盖从需求分析、系统设计到前后端实现的全流程。包内共约2000个文件以png、svg图片与js脚本为主另有140个java源码、46个vue组件、58个html页面、75个css样式及50个json接口文件并包含sql脚本、md讲义、产品原型与数据库设计文档压缩包约69.96MB。资源从理论到实践一应俱全md讲义梳理需求与技术选型sql脚本与数据库设计支撑数据持久化前端代码构建用户界面SpringBoot后端代码实现业务逻辑json接口定义前后端数据交互格式产品原型则帮助理解功能布局与交互流程。目前已有2537人学习下载适合希望系统掌握该项目架构、对照实操与查漏补缺的Java学习者。1. 苍穹外卖这套 Java 全栈资源到底适合谁在什么阶段拆如果你正在找一个能写进简历、又能扛住面试官追问的 Java 全栈项目苍穹外卖大概率已经被你刷到过好几次了。它是一套基于 SpringBoot MyBatis-Plus Redis MySQL 的外卖业务系统覆盖了管理端和用户端两条完整链路从菜品管理、套餐配置、购物车、下单、支付回调到订单状态流转业务闭环是完整的。这套资源里通常包含后端源码、前端源码、数据库脚本、接口文档以及部署说明属于那种「拿过来能跑、拆开能学、改完能讲」的类型。适合已经学完 SSM 或 SpringBoot 基础、想找一个真实业务场景把知识点串起来的人也适合工作一两年、想补一补全栈视角的初中级开发。不适合完全没写过 Controller 的新手直接硬啃因为它的业务分支和状态机足够让你在第一天就卡住。2. 环境搭建与数据库初始化从零把项目跑起来2.1 技术栈版本对齐与依赖检查拿到源码包之后第一件事不是急着mvn spring-boot:run而是先把版本对齐。苍穹外卖常见的组合是 JDK 8 或 JDK 11、SpringBoot 2.7.x、MyBatis-Plus 3.5.x、MySQL 8.0、Redis 6.x、Maven 3.6。版本不对齐是新手翻车最集中的地方比如 JDK 17 跑老版本 SpringBoot 会在启动时直接抛Unsupported class file major versionMySQL 5.7 导入 8.0 的脚本又会在字符集和utf8mb4_0900_ai_ci上卡住。我一般会先看pom.xml里的 parent 版本和java.version属性再确认本机java -version和mvn -v的输出。如果本机装的是 JDK 17最省事的做法是装一个 JDK 8 或 11 并在 IDE 里单独配置项目 SDK而不是去改 pom 里的版本号因为改版本号会连带触发一堆依赖冲突。# 检查本机环境三个命令的输出要能对上项目要求 java -version mvn -v mysql --version redis-server --version这段命令的作用是快速建立环境基线。java -version看主版本mvn -v看 Maven 用的 JDK 是不是和项目一致Maven 有时会用自己的 JAVA_HOMEmysql --version和redis-server --version确认中间件版本。参数上没什么可调的重点是输出结果要和项目文档里的要求逐条比对任何一条对不上都先解决再往下走。2.2 数据库脚本导入与连接配置数据库这一步是血泪经验最多的地方。苍穹外卖的 SQL 脚本一般包含建库、建表、初始化数据三部分导入顺序不能乱。常见做法是先建库再导表最后导数据因为部分脚本里带了外键或索引依赖。-- 建库时显式指定字符集避免中文乱码 CREATE DATABASE sky_take_out DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; -- 导入顺序先结构后数据 -- mysql -u root -p sky_take_out sky_take_out.sql建库语句里utf8mb4和utf8mb4_general_ci是关键参数。用utf8会在存 emoji 或部分生僻字时出问题用utf8mb4_0900_ai_ci在 MySQL 5.7 上又不认。general_ci是兼容性最好的选择。导入命令用重定向而不是复制粘贴是因为脚本里可能有几千行初始化数据粘贴容易截断。导完之后要改application.yml或application-dev.yml里的数据源配置spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/sky_take_out?serverTimezoneAsia/ShanghaiuseUnicodetruecharacterEncodingutf-8zeroDateTimeBehaviorconvertToNulluseSSLfalseallowPublicKeyRetrievaltrue username: root password: 你的密码 redis: host: localhost port: 6379 database: 0serverTimezoneAsia/Shanghai不加会在时间字段上差 8 小时useSSLfalse和allowPublicKeyRetrievaltrue是 MySQL 8 连接必须的少了会报Public Key Retrieval is not allowed。Redis 的database参数建议单独用一个库比如 0 号库留给项目避免和你本机其他项目的缓存互相覆盖。2.3 启动顺序与首次运行验证启动顺序建议是MySQL → Redis → 后端 → 前端。后端启动类一般在sky-server模块下找到带SpringBootApplication的类直接运行。启动日志里重点看三行Tomcat 端口、数据源初始化、Redis 连接。任何一行报错都别急着往下走。# 后端启动后用 curl 验证接口是否通 curl -X POST http://localhost:8080/admin/employee/login \ -H Content-Type: application/json \ -d {username:admin,password:123456}这个请求验证的是管理端登录接口。返回体里如果有code: 1和data.token说明数据库连接、MyBatis 映射、JWT 签发这条链路是通的。如果返回code: 0先看后端控制台的 SQL 日志大概率是账号密码在数据库里对不上或者密码加密方式不匹配。前端启动后如果页面空白优先看浏览器控制台的接口请求地址是不是指向了localhost:8080跨域问题在开发阶段一般由后端 CORS 配置解决。3. 核心业务链路拆解从登录鉴权到订单状态流转3.1 JWT 鉴权与拦截器配置苍穹外卖的鉴权用的是 JWT 拦截器方案。登录成功后后端签发 token前端存起来后续请求在 header 里带token字段拦截器统一校验。这套方案的好处是无状态、易扩展坑在于 token 过期处理和拦截路径配置。// JwtTokenAdminInterceptor 核心逻辑 public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) { // 非 Controller 方法直接放行 if (!(handler instanceof HandlerMethod)) { return true; } String token request.getHeader(token); try { Claims claims JwtUtil.parseJWT(jwtProperties.getAdminSecretKey(), token); Long empId Long.valueOf(claims.get(empId).toString()); BaseContext.setCurrentId(empId); return true; } catch (Exception e) { response.setStatus(401); return false; } }preHandle里先判断handler类型是为了放行静态资源和错误页不加这个判断会在访问 swagger 或 favicon 时报 401。BaseContext用的是 ThreadLocal请求结束后必须在afterCompletion里调remove()否则线程池复用时会串数据这个坑在并发测试时才暴露属于典型的玄学问题。jwtProperties里的密钥和过期时间建议放在配置文件中不要硬编码。3.2 订单状态机与微信支付回调订单模块是整个项目业务最厚的地方。状态流转大致是待付款 → 待接单 → 已接单 → 派送中 → 已完成中间还夹着取消和退款分支。每个状态变更都涉及数据库更新和可能的 WebSocket 推送。// 订单状态流转的核心更新逻辑 LambdaUpdateWrapperOrders wrapper new LambdaUpdateWrapper(); wrapper.eq(Orders::getId, ordersId) .eq(Orders::getStatus, Orders.PENDING_PAYMENT) .set(Orders::getStatus, Orders.TO_BE_CONFIRMED) .set(Orders::getCheckoutTime, LocalDateTime.now()); boolean success ordersMapper.update(null, wrapper) 0; if (!success) { throw new OrderBusinessException(订单状态已变更请刷新后重试); }这里用LambdaUpdateWrapper而不是先查再改是为了用数据库的行锁保证状态变更的原子性。eq(Orders::getStatus, PENDING_PAYMENT)这个条件不能省省了会出现两个请求同时把同一订单改成不同状态的并发问题。update返回影响行数为 0 说明状态已经被别人改过直接抛业务异常让前端刷新。支付回调这块项目里一般用模拟回调或者微信支付沙箱。回调接口要做三件事验签、幂等、更新状态。幂等靠订单号加唯一索引或者 Redis 分布式锁实现重复回调不能重复加积分或重复改状态。3.3 Redis 缓存与购物车实现购物车用 Redis 的 Hash 结构存储key 是cart:userIdfield 是菜品或套餐 IDvalue 是数量。选 Hash 而不是 String 是因为购物车需要频繁增减单个商品Hash 的HINCRBY是原子操作比读出来改再写回去安全。// 添加购物车 String key cart: userId; HashOperationsString, Object, Object ops redisTemplate.opsForHash(); ops.increment(key, dishId.toString(), 1); redisTemplate.expire(key, 7, TimeUnit.DAYS);increment的第二个参数是 field第三个是增量。每次操作后重设过期时间是常见做法避免购物车数据永久堆积。expire放在increment之后是因为如果 key 不存在increment会先创建再设值此时设过期才生效。菜品和套餐要分开存或者用前缀区分否则 ID 冲突时数量会加错。4. 避坑与排查部署和联调阶段最容易翻车的五个点4.1 启动报错 Port 8080 was already in use现象是后端启动直接失败日志第一行就是端口占用。原因是本机有其他服务占了 8080或者上一次启动的进程没退干净。解决方式是先查占用进程再决定是杀进程还是换端口。# Windows netstat -ano | findstr :8080 taskkill /PID 进程号 /F # Linux / Mac lsof -i:8080 kill -9 进程号换端口的话改application.yml里的server.port但要注意前端配置的接口地址也要同步改否则前端会 404。4.2 数据库连接报 Access denied for user现象是启动时数据源初始化失败报Access denied。原因通常是application.yml里的用户名密码和本机 MySQL 实际的不一致或者 MySQL 8 的caching_sha2_password认证插件和旧驱动不兼容。解决方式是先用命令行登录验证账号密码能登进去再检查驱动版本MySQL 8 要用mysql-connector-java 8.0.x以上。4.3 前端请求跨域被浏览器拦截现象是页面能打开但所有接口请求报 CORS 错误。原因是前后端端口不同浏览器同源策略拦截。解决方式是在后端加 CORS 配置或者用 Nginx 做统一入口。开发阶段我一般直接在配置类里加addCorsMappings允许localhost的常见端口。4.4 订单状态更新影响行数为 0现象是接口返回业务异常「订单状态已变更」。原因是并发场景下两个请求同时操作同一订单或者前端重复提交。解决方式是前端做按钮防抖后端用乐观锁或状态条件更新。上面 3.2 里的eq(status)就是最轻量的乐观锁实现。4.5 Redis 连接超时或序列化乱码现象是启动时报Unable to connect to Redis或者存进去的数据在 redis-cli 里看是乱码。连接问题先确认 Redis 服务是否启动、端口是否对、有没有设密码。乱码是序列化器配置问题RedisTemplate默认用 JDK 序列化存出来的 key 带二进制前缀。解决方式是手动配置StringRedisSerializer和GenericJackson2JsonRedisSerializer。Bean public RedisTemplateString, Object redisTemplate(RedisConnectionFactory factory) { RedisTemplateString, Object template new RedisTemplate(); template.setConnectionFactory(factory); template.setKeySerializer(new StringRedisSerializer()); template.setValueSerializer(new GenericJackson2JsonRedisSerializer()); template.setHashKeySerializer(new StringRedisSerializer()); template.setHashValueSerializer(new GenericJackson2JsonRedisSerializer()); return template; }四个序列化器都要设只设 key 不设 value 一样会乱码。GenericJackson2JsonRedisSerializer会在 JSON 里带类信息反序列化时能还原成原对象代价是存储体积略大。5. 部署到 Linux 与接口文档验证把项目从本机搬到服务器5.1 打包与服务器环境准备本机跑通之后下一步常见诉求是部署到 Linux。打包用mvn clean package -DskipTests产物在target目录下的 jar 包。服务器上要提前装好 JDK、MySQL、Redis版本和本机保持一致。# 服务器上后台启动 jar日志输出到文件 nohup java -jar sky-server-1.0-SNAPSHOT.jar \ --spring.profiles.activeprod \ sky.log 21 nohup保证终端断开后进程继续跑--spring.profiles.activeprod指定生产配置 sky.log 21把标准输出和错误都重定向到日志文件。是后台运行。启动后用tail -f sky.log看日志看到 Tomcat started on port 才算成功。生产配置里的数据库地址要改成服务器内网地址不要写 localhost。5.2 接口文档与前后端联调验证苍穹外卖一般带 Swagger 或 Knife4j 接口文档启动后访问/doc.html或/swagger-ui.html。验证顺序建议是先测登录拿 token再用 token 测带鉴权的接口最后测业务链路。验证项请求方式关键参数预期结果管理端登录POSTusername/password返回 token菜品分页查询GETpage/pageSize/name返回分页数据新增套餐POST套餐 JSON tokencode1用户端下单POST购物车数据 token返回订单号订单状态查询GETorderId返回当前状态表格里的验证顺序不能跳登录是后面所有接口的前提。如果某个接口返回 401先检查 header 里 token 字段名是不是和拦截器里取的一致大小写敏感。如果返回 500看后端日志的异常栈大概率是 SQL 映射或者空指针。5.3 一个容易被忽略的验证技巧部署到 Linux 之后时区问题会比本机更明显。服务器默认 UTC 时区时订单时间会比实际少 8 小时。解决方式是在启动参数里加-Duser.timezoneAsia/Shanghai或者改服务器时区。# 启动时指定时区 nohup java -Duser.timezoneAsia/Shanghai -jar sky-server-1.0-SNAPSHOT.jar sky.log 21 这个参数要放在-jar之前放在之后会被当成程序参数传给 main 方法而不是 JVM。从那以后我每次部署 Java 服务都强制走一遍「时区 字符集 日志路径」三件套检查因为这三个问题在本机开发时几乎不会暴露一到服务器就集中爆发。希望帮到你。本文还有配套的精品资源点击获取