简介这份资源是黑马程序员「苍穹外卖」Java SpringBoot 项目的完整开发资料合集面向正在学习或准备实战该项目的开发者覆盖从需求分析到前后端落地的全流程。包内共约2000个文件以png、svg图片与js脚本为主另有java源码、vue组件、css样式、xml配置、json接口数据、sql脚本及md讲义等涵盖前端页面、后端业务逻辑、数据库设计与产品原型等环节压缩包约69.96MB。目前已有2537人学习下载热度较高。借助其中的MD讲义、SQL脚本、前后端代码、数据库设计与JSON接口定义读者可对照梳理项目架构、理解前后端数据交互与业务实现思路并参考原型与配置完成本地搭建与调试适合作为课程配套练习或毕业设计参考。1. 苍穹外卖这套资源到底包含什么从跑通到讲透的完整路径很多同学搜「黑马家苍穹外卖所有资源」其实心里想的不是「给我一个压缩包」而是「我拿到这套东西之后怎么在本地跑起来、怎么把数据库设计文档看懂、怎么部署到 Linux、面试时怎么讲」。苍穹外卖是黑马程序员 Java 路线里一个典型的 Spring Boot MyBatis Redis MySQL 的外卖业务系统覆盖了员工管理、分类管理、菜品管理、套餐管理、订单管理、微信支付对接、报表统计等模块。它最大的价值不在于代码有多难而在于业务链路完整、技术栈贴近真实企业开发。你如果只是把源码下载下来跑个 Hello World那基本等于没学。真正要吃透得从环境搭建、数据库设计、接口调试、缓存设计、部署上线这几个环节逐个击破。这篇笔记就按这个顺序把「所有资源」拆成可复现的步骤和可避开的坑适合正在做这个项目、准备把它写进简历、或者想拿它练手 Spring Boot 全栈的 Java 开发者。2. 环境与资源清单把苍穹外卖在本地跑起来的最小闭环2.1 先搞清楚「所有资源」到底指哪些东西网上流传的「苍穹外卖所有资源」通常包含这几类后端源码Maven 多模块或单模块 Spring Boot 工程、前端源码管理端 Vue 项目 用户端小程序或 H5、数据库脚本建表 SQL 初始数据、接口文档Swagger 或 YAPI 导出、部署脚本Dockerfile、Nginx 配置、启动脚本、以及配套的笔记和视频大纲。你不需要一次性全看完但必须知道每一块的作用。后端源码是核心数据库脚本是地基前端是验证接口的工具部署脚本是上线前的最后一公里。很多人卡住不是因为代码不会写而是因为资源版本对不上——比如数据库脚本里字段和实体类对不上或者前端请求的接口路径和后端 Controller 不一致。所以第一步不是急着敲代码而是先把资源清单对齐。我一般会先建一个目录把资源按类型分开放避免后面找文件找到崩溃# 建立项目根目录按资源类型分层 mkdir -p cangqiong/{backend,frontend,sql,docs,deploy} # backend 放 Spring Boot 工程 # frontend 放管理端和用户端 # sql 放建表脚本和初始数据 # docs 放接口文档和笔记 # deploy 放 Dockerfile、Nginx 配置、启动脚本这样做的逻辑是后面无论你是用 IDEA 打开后端还是用 HBuilderX 打开前端路径都是清晰的。参数上唯一要注意的是如果你的资源包里后端是多模块比如 sky-common、sky-pojo、sky-server那backend目录下应该直接是父工程 pom.xml不要多套一层文件夹否则 Maven 识别会出问题。2.2 数据库设计文档怎么看才不白看苍穹外卖的数据库设计文档是很多人忽略的宝藏。它不只是告诉你有哪些表更重要的是告诉你表之间的关系和业务约束。核心表大概有employee员工、category分类、dish菜品、dish_flavor菜品口味、setmeal套餐、setmeal_dish套餐菜品关系、orders订单、order_detail订单明细、user用户、shopping_cart购物车、address_book地址簿。你看文档的时候重点看三个东西主键策略、外键关联、状态字段。比如 orders 表里的 status 字段1 到 6 分别代表待付款、待接单、已接单、派送中、已完成、已取消这个状态机是后面写业务逻辑的关键。再比如 dish 和 dish_flavor 是一对多套餐和菜品是多对多这些关系决定了你写查询时要不要 join。常见做法是先把 SQL 脚本导入 MySQL然后用 Navicat 或 DataGrip 打开对着设计文档逐个表核对字段类型和注释。如果发现脚本里某个字段没有注释而文档里有以文档为准因为文档通常是后来更新的。导入的时候注意字符集用 utf8mb4否则微信昵称里的 emoji 会报错。-- 建库时指定字符集避免 emoji 和特殊字符翻车 CREATE DATABASE cangqiong DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; -- 导入脚本前先切库 USE cangqiong; -- 导入后检查核心表是否齐全 SHOW TABLES;参数说明utf8mb4_general_ci是排序规则比utf8mb4_unicode_ci性能略好对中文和 emoji 都支持。如果你用的是 MySQL 8.0默认字符集已经是 utf8mb4但显式指定更稳妥。导入完成后执行SELECT COUNT(*) FROM employee;看看有没有初始管理员账号通常是 admin/123456如果没有后面登录都进不去。2.3 后端启动的必调参数与常见报错后端启动前先检查application.yml或application-dev.yml里的几个关键配置数据库连接、Redis 连接、文件上传路径、微信支付参数如果要做支付。数据库连接池一般用 Druid 或 HikariCP你只需要改 url、username、password。Redis 默认端口 6379如果本地没装 Redis要么装一个要么先把缓存相关的代码注释掉否则启动会报连接拒绝。文件上传路径要改成本地真实存在的目录比如D:/cangqiong/upload/否则上传图片时会报路径不存在。# application-dev.yml 关键配置片段 spring: datasource: driver-class-name: com.mysql.cj.jdbc.Driver url: jdbc:mysql://localhost:3306/cangqiong?serverTimezoneAsia/ShanghaiuseUnicodetruecharacterEncodingutf-8 username: root password: 你的密码 redis: host: localhost port: 6379 database: 0 cangqiong: upload: path: D:/cangqiong/upload/逻辑说明serverTimezoneAsia/Shanghai不加的话MySQL 8.0 会报时区错误。characterEncodingutf-8保证中文不乱码。Redis 的 database 用 0 就行除非你本地有多个项目共用 Redis那可以换成 1 到 15 之间的库。上传路径最后一定要带斜杠否则拼接文件名时会少一个分隔符。启动类跑起来后如果控制台没有报错访问http://localhost:8080/doc.html能看到 Swagger 接口文档就说明后端通了。3. 核心业务链路从员工登录到订单状态的完整实现3.1 员工登录与 JWT 拦截器怎么配才不翻车苍穹外卖的登录流程是前端提交用户名密码后端查 employee 表比对密码通常是 MD5 加密生成 JWT token 返回后续请求在请求头里带 token拦截器校验通过才放行。这里最容易翻车的地方有两个一是密码加密方式对不上数据库里存的是 MD5 密文你登录时传明文后端如果没做 MD5 转换就会比对失败二是拦截器路径配置不对把登录接口也拦截了导致永远登录不进去。// JwtUtil 生成 token 的核心逻辑 public static String createJWT(String secretKey, long ttlMillis, MapString, Object claims) { SignatureAlgorithm signatureAlgorithm SignatureAlgorithm.HS256; long expMillis System.currentTimeMillis() ttlMillis; Date exp new Date(expMillis); JwtBuilder builder Jwts.builder() .setClaims(claims) // 自定义 claims一般放员工 id .setExpiration(exp) // 过期时间 .signWith(signatureAlgorithm, secretKey.getBytes(StandardCharsets.UTF_8)); return builder.compact(); }参数说明secretKey是签名密钥长度建议 32 位以上太短会报弱密钥异常。ttlMillis是过期时间一般设 2 小时到 12 小时太短用户老掉线太长不安全。claims里通常放empId拦截器解析出来后存到 ThreadLocal方便后续业务取当前登录人。拦截器配置时addPathPatterns(/**)要配合excludePathPatterns排除登录接口、Swagger 相关路径、静态资源路径否则你会看到登录接口返回 401然后陷入「为什么登录还要 token」的玄学循环。3.2 菜品与套餐的缓存设计Redis 到底该存什么苍穹外卖里 Redis 主要用在两个地方一是菜品和套餐的缓存二是购物车。菜品缓存一般用dish_前缀加分类 id 作为 keyvalue 是菜品列表的 JSON。套餐缓存类似。这里的关键是缓存更新策略新增、修改、删除菜品时要清理对应分类的缓存否则前端看到的是旧数据。很多人图省事直接flushdb这在生产环境是血泪教训会把购物车和其他缓存全清掉。正确做法是根据分类 id 精确删除。// 菜品缓存清理的常见写法 Autowired private RedisTemplate redisTemplate; public void cleanCacheByCategoryId(Long categoryId) { // 构造 key与查询时保持一致 String key dish_ categoryId; redisTemplate.delete(key); }逻辑说明key 的命名规则必须和查询时完全一致包括前缀、下划线、id 拼接方式。如果你查询时用的是dish_1清理时写成dish:1那就永远清不掉。参数上RedisTemplate的序列化器要配好否则存进去的是乱码取出来反序列化会报错。一般 key 用 StringRedisSerializervalue 用 GenericJackson2JsonRedisSerializer。购物车缓存用shopping_cart_加用户 id 作为 key存的是购物车条目列表这个数据更新频繁但量不大适合用 Redis 扛。3.3 订单状态流转与微信支付对接的边界订单模块是苍穹外卖最复杂的部分。用户下单后订单状态从 1待付款开始付款后变 2待接单商家接单变 3已接单派送变 4派送中完成变 5已完成取消变 6已取消。每个状态变更都要写对应的业务逻辑比如接单时要检查订单是否存在、状态是否为 2派送时要更新派送员信息。微信支付对接是选做内容因为需要商户号、证书、回调地址个人开发者很难凑齐。如果你只是练手可以把支付部分 mock 掉直接改订单状态为已支付把精力放在状态机和订单明细的查询上。// 订单状态流转的简化示例 public void updateOrderStatus(Long orderId, Integer status) { Orders orders ordersMapper.getById(orderId); if (orders null) { throw new OrderBusinessException(订单不存在); } // 只有待接单状态才能接单 if (status 3 orders.getStatus() ! 2) { throw new OrderBusinessException(订单状态不正确); } orders.setStatus(status); ordersMapper.update(orders); }参数说明orderId是订单主键status是目标状态。实际开发中还要考虑并发比如两个管理员同时接同一单可以用乐观锁或数据库行锁。微信支付对接时回调接口要验签验签失败直接返回失败不要更新订单状态否则会被伪造请求刷单。回调地址必须是公网可访问的本地开发可以用内网穿透工具但注意不要用于生产。4. 部署到 Linux从本地 jar 到服务器运行的完整步骤4.1 打包与上传jar 包和前端静态资源怎么放后端用 Maven 打包成 jar命令是mvn clean package -DskipTests跳过测试是因为测试可能依赖本地数据库服务器上不一定有。打包完成后jar 在target目录下。前端管理端用npm run build生成 dist 目录里面是静态文件。上传到 Linux 服务器时我一般用 scp 或宝塔面板的文件管理把 jar 放到/opt/cangqiong/dist 放到/usr/share/nginx/html/。注意 jar 包的名字可能带版本号启动时要写对。# 打包后端 mvn clean package -DskipTests # 上传 jar 到服务器 scp target/sky-server-1.0-SNAPSHOT.jar root服务器IP:/opt/cangqiong/ # 上传前端 dist scp -r dist/* root服务器IP:/usr/share/nginx/html/逻辑说明-DskipTests跳过单元测试避免因为测试环境问题导致打包失败。scp 命令要确保服务器 SSH 端口开放默认 22。上传后检查文件权限jar 包至少要有读权限Nginx 静态目录要有读和执行权限否则会报 403。4.2 Nginx 反向代理配置与跨域处理前端部署后请求后端接口会遇到跨域问题。解决方案有两种后端加 CORS 配置或者 Nginx 反向代理。生产环境更推荐 Nginx 反向代理因为可以统一入口、隐藏后端端口、方便加 HTTPS。配置的核心是location /api/转发到后端http://127.0.0.1:8080/同时把前端路由的try_files配好避免刷新页面 404。server { listen 80; server_name 你的域名或IP; location / { root /usr/share/nginx/html; index index.html; try_files $uri $uri/ /index.html; # 解决前端路由刷新 404 } location /api/ { proxy_pass http://127.0.0.1:8080/; # 转发到后端 proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } }参数说明try_files是 Vue Router history 模式的必备配置不加的话刷新非首页路由会 404。proxy_pass末尾的斜杠要注意如果 location 是/api/proxy_pass 是http://127.0.0.1:8080/那请求/api/employee/login会被转发成/employee/login斜杠数量对不上会导致 404。改完配置后nginx -t测试语法然后nginx -s reload重载。4.3 服务器上 MySQL 和 Redis 的安装与远程连接服务器上装 MySQL 和 Redis可以用 apt 或 yum也可以用 Docker。Docker 的好处是环境隔离、版本可控。MySQL 要设置 root 密码并且允许远程连接如果后端和数据库不在同一台机器。Redis 默认只允许本地连接要改bind 0.0.0.0和protected-mode no但这样有安全风险建议设置密码并限制防火墙 IP。# 用 Docker 启动 MySQL docker run -d --name mysql-cangqiong -p 3306:3306 \ -e MYSQL_ROOT_PASSWORD你的密码 \ -e MYSQL_DATABASEcangqiong \ mysql:8.0 --character-set-serverutf8mb4 # 用 Docker 启动 Redis docker run -d --name redis-cangqiong -p 6379:6379 \ redis:6.2 --requirepass 你的Redis密码逻辑说明MySQL 容器启动时自动建库cangqiong字符集设为 utf8mb4。Redis 加了--requirepass后端配置里也要同步改密码否则连接报 NOAUTH。如果服务器有防火墙记得放行 3306 和 6379 端口但生产环境不建议把数据库端口暴露到公网最好只允许内网访问。5. 避坑与排查苍穹外卖从本地到上线最容易翻车的 5 个点5.1 现象登录接口返回 401但账号密码是对的原因拦截器把登录接口也拦截了或者 JWT 密钥前后端不一致。解决检查拦截器配置的excludePathPatterns是否包含/employee/login和/user/login检查 JWT 工具类里的密钥和拦截器里解析用的密钥是否同一个。如果密钥写在配置文件里确认 dev 和 prod 环境用的是同一份。5.2 现象菜品图片上传成功但前端显示裂图原因上传路径配置的是相对路径或者 Nginx 没有配置静态资源映射。解决后端上传路径改成绝对路径并且配置静态资源映射registry.addResourceHandler(/upload/**).addResourceLocations(file:D:/cangqiong/upload/);。如果部署到 LinuxNginx 里加一个 location 指向上传目录或者后端直接通过接口返回图片流。5.3 现象Redis 缓存清理后前端还是旧数据原因key 命名不一致或者缓存没有设置过期时间清理时删错了 key。解决把 key 的生成逻辑抽成一个工具类查询和清理都调用同一个方法。给缓存设置合理的过期时间比如 30 分钟避免数据永久不一致。清理时用redisTemplate.delete(key)不要用flushdb。5.4 现象订单状态更新后数据库没变原因MyBatis 的 update 语句没有提交事务或者实体类字段和数据库字段映射不上。解决检查 Service 方法上有没有Transactional检查实体类字段是否用了TableField或驼峰映射。如果用的是 MyBatis-Plus确认updateById传的对象 id 不为空。5.5 现象部署到 Linux 后接口响应特别慢原因数据库连接池配置太小或者服务器内存不足导致 Redis 频繁淘汰数据。解决调整 Druid 或 HikariCP 的max-active和min-idle一般 10 到 20 够用。检查 Redis 的maxmemory和淘汰策略建议用allkeys-lru。如果服务器只有 1G 内存MySQL 和 Redis 不要同时跑至少加到 2G。6. 进阶技巧用接口文档和日志把苍穹外卖讲成简历亮点6.1 用 Swagger 和日志快速定位接口问题苍穹外卖的接口文档通常是 Swagger 或 Knife4j访问/doc.html就能看到所有接口。调试时不要只依赖前端直接用 Swagger 发请求能排除前端参数拼接的问题。日志方面后端一般用 SLF4J Logback在application.yml里把日志级别调到 debug能看到 SQL 执行和参数。如果接口报错但日志没输出检查日志配置文件里包的路径有没有包含你的 Mapper 包。# 开启 MyBatis SQL 日志 mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl logging: level: com.cangqiong.mapper: debug逻辑说明StdOutImpl会把 SQL 打印到控制台方便本地调试。生产环境不要开会影响性能。logging.level指定 Mapper 包的日志级别为 debug能看到参数和返回结果。如果 SQL 没打印检查包名是否写对或者 MyBatis 配置是否被其他配置覆盖。6.2 把项目讲成简历亮点的三个角度第一个角度是业务复杂度苍穹外卖覆盖了员工、菜品、套餐、订单、购物车、地址簿、报表等多个模块你可以说「独立负责订单模块的状态机设计和缓存优化」。第二个角度是技术深度Redis 缓存、JWT 鉴权、AOP 日志、全局异常处理、微信支付对接挑两个你真正改过代码的点深入讲。第三个角度是部署运维从本地开发到 Linux 部署Nginx 反向代理、Docker 容器化、数据库远程连接这些能体现你的工程能力。面试时不要背项目介绍而是讲你遇到的一个具体问题怎么解决的比如「订单并发接单导致状态不一致我用乐观锁加版本号解决了」。6.3 一个具体技巧用 AOP 统一记录操作日志苍穹外卖里有很多管理端操作比如新增菜品、删除套餐、接单。你可以用 AOP 加自定义注解统一记录操作人、操作时间、操作类型写入数据库。这样既方便排查问题也能在简历里写「基于 AOP 实现操作日志自动记录」。Aspect Component public class OperationLogAspect { Around(annotation(operationLog)) public Object around(ProceedingJoinPoint joinPoint, OperationLog operationLog) throws Throwable { Long empId BaseContext.getCurrentId(); // 从 ThreadLocal 取当前登录人 String methodName joinPoint.getSignature().getName(); // 执行原方法 Object result joinPoint.proceed(); // 异步写入日志表 logService.save(empId, methodName, operationLog.value()); return result; } }参数说明annotation(operationLog)匹配所有加了OperationLog注解的方法。BaseContext.getCurrentId()是拦截器里存进 ThreadLocal 的员工 id。joinPoint.proceed()执行原业务方法注意异常处理如果原方法抛异常日志也要记录失败状态。写入日志建议用异步线程池避免拖慢主业务。我自己的习惯是每做完一个模块就把接口文档、数据库表、关键代码片段整理成一个 markdown 笔记面试前翻一遍比重新看视频快得多。苍穹外卖这套资源跑通只是起点能把订单状态机、缓存一致性、部署链路讲清楚才算真正吃透。希望帮到你。本文还有配套的精品资源点击获取