Google Cloud Function与Golang embed文件部署异常问题咨询

问题本质 #

这是Google Cloud Functions构建系统的已知缓存失效问题，并非Go embed特性本身的bug。GCF的构建缓存偶尔会错误地忽略嵌入文件的存在，导致构建阶段无法匹配到//go:embed声明的文件。重命名文件之所以能临时解决，是因为新文件名会触发缓存失效，迫使构建系统重新读取文件。

无需重命名的解决方法 #

1. 部署时强制禁用构建缓存 #

在gcloud functions deploy命令中添加--no-cache参数，强制构建系统从头开始构建，绕过缓存：

gcloud functions deploy YOUR_FUNCTION_NAME --runtime go121 --trigger-http --no-cache [其他部署参数]

2. 触发go.mod文件的微小变更 #

通过修改go.mod文件（比如添加一行空注释、调整模块描述的空格）来触发构建系统重新同步所有文件，避免缓存误判。修改后再执行部署命令即可。

3. 改用目录通配符嵌入整个凭证目录 #

将单个文件的嵌入改为对整个creds目录的通配符嵌入，使用embed.FS类型管理嵌入文件，这种方式能降低缓存匹配错误的概率：

import "embed"

//go:embed creds/*.json
var credsFS embed.FS

// 读取a.json的示例
func getACredentials() ([]byte, error) {
    return credsFS.ReadFile("creds/a.json")
}

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