go-zero 微服务框架采用分层架构设计,核心原则是将业务逻辑从基础设施中解耦。具体做法是遵循 api、logic、model、svc 和 types 的分层规范,其中 api 层处理 http/grpc 协议解析,logic 层承载核心业务规则,model 层负责数据持久化,svc 层管理依赖注入。这种结构确保了代码的高内聚低耦合,便于单元测试和维护。

api 层如何定义接口与路由?
api 层通过 .api 文件定义接口契约,使用 goctl 工具自动生成 handler 代码。开发者只需关注请求参数和响应结构,无需手动编写路由映射或参数校验逻辑。生成的 handler 代码仅负责调用 logic 层的业务方法,并处理异常返回,从而保持入口层的纯净。

package main
import (
"github.com/zeromicro/go-zero/core/stores/sqlx"
"github.com/zeromicro/go-zero/rest/httpx"
"net/http"
)
// UserHandler 处理用户相关请求
type UserHandler struct {
userService UserService
}
// NewUserHandler 创建新的用户处理器
func NewUserHandler(svc *svc.ServiceContext) http.Handler {
return &UserHandler{
userService: svc.UserService,
}
}
// GetUser 获取用户信息
func (h *UserHandler) GetUser(w http.ResponseWriter, r *http.Request) {
id := r.PathValue("id") // Go 1.22+ path parameter
user, err := h.userService.GetUser(id)
if err != nil {
httpx.ErrorCtx(r.Context(), w, err)
return
}
httpx.OkJsonCtx(r.Context(), w, user)
}
logic 层如何实现业务逻辑?
logic 层是业务逻辑的核心,直接依赖 model 层进行数据操作。它不感知 HTTP 协议细节,只接收结构化输入并返回业务结果。在 logic 层中,可以方便地集成缓存、消息队列等中间件,通过 svc 层注入的上下文获取这些资源。这种设计使得业务逻辑易于测试,因为可以直接实例化 logic 对象并传入 Mock 的 model 依赖。

package logic
import (
"context"
"github.com/zeromicro/go-zero/core/logx"
"your-project/internal/model"
"your-project/internal/svc"
"your-project/internal/types"
)
type UserService struct {
ctx context.Context
svcCtx *svc.ServiceContext
logx.Logger
}
func NewUserService(ctx context.Context, svcCtx *svc.ServiceContext) *UserService {
return &UserService{
ctx: ctx,
svcCtx: svcCtx,
Logger: logx.WithContext(ctx),
}
}
func (u *UserService) GetUser(id string) (*types.User, error) {
// 1. 检查缓存
cacheKey := "user:" + id
var cachedUser types.User
if u.svcCtx.Redis.Get(cacheKey, &cachedUser) == nil {
return &cachedUser, nil
}
// 2. 查询数据库
userModel, err := u.svcCtx.UserModel.FindOne(u.ctx, id)
if err != nil {
return nil, err
}
// 3. 转换类型并缓存
user := &types.User{
Id: userModel.Id,
Name: userModel.Name,
}
u.svcCtx.Redis.Set(cacheKey, user, 0)
return user, nil
}
当 model 层查询返回空值时如何处理?
在 model 层,如果根据主键查询不到记录,go-zero 的 sqlx 模块会返回 sql.ErrNoRows 错误。在 logic 层,应当捕获此错误并根据业务需求决定是返回特定错误码还是默认值。例如,在用户查询场景中,若用户不存在,通常应返回 404 Not Found 或自定义的业务错误,而不是让程序崩溃或返回空对象。这种处理方式保证了 API 响应的规范性和一致性。


















