无法构建Docker容器：Laravel Sail执行apt-get update失败

问题说明 #

执行./sail up -d启动容器时，Docker构建过程卡在apt-get update步骤，报错：

failed to solve: executor failed running [/bin/sh -c apt-get update]: exit code: 100

使用的Dockerfile基于ubuntu:21.04，手动执行sudo apt-get update也无法解决。

根本原因 #

Ubuntu 21.04（Hirsute Hippo）属于短期支持版本，已于2022年1月结束维护，官方软件源已停止服务，导致apt-get update无法获取软件包索引，触发错误码100。

解决方案 #

方案1：更换为受支持的Ubuntu基础镜像 #

将Dockerfile的基础镜像替换为长期支持的版本（如Ubuntu 22.04 Jammy Jellyfish），同时适配对应的PHP版本：

FROM ubuntu:22.04

LABEL maintainer="Taylor Otwell"

ARG WWWGROUP
ARG NODE_VERSION=16

WORKDIR /var/www/html

ENV DEBIAN_FRONTEND noninteractive
ENV TZ=UTC

RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone

# 先安装必要依赖，再更新源
RUN apt-get update && apt-get install -y --no-install-recommends \
    php8.1-cli \
    php8.1-mbstring \
    php8.1-xml \
    php8.1-pdo \
    php8.1-mysql \
    supervisor \
    curl \
    && apt-get clean && rm -rf /var/lib/apt/lists/*

RUN setcap "cap_net_bind_service=+ep" /usr/bin/php8.1

RUN groupadd --force -g $WWWGROUP sail
RUN useradd -ms /bin/bash --no-user-group -g $WWWGROUP -u 1337 sail

COPY start-container /usr/local/bin/start-container
COPY supervisord.conf /etc/supervisor/conf.d/supervisord.conf
COPY php.ini /etc/php/8.1/cli/conf.d/99-sail.ini
RUN chmod +x /usr/local/bin/start-container

EXPOSE 8000

ENTRYPOINT ["start-container"]

方案2：保留PHP7.4并更换为归档源 #

如果必须使用PHP7.4，可将Ubuntu源替换为旧版本归档源，并添加PHP7.4的第三方源：

FROM ubuntu:21.04

LABEL maintainer="Taylor Otwell"

ARG WWWGROUP
ARG NODE_VERSION=16

WORKDIR /var/www/html

ENV DEBIAN_FRONTEND noninteractive
ENV TZ=UTC

RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone

# 替换为Ubuntu归档源
RUN sed -i 's/archive.ubuntu.com/old-releases.ubuntu.com/g' /etc/apt/sources.list
# 添加PHP7.4的第三方源
RUN apt-get update && apt-get install -y --no-install-recommends software-properties-common \
    && add-apt-repository ppa:ondrej/php \
    && apt-get update

# 安装PHP7.4及依赖
RUN apt-get install -y --no-install-recommends \
    php7.4-cli \
    php7.4-mbstring \
    php7.4-xml \
    php7.4-pdo \
    php7.4-mysql \
    supervisor \
    curl \
    && apt-get clean && rm -rf /var/lib/apt/lists/*

RUN setcap "cap_net_bind_service=+ep" /usr/bin/php7.4

RUN groupadd --force -g $WWWGROUP sail
RUN useradd -ms /bin/bash --no-user-group -g $WWWGROUP -u 1337 sail

COPY start-container /usr/local/bin/start-container
COPY supervisord.conf /etc/supervisor/conf.d/supervisord.conf
COPY php.ini /etc/php/7.4/cli/conf.d/99-sail.ini
RUN chmod +x /usr/local/bin/start-container

EXPOSE 8000

ENTRYPOINT ["start-container"]

最后步骤 #

1. 清理旧的Docker镜像和缓存：

docker system prune -a

2. 重新启动Sail：

./sail up -d --build

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