这两天在 Linux 环境部署一个 Go 项目遇到一个报错：copy_file_range: bad file descriptor。网上查找各种方法，花了两天的时间，经过一番折腾后才解决，觉得非常有必要记录一下过程。

一、问题复现

安装完 Go、配置完 Go 环境以及 Beego 框架运行 Go 项目，一直报下面的错：

期间经过 Go 卸载重装、代码修改等一系列网上查找的解决方法，都无济于事，最终通过降 Go 版本成功运行项目，解决此问题。

二、解决方法

1. Linux 环境卸载 Go

先执行 go env 查看 GOROOT，我的 GOROOT=/usr/local/go，进入 /usr/local，删除 go 文件夹。

执行以下命令（因为我是在超级管理员下进行操作的，因此命令最前面不需要加 sudo）

rm -rf /usr/local/go

删除软链接：

rm /usr/bin/go /usr/bin/gofmt

2. Linux 环境安装 Go

首先使用 wget 下载 Go 安装包（因项目需要，我下的是 arm 架构下的 Go 版本）

附上一个 Go 安装包下载地址：Go下载 - Go语言中文网 - Golang中文社区 (studygolang.com)

wget https://studygolang.com/dl/golang/go1.14.12.linux-arm64.tar.gz

解压安装包：

tar -xzf go1.14.12.linux-arm64.tar.gz -C /usr/local

建立软链接：

ln -s /usr/local/go/bin/* /usr/bin/

查看 Go 版本：

go version

3. 设置 Go 开发环境

在合适的位置创建工作空间和子目录，实例如下：

mkdir -p $HOME/go/src
mkdir -p $HOME/go/pkg
mkdir -p $HOME/go/bin

因为我之前文件夹下有 pkg 和 bin 这两个文件夹，所以就只创建了 src 文件夹，如下图：

4. 配置环境变量

使用 vi 编辑环境变量配置文件 $HOME/.bashrc ：

vim $HOME/.bashrc

进入编辑页面然按 i，移动到代码末尾，插入以下内容：

export GOROOT=/usr/local/go  #设置为go安装的路径，有些安装包会自动设置默认的goroot
export GOPATH=$HOME/go   #默认的Golang项目的工作空间
export GOBIN=$GOPATH/bin   # go install命令生成的可执行文件的路径
export PATH=$PATH:$GOROOT/bin:$GOBIN

之后按 Esc 键，输入 :wq 保存退出。

使配置文件生效：

source $HOME/.bashrc

可运行 go env 查看 Go 环境变量：

go env

下图是我配置完的 Go 环境变量，主要注意着画红线的这三个配置：

5. 安装 Beego

执行命令：

go get github.com/astaxie/beego

安装 bee 工具执行命令：

go get github.com/beego/bee

通常都会安装成功，但也不排除特殊情况，比如我。此时试一下这行命令：

go get -u github.com/beego/bee

神奇地发现安装成功了。

这里可能也会遇到 timeout 的问题，可以参考一下我的这篇文章：goproxy 模块代理，解决 timeout 问题。

进入项目目录，然后运行：

bee run

发现项目成功运行：

三、原因

授人以鱼不如授人以渔，找到成功解决的方法当然是建立在找到问题原因的基础上。

经过我的一番查阅资料，发现是因为我之前安装的 Go 是 1.15.5 版本，而这篇文章 Go 1.15中值得关注的几个变化 | Tony Bai 提到：

我的理解就是：Go 1.11 - Go 1.14 的版本运行 Go 项目应该是需要这个 go.mod 文件。

而 Go 1.15 版本则是通过环境变量里的这个来实现的：

因为项目是在 Go 1.15 之前的版本下开发的，因此 /pkg/mod 下可能没有需要的文件，因此导致项目运行不起来，不知道我的理解对不对，献丑了。

可以看到下图 Go 1.14 中的环境变量，是没有 GOMODCACHE 这一条的。

四、致谢

golang bad file descriptor_benben的博客-CSDN博客：此文章的方法不适用于我这个问题，但是也要感谢作者写的此篇文章。

linux下go安装/卸载重装：此文章的卸载 Go 方法有用到。

Linux下Go的安装、配置 、升级和卸载：此文章的安装与卸载 Go 方法有用到。

linux安装golang 以及beego框架：此文章的安装 beego 与 bee 工具方法有用到。

Go 1.15中值得关注的几个变化 | Tony Bai：此文章找到了问题所在：是 Go 版本不同导致的。