google app engine（标准环境）要求所有 go 包导入必须使用绝对包路径（即以应用根目录为基准的完整路径），禁止使用 ../ 等相对路径，否则 goapp serve 会因解析失败而报错。
google app engine（标准环境）要求所有 go 包导入必须使用绝对包路径（即以应用根目录为基准的完整路径），禁止使用 ../ 等相对路径，否则 goapp serve 会因解析失败而报错。
在 Google App Engine 的 Go 标准环境中，构建工具（go-app-builder）严格遵循 Go 的包管理约定：每个导入路径必须是可唯一识别的绝对路径，且需相对于应用的根目录（即包含 app.yaml 的目录）。这意味着你不能像本地开发或普通 Go 项目那样使用相对导入（如 "../common"），因为 App Engine 的构建上下文不支持基于文件系统位置的相对解析——它只认“包名即路径”的绝对导入形式。
例如，你的项目结构如下：
├── app.yaml ├── controllers/ │ ├── home/ │ │ └── home.go ← 当前文件 │ └── common/ │ └── common.go
若在 controllers/home/home.go 中写：
import "../common" // ❌ 错误：相对路径不被 App Engine 允许
构建器会直接报错：parser: bad import "../common"。
✅ 正确做法是使用以项目根目录为起点的绝对路径（注意：不带开头的 ./ 或 ../，也不需要模块路径前缀）：
import (
"controllers/common"
)
⚠️ 注意事项：
- 导入路径必须与实际目录层级完全一致，区分大小写；
- 所有子包（如 controllers/admin、controllers/auth/login）都应按此规则导入，例如 "controllers/auth"；
- 不要添加 github.com/yourname/yourapp/ 这类外部模块路径——App Engine 标准环境不使用 Go modules（旧版 goapp 工具链），而是依赖目录结构隐式定义包路径；
- 确保每个 .go 文件顶部的 package 声明与所在目录语义一致（如 controllers/common/common.go 应声明 package common）；
- 若升级至较新版本的 Go 运行时（如 Go 1.11+ 标准环境），请改用官方 gcloud app deploy 和 go mod，此时需在根目录初始化模块（go mod init your-app-id），并使用符合模块规范的导入路径（如 "your-app-id/controllers/common"）——但本例基于传统 goapp 工具链，仍以绝对目录路径为准。
总结：App Engine 的构建机制决定了它只接受“根目录起始的纯路径”作为导入标识符。将所有 ../ 替换为形如 "controllers/common" 的绝对路径，即可解决该解析错误，并确保服务正常启动。
