如何解决pion/stun包编译时的//go:build注释缺失错误？

executor failed running [/bin/sh -c CGO_ENABLED=0 go build -o /bin/app ./cmd]: exit code: 1
make: *** [build-dev] Error 1

我已经尝试了网上能找到的所有解决方案：
- 将Go版本升级至1.20，也尝试降级至1.17
- 将出现问题的stun包从v0.4.0降级至0.3.5

其中升级Go版本是很多已提交issue中给出的解决办法，但对我无效。

我的本地开发环境是Mac M1，通过Homebrew安装的Go 1.18.10，以下是`go env`的输出信息：

GO111MODULE=""
GOARCH="arm64"
GOBIN=""
GOCACHE="/Users/teja/Library/Caches/go-build"
GOENV="/Users/teja/Library/Application Support/go/env"
GOEXE=""
GOEXPERIMENT=""
GOFLAGS=""
GOHOSTARCH="arm64"
GOHOSTOS="darwin"
GOINSECURE=""
GOMODCACHE="/Users/teja/go/pkg/mod"
GONOPROXY=""
GONOSUMDB=""
GOOS="darwin"
GOPATH="/Users/teja/go"
GOPRIVATE=""
GOPROXY="https://proxy.golang.org,direct"
GOROOT="/opt/homebrew/opt/go/libexec"
GOSUMDB="sum.golang.org"
GOTMPDIR=""
GOTOOLDIR="/opt/homebrew/opt/go/libexec/pkg/tool/darwin_arm64"
GOVCS=""
GOVERSION="go1.18.10"
GCCGO="gccgo"
AR="ar"
CC="clang"
CXX="clang++"
CGO_ENABLED="1"
.....

# 解决方案建议

1. **确认Docker镜像中的Go版本与架构兼容性**
   本地使用Go 1.18，但Docker构建阶段的Go镜像版本可能不匹配或未适配ARM64架构。修改Dockerfile中基础镜像为明确支持arm64的版本，比如：
   ```dockerfile
   FROM golang:1.18-alpine AS builder

避免使用未声明架构的镜像导致编译环境异常。

2. 清理模块缓存并重新拉取依赖
   缓存的依赖包可能存在损坏，在构建流程中添加清理步骤：

   RUN go clean -modcache && go mod download
   

   本地也可以先执行go clean -modcache && go mod tidy更新依赖文件后再进行Docker构建。

3. 强制替换stun包为兼容版本
   如果降级到v0.3.5无效，尝试使用Pion stun包的最新稳定兼容版本，在go.mod中添加replace指令：

   replace github.com/pion/stun => github.com/pion/stun v0.3.8
   

   执行go mod tidy后重新构建，确保依赖版本完全兼容当前Go版本。

4. 确保CGO_ENABLED环境变量正确设置
   在Dockerfile中全局设置CGO_ENABLED，避免仅在build命令中传递导致的环境变量失效：

   ENV CGO_ENABLED=0
   RUN go build -o /bin/app ./cmd
   

5. 检查构建上下文的依赖文件
   确认Docker构建上下文目录中的go.mod和go.sum没有残留旧版本依赖记录，本地执行go mod tidy后再将文件同步到构建上下文。

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