Go gRPC认证服务报错：Unimplemented desc = unknown service pb.AuthService

我用Golang搭建了一个简单的认证服务，定义了对应的.proto文件并生成了auth_grpc.pb.go和auth.pb.go文件。但客户端调用注册接口时，出现上述错误，且找不到任何pb.AuthService相关的函数或实例。

服务端代码 #

main.go #

func main() {
    env, err := config.LoadConfig()
    if err != nil {
        log.Fatalln("FAILED AT CONFIG: ", err)
    }

    h := db.Init(env.DBUrl)

    jwt := utils.JwtWrapper{
        SecretKey:       env.JWTSecretKey,
        Issuer:          "go-grpc-auth-svc",
        ExpirationHours: 24 * 365,
    }

    s := services.Server{
        H:   h,
        Jwt: jwt,
    }

    grpcServer := grpc.NewServer()
    pb.RegisterAuthServiceServer(grpcServer, &s)

    lis, err := net.Listen("tcp", env.Port)
    if err != nil {
        log.Fatalln("Failed to listing:", err)
    }
    fmt.Printf("start gRPC server on %s", lis.Addr().String())

    if err := grpcServer.Serve(lis); err != nil {
        log.Fatalln("Failed to serve:", err)
    }
}

auth.go #

type Server struct {
    H   db.Handler
    Jwt utils.JwtWrapper
    pb.UnimplementedAuthServiceServer
}

func (s *Server) Register(ctx context.Context, req *pb.RegisterRequest) (*pb.RegisterResponse, error) {...}

客户端代码 #

服务客户端结构体 #

type ServiceClient struct {
    Client pb.AuthServiceClient
}

main.go #

func main() {
    c, err := config.LoadConfig()
    if err != nil {
        log.Fatalln("Failed at config: ", err)
    }

    // ROUTER INSTANCE
    router := gin.Default()

    // MIDDLEWARES
    router.Use(middlewares.ErrorHandler)

    auth.RegisterRoutes(router, &c)

    router.Run(c.Port)
}

注册路由文件 #

func RegisterRoutes(r *gin.Engine, c *config.Config) *ServiceClient {
    svc := &ServiceClient{
        Client: InitServiceClient(c),
    }

    routes := r.Group("/auth")
    routes.POST("/register", svc.Register)
    routes.POST("/login", svc.Login)
    fmt.Println(svc)
    return svc
}

func (svc *ServiceClient) Register(ctx *gin.Context) {
    routes.Register(ctx, svc.Client)
}

func (svc *ServiceClient) Login(ctx *gin.Context) {
    routes.Login(ctx, svc.Client)
}

排查与解决思路 #

1. 核对proto文件定义

   • 确认proto文件中正确声明了AuthService服务，示例：

     service AuthService {
         rpc Register(RegisterRequest) returns (RegisterResponse);
         rpc Login(LoginRequest) returns (LoginResponse);
     }
     

   • 重新执行代码生成命令，确保参数正确：

     protoc --go_out=. --go-grpc_out=. auth.proto
     

   • 检查生成的auth_grpc.pb.go中是否存在RegisterAuthServiceServer函数和UnimplementedAuthServiceServer结构体，这是服务端注册的核心依赖。

2. 服务端实现校验

   • 确认services.Server结构体正确嵌入pb.UnimplementedAuthServiceServer，这是gRPC v1.4+要求的默认实现，避免因未实现全量方法触发错误。
   • 检查服务端启动时pb.RegisterAuthServiceServer的调用是否正确，传入的&s是合法的服务实例。

3. 客户端连接检查

   • 确保InitServiceClient中gRPC客户端连接的地址与服务端监听地址完全一致（包括IP和端口）。
   • 确认客户端用正确方式创建实例，示例：

     func InitServiceClient(c *config.Config) pb.AuthServiceClient {
         conn, err := grpc.Dial(c.AuthSvcUrl, grpc.WithInsecure())
         if err != nil {
             log.Fatalln("Failed to connect to auth service:", err)
         }
         return pb.NewAuthServiceClient(conn)
     }
     

4. 导入路径一致性校验

   • 服务端和客户端的pb包导入路径必须完全相同（比如都是your/project/module/pb），避免因路径差异导致类型不匹配。
   • 检查go.mod中的模块路径，确保生成的pb代码包名与导入路径一致。

内容的提问来源于stack exchange，提问作者barankibar