应选用 version: '3.8'，统一2空格缩进，定义services、networks和volumes，配置depends_on与healthcheck确保启动顺序与服务就绪，使用named volume持久化数据，并通过.env管理敏感信息。
Java 微服务项目用 Docker Compose 单机编排，核心是把每个模块（如 user-service、order-service、gateway、nacos、mysql、redis）定义为独立 service，并理清依赖、网络、数据持久化和环境隔离。配置不复杂，但缩进、版本兼容性、启动顺序这些细节容易出错。
明确 version 与基础结构
选 version: '3.8' 最稳妥——它兼容当前主流 Docker 引擎（20.10+），支持 healthcheck、profiles、deploy 等关键字段，又避开 v2 的老旧限制和 v4 尚未广泛落地的问题。文件开头必须是 version，紧接着 services，再是 volumes/networks（可选）。所有缩进统一用 2 个空格，禁止 Tab。
- 不要写 version: 3.8（缺少引号，YAML 解析会失败）
- services 下每个服务名（如 gateway）顶格写，其子项（image、ports 等）缩进 2 空格
- 数组项（如 ports、environment）用 - 开头，- 后跟 1 空格
按模块拆分 services 并设置合理依赖
Java 微服务通常含网关、注册中心、数据库、缓存和若干业务服务。每个 service 对应一个模块的构建或镜像，用 depends_on 控制启动顺序（仅表示“先启动”，不保证就绪；真正健康检查需配合 healthcheck）。
Linux系统管理专家，覆盖12大模块：用户权限、SSH、存储、网络、systemd、防火墙、日志监控、备份恢复、TLS证书、Ansible、容器、IaC。提供配置、验证、加固、监控、备份、自动化、故障排查、回滚闭环。关键词：useradd、sudo、sshd_config、chmod、SEL...
- 网关（如 Spring Cloud Gateway）：build 指向其 Dockerfile 目录，暴露 8080 端口，depends_on 注册中心
- 注册中心（如 Nacos）：用官方镜像，挂载 application.properties 和 data 目录，开放 8848 端口
- MySQL：指定 image、root 密码、初始化 SQL 脚本路径，用 named volume 持久化 /var/lib/mysql
- Redis：用 redis:7-alpine，配置 redis.conf 挂载，暴露 6379
- 业务服务（user-service）：build: ./user-service，环境变量指定 spring.profiles.active=prod，依赖 nacos 和 mysql
统一网络与数据卷管理
所有 service 必须接入同一个自定义 bridge 网络（如 app-network），才能通过服务名互访（nacos:8848、mysql:3306）。命名卷（volumes）比 bind mount 更适合生产场景，避免权限和路径硬编码问题。
- networks 下定义 app-network: {driver: bridge}，每个 service 的 networks: [- app-network]
- MySQL 数据卷写 volumes: [mysql-data:/var/lib/mysql]，并在顶层 volumes: {mysql-data: {}} 声明
- Nacos 配置和数据目录建议也用 named volume（如 nacos-conf、nacos-data），而非 ./conf 映射
补充关键健壮性配置
微服务集群不能只靠 up 就完事。要加 restart: unless-stopped 防意外退出，用 healthcheck 让 depends_on 真正生效，通过 environment 统一管理 profile 和 JVM 参数。
- 每个 service 加 restart: unless-stopped（非 no 或 always）
- Nacos 和 MySQL 加 healthcheck：interval: 30s, timeout: 10s, retries: 3，命令用 curl 或 mysqladmin
- JVM 参数写在 environment 中，如 JAVA_OPTS: "-Xms512m -Xmx1g -Duser.timezone=GMT+8"
- 敏感信息（DB 密码、Nacos 密钥）用 .env 文件管理，docker-compose.yml 中引用 ${MYSQL_ROOT_PASSWORD}
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
