使用Go Chi框架托管静态文件始终返回404错误如何解决

配置存在两个核心问题，直接导致静态资源返回404：

• 静态文件根路径配置错误
  代码中http.Dir("./static/")指向的是程序启动时工作目录下的static文件夹，但实际静态文件存放在项目根目录下的root/static/路径，路径完全不匹配，文件服务器无法定位到目标文件。

  注意：Go语言中http.Dir使用相对路径时，基准路径是执行启动命令时终端所在的工作目录，而非源码文件所在目录，这是静态文件配置最常见的踩坑点。

• 前缀剥离配置不规范
  代码中http.StripPrefix("/static", fileServer)的前缀未加尾斜杠，和路由/static/*的匹配规则存在适配问题，极端场景下会出现路径拼接异常。

1. 修正文件服务器根路径
   根据你实际的静态文件存放位置调整http.Dir参数：
   • 如果静态文件确实存放在项目根的root/static目录下，将代码改为：

     fileServer := http.FileServer(http.Dir("./root/static"))
     

   • 如果你是笔误，实际想把静态文件放在项目根目录下的static文件夹（即路径为项目根/static/breakfast.jpg），要么把现有root/static下的所有文件移动到项目根的static文件夹，要么保持路径配置为./static即可。
2. 规范前缀剥离配置
   将StripPrefix的参数补全尾斜杠，和路由规则对齐，修改后的完整路由配置代码如下：

   mux := chi.NewRouter()    
   mux.Get("/", handlers.Repo.Home)
   // 注意此处Dir路径根据你实际的静态文件存放位置调整
   fileServer := http.FileServer(http.Dir("./root/static"))
   mux.Handle("/static/*", http.StripPrefix("/static/", fileServer))
   

3. （可选）规避工作目录问题
   如果你经常在非项目根目录启动服务（比如在cmd/web目录下执行go run main.go），相对路径会失效，建议使用项目绝对路径初始化文件服务器，或者启动服务前先切换到项目根目录执行命令。

修改完成后重启服务，先直接访问http://localhost:3001/static/breakfast.jpg，如果能正常加载图片，再刷新首页即可看到img标签正常显示图片。

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