Revel 应用在 Heroku 上正确导入本地包的完整解决方案-Golang-PHP中文网

Revel 应用在 Heroku 上正确导入本地包的完整解决方案

Revel 项目部署到 Heroku 时，因 GOPATH 结构与本地不一致导致本地包（如 base/app/models）无法被 Go 编译器识别，核心原因是 Heroku Buildpack 自动将项目根目录映射为 $GOPATH/src/，而 .godir 文件必须与该路径严格匹配。

revel 项目部署到 heroku 时，因 gopath 结构与本地不一致导致本地包（如 `base/app/models`）无法被 go 编译器识别，核心原因是 heroku buildpack 自动将项目根目录映射为 `$gopath/src/`，而 `.godir` 文件必须与该路径严格匹配。

在 Heroku 上部署 Revel 应用时，Go 构建环境与本地开发环境存在根本性差异：Heroku 的 Go Buildpack 会将整个代码仓库克隆至临时构建路径（如 /tmp/build_.../.go/src/base-test/），并依据 .godir 文件内容确定模块根路径。这意味着——你的 import 路径不是由文件系统相对位置决定的，而是由 GOPATH 下的绝对导入路径决定的。

从你提供的日志可见关键线索：

remote: /tmp/build_.../.go/src/base-test/
remote: can't load package: .../gorp.go:10:2: local import "../models" in non-local package

错误 local import "../models" in non-local package 明确指出：Go 禁止在非 main 包中使用 ../ 这类相对路径导入（违反 Go 的可重现构建原则）。而 import("base/app/models") 失败，是因为 Heroku 实际使用的 GOPATH 子路径是 base-test，而非你本地重命名后的 base。

✅ 正确解决步骤如下：

统一项目标识名
确保以下三者完全一致：
- Heroku 应用名称（可通过 heroku apps:rename base-test 修改）；
- 项目根目录下的 .godir 文件内容（必须为单行纯文本，无空格、无注释、无引号）；
- 所有 Go 源文件中的 import 语句前缀（如 import "base-test/app/models"）。
? 验证方式：heroku run bash 进入容器后执行
```
ls -l $GOPATH/src/
# 应看到：base-test@ -> /app（或类似软链）
cat .godir  # 必须输出 exactly "base-test"
```
修正所有 import 语句
将原 import("base/app/models") 全部替换为：
```
import (
    "base-test/app/models"
    "base-test/app/routes"
    // 其他同理
)
```
注意：不可使用 ./、../ 或 app/models 等相对路径；必须使用以 .godir 值为根的全限定导入路径。

确保 .godir 文件存在于项目根目录且仅含一行

echo "base-test" > .godir
git add .godir && git commit -m "fix: pin GOPATH src dir to base-test"

（可选但推荐）升级 Go 版本并显式声明
你当前使用 Go 1.4（已严重过时，且不支持 modules），极易引发兼容性问题。建议在项目根目录设置 GOVERSION：
```
heroku config:set GOVERSION=1.21.0
```
并确保 go.mod（若使用 modules）或 Gopkg.toml（若使用 dep）已提交——现代 Revel 推荐搭配 Go Modules 使用。

⚠️ 重要注意事项：

Heroku 不会自动更新 .godir —— 即使你重命名了 Heroku App，也必须手动修改 .godir 文件内容并重新推送；
所有本地包导入必须符合 Go 的“导入路径即文件路径”规则，Heroku 的构建路径永远是 $GOPATH/src/<your-app-name>/...</your-app-name>；
若使用 Revel CLI（如 revel run），请确保本地 GOPATH 结构与 Heroku 一致，避免“本地能跑，线上报错”的陷阱；
不要依赖 vendor/ 目录绕过此问题——Heroku Buildpack 对 vendor 的处理逻辑复杂且易出错，应优先保证 import 路径语义清晰。