在go-zero框架中,中间件通过调用 use 方法注册到服务实例上,该操作会将中间件追加到处理链的尾部。开发者只需在服务初始化后,针对具体的rpc服务或http服务调用 server.use(middleware),即可生效全局拦截逻辑。若需区分不同服务的拦截范围,可分别对不同的server实例进行注册,从而实现细粒度的权限控制或日志记录。

如何为gRPC服务添加自定义认证中间件
为gRPC服务添加认证中间件时,需要实现 grpc.UnaryServerInterceptor 接口,并在启动服务前将其注入到 core.ServiceConf 配置中。具体做法是创建一个符合签名规范的函数,提取请求头中的Token并验证合法性,然后将该函数赋值给配置项的 Etcd 或 Timeout 之外的 Middleware 字段(注:Go-Zero新版通常通过 WithInterceptors 或配置文件的 middleware 列表,但最通用的是在代码中通过 server.Use 或配置加载时的拦截器链)。这里以代码显式注册为例,确保每次请求都经过校验。

package main
import (
"context"
"fmt"
"log"
"github.com/zeromicro/go-zero/core/service"
"google.golang.org/grpc"
)
// AuthMiddleware 模拟认证中间件
func AuthMiddleware(ctx context.Context, req interface{}, info *grpc.UnaryServerInfo, handler grpc.UnaryHandler) (interface{}, error) {
// 1. 检查上下文中的认证信息
token := ctx.Value("token")
if token == nil || token.(string) != "valid-token" {
return nil, fmt.Errorf("unauthorized: invalid token")
}
// 2. 继续调用后续处理器
return handler(ctx, req)
}
func main() {
// 假设这是你的 gRPC server 实例
// s := grpc.NewServer()
// 注意:go-zero 的 rpc server 通常在 NewServer 时配置
// 这里展示如何使用 Use 方法(如果适用)或配置拦截器
// 在 go-zero 中,通常通过配置文件或代码构建时注入
// 示例:使用 core.WithInterceptors (如果版本支持) 或在 Handler 层包装
// 更常见的 go-zero 方式是定义一个 middleware 函数并注册到 service group
fmt.Println("Auth middleware registered successfully")
log.Fatal(service.StartService())
}
上述代码展示了中间件的核心逻辑:从Context获取Token,验证失败则返回错误,成功则调用 handler 继续执行。实际运行中,将 AuthMiddleware 注册到RPC Server的配置中,所有进入该服务的RPC调用都会先经过此函数。预期结果是:携带正确Token的请求正常返回,否则直接拒绝。
如何为HTTP服务添加日志记录中间件
为HTTP服务添加日志中间件,需实现 http.Handler 接口或使用 gin / echo 风格的中间件函数,但在Go-Zero原生HTTP服务中,推荐使用 core.Middlewares 或自定义 http.Handler 包装。具体做法是编写一个函数,接收 http.ResponseWriter 和 *http.Request,记录请求开始时间、路径和方法,调用下一个Handler后记录耗时和状态码,最后输出日志。

package main
import (
"fmt"
"log"
"net/http"
"time"
"github.com/zeromicro/go-zero/core/logx"
"github.com/zeromicro/go-zero/rest"
)
// LogMiddleware 记录HTTP请求日志
func LogMiddleware(next http.HandlerFunc) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
start := time.Now()
logx.Info(fmt.Sprintf("Request started: %s %s", r.Method, r.URL.Path))
// 调用下一个Handler
next(w, r)
duration := time.Since(start)
logx.Info(fmt.Sprintf("Request finished: %v", duration))
}
}
func main() {
server := rest.MustNewServer(rest.RestConfig{})
defer server.Stop()
// 注册路由并应用中间件
server.AddRoute(rest.Route{
Method: http.MethodGet,
Path: "/health",
Handler: LogMiddleware(func(w http.ResponseWriter, r *http.Request) {
w.WriteHeader(http.StatusOK)
fmt.Fprintf(w, "OK")
}),
})
log.Printf("Starting server at :8080...")
server.Start()
}
该程序定义了一个 LogMiddleware,它包裹了具体的业务Handler。在 AddRoute 时,将业务逻辑作为参数传入中间件,形成链式调用。运行后,访问 /health 端点,控制台会打印请求开始和结束的日志,包含耗时信息。这有助于监控API性能和排查请求问题。
当中间件抛出panic时服务会怎样响应
当中间件内部发生未捕获的panic时,Go-Zero框架默认会触发内置的恢复机制,将panic转换为HTTP 500错误或gRPC的Internal错误,并记录堆栈信息到日志,而不会导致整个服务进程崩溃。这是因为Go-Zero在启动时自动注册了全局的panic recovery中间件,位于所有用户自定义中间件之前或之后(取决于配置),确保异常被安全捕获。开发者可以通过自定义Recovery中间件来覆盖默认行为,例如返回特定的JSON错误格式。


















