本地执行AWS SAM Build遇Go二进制验证失败，如何解决？

问题重现 #

执行sam build时触发以下错误：

$ sam build
Building codeuri: path/to/path runtime: provided.al2 metadata: {'BuildMethod': 'go1.x'} architecture:
x86_64 functions: x/y
Workflow GoModulesBuilder does not support value "False" for building in source. Using default value "True"

Build Failed
Error: GoModulesBuilder:Validation - Binary validation failed for go, searched for go in following locations  : ['/usr/local/bin/go'] which did not satisfy constraints for runtime: provided. Do you have go for runtime: provided on your PATH?

环境版本信息：

➜  ~ ls /usr/local/bin/go
/usr/local/bin/go
➜  ~ go version
go version go1.21.5 darwin/amd64
➜  ~ sam --version
SAM CLI, version 1.118.0

解决方案 #

1. 修正函数模板配置 #

在template.yaml的函数元数据中明确指定适配Amazon Linux 2的构建环境参数，示例配置如下：

Resources:
  YourTargetFunction:
    Type: AWS::Serverless::Function
    Properties:
      CodeUri: path/to/your/code
      Runtime: provided.al2
      Architectures:
        - x86_64
      Handler: bootstrap
    Metadata:
      BuildMethod: go1.x
      BuildProperties:
        GOOS: linux
        GOARCH: amd64
        GoBuildFlags: "-ldflags '-s -w'"

通过BuildProperties强制指定GOOS和GOARCH，确保生成的二进制兼容运行环境，消除SAM对Go环境的验证歧义。

2. 手动指定Go二进制路径 #

直接通过环境变量告知SAM Go的具体位置：

export GO_BIN=/usr/local/bin/go
sam build

3. 清理SAM缓存后重试 #

SAM的缓存文件可能导致验证逻辑异常，执行清理后重新构建：

rm -rf .sam
sam build

或使用缓存强制刷新命令：

sam build --cached --force

4. 升级SAM CLI到最新版本 #

旧版本SAM CLI可能存在与Go 1.21的兼容性问题，执行升级：

pip install --upgrade aws-sam-cli

前置验证 #

先手动编译Go代码，确认本地环境能生成兼容Linux的二进制：

GOOS=linux GOARCH=amd64 go build -o bootstrap path/to/your/main.go

如果该命令能成功生成bootstrap文件，说明Go环境本身无问题，重点排查SAM配置或缓存问题。

内容的提问来源于stack exchange，提问作者cosmos-1905-14