go-zero 框架通过 goctl 工具生成标准化的项目目录结构,核心规范是将 api 定义、逻辑实现和数据访问层严格分离。具体做法是在根目录下创建 api/ 存放 .api 文件,在 internal/ 下按模块划分 logic/、handler/ 和 svc/ 等子目录,并运行 goctl api go 自动生成代码骨架。这种结构确保了业务逻辑与接口定义的解耦,便于维护和测试。

API 文件如何映射到 Handler 和 Logic?
API 文件中的路由定义会自动生成对应的 Handler 函数,而具体的业务逻辑则位于 Logic 层。开发者只需在 logic/ 目录下实现 .go 文件中的方法,无需手动编写 HTTP 处理逻辑。这种映射关系由 goctl 在代码生成时确立,确保每个 API 端点都有明确的逻辑入口。

package main
import (
"github.com/zeromicro/go-zero/core/conf"
"myapp/internal/handler"
"myapp/internal/svc"
)
func main() {
var c struct {
ServiceName string `json:"serviceName"`
}
conf.MustLoad("config.yaml", &c)
s := svc.NewServiceContext(c)
h := handler.NewRouter(s)
h.Start()
}Service Context 如何管理全局依赖?
svc/ 目录下的 ServiceContext 结构体负责集中管理所有全局依赖,如数据库连接、Redis 客户端或配置对象。在初始化阶段,这些依赖被注入到 ServiceContext 中,随后传递给所有的 Handler 和 Logic 实例。这种方式避免了在每个逻辑函数中重复初始化资源,提高了代码的可维护性和性能。

package svc
import (
"github.com/zeromicro/go-zero/core/stores/sqlx"
"myapp/config"
)
type ServiceContext struct {
Config config.Config
DB sqlx.SqlConn
}
func NewServiceContext(c config.Config) *ServiceContext {
return &ServiceContext{
Config: c,
DB: sqlx.NewSqlConn(c.DataSource),
}
}Logic 层如何处理数据访问错误?
在 Logic 层中,数据访问错误通常通过返回自定义的错误码和消息来处理。开发者可以在 Logic 方法中捕获数据库或缓存操作产生的异常,并将其转换为符合 API 规范的错误响应。这种处理方式保证了前端能够接收到结构化的错误信息,便于调试和用户提示。
,


















