Dockerfile从UBI8迁移到Alpine后sha256sum校验失败，请求排查思路

遇到这种日志不足导致的排查困境确实挺闹心的，我给你梳理几个实用的排查方向，一步步来定位问题：

第一步：先解决日志不足的问题，拿到具体错误信息 #

Docker build默认的日志输出比较精简，你可以在构建时加上--progress=plain参数，这样就能看到每一步的详细执行输出，包括sha256sum校验时的具体错误（比如是哈希不匹配、文件找不到还是格式错误）：

docker build --progress=plain -t your-image-name .

另外，也可以在出问题的RUN命令开头加上set -x，让每一条子命令都输出执行细节，方便追踪：

RUN set -x \
    && cd ${TEMP} \
    && curl -L https://download.sonatype.com/clm/server/nexus-iq-server-${SERVER_VERSION}-bundle.tar.gz --output nexus-iq-server-${SERVER_VERSION}-bundle.tar.gz \
    && echo "${SERVER_SHA256}  nexus-iq-server-${SERVER_VERSION}-bundle.tar.gz" > nexus-iq-server-${SERVER_VERSION}-bundle.tar.gz.sha256 \
    && sha256sum -c nexus-iq-server-${SERVER_VERSION}-bundle.tar.gz.sha256 \
    && tar -xvf nexus-iq-server-${SERVER_VERSION}-bundle.tar.gz \
    && mv nexus-iq-server-${SERVER_VERSION}.jar ${HOME} \
    && cd ${HOME} \
    && rm -rf ${TEMP}

第二步：排查sha256校验文件的格式问题 #

Alpine里的sha256sum是Busybox实现的，和UBI8里的GNU版本有个关键差异——Busybox的sha256sum要求校验文件里的哈希值和文件名之间必须是双空格分隔，而GNU版本允许单空格。你当前的echo命令用的是单空格，这大概率是校验失败的核心原因！

把echo那一行改成双空格分隔：

&& echo "${SERVER_SHA256}  nexus-iq-server-${SERVER_VERSION}-bundle.tar.gz" > nexus-iq-server-${SERVER_VERSION}-bundle.tar.gz.sha256 \

第三步：验证下载文件与环境变量的正确性 #

1. 检查环境变量是否有效：在RUN命令开头先输出${SERVER_VERSION}和${SERVER_SHA256}，确认变量有没有被正确赋值（比如有没有空值或者错误的哈希字符串）：

   RUN set -x \
       && echo "SERVER_VERSION: ${SERVER_VERSION}" \
       && echo "SERVER_SHA256: ${SERVER_SHA256}" \
       && cd ${TEMP} \
       && ... # 后续原有命令
   

2. 确认文件下载完整性：可以在下载后先查看文件大小，或者手动计算哈希值对比，排查是否因为网络问题导致文件损坏：

   && ls -lh nexus-iq-server-${SERVER_VERSION}-bundle.tar.gz \
   && sha256sum nexus-iq-server-${SERVER_VERSION}-bundle.tar.gz \
   

3. 优化curl参数：Alpine的curl默认参数和UBI8可能有差异，加上-f（下载失败直接退出）和--retry 3（重试3次），降低网络波动导致的下载失败概率：

   && curl -Lf --retry 3 https://download.sonatype.com/clm/server/nexus-iq-server-${SERVER_VERSION}-bundle.tar.gz --output nexus-iq-server-${SERVER_VERSION}-bundle.tar.gz \
   

第四步：检查路径与权限问题 #

确认${TEMP}目录是否存在且有读写权限，Alpine默认的临时目录规则和UBI8不同，你可以提前创建${TEMP}目录避免路径不存在的问题：

RUN mkdir -p ${TEMP} \
    && cd ${TEMP} \
    && ... # 后续原有命令

备注：内容来源于stack exchange，提问作者rasilvap