go-zero 是怎么启动服务、监听端口、处理 HTTP 请求的？

端口写在配置文件里，Start() 调底层 Go HTTP Server 监听

go-zero 的 HTTP 服务 = rest.MustNewServer(c.RestConf) 创建 + server.Start() 监听端口。端口不写死在代码里，而是来自 etc/*.yaml 的 Host / Port 字段，经 config.go 的 rest.RestConf 读进程序。

第一步：端口来自 etc/*.yaml，不是代码

go-zero 是配置驱动的——服务监听哪个地址、哪个端口，全在 YAML 里。

Name: user-api
Host: 0.0.0.0      # 监听地址
Port: 8888        # 监听端口
Mode: dev

package config

type Config struct {
    rest.RestConf   // 内嵌！Host/Port 都在这
}

那 rest.RestConf 里到底有哪些字段？下面是常被用到的一组（具体字段随版本略有差异，以源码 rest.RestConf 为准）：

第二步：main.go 里的五步启动序列

goctl 生成的入口（文件名通常是 user.go）已经把骨架写好了，你基本只补业务逻辑。

package main

import (
    "flag"
    "github.com/zeromicro/go-zero/core/conf"
    "github.com/zeromicro/go-zero/rest"
    "your_project/user/internal/config"
    "your_project/user/internal/handler"
    "your_project/user/internal/svc"
)

var configFile = flag.String("f", "etc/user-api.yaml", "the config file")

func main() {
    flag.Parse()                                       // 解析 -f 指定的配置文件路径

    var c config.Config
    conf.MustLoad(*configFile, &c)                     // ① 读配置（含 Host/Port）

    svcCtx := svc.NewServiceContext(c)                   // ② 建依赖（DB/Redis/RPC/...）

    server := rest.MustNewServer(c.RestConf)             // ③ 创建 HTTP 服务，把端口交给框架
    defer server.Stop()                              // ④ 退出时优雅关闭

    handler.RegisterHandlers(server, svcCtx)          // ⑤ 注册所有路由

    server.Start()                                    // ⑥ 监听端口 + 接请求（阻塞）
}

第三步：server.Start() 内部到底做了什么

一句话：打印地址 → 用 Go 原生 net/http 监听 → 进入 Accept 循环。下面拆开看。

第四步：一次 HTTP 请求是怎么被处理的

server.Start() 监听着，浏览器发来一个请求后，go-zero 把它一路送到你的 logic。

// internal/handler/userhandler.go（goctl 生成的薄壳）
func GetUserHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
    return func(w http.ResponseWriter, r *http.Request) {
        var req types.GetUserReq
        if err := httpx.Parse(r, &req); err != nil { // 解析 + 校验请求
            httpx.Error(w, err)
            return
        }
        l := logic.NewGetUserLogic(r.Context(), svcCtx)  // 业务在 logic
        resp, err := l.GetUser(&req)
        if err != nil {
            httpx.Error(w, err)
        } else {
            httpx.OkJson(w, resp)                        // 写回 JSON
        }
    }
}

第五步：服务怎么优雅退出

Start() 阻塞期间，进程收到 Ctrl+C / SIGTERM 时会怎样？

rest 服务 vs zrpc 服务：端口与访问方式不同

go-zero 里「启动一个服务」有两种：对外暴露 HTTP 的 rest，和内部服务间调用的 zrpc。

一张图 + 口诀记住整条链