- 数据库默认文件 filecodebox.db → fileshare.db(config.go 默认值与全部文档/编排同步)
- Go module filecodebox → fileshare(全部 import 同步,build/vet/test 全绿)
- 应用版本 APP_VERSION 2.5.6 → 26.9(health 接口已验证返回 26.9)
- deploy 编排统一:compose 项目名、Postgres 默认凭据、minio 桶名、env 注释
- JWT issuer、存储临时目录前缀、web 包名同步 fileshare
- CI:镜像 tag 以 APP_VERSION 为唯一版本源,main/tag 推送即发布
${VER} + latest;tag 触发时校验 tag 名与 APP_VERSION 一致,防错版
- 本地开发库文件已改名 fileshare.db(含 -shm/-wal 清理)
76 lines
2.1 KiB
Go
76 lines
2.1 KiB
Go
package api
|
||
|
||
import (
|
||
"io/fs"
|
||
"net/http"
|
||
"path"
|
||
"strings"
|
||
|
||
"github.com/gin-gonic/gin"
|
||
|
||
"fileshare/internal/response"
|
||
web "fileshare/web"
|
||
)
|
||
|
||
// registerWeb 注册前端静态资源与 SPA 回退(必须最后注册):
|
||
// - 静态资源命中 web/dist 内文件则直接服务(带 Immutable 缓存,html 不缓存);
|
||
// - 未命中且为 GET/HEAD 且非 /api 前缀:回退 index.html(前端 history 路由
|
||
// /s/:code、/admin/*、/docs、/openapi 由 SPA 接管);
|
||
// - /api/* 未命中路由:JSON 404(避免调试时拿到 HTML 掩盖真实错误)。
|
||
func registerWeb(r *gin.Engine, d *Deps) {
|
||
dist, err := web.Dist()
|
||
if err != nil {
|
||
return // 嵌入异常时跳过(API 仍可用)
|
||
}
|
||
fileServer := http.StripPrefix("/", http.FileServer(http.FS(dist)))
|
||
indexHTML := readIndexHTML(dist)
|
||
|
||
r.NoRoute(func(c *gin.Context) {
|
||
p := c.Request.URL.Path
|
||
// 1. API 未命中:JSON 404
|
||
if strings.HasPrefix(p, "/api/") || p == "/api" {
|
||
response.Fail(c, http.StatusNotFound, "接口不存在")
|
||
return
|
||
}
|
||
// 2. 静态资源命中:直接服务
|
||
if p != "/" {
|
||
clean := strings.TrimPrefix(path.Clean(p), "/")
|
||
if clean != "" {
|
||
if f, err := dist.Open(clean); err == nil {
|
||
_ = f.Close()
|
||
fileServer.ServeHTTP(c.Writer, c.Request)
|
||
return
|
||
}
|
||
}
|
||
}
|
||
// 3. SPA 回退:仅 GET/HEAD 且接受 HTML
|
||
if c.Request.Method == http.MethodGet || c.Request.Method == http.MethodHead {
|
||
accept := c.GetHeader("Accept")
|
||
if accept == "" || strings.Contains(accept, "text/html") || strings.Contains(accept, "*/*") {
|
||
if indexHTML != nil {
|
||
c.Data(http.StatusOK, "text/html; charset=utf-8", indexHTML)
|
||
return
|
||
}
|
||
}
|
||
// 非 HTML 请求未命中:普通 404
|
||
c.Status(http.StatusNotFound)
|
||
return
|
||
}
|
||
c.Status(http.StatusNotFound)
|
||
})
|
||
}
|
||
|
||
// readIndexHTML 读取嵌入的 index.html(SPA 回退用)。
|
||
func readIndexHTML(dist fs.FS) []byte {
|
||
f, err := dist.Open("index.html")
|
||
if err != nil {
|
||
return nil
|
||
}
|
||
defer func() { _ = f.Close() }()
|
||
data, err := fs.ReadFile(dist, "index.html")
|
||
if err != nil {
|
||
return nil
|
||
}
|
||
return data
|
||
}
|