gRPCUnary调用原理与使用详解

本文手把手带你完成Go语言中gRPC最基础也最常用的Unary调用全流程：从编写protobuf接口定义、用protoc生成Go代码，到实现服务端逻辑（含SayHello方法）和客户端调用，最终成功输出“Response: Hello, Alice”；内容简洁实用，覆盖开发、启动、验证全环节，并贴心提示生产环境需关注TLS加密与超时控制，是初学者快速上手gRPC通信的理想实践指南。

在Go语言中使用gRPC进行服务间通信，Unary模式是最基础、最常用的调用方式。它对应“一元调用”，即客户端发送一个请求，服务器返回一个响应。本文将带你从零开始实践Golang中gRPC Unary调用的完整开发流程。

定义Protobuf接口

要使用gRPC，首先需要定义服务接口和消息结构。创建service.proto文件：

syntax = "proto3";
package example;

// 定义请求消息
message HelloRequest {
    string name = 1;
}

// 定义响应消息
message HelloResponse {
    string message = 1;
}

// 定义服务
service Greeter {
    rpc SayHello(HelloRequest) returns (HelloResponse);
}

使用protoc工具生成Go代码：

protoc --go_out=. --go_opt=paths=source_relative \
    --go-grpc_out=. --go-grpc_opt=paths=source_relative \
    service.proto

实现gRPC服务端

编写服务端逻辑，注册并启动gRPC服务器：

package main

import (
    "context"
    "log"
    "net"

    "google.golang.org/grpc"
    pb "your-module-path/proto"
)

type server struct {
    pb.UnimplementedGreeterServer
}

func (s *server) SayHello(ctx context.Context, req *pb.HelloRequest) (*pb.HelloResponse, error) {
    return &pb.HelloResponse{
        Message: "Hello, " + req.GetName(),
    }, nil
}

func main() {
    lis, err := net.Listen("tcp", ":50051")
    if err != nil {
        log.Fatalf("failed to listen: %v", err)
    }

    s := grpc.NewServer()
    pb.RegisterGreeterServer(s, &server{})

    log.Println("gRPC server listening on :50051")
    if err := s.Serve(lis); err != nil {
        log.Fatalf("failed to serve: %v", err)
    }
}

编写gRPC客户端

客户端通过连接服务端，调用Unary方法SayHello：

package main

import (
    "context"
    "log"

    "google.golang.org/grpc"
    "google.golang.org/grpc/credentials/insecure"
    pb "your-module-path/proto"
)

func main() {
    // 建立与服务端的连接
    conn, err := grpc.Dial("localhost:50051", grpc.WithTransportCredentials(insecure.NewCredentials()))
    if err != nil {
        log.Fatalf("did not connect: %v", err)
    }
    defer conn.Close()

    // 创建客户端实例
    client := pb.NewGreeterClient(conn)

    // 构造请求
    req := &pb.HelloRequest{Name: "Alice"}

    // 发起Unary调用
    resp, err := client.SayHello(context.Background(), req)
    if err != nil {
        log.Fatalf("could not greet: %v", err)
    }

    log.Printf("Response: %s", resp.GetMessage())
}

运行与验证

启动服务端：

go run server.go

另开终端运行客户端：

go run client.go

预期输出：

Response: Hello, Alice

说明gRPC Unary调用成功完成。

基本上就这些。只要定义好Proto、生成代码、实现服务和调用，就能快速搭建gRPC通信。注意错误处理和连接管理，在生产环境中建议启用TLS并设置超时。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《gRPCUnary调用原理与使用详解》文章吧，也可关注golang学习网公众号了解相关技术文章。