1. 问题背景与常见错误
在使用go语言开发thrift服务时，通常需要先编译apache thrift框架，使其支持go语言代码生成和运行时库。新手在尝试从git仓库克隆最新代码并进行编译时，可能会遇到以下错误：
Making all in go ... src/thrift/tiostream_transport.go:23:2: import "bufio": cannot find package src/thrift/tframed_transport.go:23:2: import "bytes": cannot find package ... package thrift imports runtime: import "runtime": cannot find package ... make[4]: *** [check-local] Error 1 make[3]: *** [check-am] Error 2 ... make: *** [all] Error 2
这类错误的核心表现是Go编译器在编译Thrift的Go语言部分时，无法找到Go标准库中的包（如bufio, bytes, fmt, runtime等）。这通常是由于以下一个或多个原因造成的：
- Go环境配置不正确： GOROOT或GOPATH环境变量设置有误，导致Go工具链无法正确找到标准库或项目依赖。
- Thrift源代码问题： 从Git仓库克隆的代码可能处于开发阶段，存在不稳定性或特定版本依赖问题，导致Go语言部分的构建失败。
2. 解决方案：正确配置与稳定版本
解决上述问题的关键在于使用官方发布的稳定版Thrift源代码包，并确保Go语言环境配置无误。
2.1 准备Go语言环境
在开始编译Thrift之前，请确保您的Go语言环境已正确安装和配置。这包括设置GOROOT和GOPATH。
- GOROOT: 必须指向Go SDK的安装根目录。例如，如果您将Go安装在/usr/local/go，那么GOROOT就应该设置为/usr/local/go。切勿将其设置为/usr或Go二进制文件的目录。
- GOPATH: 是您的Go工作区目录，所有Go项目代码和依赖都应组织在这个目录下。例如，GOPATH可以设置为您的用户主目录下的go文件夹（如~/go）。
您可以通过go env命令检查当前的Go环境变量配置：
立即学习“go语言免费学习笔记（深入）”；
go env
一个正确的Go环境输出示例可能如下：
GOARCH="amd64" GOBIN="/home/user/bin" GOCHAR="6" GOEXE="" GOGCCFLAGS="-g -O2 -fPIC -m64 -pthread" GOHOSTARCH="amd64" GOHOSTOS="linux" GOOS="linux" GOPATH="/home/user/go" # 确保这里指向您的Go工作区 GOROOT="/usr/local/go" # 确保这里指向Go SDK安装根目录 GOTOOLDIR="/usr/local/go/pkg/tool/linux_amd64" CGO_ENABLED="1"
2.2 下载Apache Thrift官方稳定版
强烈建议从Apache Thrift的官方发布页面下载稳定版本的源代码包（.tar.gz格式），而不是直接从Git仓库克隆。官方发布版经过了严格测试，通常更为稳定和可靠。
以Thrift 0.9.0为例，您可以从以下地址下载：
wget https://dist.apache.org/repos/dist/release/thrift/0.9.0/thrift-0.9.0.tar.gz
下载完成后，解压源代码包：
tar -zxvf thrift-0.9.0.tar.gz cd thrift-0.9.0
2.3 编译Apache Thrift（支持Go语言）
进入解压后的Thrift目录，按照以下步骤进行编译：
-
运行bootstrap.sh： 这个脚本会生成configure脚本和一些必要的构建文件。
./bootstrap.sh
-
配置编译选项： 使用configure脚本配置Thrift的编译选项。为了支持Go语言，需要添加--with-go参数。您还可以根据需要禁用其他语言支持（例如--without-python，--without-csharp等），以减少编译时间和依赖。
./configure --with-go --without-python --without-csharp
重要提示： 在运行configure之前，请确保您的GOROOT和GOPATH环境变量已经正确设置并导出到当前shell会话中。configure脚本会检查Go环境。
-
执行make编译： 运行make命令开始编译Thrift及其Go语言绑定。
make
如果一切配置正确，make过程将顺利完成，不再出现“cannot find package”等Go相关的编译错误。
-
安装Thrift（可选）： 编译成功后，您可以选择运行make install将Thrift编译器和库安装到系统路径中。
sudo make install
安装后，thrift命令行工具将可在任何位置调用。Go语言的运行时库通常会被安装到$GOROOT/lib/go/src/thrift或类似位置，或者您可以手动将其符号链接到$GOPATH/src/thrift，以便Go项目可以找到。
3. 示例构建脚本
为了简化上述步骤，您可以编写一个简单的shell脚本来自动化整个过程。请根据您的实际情况调整GOROOT和GOPATH的路径。
#!/bin/bash
# 确保Go环境已正确设置
# 假设Go SDK安装在 /usr/local/go
export GOROOT=/usr/local/go
# 假设Go工作区在用户主目录下的go文件夹
export GOPATH=$HOME/go
# 检查Go环境是否可用
if ! command -v go &> /dev/null
then
echo "Go command not found. Please ensure Go is installed and GOROOT/GOPATH are set correctly."
exit 1
fi
echo "Current Go environment:"
go env
# 下载并解压Thrift (如果尚未下载)
THRIFT_VERSION="0.9.0"
THRIFT_TARBALL="thrift-${THRIFT_VERSION}.tar.gz"
THRIFT_DIR="thrift-${THRIFT_VERSION}"
THRIFT_DOWNLOAD_URL="https://dist.apache.org/repos/dist/release/thrift/${THRIFT_VERSION}/${THRIFT_TARBALL}"
if [ ! -f "$THRIFT_TARBALL" ]; then
echo "Downloading Thrift $THRIFT_VERSION..."
wget "$THRIFT_DOWNLOAD_URL"
fi
if [ ! -d "$THRIFT_DIR" ]; then
echo "Extracting $THRIFT_TARBALL..."
tar -zxvf "$THRIFT_TARBALL"
fi
cd "$THRIFT_DIR" || { echo "Failed to enter Thrift directory."; exit 1; }
# 执行编译步骤
echo "Running bootstrap.sh..."
./bootstrap.sh
echo "Configuring Thrift with Go support..."
# 根据需要调整 --without-* 选项
./configure --with-go --without-python --without-csharp --without-java --without-cpp --without-nodejs --without-perl --without-php --without-ruby --without-erlang --without-lua --without-dart --without-d --without-delphi --without-haxe --without-netcore --without-netstd --without-c_glib --without-php_extension
echo "Compiling Thrift..."
make
if [ $? -eq 0 ]; then
echo "Thrift compilation successful!"
echo "Optionally, run 'sudo make install' to install Thrift globally."
# 如果需要，可以将Go语言运行时库链接到GOPATH中
# echo "Linking Thrift Go library to GOPATH..."
# mkdir -p "$GOPATH/src/thrift"
# ln -s "$(pwd)/lib/go/src/thrift" "$GOPATH/src/thrift"
# go install thrift
else
echo "Thrift compilation failed. Please check the logs for errors."
fi
4. 注意事项
- Go版本兼容性： 确保您使用的Go版本与Thrift版本兼容。对于较老的Thrift版本（如0.9.0），可能需要Go 1.x系列版本。
- thrift4go项目： 原问题中提及的thrift4go是Thrift的一个Go语言实现，通常指的是将Thrift生成的Go代码放入$GOPATH/src/github.com/pomack/thrift4go这样的路径下。本教程主要关注的是如何正确编译Apache Thrift工具链本身以支持Go，而不是thrift4go这个特定的Go库。一旦Thrift编译器构建完成，您就可以使用它生成Go代码，并将这些代码与thrift4go或Thrift官方Go运行时库结合使用。
- 清理构建环境： 如果编译失败，尝试运行make clean或make distclean来清理之前生成的中间文件，然后重新执行./bootstrap.sh和./configure。
- 依赖安装： 确保您的系统安装了所有必要的构建依赖，例如automake, libtool, pkg-config等。在基于Debian的系统上，可以使用sudo apt-get install automake libtool pkg-config进行安装。
5. 总结
在Go语言环境下编译Apache Thrift时，最常见的“cannot find package”错误通常源于Go环境变量配置不当或使用了不稳定的Thrift源代码。通过遵循本指南，即使用官方发布的稳定版Thrift源代码包，并严格检查和配置GOROOT和GOPATH，您可以有效避免这些问题，顺利完成Thrift的编译，为您的Go语言项目集成Thrift RPC服务打下坚实的基础。
