Dockerfile从Stretch升级到Buster时dist-upgrade失败求助

这个问题我之前在切换Debian源版本时也碰到过，核心原因是Buster的dash包维护脚本对man文件的依赖比Stretch更严格，而Docker基础镜像通常会精简掉man相关文件，导致脚本执行时找不到需要的文件。以下是几种可行的解决方法：

方法1：先补全man文件再执行升级 #

在apt-get dist-upgrade前先安装manpages相关包，确保缺失的sh.distrib.1.gz文件存在，完成升级后再清理这些冗余文件：

RUN apt-get update && \
    apt-get install -y --no-install-recommends manpages manpages-dev && \
    apt-get dist-upgrade -y && \
    # 清理man文件以减小镜像体积
    apt-get purge -y --auto-remove manpages manpages-dev && \
    rm -rf /var/lib/apt/lists/*

方法2：临时绕开脚本的文件检查 #

如果不想安装man文件，可以通过dpkg工具临时创建一个空的目标文件，让dash的预安装脚本误以为文件存在：

RUN apt-get update && \
    # 临时创建空的man文件，骗过脚本检查
    dpkg-divert --local --rename --add /usr/share/man/man1/sh.distrib.1.gz && \
    touch /usr/share/man/man1/sh.distrib.1.gz && \
    apt-get dist-upgrade -y && \
    # 清理临时操作
    dpkg-divert --local --rename --remove /usr/share/man/man1/sh.distrib.1.gz && \
    rm -rf /var/lib/apt/lists/*

方法3：使用非精简版Buster镜像 #

如果使用的是debian:buster-slim这类精简镜像，可以换成debian:buster完整版——它默认包含了manpages等基础文件，升级时不会出现这类依赖缺失问题。后续你仍可以通过清理命令压缩镜像体积。

额外注意点 #

• 切换源后一定要执行apt-get update，避免使用旧的Stretch包索引
• apt-utils本身解决不了man文件缺失的问题，不需要额外依赖它
• 执行apt-get时加上--no-install-recommends可以减少不必要的依赖安装，控制镜像大小

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