Schema-driven Go RPC framework built on ConnectRPC.
基于 ConnectRPC 的 Schema 驱动 Go RPC 框架。
Protocols: gRPC + Connect + gRPC-Web | 协议支持：gRPC + Connect + gRPC-Web 三协议
| Feature | Description |
|---|---|
| ConnectRPC | gRPC + Connect + gRPC-Web, browser-native, no proxy |
| Vanguard REST | Legacy REST client compatibility, no code changes |
| Dual Ports | App(:8080) for RPC, Admin(:8081) for health/metrics/pprof |
| Lifecycle Hooks | Ordered start/stop with priority |
| slog Logging | Pluggable handler, inject Zap or custom backend |
| Connect Errors | Error details with business codes (errs.New(code, bizCode, msg)) |
| OpenTelemetry | Built-in tracing interceptor |
| Three-layer Interceptors | HTTP middleware → Connect → Per-service |
| gRPC Health + Reflection | Standard protocols, grpcurl/grpcui ready |
| koanf Config | Multi-source: files + env vars + remote |
| Explicit DI | No Wire. Config → Logger → Server → App |
| ginnytest | One-line test server with full interceptor chain |
| Go 1.24 | Native http.Protocols h2c, enhanced ServeMux |
Requires Go 1.24+. | 需要 Go 1.24+。
go get github.com/goriller/ginny/v2
Code generation:
go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
go install connectrpc.com/connect/cmd/protoc-gen-connect-go@latest
Optional: Buf CLI replaces protoc. Templates in buf/.
package main
import (
"context""github.com/goriller/ginny/v2""github.com/goriller/ginny/v2/config""github.com/goriller/ginny/v2/server"
)
funcmain() {
cfg:=config.MustLoad()
srv:=server.New()
app, _:=ginny.New(
ginny.WithConfig(cfg),
ginny.WithServer(srv),
)
app.Start(context.Background())
}go run main.go
curl http://localhost:8081/healthz # → {"status":"ok"}- Architecture & Design — 架构设计与技术细节
- Redesign Plan — v1 → v2 改造方案
- Review & Optimization — 架构师评审与优化
MIT