Gin框架项目CSS文件无法加载，已排查常见问题仍未解决

结合你已经排查的几点，以下是几个容易被忽略的原因及解决办法：

• Gin未配置静态资源路由映射
  Gin不会自动识别静态资源目录，必须通过Static或StaticFS方法手动映射。假设你的CSS文件路径是front/assets/css/style.css，需要在启动代码中添加：

  r := gin.Default()
  // 将URL路径"/assets"映射到本地目录"./front/assets"
  r.Static("/assets", "./front/assets")
  

  没有这条配置的话，浏览器请求CSS时会返回404，直接导致加载失败。

• HTML引用路径与路由映射不匹配
  若Gin配置的是/assets映射到front/assets，HTML中必须用/assets/css/style.css引用CSS，而不是/front/assets/css/style.css。URL路径必须和Gin路由配置的前缀完全对应。

• 程序启动时的工作目录错误
  如果启动Gin项目的工作目录不是项目根目录，相对路径会失效。比如在project/cmd目录下启动程序，./front/assets会指向cmd/front/assets而非根目录下的front/assets。可以改用绝对路径解决：

  import (
      "path/filepath"
      "os"
      "github.com/gin-gonic/gin"
  )
  
  func main() {
      r := gin.Default()
      // 获取当前程序的根目录
      exePath, _ := os.Executable()
      rootDir := filepath.Dir(exePath)
      // 拼接正确的静态资源路径
      staticPath := filepath.Join(rootDir, "../front/assets")
      r.Static("/assets", staticPath)
  }
  

  或者启动程序前先切换到项目根目录。

• 路由优先级冲突
  若你定义了和静态资源路由冲突的自定义路由（比如r.GET("/assets/*path", ...)），自定义路由会优先匹配，拦截静态资源请求。需要确保静态资源路由的配置放在所有自定义路由之前。

• 父目录权限不足
  即使CSS文件权限正常，若front或assets父目录的权限设置为仅所有者可访问（如700），而运行Gin的用户不是目录所有者，也会无法读取文件。可以执行chmod -R 755 front调整目录权限。

• 嵌入静态资源的配置错误（使用go:embed时）
  若你将静态资源嵌入二进制文件，可能是//go:embed指令路径错误，或未正确使用fs.Sub获取子目录。正确示例：

  import (
      "embed"
      "io/fs"
      "net/http"
      "github.com/gin-gonic/gin"
  )
  
  //go:embed front/assets/*
  var assetsFS embed.FS
  
  func main() {
      r := gin.Default()
      // 从嵌入的FS中获取front/assets子目录
      subFS, _ := fs.Sub(assetsFS, "front/assets")
      r.StaticFS("/assets", http.FS(subFS))
  }
  

  若未正确使用fs.Sub，Gin会无法定位到嵌入的CSS文件。

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