在Go App Engine开发中，使用`goapp deploy`部署应用时，常遇到“can't find import”错误，即使本地`go run`正常。这通常是由于Go App Engine SDK在构建时解析导入路径的方式与标准Go工具不同所致。本文将详细解释此问题根源，并提供正确的项目结构和依赖管理方法，确保第三方包如`github.com/go-sql-driver/mysql`能被正确识别和部署。
理解Go App Engine的导入路径解析机制
当您使用标准的Go工具链（如go run或go build）时，它会根据GOPATH环境变量来查找导入的包。例如，如果GOPATH设置为C:\mysql\，并且您的代码在C:\mysql\src\mygoprog.go中导入了github.com/go-sql-driver/mysql，那么Go工具会在C:\mysql\src\github.com\go-sql-driver\mysql路径下查找该包。
然而，Go App Engine的goapp deploy命令在构建和部署应用时，其导入路径解析机制有所不同。它会将包含app.yaml文件的目录视为应用程序的根目录。这意味着，所有导入路径（无论是您自己的包还是第三方包）都必须相对于这个应用程序根目录来解析。goapp deploy不会像标准Go工具那样自动遍历GOPATH下的src目录。
因此，即使您的GOPATH设置正确，并且本地go run可以正常工作，goapp deploy仍然可能因为找不到导入的第三方包而失败，因为这些包的物理位置不符合App Engine的预期。
解决“can't find import”错误
解决这个问题的关键在于调整项目目录结构，使第三方依赖包能够被goapp deploy正确识别。
1. 调整项目目录结构
App Engine期望所有依赖项（包括第三方包）都能从包含app.yaml的目录向上解析。这意味着，如果您的app.yaml位于C:\myproject\，那么github.com/go-sql-driver/mysql应该位于C:\myproject\github.com\go-sql-driver\mysql\。
错误的结构示例（导致问题）：
C:\mysql\
app.yaml
src\
mygoprog.go
github.com\ <-- 依赖包在 src 目录下
go-sql-driver\
mysql\...在这种结构下，goapp deploy在C:\mysql\作为应用根目录时，会尝试查找C:\mysql\github.com\...，但实际上包位于C:\mysql\src\github.com\...，因此导致找不到。
正确的结构示例：
为了解决这个问题，您需要将github.com目录移动到与app.yaml同级的目录，或者如果您的主程序文件位于src目录下，则将github.com也放在src目录下，使得从app.yaml所在目录到src目录再到github.com的路径能够正确解析。
通常，最推荐且直接的方式是，将所有源代码（包括您的应用代码和第三方依赖）都放在一个src子目录下，而app.yaml则位于项目根目录。在这种情况下，goapp deploy会把项目根目录作为基础，并期望所有导入的包都在src子目录下。
C:\myproject\ <-- 项目根目录，包含 app.yaml
app.yaml
src\
mygoprog.go
github.com\ <-- 依赖包在 src 目录下
go-sql-driver\
mysql\...在这种结构下，mygoprog.go中的import _ "github.com/go-sql-driver/mysql"会被正确解析为C:\myproject\src\github.com\go-sql-driver\mysql。
根据原始问题和答案，更直接的解决方案是：
将github.com目录直接放在app.yaml所在的目录。
C:\mysql\
app.yaml
github.com\ <-- 将依赖包直接放在 app.yaml 同级目录
go-sql-driver\
mysql\...
src\
mygoprog.go <-- 您的应用程序代码在这种情况下，mygoprog.go中的import _ "github.com/go-sql-driver/mysql"将通过C:\mysql\github.com\go-sql-driver\mysql路径被正确找到。这要求goapp deploy在编译时，能够将C:\mysql视为一个有效的GOPATH入口点。
2. 使用goapp get管理依赖
为了确保依赖包以App Engine兼容的方式安装，请始终使用goapp get命令来获取和安装第三方包，而不是标准的go get。goapp get会确保包被下载到正确的位置，以便goapp deploy能够找到它们。
# 确保在您的项目根目录（即 app.yaml 所在的目录）下执行 cd C:\mysql\ # 使用 goapp get 安装依赖 goapp get github.com/go-sql-driver/mysql
执行此命令后，github.com目录（包含go-sql-driver/mysql）应该会被创建在C:\mysql\目录下，或者根据您的GOPATH和App Engine的特定版本行为，可能在C:\mysql\src\下。关键是检查实际生成的位置，并确保其符合上述的“正确结构示例”。如果goapp get将其放在了C:\mysql\src\github.com，而您的mygoprog.go也在C:\mysql\src，那么这种结构是兼容的。
3. 应用程序代码示例
您的Go程序代码本身不需要特殊修改，导入路径保持标准形式即可：
package main
import (
"database/sql"
"fmt"
"log"
"net/http"
_ "github.com/go-sql-driver/mysql" // 导入MySQL驱动，注意下划线表示只导入其副作用
)
func handler(w http.ResponseWriter, r *http.Request) {
// 示例：尝试打开一个数据库连接，实际在GAE上可能需要使用Cloud SQL Proxy或App Engine特定连接方式
db, err := sql.Open("mysql", "user:password@tcp(127.0.0.1:3306)/dbname")
if err != nil {
http.Error(w, fmt.Sprintf("Error opening database: %v", err), http.StatusInternalServerError)
log.Printf("Error opening database: %v", err)
return
}
defer db.Close()
err = db.Ping()
if err != nil {
http.Error(w, fmt.Sprintf("Error connecting to database: %v", err), http.StatusInternalServerError)
log.Printf("Error connecting to database: %v", err)
return
}
fmt.Fprintf(w, "Hello from App Engine with MySQL driver!")
}
func main() {
http.HandleFunc("/", handler)
port := "8080"
log.Printf("Server listening on port %s", port)
if err := http.ListenAndServe(":"+port, nil); err != nil {
log.Fatalf("Server failed to start: %v", err)
}
}4. app.yaml配置
您的app.yaml配置通常如下所示，无需特殊更改来解决导入问题：
application: skilled-nation-521 version: 1 runtime: go api_version: go1 handlers: - url: /.* script: _go_app
5. 部署命令
在确保目录结构和依赖安装正确后，您可以在项目根目录（包含app.yaml的目录）执行部署命令：
C:\mysql> goapp deploy
注意事项与最佳实践
- 始终使用goapp工具： 在开发和测试App Engine应用程序时，请始终使用goapp run、goapp test和goapp deploy等goapp工具，而不是标准的go命令。goapp工具是为App Engine环境定制的，能够模拟其特有的行为和限制。
- 清理和重试： 如果遇到持续的导入问题，尝试清理您的GOPATH或项目目录下的pkg和src目录，然后重新使用goapp get安装依赖。
- 版本控制： 将您的第三方依赖（github.com目录）纳入版本控制（例如Git），这样团队成员在克隆项目后可以直接部署，无需手动运行goapp get。
- Go Modules (现代Go开发)： 对于更现代的Go项目，Go Modules是推荐的依赖管理方式。虽然App Engine标准环境（Go 1.11+）支持Go Modules，但在旧版SDK（如问题中的1.9.1）中，可能需要手动管理vendor目录或遵循上述GOPATH兼容结构。如果可能，建议升级Go App Engine SDK和Go版本以利用Go Modules的优势。
总结
在Go App Engine上部署带有第三方依赖的应用程序时，“can't find import”错误通常源于goapp deploy与标准Go工具在解析导入路径上的差异。通过确保第三方包的目录结构符合App Engine的预期（即，github.com等包目录位于app.yaml所在的应用程序根目录或其直接src子目录下），并始终使用goapp get来管理依赖，可以有效解决此类问题。理解这些机制是成功部署Go App Engine应用程序的关键。
