fix(路由): 修复前端单页应用路由404问题

dengmengmian · dengmengmian · commit e59067525dd4 · 2026-02-06T16:31:46.000+08:00
- 修改 embed.FS 指令以正确包含前端静态资源
- 在 NoRoute 处理中区分静态资源、API 请求和前端路由
- 对于前端路由请求，直接返回内存中的 index.html 内容
- 更新前端构建生成的资源文件名
diff --git a/gotribe-admin.go b/gotribe-admin.go
@@ -45,7 +45,7 @@ import (
 	"github.com/fatih/color"
 )
 
-//go:embed web/admin/dist/*
+//go:embed all:web/admin/dist
 var content embed.FS
 
 func main() {
diff --git a/internal/app/routes/routes.go b/internal/app/routes/routes.go
@@ -12,6 +12,7 @@ import (
 	"gotribe-admin/internal/pkg/common"
 	"gotribe-admin/internal/pkg/middleware"
 	"net/http"
+	"strings"
 	"time"
 
 	jwt "github.com/appleboy/gin-jwt/v2"
@@ -90,10 +91,32 @@ func setupStaticFiles(r *gin.Engine, fs embed.FS) {
 		return
 	}
 
+	// 1. 尝试从 embed.FS 中读取 index.html 内容
+	// 注意：这里需要使用完整的嵌入路径
+	indexData, err := fs.ReadFile("web/admin/dist/index.html")
+	if err != nil {
+		common.Log.Errorf("读取 index.html 失败：%v", err)
+	}
+
+	// 2. 静态资源服务 (处理 /assets, /favicon.ico 等)
 	r.Use(static.Serve("/", embedFS))
+
+	// 3. SPA 兜底处理
 	r.NoRoute(func(c *gin.Context) {
-		common.Log.Infof("A 404 error occurred, but the specific URL path is not logged to prevent log injection.")
-		c.Redirect(http.StatusMovedPermanently, "/")
+		path := c.Request.URL.Path
+		// 如果是静态资源请求（以/assets/开头）或API请求，返回404
+		if strings.HasPrefix(path, "/assets/") || strings.HasPrefix(path, "/api/") || strings.HasPrefix(path, "/swagger/") {
+			c.AbortWithStatus(http.StatusNotFound)
+			return
+		}
+
+		// 对于前端路由，直接返回内存中的 index.html 内容
+		if len(indexData) > 0 {
+			c.Header("Content-Type", "text/html; charset=utf-8")
+			c.String(http.StatusOK, string(indexData))
+		} else {
+			c.String(http.StatusNotFound, "Index file not found")
+		}
 	})
 }
 
diff --git a/web/admin/dist/index.html b/web/admin/dist/index.html
@@ -13,7 +13,7 @@
       href="https://fonts.googleapis.com/css2?family=Inter:ital,opsz,wght@0,14..32,100..900;1,14..32,100..900&family=Manrope:wght@200..800&display=swap"
       rel="stylesheet"
     />
-    <script type="module" crossorigin src="/assets/index-BDEUfSoP.js"></script>
+    <script type="module" crossorigin src="/assets/index-Dz7RJ6Rz.js"></script>
     <link rel="stylesheet" crossorigin href="/assets/index-vsRf-QNN.css">
   </head>
   <body>

Original file line number	Diff line number	Diff line change
`@@ -45,7 +45,7 @@ import (`
`45`	`45`	`"github.com/fatih/color"`
`46`	`46`	`)`
`47`	`47`
`48`		`-//go:embed web/admin/dist/*`
	`48`	`+//go:embed all:web/admin/dist`
`49`	`49`	`var content embed.FS`
`50`	`50`
`51`	`51`	`func main() {`