为什么 Go 项目构建在 Netlify 函数上失败并出现“缺少 go.sum 条目”？

你在学习Golang相关的知识吗？本文《为什么 Go 项目构建在 Netlify 函数上失败并出现“缺少 go.sum 条目”？》，主要介绍的内容就涉及到，如果你想提升自己的开发能力，就不要错过这篇文章，大家要知道编程理论基础和实战操作都是不可或缺的哦！

我正在尝试在 netlify 函数上部署一个非常简单的 go 函数。

我按照指南进行操作，但该指南没有很好地解释 go 设置。

我使用了目前推荐的方法来做到这一点，基本上是 go init，根据需要更改我的 go 文件，然后 go mod tidy。这将创建适当的 go.mod 和 go.sum 文件，我可以在本地构建。

我还在 website/index.html 上创建了一个非常简单的网站，这样我就可以测试该网站是否可以“运行”该功能。这意味着我将 netlify 的“基本目录”配置为 website/ （这就是我通常对 netlify 上的其他网站所做的操作，并且效果很好）。

编辑：我尝试将所有内容移动到根目录，而不是使用 website/ 作为基本目录，但问题仍然相同。

然后，我将所有 go 文件（包括 go.mod 和 go.sum）移动到 website/netlify/functions/analytics/ （因此我的函数将被称为 analytics，如指南中所述）并推送。

website/netlify/functions/analytics 的内容：

go.mod  go.sum  handlers.go  main.go  main_test.go

但是，netlify 构建失败并显示：

5:33:45 pm: ❯ current directory
5:33:45 pm:   /opt/build/repo/website
5:33:45 pm: ​
5:33:45 pm: ❯ config file
5:33:45 pm:   no config file was defined: using default values.
5:33:45 pm: ​
5:33:45 pm: ❯ context
5:33:45 pm:   production
5:33:45 pm: ​
5:33:45 pm: ────────────────────────────────────────────────────────────────
5:33:45 pm:   1. functions bundling                                         
5:33:45 pm: ────────────────────────────────────────────────────────────────
5:33:45 pm: ​
5:33:45 pm: packaging functions from netlify/functions directory:
5:33:45 pm:  - analytics/main.go
5:33:45 pm: ​
5:33:45 pm: could not compile go function analytics:
5:33:45 pm: ​
5:33:45 pm: ────────────────────────────────────────────────────────────────
5:33:45 pm:   bundling of function "analytics" failed                       
5:33:45 pm: ────────────────────────────────────────────────────────────────
5:33:45 pm: ​
5:33:45 pm:   error message
5:33:45 pm:   command failed with exit code 1: go build -o /tmp/zisi-629b7b4be8f858000804bf6c/analytics -ldflags -s -w (https://ntl.fyi/exit-code-1)
5:33:45 pm:   go: github.com/aws/[email protected] requires
5:33:45 pm:     github.com/stretchr/[email protected]: missing go.sum entry; to add it:
5:33:45 pm:     go mod download github.com/stretchr/testify
5:33:45 pm: ​
5:33:45 pm:   error location
5:33:45 pm:   while bundling function "analytics"
5:33:45 pm: ​
5:33:45 pm:   resolved config
5:33:45 pm:   build:
5:33:45 pm:     base: /opt/build/repo/website
5:33:45 pm:     publish: /opt/build/repo/website
5:33:45 pm:     publishorigin: ui
5:33:45 pm:   functionsdirectory: /opt/build/repo/website/netlify/functions

该错误表明 netlify 可以正确找到 go 文件，但由于某种原因，它似乎忽略了 go.sum，因为该文件包含正确的校验和：

github.com/aws/aws-lambda-go v1.32.0 h1:i8MflawW1hoyYp85GMH7LhvAs4cqzL7LOS6fSv8l2KM=
github.com/aws/aws-lambda-go v1.32.0/go.mod h1:IF5Q7wj4VyZyUFnZ54IQqeWtctHQ9tz+KhcbDenr220=
github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
github.com/stretchr/testify v1.6.1 h1:hDPOHmpOpP40lSULcqw7IrRb/u7w6RpDC9399XyoNd0=
gopkg.in/yaml.v3 v3.0.0-20200615113413-eeeca48fe776 h1:tQIYjPdBoyREyB9XMu+nnTclpTYkz2zFM+lzLJFO4gQ=

可能出了什么问题，我该如何解决？

正确答案

在撰写本文时，netlify 使用旧版本的 go 1.16.5 进行构建。

这意味着我的 go.mod 文件甚至不应该被旧的 go 编译器接受！不管怎样，我在本地安装了那个版本的 go 来尝试一下......

以下是安装特定版本 go 的方法（假设您本地安装了 go 1.18）：

$ go install golang.org/dl/go1.16.5@latest
$ go1.16.5 download

现在您可以运行 go1.16.5 来尝试旧版编译器。

我写了一个 makefile，让我可以使用任何版本的 go 来构建......看起来像这样：

## to use a different version of go, run like this:
##    make all go=go1.16.5
go:=go

.phony: test
test:
    cd analytics && $(go) test .

../netlify/functions/analytics: test
    cd analytics && $(go) build -o ../netlify/functions/analytics .

all: ../netlify/functions/analytics

这是使用 go1.16.5 的结果：

▶ make all go=go1.16.5
cd analytics && go1.16.5 test .
go: github.com/aws/[email protected] requires
        github.com/stretchr/[email protected]: missing go.sum entry; to add it:
        go mod download github.com/stretchr/testify
make: *** [test] error 1

这与我在 netlify 上看到的错误相同！很酷，这就是问题所在。

现在，为了解决这个问题，我必须删除 go.mod 和 go.sum 并使用旧的 go 版本重新生成它们，这是我通过编写此 make 任务来完成的：

.phony: setup
setup:
    cd analytics && rm go.mod go.sum && $(go) mod init renato/analytics && $(go) mod tidy

现在，使用旧版 go 在本地构建成功：

▶ make setup all go=go1.16.5
cd analytics && rm go.mod go.sum && go1.16.5 mod init renato/analytics && go1.16.5 mod tidy
go: creating new go.mod: module renato/analytics
go: to add module requirements and sums:
        go mod tidy
go: finding module for package github.com/aws/aws-lambda-go/lambda
go: finding module for package github.com/aws/aws-lambda-go/events
go: found github.com/aws/aws-lambda-go/events in github.com/aws/aws-lambda-go v1.32.0
go: found github.com/aws/aws-lambda-go/lambda in github.com/aws/aws-lambda-go v1.32.0
cd analytics && go1.16.5 test .
ok      renato/analytics        0.166s
cd analytics && go1.16.5 build -o ../netlify/functions/analytics .

我决定在此之后提交 go 文件，让 netlify 看到这些文件的正确版本，但我还通过告诉 netlify 运行我的构建命令 make all （没有 make）来“自定义构建”（如 explained in the docs） setup，因为如果您在 netlify ui（在站点设置中）上提交 go.mod 和 go.sum 文件，则不需要它。这可能不是必需的，但我想确定正在执行正确的命令。

最后，该构建也可以在 netlify 上运行！！

7:36:59 PM: ────────────────────────────────────────────────────────────────
7:36:59 PM:   1. Build command from Netlify app                             
7:36:59 PM: ────────────────────────────────────────────────────────────────
7:36:59 PM: ​
7:36:59 PM: $ make all
7:36:59 PM: cd analytics && go test .
7:37:00 PM: go: downloading github.com/aws/aws-lambda-go v1.32.0
7:37:08 PM: ok      renato/analytics    0.017s
7:37:08 PM: cd analytics && go build -o ../netlify/functions/analytics .
7:37:09 PM: ​
7:37:09 PM: (build.command completed in 9.2s)
7:37:09 PM: ​
7:37:09 PM: ────────────────────────────────────────────────────────────────
7:37:09 PM:   2. Functions bundling                                         
7:37:09 PM: ────────────────────────────────────────────────────────────────
7:37:09 PM: ​
7:37:09 PM: Packaging Functions from netlify/functions directory:
7:37:09 PM:  - analytics
7:37:09 PM: ​
7:37:09 PM: ​
7:37:09 PM: (Functions bundling completed in 101ms)

所以，问题是 go 版本 netlify 已经过时了，不幸的是 go 一直在搞乱 go mod 格式，这导致了这样的兼容性问题......你可能需要 go 编译器的确切版本才能获得给定的项目可以正确编译，如本例所示。

到这里，我们也就讲完了《为什么 Go 项目构建在 Netlify 函数上失败并出现“缺少 go.sum 条目”？》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！