google app engine（标准环境）要求所有 go 包导入必须使用绝对路径（即以应用根目录为基准的完整包路径），不支持 ../ 等相对导入，否则会触发 parser: bad import 错误。
google app engine（标准环境）要求所有 go 包导入必须使用绝对路径（即以应用根目录为基准的完整包路径），不支持 ../ 等相对导入，否则会触发 parser: bad import 错误。
在 Google App Engine 的 Go 运行时环境中，构建工具（go-app-builder）采用严格的包解析策略：它将应用根目录（即包含 app.yaml 的目录）视为 Go 工作区的 $GOROOT 或模块根，因此所有 import 语句必须是从项目根开始的绝对包路径，而非文件系统意义上的相对路径。
例如，你的项目结构如下：
├── app.yaml ├── controllers/ │ ├── home/ │ │ └── home.go // 想在此文件中导入 common 包 │ └── common/ │ └── common.go
若在 controllers/home/home.go 中错误地写成：
import "../common" // ❌ 错误：相对路径不被 App Engine 构建器接受
就会导致你遇到的报错：
Google Workspace CLI
下载
使用 `gw` CLI 与 Google Workspace（Drive、Docs、Sheets）交互。当需要浏览、读取、创建、搜索或管理 Google Drive 中的文件时使用。
go-app-builder: Failed parsing input: parser: bad import "../common" in controllers/home/home.go
✅ 正确做法是：省略 ../，直接以项目根为起点书写包路径：
package home
import (
"controllers/common" // ✅ 正确：绝对包路径，等价于从项目根导入 ./controllers/common
)
func HomeHandler(w http.ResponseWriter, r *http.Request) {
// 可正常使用 common 包中的类型或函数
_ = common.DBConfig{}
}
⚠️ 注意事项：
- 不要添加前导 ./ 或 ../，也不要用完整文件系统路径；
- 包名（如 common）应与对应目录下的 package common 声明一致；
- 所有子包（如 controllers/auth, controllers/forum）均需遵循相同规则，统一使用 "controllers/xxx" 形式导入；
- 如果使用较新版本的 Go（1.11+）及 Go Modules，App Engine 标准环境仍不兼容 go.mod（除非明确部署为 Go 1.16+ 的第二代运行时），因此请确保项目未启用模块模式，或改用 App Engine flexible environment / Cloud Run 以获得现代 Go 工具链支持。
总结：App Engine 的构建约束本质是其沙箱化编译模型决定的——它需要可预测、无歧义的包依赖图。坚持使用从项目根出发的扁平化绝对导入路径，即可彻底规避此类解析失败问题。
