如何用Golang Fiber框架实现MVC项目结构-Golang-PHP中文网

fiber 项目应避免硬套传统 mvc，而需按 handler→service→repository→model 单向依赖分层，各层职责分明、不暴露框架类型，通过构造函数注入依赖实现解耦。

如何用golang fiber框架实现mvc项目结构

Fiber 本身不内置 MVC 概念，硬套传统 MVC（比如把 controller、model、view 当成三个强耦合包）会迅速掉进循环导入、职责混乱、测试困难的坑里。Go 的编译模型和包管理机制决定了：MVC 是一种组织意图，不是框架契约。

为什么直接按 Spring Boot 那套建 `controller`/`service`/`dao` 目录会出问题

常见错误现象：import cycle not allowed 报错；service 层调用 handler 里的响应工具；model 包里出现 fiber.Ctx 或 json.NewEncoder —— 这些都不是 Fiber 的锅，而是目录结构没守住边界。

controller 目录里写数据库操作或业务判断 → 实际是 service 和 repository 的活
model 包里定义 User.Create(ctx *fiber.Ctx) → 数据结构不该感知 HTTP 上下文
所有 handler 函数都依赖全局 db *gorm.DB 变量 → 无法 mock，单元测试写不下去
用 fiber.Group() 模拟“Controller 类”，再塞一堆闭包中间件 → 最终变成状态难追踪的函数堆砌

`Fiber` 项目中真正该有的分层与依赖流向

核心原则：依赖只能单向向下，handler → service → repository → model，反向绝不允许。每层只暴露接口或纯函数，不暴露框架类型。

handler：只做三件事 —— 解析参数（c.Params、c.Body）、调用 service 方法、写响应（c.JSON 或 c.Status().SendString）
service：接收已校验的输入（如 user_service.CreateUser(req CreateUserReq)），组合多个 repository 调用，处理事务和业务规则
repository：只封装数据访问，返回 model.User 或 error，不碰 HTTP、不封装响应逻辑
model：纯 Go 结构体 + 字段 tag（如 json:"id"、gorm:"primaryKey"），零方法、零依赖

示例路径结构：

Colly Golang Web Scraper and Crawler Framework

Colly 是一个用于 Go 语言的快速开源爬取和爬虫框架。它适用于从简单的页面提取到异步爬虫处理大量页面集合，支持请求回调和结构化解析。

下载

internal/
├── handler/
│   └── user_handler.go // func CreateUser(c *fiber.Ctx)
├── service/
│   └── user_service.go // func CreateUser(req CreateUserReq) (User, error)
├── repository/
│   └── user_repo.go    // func Create(u model.User) error
└── model/
    └── user.go         // type User struct { ID int `json:"id"` }

如何让 `Fiber` handler 与 service 层解耦

关键不是“怎么注册路由”，而是“怎么把依赖传进去”。别用全局变量，用构造函数注入。

在 main.go 初始化时，先创建 repo := &user_repo.GormUserRepo{DB: db}，再传给 service := &user_service.UserService{Repo: repo}，最后注册 handler：app.Post("/users", user_handler.MakeCreateUserHandler(service))
MakeCreateUserHandler 是一个工厂函数，返回 func(*fiber.Ctx)，它把 service 闭包进去，避免 handler 直接 import service 包
这样 handler 包就不用 import service，只依赖 func 类型，方便替换和测试

简短示意：

func MakeCreateUserHandler(svc UserService) fiber.Handler {
    return func(c *fiber.Ctx) error {
        var req CreateUserReq
        if err := c.BodyParser(&req); err != nil {
            return c.Status(fiber.StatusBadRequest).JSON(fiber.Map{"error": err.Error()})
        }
        u, err := svc.CreateUser(req)
        if err != nil {
            return c.Status(fiber.StatusInternalServerError).JSON(fiber.Map{"error": err.Error()})
        }
        return c.Status(fiber.StatusCreated).JSON(u)
    }
}