在heroku上部署go revel应用时，若遇到因`robfig/heroku-buildpack-go-revel`构建包内部文件移动逻辑缺陷导致的`mv: cannot stat`错误，本文将提供一个有效的解决方案。通过利用社区维护的修复版构建包，开发者可以绕过此问题，实现revel应用的顺利部署。教程将详细指导从环境准备到最终部署的每一步，并包含必要的命令示例。
Go语言以其高效和并发特性，在Web开发领域日益受到青睐，而Revel作为其全栈Web框架，提供了快速开发的能力。将Revel应用部署到云平台如Heroku，能够简化运维并专注于业务逻辑。然而，在使用特定的Heroku构建包时，开发者可能会遇到一些挑战。本文将聚焦于robfig/heroku-buildpack-go-revel构建包在部署Revel应用时可能出现的mv命令错误，并提供一套行之有效的解决方案。
部署错误分析
当尝试使用robfig/heroku-buildpack-go-revel构建包部署Go Revel应用时，可能会在Heroku的构建日志中看到如下错误信息：
mv: cannot stat `/tmp/build_86bd3433-7925-4ae9-b4bf-f5466525aef1/.go/bin/*': No such file or directory ! Push rejected, failed to compile Revel app
这个错误表明，构建包在编译Go应用后，尝试将编译生成的可执行文件从一个临时目录（例如/tmp/build_.../.go/bin/）移动到最终的应用运行目录时失败了。失败的原因是源路径下没有找到任何匹配的文件，即*.go编译后可能没有生成预期的二进制文件，或者生成的路径与构建包预期的不符。这通常是由于构建包内部的文件移动逻辑不够健壮，没有考虑到某些情况下文件可能不存在或者命名方式不同，导致mv命令执行失败，进而中断整个部署过程。
解决方案：使用修复版构建包
针对上述问题，社区中已经有开发者提供了修复方案。核心思想是修改构建包中文件移动的逻辑，使其在尝试移动文件时更加灵活和健壮，例如进行条件性移动。目前，一个经过修复的构建包版本dougnukem/heroku-buildpack-go-revel已经解决了此问题。通过指定使用这个修复版的构建包，我们可以顺利地将Go Revel应用部署到Heroku。
部署Go Revel应用到Heroku的详细步骤
以下是使用修复版构建包部署Go Revel应用到Heroku的详细步骤：
1. 环境准备
首先，确保您的本地开发环境已正确配置Go，并设置了GOPATH环境变量。Heroku的构建过程依赖于Go模块和GOPATH的正确识别。
# 设置GOPATH，如果尚未设置 export GOPATH=$HOME/go # 创建GOPATH目录，如果不存在 mkdir -p $GOPATH
2. 获取Revel应用示例
为了演示部署过程，我们将使用一个Revel的helloworld示例应用。您可以将自己的Revel应用替换此步骤中的示例。
# 获取修复者提供的Revel helloworld示例应用 go get github.com/dougnukem/revel-helloworld # 切换到应用项目目录 cd $GOPATH/src/github.com/dougnukem/revel-helloworld
3. 创建Heroku应用
在Heroku上创建一个新的应用。这将生成一个远程Git仓库，您将代码推送到此仓库进行部署。
heroku create
执行此命令后，Heroku会为您创建一个随机命名的应用（例如peaceful-hamlet-6152），并自动将其Git远程仓库添加到您的本地仓库中。
4. 配置修复版构建包URL
这是解决部署问题的关键步骤。您需要告诉Heroku使用修复版的构建包，而不是默认或有问题的版本。
heroku config:set BUILDPACK_URL=https://github.com/dougnukem/heroku-buildpack-go-revel.git
这条命令会将BUILDPACK_URL环境变量设置为修复版构建包的Git仓库地址。Heroku在下次部署时会优先使用此URL指定的构建包。
5. 部署应用到Heroku
现在，您可以将本地的Revel应用代码推送到Heroku的远程仓库。Heroku将使用之前配置的修复版构建包来编译和部署您的应用。
git push heroku master
此过程可能需要几分钟，Heroku会下载Go、Revel依赖，编译您的应用，并最终启动它。
6. 验证部署
部署成功后，您可以打开浏览器访问您的Heroku应用，并查看应用日志以确认其正常运行。
# 在浏览器中打开您的Heroku应用 heroku open # 查看Heroku应用的实时日志，以便调试或确认启动状态 heroku logs --tail
如果一切顺利，您应该能在浏览器中看到Revel helloworld应用的欢迎页面，并且日志中不会出现mv相关的错误。
完整部署示例代码
以下是将上述所有命令整合在一起的完整示例：
# 1. 环境准备 export GOPATH=$HOME/go mkdir -p $GOPATH # 2. 获取Revel应用示例 go get github.com/dougnukem/revel-helloworld cd $GOPATH/src/github.com/dougnukem/revel-helloworld # 3. 创建Heroku应用 heroku create # 4. 配置修复版构建包URL (关键步骤) heroku config:set BUILDPACK_URL=https://github.com/dougnukem/heroku-buildpack-go-revel.git # 5. 部署应用到Heroku git push heroku master # 6. 验证部署 heroku open heroku logs --tail
注意事项与最佳实践
- 构建包状态更新： 在实际项目中，建议在部署前检查原始构建包robfig/heroku-buildpack-go-revel是否已合并相关修复（例如，检查其Pull Request #4是否已关闭并合并）。如果原始构建包已修复，则可以直接使用原始构建包，无需指定BUILDPACK_URL。
- Revel应用结构： 确保您的Revel应用遵循其标准的目录结构，以便构建包能够正确识别和处理。
- Heroku日志： 在遇到任何部署或运行时问题时，heroku logs --tail是您最重要的调试工具。仔细分析日志输出，可以帮助您定位问题。
- Go版本： Heroku构建包通常会安装特定版本的Go。如果您的应用依赖于某个特定Go版本，请确保构建包支持或可以配置。
- 依赖管理： 确保您的Go Revel应用使用Go Modules或其他合适的依赖管理方式，以便Heroku构建过程能够正确解析和下载所有依赖。
总结
通过利用社区提供的修复版构建包，Go Revel应用在Heroku上部署时遇到的mv: cannot stat错误可以被有效解决。本文详细阐述了从问题分析到具体部署步骤的完整流程，并提供了可直接执行的命令示例。开发者在享受Heroku便捷部署的同时，也应关注构建包的维护状态，并在必要时寻求或贡献社区解决方案，以确保项目的顺利进行。
