本文探讨go程序通过upstart启动时遇到的常见“包找不到”错误，主要原因在于upstart脚本未能正确设置或继承gopath环境变量。文章提供了两种主要解决方案：一是推荐将go程序预编译成独立二进制文件运行，避免gopath依赖；二是演示如何在upstart脚本中显式配置gopath，确保程序在正确的环境中执行，从而解决启动问题。
Go程序Upstart启动失败原因分析
当我们在终端中手动运行Go程序，例如使用go run main.go时，当前的shell环境通常已经配置了GOPATH环境变量。GOPATH是Go语言工作区的重要组成部分，它告诉Go编译器在哪里查找项目源码、第三方包以及编译后的二进制文件。当Go程序需要导入其他模块（如print.io/geodomain）时，它会依据GOPATH来解析这些导入路径。
然而，当通过进程管理器（如Upstart）启动Go程序时，Upstart脚本通常在一个相对“干净”的环境中执行，它不会自动继承用户shell中设置的所有环境变量，包括GOPATH。因此，尽管Upstart脚本能够切换到正确的项目目录（例如chdir ~/go/src/print.io/geo/），但当exec go run main.go命令被执行时，go工具无法找到GOPATH，进而无法解析项目内部的导入路径，最终导致“cannot find package”错误。
解决方案一：编译为独立二进制文件运行
这是在生产环境中运行Go程序的推荐方法。通过go build命令将Go源代码编译成一个独立的二进制可执行文件，这个文件在运行时不再需要GOPATH环境变量来解析其内部依赖。它包含了所有必要的代码和运行时信息。
1. Go Build 命令
首先，在您的Go项目目录下（通常是~/go/src/print.io/geo/），执行以下命令编译您的程序：
cd ~/go/src/print.io/geo/ go build -o myapp .
这里的-o myapp指定了输出的二进制文件名为myapp，.表示编译当前目录下的Go源文件。编译成功后，您将在当前目录得到一个名为myapp的可执行文件。
2. Upstart 配置示例
将Upstart脚本修改为直接执行这个编译好的二进制文件。
本文档主要讲述的是eclipse maven工程配置说明；编写本文的目的解决因环境问题带来的一系别问题，比如类没找到异常，JAR新旧并成，导致有些方法不可用，支持热拔插式的修改，当调试程序时，修改后不用重启tomcat等问题；感兴趣的朋友可以过来看看
description "go-server"
author "micah smith"
start on (net-device-up
and local-filesystems
and runlevel [2345])
stop on runlevel [!2345]
respawn
script
# 切换到二进制文件所在的目录，或者使用绝对路径
chdir ~/go/src/print.io/geo/
# 执行编译好的二进制文件
exec ./myapp
end script优点：
- 独立性强： 运行时无需GOPATH，环境依赖更少。
- 启动速度快： 省去了go run在每次启动时进行的编译步骤。
- 部署简便： 只需分发一个二进制文件即可。
解决方案二：在Upstart脚本中显式设置GOPATH
如果由于某些原因（例如，希望每次启动都使用最新的源码，或者不方便预编译），您仍然希望通过go run来启动程序，那么您需要在Upstart脚本中显式地设置GOPATH环境变量。
Upstart 配置示例
在script块的开头添加env GOPATH=/path/to/your/go/dir来设置GOPATH。请确保/path/to/your/go/dir是您实际的Go工作区根目录（例如，示例中的/go）。
description "go-server"
author "micah smith"
start on (net-device-up
and local-filesystems
and runlevel [2345])
stop on runlevel [!2345]
respawn
script
# 显式设置GOPATH环境变量
env GOPATH=/go
# 切换到程序主目录
chdir ~/go/src/print.io/geo/
# 执行go run命令
exec go run main.go
end script注意事项：
- GOPATH的准确性： 确保env GOPATH指向的路径是正确的Go工作区根目录。在示例中，如果/go是您的GOPATH，那么/go/src/print.io/geo/就是正确的项目路径。
- 用户上下文： Upstart服务通常以root用户或特定服务用户运行。确保~/go/这样的路径对于运行服务的用户是可访问的，或者使用绝对路径如/home/youruser/go。
最佳实践与总结
- 生产环境推荐： 对于生产部署，强烈推荐使用解决方案一，即预编译Go程序为独立二进制文件。这不仅解决了GOPATH问题，还提高了启动效率和部署的可靠性。
- 日志管理： 无论采用哪种方案，都应考虑将程序的标准输出和标准错误重定向到日志文件，以便于问题排查和监控。Upstart脚本可以通过exec >> /var/log/go-server.log 2>&1来实现简单的日志记录。
- Upstart与Systemd： 值得注意的是，在较新的Linux发行版中，Systemd已经取代了Upstart成为主流的初始化系统。如果您正在使用较新的系统，建议考虑使用Systemd来管理您的Go服务，其配置环境变量和管理服务的方式与Upstart有所不同，但核心思想（确保程序运行在正确的环境中）是相同的。
通过理解Upstart服务与用户shell环境之间的差异，并采取相应的措施（编译二进制或显式设置环境变量），您可以有效地解决Go程序通过Upstart启动时遇到的“包找不到”问题，确保您的服务稳定运行。
