无法上传源码到测试服务器时如何编译启用-race的Go二进制文件

核心逻辑 #

Go语言使用-race参数编译时，会直接将竞争检测逻辑内置到输出的二进制文件中，运行时不需要依赖源码、也不需要额外加启动参数，只需要本地编译时匹配测试服务器的运行环境即可。

具体操作步骤 #

• 提前确认测试服务器的操作系统（对应编译参数GOOS）和CPU架构（对应编译参数GOARCH），常用组合为linux/amd64、linux/arm64等
• 本地安装对应目标平台的CGO交叉编译链（竞争检测依赖CGO，必须开启CGO_ENABLED=1才能编译成功）
• 执行交叉编译命令，以目标环境为linux amd64为例，命令如下：

  CGO_ENABLED=1 GOOS=linux GOARCH=amd64 go build -race -o 可执行文件名 入口包路径
  

• 将编译完成的可执行文件上传到测试服务器，直接正常启动即可，运行过程中如果检测到数据竞争，相关日志会自动输出到标准错误流

注意事项 #

• 开启竞争检测的二进制运行性能相比正常版本下降2_{10倍，内存占用提升2}5倍，仅可用于测试环境，禁止用于生产环境
• 交叉编译时如果目标环境和本地开发环境不一致，必须确保交叉编译链配置正确，否则会出现二进制无法运行的问题
• 竞争检测日志会自动记录发生数据竞争的具体代码位置、goroutine调用栈，可直接用于问题定位

内容的提问来源于stack exchange，提问作者daisy