“no valid drivers found”是因buildx builder未初始化，需执行docker buildx create --use --name mybuilder --platform linux/amd64,linux/arm64创建多架构builder。
buildx build 时提示 “no valid drivers found”
这是本地没启用 Buildx 驱动的典型表现，不是 Docker Desktop 版本太低，也不是 Go 代码问题，而是 buildx 的 builder 实例没初始化。Docker 默认只带一个 default builder，它不支持多架构构建。
执行以下命令创建支持多架构的 builder：
docker buildx create --use --name mybuilder --platform linux/amd64,linux/arm64
注意：--platform 必须显式列出目标架构，不能只写 linux/arm64 单个值（否则后续 buildx build 会静默降级为单架构）；--use 让它成为当前默认 builder，避免每次都要加 --builder mybuilder。
- 如果用的是 Apple Silicon Mac，
linux/arm64是原生支持的，但linux/amd64依赖 QEMU 模拟，首次构建会慢，且需确保已运行docker run --privileged --rm tonistiigi/binfmt --install all - Linux 主机若未启用
binfmt_misc，即使装了 QEMU，buildx 也会跳过多架构构建，直接报 “unsupported platform” - CI 环境（如 GitHub Actions）中，
docker/setup-buildx-action默认不启用多平台，必须显式传参platforms: 'linux/amd64,linux/arm64'
Go 编译产物在 ARM 容器里 panic: “exec format error”
这不是镜像没推到远程仓库，而是 Go 二进制本身没交叉编译——Docker 构建阶段仍用宿主机 GOOS/GOARCH 编译，导致 AMD64 机器上生成的二进制被扔进 ARM 容器执行。
立即学习“go语言免费学习笔记（深入）”；
正确做法是在 Dockerfile 的构建阶段显式指定 Go 目标平台：
FROM golang:1.22-alpine AS builder ARG TARGETARCH ARG BUILDPLATFORM WORKDIR /app COPY . . RUN CGO_ENABLED=0 GOOS=linux GOARCH=$TARGETARCH go build -o myapp .
$TARGETARCH 是 Buildx 内置变量，会在每个架构构建时自动设为 amd64 或 arm64；CGO_ENABLED=0 强制纯静态链接，避免容器里缺 libc。
- 别用
runtime.GOARCH替代$TARGETARCH—— 这是 Go 运行时变量，在构建阶段还没生效 - 如果项目用了 cgo（比如 SQLite、OpenSSL），必须提前安装对应架构的 sysroot 和 pkg-config，否则
go build直接失败 - Alpine 基础镜像默认用 musl libc，而标准 Go 发布版二进制依赖 glibc；若坚持用 Alpine，务必加
CGO_ENABLED=0，否则跨架构运行时大概率崩溃
buildx build 后 docker images 看不到镜像
Buildx 默认输出到“构建缓存”或“registry”，而不是本地 docker images 列表——这是设计使然，不是构建失败。
要让结果出现在本地镜像列表，必须加 --load 参数：
docker buildx build --platform linux/amd64,linux/arm64 --load -t myorg/myapp:latest .
但注意：--load 不支持多平台同时加载（Docker 只能存一个 manifest list 的引用），所以它实际只加载最后一个平台的镜像（通常是 arm64）。想验证所有平台都成功，得用 --push 推到 registry，再用 docker buildx imagetools inspect 查看完整 manifest。
-
--load和--push互斥，不能同时用 - 本地调试时，可先用
--load快速验证单个平台，再切到--push走完整流程 - 某些旧版 buildx（--load 多平台，会报错 “cannot load multi-platform image”，必须升级
Go HTTP 服务在 ARM64 容器里监听失败：bind: cannot assign requested address
这通常不是端口被占，而是 Go 代码里硬编码了 "127.0.0.1:8080"——在容器网络 namespace 下，127.0.0.1 指向容器自身回环，但 Docker 默认只把 host 网络的 0.0.0.0 映射出去；ARM64 和 AMD64 行为一致，但错误更容易在 ARM 上暴露（因测试环境常混用不同架构）。
修复方式很简单：监听地址改用 ":8080" 或 "0.0.0.0:8080"：
http.ListenAndServe(":8080", handler)
另外检查 Dockerfile 是否漏了 EXPOSE，虽然不影响运行，但 docker run -P 会无法自动映射端口。
- 别依赖
os.Getenv("HOST")拼接监听地址——环境变量可能为空，Go 会尝试解析空字符串为 IP，导致 panic - Kubernetes 中若用 HostNetwork，
127.0.0.1依然不可用，因为 Pod 共享宿主机 network namespace，但容器内lo接口和宿主机不是同一上下文 - ARM64 容器里
netstat -tln看不到监听，不代表没起来——可能是 Alpine 的 busybox netstat 不识别新内核 socket 标志，换用ss -tln更可靠
