部署Flutter Web至AWS EC2时遇flutter.js语法错误，求解决方案

核心问题是Go服务器未正确处理静态文件请求：浏览器请求flutter.js等静态资源时，服务器错误返回了index.html内容（首行的<字符触发语法错误）。虽然EC2上的静态文件本身无误，但路由或静态服务配置错误导致资源无法正确返回。

排查与修复步骤 #

1. 检查Go服务器静态文件服务配置 #

确保静态文件路由优先级高于API路由，避免资源请求被错误路由：

• 若使用net/http包：

  // 先注册静态文件服务，再处理API路由
  http.Handle("/", http.FileServer(http.Dir("./build/web"))) // Flutter Web构建产物目录
  http.HandleFunc("/api/your-endpoint", yourAPIFunction)
  

• 若使用Gin框架：

  r := gin.Default()
  r.Static("/", "./build/web") // 映射静态文件目录
  // 之后注册API路由
  r.GET("/api/your-endpoint", yourAPIFunction)
  

2. 验证Flutter Web的base href配置 #

检查index.html中的<base href>设置：

• 根路径部署时，确保值为<base href="/">（末尾斜杠不能省略）；
• 若部署在子路径下（如http://EC2-IP/app/），需改为对应路径，比如<base href="/app/">。

3. 确认CodePipeline部署脚本完整性 #

确保部署脚本完整复制Flutter Web的build/web目录（包括子目录）到EC2：

• 使用cp -r而非cp，避免遗漏assets等子目录：

  cp -r /path/to/local/build/web/* /path/to/ec2/server/static/
  

4. 修正Go服务器的静态文件路径 #

避免使用相对路径引发的工作目录问题，优先用绝对路径：

// EC2上静态文件的绝对路径
staticDir := "/var/www/flutter-web/build/web"
http.Handle("/", http.FileServer(http.Dir(staticDir)))

5. 排查404 fallback逻辑 #

若服务器配置了SPA路由的404 fallback（返回index.html），需确保路径拼接正确：

• 错误示例（路径拼接缺失斜杠）：

  // 会导致路径变成 ./build/webflutter.js，触发404返回index.html
  _, err := os.Stat("./build/web" + r.URL.Path)
  

• 正确写法：

  _, err := os.Stat("./build/web/" + r.URL.Path)
  if os.IsNotExist(err) {
      http.ServeFile(w, r, "./build/web/index.html")
      return
  }
  http.FileServer(http.Dir("./build/web")).ServeHTTP(w, r)
  

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