无法从Go源码构建Google Cloud Functions问题求助

报错信息 #

ERROR: (gcloud.functions.deploy) OperationError: code=3, message=Build failed with status: FAILURE and message: functions.local/app/main.go:18:2: import "github.com/my/app" is a program, not an importable package. For more details see the logs at https://console.cloud.google.com/cloud-build/builds;region=....

代码结构 #

handlers包代码 #

package handlers

import (
     ...
     ...
    "github.com/my/app/data"
    "github.com/my/app/utils"
    "github.com/GoogleCloudPlatform/functions-framework-go/functions"
)

func init() {
    functions.HTTP("handleFunc", IncomingCall)
}

func IncomingCall(w http.ResponseWriter, r *http.Request) {
...
...
}

main.go代码 #

package main

import (
    "fmt"
    "log"
    "os"

    // Blank-import the function package so the init() runs
    _ "github.com/my/app/handlers"
    "github.com/GoogleCloudPlatform/functions-framework-go/funcframework"
)

const DEFAULT_PORT = 12789

func main() {
    fmt.Println("Started")

    // logger := utils.CreateLogger()

    port := os.Getenv("PORT")
    if len(port) == 0 {
        port = string(DEFAULT_PORT)
    }

    if err := funcframework.Start(port); err != nil {
        log.Fatalf("funcframework.Start: %v\n", err)
    }

    log.Println("Done")
}

go.mod内容 #

module github.com/my/app

go 1.21.4

require github.com/GoogleCloudPlatform/functions-framework-go v1.8.0

require (
    cloud.google.com/go/functions v1.15.1 // indirect
    github.com/cloudevents/sdk-go/v2 v2.14.0 // indirect
    github.com/google/uuid v1.3.0 // indirect
    github.com/json-iterator/go v1.1.10 // indirect
    github.com/modern-go/concurrent v0.0.0-20180228061459-e0a39a4cb421 // indirect
    github.com/modern-go/reflect2 v0.0.0-20180701023420-4b7aa43c6742 // indirect
    go.uber.org/multierr v1.10.0 // indirect
    go.uber.org/zap v1.26.0 // indirect
)

部署命令 #

gcloud functions deploy temp01 `
    --gen2 `
    --runtime=go121 `
    --region=europe-west6 `
    --source=. `
    --entry-point handleFunc `
    --trigger-http `
    --allow-unauthenticated

问题 #

1. 报错中的“program”指什么？
2. 如何解决该导入包错误？

1. 报错中的“program”含义 #

这里的program指包含main函数的Go可执行程序包。Go语言规定，package main是可执行程序的入口包，这类包的设计目的是编译成独立运行的二进制文件，不能被其他Go包导入引用。

报错提示import "github.com/my/app" is a program，说明Cloud Build在构建时尝试导入你的整个模块，但模块根目录下存在main.go（属于package main），因此被判定为不可导入的程序包。

2. 解决导入错误的方法 #

Google Cloud Functions Gen2部署Go函数时，不需要根目录的main.go——它会直接识别functions.HTTP注册的函数，本地调试用的启动入口会干扰构建流程，解决步骤如下：

方法一：调整文件结构（推荐） #

将本地调试用的main.go移到单独的子目录（比如cmd/server/），分离本地运行代码和部署代码：

github.com/my/app/
├── handlers/
│   └── handlers.go
├── data/
│   └── ...
├── utils/
│   └── ...
├── cmd/
│   └── server/
│       └── main.go  # 移至此处
└── go.mod

修改后的main.go导入路径无需变更，本地调试时直接运行cmd/server/main.go即可。

方法二：指定部署源目录 #

如果不想移动文件，可修改部署命令的--source参数，让Cloud Build仅处理handlers目录下的代码：

gcloud functions deploy temp01 `
    --gen2 `
    --runtime=go121 `
    --region=europe-west6 `
    --source=./handlers `
    --entry-point handleFunc `
    --trigger-http `
    --allow-unauthenticated

额外检查 #

确保handlers包中的init函数正确注册了handleFunc，且IncomingCall函数签名符合要求（func(http.ResponseWriter, *http.Request)），同时go.mod依赖版本与Go 1.21环境兼容。

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