Windows打包的Docker镜像一直报错：exec /app/entrypoint.sh: no such file or directory 怎么回事？怎么解决？

> 本文为 `Gemini2.5` 生成的答案，其中第一个问题即是博主遇到的问题。

在 `Windows` 环境中构建 `Docker` 容器，并在启动时遇到 "找不到 `entrypoint.sh`" 的错误，这通常是由于以下几个常见原因造成的，尤其是在涉及到 `Shell` 脚本 (`.sh`) 时。

## 1. 行尾符问题

- 问题

`Windows` 使用 `CRLF` (Carriage Return Line Feed, `\r\n`) 作为文本文件的行尾符，而 `Linux/Unix` 系统（包括 Docker 容器通常运行的环境）使用 `LF` (Line Feed, `\n`)。

Linux 系统期望脚本文件使用 `LF` 行尾符。当脚本文件使用 `CRLF` 时，每行末尾会多出一个 `\r` 字符，这会被 `Shell` 解释器误解为命令的一部分，导致脚本解析失败，甚至无法找到脚本文件本身。

- 解决方案：你需要确保 `entrypoint.sh` 文件在 `Docker` 镜像中使用了 `LF` 行尾符。以下是一些方法：

<!-- more -->

### 推荐方案

在多人协作，尤其是不同开发环境的情况下，优先推荐使用本方案，来确保你的脚本文件使用 `LF` 行尾符

如果你使用 Git 管理你的项目，可以在项目根目录下创建一个 `.gitattributes` 文件，并添加以下内容：
```
* text=auto eol=lf
*.sh text eol=lf
```
这会告诉 Git 在提交时将所有文本文件（text=auto）和 .sh 文件强制转换为 LF 行尾符 (eol=lf)。确保你的编辑器也配置为使用 LF 行尾符。

### 简单方案

许多文本编辑器（如 `VS Code`, `Notepad++`, `Sublime Text` 等）都允许你配置默认的行尾符为 `LF`。

比如在`VS Code` 中，打开 `entrypoint.sh` 文件后，右下角可以看到 `CRLF` / `LF` 行位符标识，在保存 `entrypoint.sh` 文件时，请确保选择 `LF` 作为行尾符。

其他编辑器具体操作方式请自行了解。

### 麻烦方案

在 Dockerfile 中，你可以安装 dos2unix 工具，并在复制 entrypoint.sh 文件后，使用 dos2unix 将其转换为 LF 行尾符。

```Dockerfile
FROM your-base-image

# ... 其他 Dockerfile 指令 ...

COPY entrypoint.sh /app/

# 安装 dos2unix 并转换行尾符
RUN apt-get update && apt-get install -y dos2unix --no-install-recommends && rm -rf /var/lib/apt/lists/*
RUN dos2unix /app/entrypoint.sh

# ... 设置执行权限 ...
RUN chmod +x /app/entrypoint.sh
```

注意:  你需要根据你的基础镜像选择合适的包管理器来安装 dos2unix (例如 apt-get for Debian/Ubuntu, apk for Alpine, yum for CentOS/RHEL 等)。

## 2. 文件权限问题

- 问题

在 `Linux/Unix` 系统中，脚本文件需要具有执行权限 (`+x`) 才能被执行。Windows 文件系统没有直接的文件执行权限概念。当你从 Windows 复制 `entrypoint.sh` 到 Docker 镜像中时，默认情况下它可能不具备执行权限。

- 解决方案: 在 `Dockerfile` 中，你需要显式地为 `entrypoint.sh` 文件添加执行权限。

```Dockerfile
FROM your-base-image

# ... 其他 Dockerfile 指令 ...

COPY entrypoint.sh /app/

# 添加执行权限
RUN chmod +x /app/entrypoint.sh

ENTRYPOINT ["/app/entrypoint.sh"] # 或者 CMD ["/app/entrypoint.sh"]
```

其中使用 `RUN chmod +x /app/entrypoint.sh` 命令可以为 `/app/entrypoint.sh` 文件添加执行权限。

## 3. 路径问题(不太常见，但需要检查)

- 问题: 虽然不太常见，但也需要检查你在 `ENTRYPOINT` 或 `CMD` 指令中指定的 `entrypoint.sh` 路径是否正确。确保路径与你在 `COPY` 指令中复制脚本的目标路径一致。

- 检查: 例如，如果 `COPY entrypoint.sh /app/`，那么 `ENTRYPOINT` 应该设置为 `["/app/entrypoint.sh"]`。

## 总结和排查步骤:

- 检查行尾符: 使用文本编辑器（例如 `VS Code`）打开 `entrypoint.sh` 文件，查看`文件右下角`显示的行尾符类型。确保它是 `LF` 而不是 `CRLF`。如果显示 `CRLF`，请将其转换为 `LF` 并重新构建 `Docker` 镜像。
- 检查文件权限: 在 `Dockerfile` 中添加 `RUN chmod +x /app/entrypoint.sh` (假设你将脚本复制到 /app/ 目录)。
- 检查路径: 确认 `COPY` 指令和 `ENTRYPOINT` (或 CMD) 指令中的路径是否一致。
- 重新构建镜像: 在修改 `Dockerfile` 或脚本后，务必重新构建 Docker 镜像 (`docker build ...`)。
- 运行容器并查看日志: 启动 Docker 容器，并查看 Docker 容器的日志 (`docker logs <container_id>`)，看是否有更详细的错误信息。

## 最佳实践总结

1. 使用 `.gitattributes` 管理行尾符: 这是最推荐的方式，可以从源头上解决行尾符问题。
2. 始终在 `Dockerfile` 中显式设置执行权限 (`chmod +x`)。
3. 在 `Linux` 环境中创建和编辑 `Shell` 脚本: 为了避免 `Windows` 环境带来的潜在问题，最好在 `Linux` 环境中创建和编辑 `Shell` 脚本，或者使用支持 `LF` 行尾符的编辑器在 `Windows` 中进行编辑。