求助：Vercel Go Runtime无法访问本地二进制文件X的解决方法

核心原因 #

出现fork/exec ./X: no such file or directory错误，通常是以下三种情况导致：

• 二进制文件未被纳入Vercel的部署包
• 运行时工作目录与预期不符，相对路径失效
• 二进制文件架构与Vercel的Linux/amd64运行环境不兼容

具体解决方案 #

1. 确保二进制文件被Vercel包含 #

Vercel会默认忽略部分文件，先检查项目中的.vercelignore，确认X未被列入忽略列表。若要明确指定包含该文件，修改vercel.json：

{
  "functions": {
    "api/index.go": {
      "includeFiles": ["X"]
    }
  }
}

2. 使用绝对路径定位二进制文件 #

Vercel运行Go函数的工作目录并非固定为项目根目录，相对路径./X会失效。通过代码推导绝对路径：

import (
  "os"
  "path/filepath"
)

func main() {
  // 获取当前可执行文件所在目录
  exePath, err := os.Executable()
  if err != nil {
    // 错误处理逻辑
  }
  exeDir := filepath.Dir(exePath)
  // 从api目录向上一级找到根目录下的X
  cliPath := filepath.Join(exeDir, "../X")
  
  helpCmd := exec.Command(cliPath, "--help")
  // 后续执行逻辑
}

3. 编译适配Vercel环境的二进制文件 #

Vercel运行环境为Linux/amd64，若本地编译的X是其他架构（如macOS arm64、Windows amd64），即使文件存在也无法执行。在本地编译适配版本：

GOOS=linux GOARCH=amd64 go build -o X ./path/to/your/cli/source

将编译后的X提交到仓库再部署。

4. 调整文件位置简化路径 #

部署前将X复制到api目录下，这样在index.go中直接使用./X即可访问：

cp X api/

修改代码：

cliPath := "./X"
helpCmd := exec.Command(cliPath, "--help")

内容的提问来源于stack exchange，提问作者Abdullah Al Nahid