Fiber - Golang高性能Express风格Web框架

Fiber是一个受Express启发的Golang Web框架，建立在Fasthttp（Go最快的HTTP引擎）之上，旨在简化快速开发，同时不牺牲性能。以下是Fiber的核心特性和使用示例。

主要特性

1. 高性能：基于Fasthttp，比标准net/http快10倍
2. Express风格API：路由、中间件等设计类似Express
3. 低内存占用：优化内存使用
4. 中间件支持：丰富的中间件生态系统
5. 静态文件服务：内置静态文件处理

安装

go get github.com/gofiber/fiber/v2

基础示例

package main

import "github.com/gofiber/fiber/v2"

func main() {
    app := fiber.New()

    // 简单GET路由
    app.Get("/", func(c *fiber.Ctx) error {
        return c.SendString("Hello, Fiber!")
    })

    // 带参数的路由
    app.Get("/user/:name", func(c *fiber.Ctx) error {
        return c.SendString("Hello, " + c.Params("name"))
    })

    // 启动服务器
    app.Listen(":3000")
}

路由处理

// GET请求
app.Get("/api/users", getUsers)

// POST请求
app.Post("/api/users", createUser)

// PUT请求
app.Put("/api/users/:id", updateUser)

// DELETE请求
app.Delete("/api/users/:id", deleteUser)

// 匹配所有HTTP方法
app.All("/api/all", handleAllMethods)

// 匹配多个路径
app.Use("/api", middleware) // 匹配/api开头的所有路径

中间件使用

// 日志中间件
app.Use(logger.New())

// 恢复中间件(panic恢复)
app.Use(recover.New())

// CORS中间件
app.Use(cors.New())

// 自定义中间件
func AuthMiddleware(c *fiber.Ctx) error {
    token := c.Get("Authorization")
    if token != "valid-token" {
        return c.Status(fiber.StatusUnauthorized).SendString("Unauthorized")
    }
    return c.Next()
}

// 应用中间件到特定路由
app.Get("/protected", AuthMiddleware, protectedHandler)

请求处理

// 获取查询参数
app.Get("/search", func(c *fiber.Ctx) error {
    query := c.Query("q")
    return c.SendString("Search query: " + query)
})

// 获取POST表单数据
app.Post("/form", func(c *fiber.Ctx) error {
    name := c.FormValue("name")
    return c.SendString("Hello, " + name)
})

// JSON请求体解析
app.Post("/json", func(c *fiber.Ctx) error {
    var data struct {
        Name string `json:"name"`
    }
    if err := c.BodyParser(&data); err != nil {
        return err
    }
    return c.JSON(fiber.Map{
        "message": "Hello, " + data.Name,
    })
})

响应处理

// 发送文本响应
app.Get("/text", func(c *fiber.Ctx) error {
    return c.SendString("Plain text response")
})

// 发送JSON响应
app.Get("/json", func(c *fiber.Ctx) error {
    return c.JSON(fiber.Map{
        "name": "John",
        "age":  30,
    })
})

// 发送状态码
app.Get("/notfound", func(c *fiber.Ctx) error {
    return c.SendStatus(fiber.StatusNotFound)
})

// 重定向
app.Get("/redirect", func(c *fiber.Ctx) error {
    return c.Redirect("/new-location")
})

静态文件服务

// 提供单个文件
app.Get("/file", func(c *fiber.Ctx) error {
    return c.SendFile("./public/file.txt")
})

// 静态文件目录
app.Static("/static", "./public")

// 带前缀的静态文件服务
app.Static("/prefix", "./public", fiber.Static{
    Prefix: "/prefix",
})

错误处理

// 自定义错误处理
app := fiber.New(fiber.Config{
    ErrorHandler: func(ctx *fiber.Ctx, err error) error {
        code := fiber.StatusInternalServerError
        if e, ok := err.(*fiber.Error); ok {
            code = e.Code
        }
        return ctx.Status(code).JSON(fiber.Map{
            "error": err.Error(),
        })
    },
})

// 404处理
app.Use(func(c *fiber.Ctx) error {
    return c.Status(fiber.StatusNotFound).SendFile("./public/404.html")
})

性能优化技巧

1. 连接复用：Fiber默认启用Keep-Alive
2. 零内存分配：Fasthttp设计目标之一
3. 并发处理：Go的goroutine模型
4. 避免阻塞操作：将长时间任务放入goroutine
5. 使用适当中间件：只加载必要的中间件

完整示例

package main

import (
    "github.com/gofiber/fiber/v2"
    "github.com/gofiber/fiber/v2/middleware/logger"
    "github.com/gofiber/fiber/v2/middleware/recover"
)

func main() {
    app := fiber.New(fiber.Config{
        Prefork: true, // 启用多进程模式
    })

    // 中间件
    app.Use(logger.New())
    app.Use(recover.New())

    // 路由
    app.Get("/", func(c *fiber.Ctx) error {
        return c.JSON(fiber.Map{
            "message": "Welcome to Fiber API",
        })
    })

    // API组
    api := app.Group("/api")
    api.Get("/users", getUsers)
    api.Post("/users", createUser)

    // 静态文件
    app.Static("/public", "./public")

    // 404处理
    app.Use(func(c *fiber.Ctx) error {
        return c.Status(404).SendString("Sorry, page not found!")
    })

    // 启动服务器
    app.Listen(":3000")
}

func getUsers(c *fiber.Ctx) error {
    // 模拟数据
    users := []fiber.Map{
        {"id": 1, "name": "John"},
        {"id": 2, "name": "Jane"},
    }
    return c.JSON(users)
}

func createUser(c *fiber.Ctx) error {
    type User struct {
        Name string `json:"name"`
    }
    
    var user User
    if err := c.BodyParser(&user); err != nil {
        return c.Status(400).JSON(fiber.Map{
            "error": "Invalid request",
        })
    }
    
    // 模拟创建用户
    return c.Status(201).JSON(fiber.Map{
        "id":   3,
        "name": user.Name,
    })
}

Fiber提供了Express的易用性，同时保持了Go的高性能特性，是构建现代Web应用的优秀选择。