SvelteKit 静态部署路由故障排除与服务器配置指南

package main

import (
    "net/http"
    "os"
    "path/filepath"

    "github.com/gin-gonic/gin"
)

func main() {
    router := gin.Default()

    // 1. 服务 SvelteKit 构建的静态资产 (例如 _app 目录, static 目录)
    // 确保这些路径与 svelte.config.js 中的配置一致
    router.StaticFS("/_app", http.Dir("./build/_app"))
    // 如果 SvelteKit 项目中有 static 目录，也需要服务
    router.StaticFS("/static", http.Dir("./build/static")) 

    // 2. 服务根路径的 index.html
    router.GET("/", func(c *gin.Context) {
        c.File("./build/index.html")
    })

    // 3. 处理所有其他未匹配的路由
    router.NoRoute(func(c *gin.Context) {
        requestPath := c.Request.URL.Path

        // 尝试查找对应的预渲染 HTML 文件 (例如 /about -> ./build/about.html)
        // 注意：SvelteKit默认在构建根目录生成，所以路径拼接需要注意
        htmlFilePath := filepath.Join("./build", requestPath+".html")

        // 检查文件是否存在
        if _, err := os.Stat(htmlFilePath); err == nil {
            c.File(htmlFilePath)
            return
        }

        // 如果没有找到特定的 .html 文件，则回退到 index.html
        // 这允许 SvelteKit 的客户端路由器处理动态路由或未预渲染的路由
        c.File("./build/index.html")
    })

    router.Run(":5555") // 监听端口
}

server {
    listen 80;
    server_name yourdomain.com;

    root /path/to/your/build; # SvelteKit build 目录的路径

    index index.html;

    location / {
        # 尝试查找对应的 .html 文件 (例如 /about -> /about.html)
        # 如果不存在，尝试查找目录下的 index.html (例如 /nested/ -> /nested/index.html)
        # 最后回退到根目录的 index.html (SPA 模式)
        try_files $uri $uri.html $uri/ /index.html; 
    }

    # 也可以显式定义重写规则，但 try_files 更简洁
    # rewrite ^/(.*)$ /$1.html last;
}

package main

import (
    "net/http"
    "github.com/gin-gonic/gin"
)

func main() {
    router := gin.Default()

    // 服务 SvelteKit 构建的静态资产
    router.StaticFS("/_app", http.Dir("./build/_app"))
    router.StaticFS("/static", http.Dir("./build/static"))

    // 根路径直接服务 index.html
    router.GET("/", func(c *gin.Context) {
        c.File("./build/index.html")
    })

    // 所有其他未匹配的路由都回退到 index.html
    // 这使得 SvelteKit 的客户端路由器能够处理所有路由
    router.NoRoute(func(c *gin.Context) {
        c.File("./build/index.html")
    })

    router.Run(":5555")
}

server {
    listen 80;
    server_name yourdomain.com;

    root /path/to/your/build; # SvelteKit build 目录的路径

    index index.html;

    location / {
        # 尝试查找文件或目录，如果找不到，则回退到 index.html
        try_files $uri $uri/ /index.html; 
    }
}