Docker容器启动时运行wait-for-it.sh脚本失败问题求助

我之前也碰到过Docker里wait-for-it.sh跑不起来的坑，给你几个实用的排查和解决方向：

1. 先确认脚本的权限与存在性 #

首先得确保wait-for-it.sh已经正确进入服务容器，并且具备可执行权限：

• 如果是通过Dockerfile复制脚本，要加上权限设置：

# 假设脚本放在项目根目录，复制到容器的可执行路径
COPY wait-for-it.sh /usr/local/bin/
# 给脚本添加执行权限
RUN chmod +x /usr/local/bin/wait-for-it.sh

• 如果用Docker Compose的volumes挂载脚本，要先给宿主机上的脚本执行chmod +x wait-for-it.sh，不然挂载到容器里还是没有执行权限。

2. 匹配容器的shell修改脚本首行 #

脚本的shebang（首行）必须和容器里的shell对应：

• 用Alpine原生ash的话，首行改成#!/bin/sh
• 装了bash的话，首行改成#!/bin/bash
  注意：改完脚本后一定要重新构建镜像，不然容器里还是旧的脚本内容。

3. 修正Docker Compose的命令写法 #

在服务的command里，推荐用数组形式调用脚本，避免shell解析的问题，比如等待数据库的3306端口：

services:
  app:
    build: .
    # 数组格式：[脚本路径, 等待的目标, "--", 你的服务启动命令]
    command: ["/usr/local/bin/wait-for-it.sh", "db:3306", "--", "node app.js"]
    depends_on:
      - db
  db:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: your_password

这里的depends_on只是保证容器启动顺序，不能确保数据库服务就绪，所以wait-for-it的作用还是必要的。

4. 手动排查脚本执行的错误信息 #

如果还是不行，直接进入服务容器手动执行脚本，看具体报错：

# 进入运行中的服务容器
docker exec -it <你的服务容器名称> sh
# 加-v参数执行脚本，查看详细调试信息
/usr/local/bin/wait-for-it.sh db:3306 -v

通过调试信息可以快速定位问题：是找不到shell、连不上数据库端口，还是脚本本身有语法错误。

5. 替代方案：用原生shell循环等待 #

如果wait-for-it始终有问题，也可以用原生shell命令实现等待逻辑，比如：

command: sh -c "until nc -z db 3306; do echo '等待数据库启动...'; sleep 2; done; node app.js"

如果Alpine镜像里没有nc，需要在Dockerfile里安装：RUN apk add --no-cache netcat-openbsd

内容的提问来源于stack exchange，提问作者Rafalsky