解决Docker Compose报错：`exec ./entrypoint.sh: no such file or directory`

在使用Docker Compose部署应用时，你是否遇到过exec ./entrypoint.sh: no such file or directory这个令人头疼的错误？本文将深入分析错误原因并提供多种解决方案，帮助你快速恢复服务运行。

问题现象

当运行docker-compose logs -f命令查看容器日志时，可能会看到如下错误：

ki2api-1| exec ./entrypoint.sh: no such file or directory

这个错误表明Docker容器无法找到或执行指定的entrypoint脚本，导致容器无法正常启动。下面我们将一步步排查并解决这个问题。

错误原因分析

这个错误通常由以下原因引起：

entrypoint文件不存在：Docker镜像中缺少entrypoint.sh文件
权限问题：entrypoint.sh缺少可执行权限
路径错误：路径配置不正确（相对路径/绝对路径问题）
换行符冲突：Windows/Linux换行符差异导致脚本无法识别
卷挂载冲突：本地目录挂载覆盖了镜像中的entrypoint文件

解决方案大全

1. 检查文件是否存在

首先确认entrypoint.sh文件是否存在于Docker镜像中：

docker-compose run --rm ki2api ls -l ./entrypoint.sh

如果文件不存在，说明Docker构建过程没有正确复制文件。

2. 修正Dockerfile配置

确保Dockerfile中正确复制entrypoint文件并设置权限：

# 设置工作目录
WORKDIR /app# 复制entrypoint文件
COPY entrypoint.sh ./# 添加执行权限并修复换行符
RUN chmod +x entrypoint.sh && \
sed -i 's/\r$//' entrypoint.sh# 修复Windows换行符问题

3. 解决路径问题

在docker-compose.yml中使用绝对路径更可靠：

services:
ki2api:
entrypoint: /app/entrypoint.sh# 使用绝对路径替代相对路径

4. 处理挂载冲突

如果使用了卷挂载，确保不会覆盖entrypoint文件：

services:
ki2api:
volumes:
# 仅挂载必要目录，避免覆盖整个工作目录
- ./config:/app/config
# - .:/app# 注释掉可能覆盖entrypoint的挂载

5. 验证文件权限和格式

在容器内部检查文件状态：

docker-compose run --rm ki2api sh -c "pwd && ls -l entrypoint.sh && file entrypoint.sh"

输出应类似：

/app
-rwxr-xr-x 1 root root 167 May 15 08:30 entrypoint.sh
entrypoint.sh: POSIX shell script, ASCII text executable

6. 彻底重建容器

完成上述修正后，彻底重建容器：

docker-compose down
docker-compose build --no-cache
docker-compose up -d

预防措施

统一换行符：在Git中设置core.autocrlf input（Linux/Mac）或true（Windows）
明确路径：始终在docker-compose.yml中使用绝对路径
最小化挂载：仅挂载必要的配置文件目录，避免覆盖整个应用目录
添加健康检查：在docker-compose.yml中配置健康检查：

healthcheck:
test: ["CMD-SHELL", "curl -f http://localhost:8080/health || exit 1"]
interval: 30s
timeout: 10s
retries: 3

完整修复示例

Dockerfile修正：

FROM python:3.9
WORKDIR /app# 复制项目文件
COPY requirements.txt ./
RUN pip install -r requirements.txt# 处理entrypoint
COPY entrypoint.sh ./
RUN chmod +x entrypoint.sh && \
sed -i 's/\r$//' entrypoint.sh# 修复换行符COPY . .# 使用exec形式确保信号正确传递
ENTRYPOINT ["/app/entrypoint.sh"]

docker-compose.yml修正：

version: '3.8'services:
ki2api:
build: .
ports:
- "8000:8000"
volumes:
- ./config:/app/config# 仅挂载配置目录
healthcheck:
test: ["CMD-SHELL", "curl -f http://localhost:8000/health || exit 1"]
interval: 30s
timeout: 10s
retries: 3
# entrypoint由Dockerfile定义，此处无需重复