NextJS与Strapi项目Docker化时容器启动顺序问题求解

方案1：通过docker-compose配置实现（推荐） #

docker-compose原生的depends_on仅能控制容器启动顺序，无法等待内部服务就绪，需要搭配健康检查实现按需启动：

1. 在docker-compose.yml中为Strapi服务添加健康检测配置，使用Strapi自带的/api/_health端点验证服务可用性
2. 为NextJS服务的depends_on添加service_healthy启动条件

配置示例：

version: '3.8'
services:
  strapi:
    build: ./strapi
    # 保留你原有Strapi配置：端口、环境变量、挂载卷等
    healthcheck:
      test: ["CMD-SHELL", "curl -f http://localhost:1337/api/_health || exit 1"]
      interval: 5s
      timeout: 5s
      retries: 10
      start_period: 30s # 首次启动需初始化数据可调整为60s

  nextjs:
    build: ./nextjs
    # 保留你原有NextJS配置：端口、环境变量等
    depends_on:
      strapi:
        condition: service_healthy

方案2：独立启动脚本实现 #

如果不想修改docker-compose配置，可以编写独立Shell脚本控制启动顺序：

1. 在项目根目录创建start.sh脚本，内容如下：

#!/bin/bash
# 启动Strapi后台服务
docker-compose up -d strapi

# 替换为你的实际Strapi健康检查地址
STRAPI_HEALTH_URL="http://localhost:1337/api/_health"
echo "等待Strapi服务就绪..."
until $(curl --output /dev/null --silent --head --fail $STRAPI_HEALTH_URL); do
    printf '.'
    sleep 5
done
echo -e "\nStrapi已就绪，开始启动NextJS..."

# 构建启动NextJS
docker-compose up --build -d nextjs

2. 给脚本添加执行权限：chmod +x start.sh
3. 后续直接执行./start.sh即可按要求启动服务。

注意事项 #

如果你的NextJS在构建阶段就需要请求Strapi拉取静态资源/数据，不要将npm run build步骤写在NextJS的Dockerfile中（镜像构建阶段无法连通其他服务容器），需要将构建步骤放到容器启动命令中，NextJS的Dockerfile末尾修改为：

# 原有Dockerfile内容保留，仅替换CMD
CMD ["sh", "-c", "npm run build && npm start"]

内容的提问来源于stack exchange，提问作者kurr kurr uma ma