解決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定義，此處無需重復
總結
exec ./entrypoint.sh: no such file or directory錯誤的本質是Docker容器無法定位或執行入口腳本。通過本文介紹的排查步驟和解決方案，你可以：
- 確認文件是否存在及路徑是否正確
- 修復文件權限和換行符問題
- 解決卷掛載沖突
- 優化Docker配置預防未來錯誤
遵循Docker最佳實踐，如使用絕對路徑、最小化掛載范圍、統一換行符標準等，可以有效避免此類問題。容器化部署雖然強大，但需要關注這些細節才能確保服務穩定運行。
遇到問題不要慌，一步步排查是關鍵！ 如果本指南解決了你的問題，歡迎點贊收藏支持！
)
