树莓派4使用docker buildx构建Dockerfile时apk拉取包失败如何解决

1. 架构兼容性问题：你使用的golang:1.17.3-alpine镜像底层基于Alpine 3.14版本，该版本的musl libc依赖ARMv7架构设备支持VFPv3浮点单元与LDREX/STREX原子操作指令，部分搭载Pi OS 10（buster）的树莓派4内核未适配该要求，导致apk工具运行异常，抛出看似网络故障的temporary error报错。
2. buildx网络配置问题：buildx构建默认使用隔离网络环境，即使宿主机可以正常拉取基础镜像，也可能存在容器内部DNS解析失败的情况，导致apk无法访问软件源。
3. 平台参数匹配错误：若未显式设置BUILDPLATFORM参数，buildx可能错误识别架构，拉取非armv7的基础镜像，导致apk无法匹配对应架构的软件包索引。

• 更换兼容性更好的基础镜像
  改用基于Alpine 3.13的golang镜像，该版本对armv7架构的适配更成熟，修改Dockerfile对应行即可：

  FROM --platform=${BUILDPLATFORM} golang:1.17.3-alpine3.13 AS build
  

• 提前替换apk软件源
  在执行apk安装命令前先替换为国内镜像，同时规避源地址解析与访问故障，修改Dockerfile对应段：

  WORKDIR /src
  RUN sed -i 's/dl-cdn.alpinelinux.org/mirrors.tuna.tsinghua.edu.cn/g' /etc/apk/repositories \
      && apk --no-cache add git build-base
  

• 显式指定构建平台参数
  执行buildx命令时手动声明架构，避免自动识别错误：

  docker buildx build --platform linux/arm/v7 .
  

• 使用host网络构建
  若确认是buildx隔离网络导致的解析故障，可直接使用宿主机网络构建：

  docker buildx build --network host .
  

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