【SpringBoot 3.x 第146节】Docker Compose 开发联调高级玩法，一文带你搞透！

🏆本文收录于《滚雪球学SpringBoot 3.x》，专门攻坚指数提升，本年度国内最系统+最专业+最详细（永久更新）。    该专栏致力打造最硬核 SpringBoot3 从零基础到进阶系列学习内容，🚀均为全网独家首发，打造精品专栏，专栏持续更新中…欢迎大家订阅持续学习。 如果想快速定位学习，可以看这篇【SpringBoot3教程导航帖】，你想学习的都被收集在内，快速投入学习！！两不误。    若还想学习更多，可直接订阅 《Spring Boot实战合集》，一次订阅，持续学习，后续更新内容无需重复付费，适合长期收藏与系统进阶。

演示环境说明：

• 开发工具：IDEA 2021.3
• JDK版本： JDK 17（推荐使用 JDK 17 或更高版本，因为 Spring Boot 3.x 系列要求 Java 17，Spring Boot 3.5.4 基于 Spring Framework 6.x 和 Jakarta EE 9，它们都要求至少 JDK 17。）
• Spring Boot版本：3.5.4（于25年7月24日发布）
• Maven版本：3.8.2 （或更高）
• Gradle：（如果使用 Gradle 构建工具的话）：推荐使用 Gradle 7.5 或更高版本，确保与 JDK 17 兼容。
• 操作系统：Windows 11

全文目录：

• • 导读
  • 一、这篇文章要解决的，不只是“能跑”，而是“好联调”
  • 二、先理解 Spring Boot 3.x 的官方支持：Compose 不是外挂，而是开发时服务
  • 三、为什么“多应用共享一个 compose.yaml”是高级玩法，而不是图省事
  • 四、先把边界画清楚：Compose 里放什么，不放什么？？
  • 五、一个推荐的目录结构：把共享基础设施从应用中分离出来
  • 六、先看完整的 compose.yaml：用 profile 把基础设施分层
  • 七、Spring Boot 中 `spring.docker.compose.file` 的真正用法
  • 八、`lifecycle-management`：共享 Compose 时，最容易踩坑的就是它
  • 九、让容器真正“可用”，而不是只“活着”：健康检查与就绪等待
  • 十、Spring Boot 为什么能“自动接上”数据库、Redis、RabbitMQ
  • 十一、从零搭一个可运行的订单服务：先看依赖
  • 十二、应用配置：用一份 `application-local.yml` 串起开发联调
  • 十三、订单领域模型：先把数据结构写稳
  • 十四、Redis：缓存不是为了“更快”而已，更是为了“更稳”
  • 十五、RabbitMQ：消息链路的价值，不只是“异步”
  • 十六、对象存储 MinIO：把文件联调也纳入本地基础设施
  • 十七、把主流程串起来：Controller、Service、Repository、事件、文件上传
  • 十八、多应用共享同一份 compose.yaml：订单服务 + 管理服务
  • 十九、从启动到联调：整个流程应该怎么走
  • 二十、Compose 与生产环境必须隔离：这是红线，不是建议
  • 二十一、测试环境也要讲边界：`spring.docker.compose.skip.in-tests` 很关键
  • 二十二、常见坑位清单：这些问题几乎每个团队都会遇到
  • • 1. 把 `latest` 当成默认版本
    • 2. 忘记写健康检查
    • 3. 多应用共享 Compose 还用默认生命周期
    • 4. 生产和开发共用同一份配置
    • 5. 只关心服务启动，不关心数据卷
    • 6. 以为 Spring Boot 能解决所有连接问题
    • 7. 依赖服务太多，Compose 文件失控
    • 8. 没有团队级启动/清理约定
    • 9. 把 Compose 当成生产编排工具
    • 10. 忽略应用启动日志中的连接详情
  • 二十三、把这套方案升级成团队标准：你应该沉淀什么？
  • • 1. 一个共享的 `infra/compose.yaml`
    • 2. 一个标准的 `application-local.yml`
    • 3. 一份团队级 README
    • 4. 一套依赖服务版本锁定策略
    • 5. 一组基础模板代码
    • 6. 一套清理策略
    • 7. 一套环境边界规范
  • 二十四、总结：把“环境问题”变成“配置问题”
  • 附录 A：本文推荐的启动命令
  • 附录 B：一张总览图
  • 附录 C：你可以直接复用的检查清单
  • 🧧 学习福利 · 限时开放 🧧
  • 🫵 Who am I?

导读

在 Spring Boot 3版本时代里，本地开发的体验已经不再只是“把应用跑起来”这么简单。真正高效的团队，追求的是一套可以复用、可预测、可迁移的联调体系：开发者拉起项目，数据库、缓存、消息队列、对象存储、可观测组件跟着一起启动；代码一保存，服务能自动重启；切换应用时，连接信息不会乱；多个应用共享一套基础设施时，也不会互相误伤。Docker Compose 正是这套体验的核心拼图之一。

这篇文章不是“概念速览”，而是把 Spring Boot 3.x 与 Docker Compose 的组合拆开、揉碎、再重新拼成一套实战方法论。你会看到：