使用gorilla/mux托管HTML静态文件 本地正常AWS Ubuntu部署返回404如何解决

常见触发原因 #

• 相对路径上下文不匹配：代码中使用的./views/是相对路径，本地运行时你是在项目根目录启动二进制，路径可以正确匹配到views目录。部署到Ubuntu服务器后如果在其他工作目录启动二进制、用systemd等服务管理工具未指定工作目录、或者部署时未将views目录放到二进制同级目录，就会导致程序找不到目标静态文件目录，返回404。
• 文件权限不足：Ubuntu系统的文件权限管控严格，运行Go应用的系统用户（如服务配置的www-data、普通运行用户等）如果没有./views目录及目录下文件的可读权限，http.FileServer无法读取资源就会返回404。
• 路由优先级冲突：如果使用gorilla/mux等第三方路由库，根路径的PathPrefix路由优先级低于其他精确匹配的路由，或者路由规则顺序错误，也可能导致静态资源请求被其他路由拦截，返回404。

对应修复方案 #

• 消除相对路径依赖
  1. 部署时明确指定views目录的绝对路径，代码中通过配置项、环境变量读取该路径传入http.Dir()，避免相对路径的上下文差异。如果使用systemd管理服务，可以在service配置文件中通过WorkingDirectory参数指定项目根目录。
  2. 也可以使用Go 1.16+内置的embed包将views目录直接编译进二进制文件，彻底避免路径依赖，示例代码：

  import "embed"
  
  //go:embed views/*
  var viewsFS embed.FS
  
  // 路由配置调整为
  router.PathPrefix("/").Handler(http.FileServer(http.FS(viewsFS)))
  

• 修正目录权限：给views目录及子文件配置正确的访问权限，假设views目录绝对路径为/opt/your_app/views，运行应用的用户为appuser，执行以下命令：

  sudo chown -R appuser:appuser /opt/your_app/views
  sudo chmod -R 755 /opt/your_app/views
  sudo chmod -R 644 /opt/your_app/views/*
  

• 添加路径调试日志：在代码中加入调试日志确认路径匹配情况，部署后查看日志即可快速定位路径问题：

  pwd, _ := os.Getwd()
  log.Println("当前工作目录：", pwd)
  absPath, _ := filepath.Abs("./views/")
  log.Println("views目录绝对路径：", absPath)
  

• 调整路由规则：调整路由顺序保证静态资源路由优先级，也可以单独匹配首页路由避免异常：

  // 优先匹配首页请求
  router.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
      http.ServeFile(w, r, filepath.Join(viewsPath, "index.html"))
  })
  // 匹配其他静态资源
  router.PathPrefix("/").Handler(http.FileServer(http.Dir(viewsPath)))
  

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