Docker构建时执行shell脚本报错排查及解决方案咨询

问题背景 #

需要构建Docker镜像时，通过脚本检查指定HTTP接口返回状态码是否为200，符合则继续构建，否则终止。但构建过程中出现脚本执行错误，报错信息显示脚本解析异常及语法错误。

错误原因分析 #

1. 脚本换行符不兼容：Windows环境下创建的脚本默认使用CRLF（回车+换行）换行，而Alpine Linux仅识别LF（换行）格式，导致脚本解析时出现line 3: not found和syntax error: unexpected "fi"的错误。
2. curl逻辑错误：原脚本中code=$(curl https://someendpoint)是将接口的响应内容赋值给变量，而非HTTP状态码，完全不符合需求逻辑。

修复方案 #

1. 修正脚本换行符 #

将test-start.sh的换行格式转换为LF：

• 使用Notepad++：编辑 → 文档格式转换 → 转为UNIX格式
• 使用VSCode：点击右下角的CRLF标识，切换为LF

2. 修正curl获取状态码的逻辑 #

修改脚本，使用curl的参数直接获取HTTP状态码，而非响应内容：

#!/bin/bash
# -s: 静默模式，不输出进度信息
# -o /dev/null: 丢弃响应内容
# -w "%{http_code}": 输出HTTP状态码
code=$(curl -s -o /dev/null -w "%{http_code}" https://someendpoint)

# 用双引号包裹变量，避免空值或特殊字符导致的语法问题
if [ "$code" = "200" ]; then
  exit 0
else
  echo "构建终止：接口返回状态码 $code，预期为200"
  exit 1
fi

3. 优化Dockerfile中的脚本执行方式 #

脚本已指定#!/bin/bash，直接用./test-start.sh执行，避免用sh解释bash脚本可能的兼容问题：

FROM alpine
RUN apk update --no-cache && apk add --no-cache bash curl
COPY test-start.sh ./test-start.sh
RUN chmod +x ./test-start.sh
RUN ./test-start.sh

验证步骤 #

1. 确保脚本已转换为LF换行格式
2. 执行构建命令：docker build -t test-image .
   • 若接口返回200，构建将正常完成
   • 若接口返回非200状态码，构建会终止并输出错误提示

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