如何解决Docker容器运行entrypoint时的exec格式错误

核心原因分析 #

exec format error通常是因为shell脚本格式不符合Linux系统要求，最常见的场景是Windows下的CRLF换行符被容器识别为脚本内容的一部分，导致shebang（#!/bin/sh）解析失败；其次是脚本的环境变量配置逻辑存在问题，或者存在隐藏字符干扰解析。

具体修复方案 #

1. 修复脚本换行符问题 #

Windows系统默认用CRLF（\r\n）换行，而Linux容器仅支持LF（\n）。当容器执行脚本时，\r会被当成#!/bin/sh的一部分，触发格式错误。

• 手动修改：用VS Code等编辑器打开entrypoint.sh和.bashrc，点击右下角的「CRLF」切换为「LF」后保存。
• Dockerfile自动修复：在COPY脚本后添加sed命令清除换行符中的\r：

  COPY entrypoint.sh /root/entrypoint.sh
  COPY .bashrc /root/.bashrc
  RUN chmod +x /root/entrypoint.sh && \
      sed -i 's/\r$//' /root/entrypoint.sh /root/.bashrc
  

2. 简化entrypoint逻辑，避免依赖.bashrc #

nvm的环境配置无需依赖.bashrc，直接在entrypoint中加载更稳定，同时强制将yarn/node的路径加入PATH：

修改entrypoint.sh内容：

#!/bin/sh
# 直接加载nvm配置
export NVM_DIR="/root/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"
# 强制添加node/yarn的全局路径到PATH
export PATH="$NVM_DIR/versions/node/$(nvm version default)/bin:$PATH"
exec "$@"

3. 验证脚本的shebang行 #

检查entrypoint.sh和.bashrc的第一行#!/bin/sh是否存在多余空格、全角字符或隐藏字符。执行以下命令查看脚本内容：

cat -A /root/entrypoint.sh

正常输出应无^M字符（CRLF的标记），示例：

#!/bin/sh$
export NVM_DIR="/root/.nvm"$
[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"$
export PATH="$NVM_DIR/versions/node/$(nvm version default)/bin:$PATH"$
exec "$@"$

4. 优化Dockerfile构建流程 #

将nvm的环境配置写入系统全局配置文件，确保所有shell会话都能直接访问node/yarn：

FROM amazonlinux:2

RUN yum update -y && \
    yum install -y tar curl gzip zip unzip aws-cli && \
    yum clean all && rm -rf /var/cache/yum

# 安装nvm、node14和yarn，同时配置全局环境变量
RUN curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | sh && \
    . ~/.nvm/nvm.sh && \
    nvm install 14 && \
    nvm alias default 14 && \
    npm install -g yarn && \
    # 将nvm配置写入/etc/profile.d，全局生效
    echo 'export NVM_DIR="/root/.nvm"' > /etc/profile.d/nvm.sh && \
    echo '[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"' >> /etc/profile.d/nvm.sh && \
    echo 'export PATH="$NVM_DIR/versions/node/$(nvm version default)/bin:$PATH"' >> /etc/profile.d/nvm.sh

COPY entrypoint.sh /root/entrypoint.sh
RUN chmod +x /root/entrypoint.sh && sed -i 's/\r$//' /root/entrypoint.sh

ENTRYPOINT ["/root/entrypoint.sh"]

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