Docker环境中wait-for-it工具始终超时无法正常执行问题咨询

问题根因排查与解决方案 #

1 最高概率诱因：entrypoint参数格式错误 #

你当前使用exec数组格式定义entrypoint时，错误将-t和20两个独立参数合并为单个字符串"-t 20"传入，导致wait-for-it无法正常解析超时配置，甚至会将该字符串误识别为第二个待检测的服务地址，最终触发逻辑异常导致超时。
修复方式为拆分参数，修改后的entrypoint配置如下：

entrypoint: ["wait-for-it", "127.0.0.1:80", "-t", "20", "--", "script", "127.0.0.1"]

2 服务监听地址不匹配 #

若你要检测的80端口服务未绑定127.0.0.1，仅绑定了容器的内网IP，就会出现本地访问127.0.0.1不通的情况。可进入容器执行ss -tulnp | grep :80查看端口监听地址，若监听地址为容器的特定内网IP，需将检测地址替换为对应IP；若需要允许本地访问，可修改服务配置监听0.0.0.0:80。

3 跨容器访问地址错误 #

如果你实际要检测的是其他容器的服务，不能使用127.0.0.1作为检测地址，docker容器的本地环回地址是隔离的，需确保两个容器处于同一个docker compose网络下，直接使用目标服务的compose服务名作为检测地址即可。

4 工具兼容校验 #

你可以进入容器手动执行命令验证wait-for-it本身功能是否正常：
wait-for-it 127.0.0.1:80 -t 5 -- echo "test success"
如果手动执行可正常返回，即可确认问题完全由entrypoint参数配置错误导致。

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