Vercel部署Go服务时无法将静态文件纳入构建目录求助

问题分析 #

你的includeFiles配置路径逻辑上没问题，但Vercel编译后二进制的运行目录和本地开发环境不同，导致程序找不到静态文件。另外需要确认includeFiles的路径匹配是否生效，以及程序中读取静态文件的路径是否适配Vercel的部署结构。

修正步骤 #

• 验证includeFiles路径匹配
  确保public/**/*能覆盖所有需要的静态文件，若有更深层级的子目录，这个通配符是有效的，但可以尝试更明确的路径（比如public/assets/**/*）测试是否能正常包含文件。

• 调整程序中静态文件的读取路径
  Vercel编译完成后，二进制文件会被放在.vercel/output/functions/[function-name]目录下，includeFiles指定的文件会同步到同一个目录。所以你的Go程序不能用本地的相对路径（比如./public/xxx），要通过动态获取运行目录来拼接路径：

  import (
      "os"
      "path/filepath"
  )
  
  func getStaticFilePath(filename string) string {
      // 获取当前二进制文件的运行目录
      exePath, err := os.Executable()
      if err != nil {
          panic(err)
      }
      exeDir := filepath.Dir(exePath)
      // 拼接静态文件路径，此时public下的文件已和二进制同目录
      return filepath.Join(exeDir, filename)
  }
  

  比如原来读取public/index.html，现在要改用getStaticFilePath("index.html")。

• 优化vercel.json配置
  注意routes的dest应该指向编译后的二进制文件名（默认是和main.go同名的main），而不是原Go文件路径，调整后的配置如下：

  {
    "builds": [
      {
        "src": "cmd/serverless/main.go",
        "use": "@vercel/go",
        "config": {
          "includeFiles": [
            "public/**/*"
          ]
        }
      }
    ],
    "routes": [
      {
        "src": "/(.*)",
        "dest": "/cmd/serverless/main"
      }
    ]
  }
  

• 本地模拟部署测试
  使用vercel dev命令本地模拟Vercel部署环境，查看静态文件是否被正确复制到二进制的运行目录，同时测试程序是否能正常读取文件。

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