保姆级go-grpc 代码示例

1. 初始化目录

mkdir grpc
cd grpc
mkdir client && mkdir server && mkdir proto
---

2. 创建文件

2.1写入文件 client/greeter.proto

cd client
vim greeter.proto

greeter.proto

syntax = "proto3";

option go_package = "./;greeter";

package greeter;

// 问候服务定义
service Greeter {
  rpc SayHello (HelloRequest) returns (HelloReply) {}
}

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

// 响应消息
message HelloReply {
  string message = 1;
}

2.2写入文件 server/main.go

cd ../server
vim main.go

main.go

package main

import (
	"context"
	"log"
	"net"

	pb "grpc/proto" // 替换为实际路径
	"google.golang.org/grpc"
)

const (
	port = ":50051"
)

// 实现 Greeter 服务
type server struct {
	pb.UnimplementedGreeterServer
}

func (s *server) SayHello(ctx context.Context, in *pb.HelloRequest) (*pb.HelloReply, error) {
	log.Printf("Received: %v", in.GetName())
	return &pb.HelloReply{Message: "Hello " + in.GetName()}, nil
}

func main() {
	lis, err := net.Listen("tcp", port)
	if err != nil {
		log.Fatalf("failed to listen: %v", err)
	}
	s := grpc.NewServer()
	pb.RegisterGreeterServer(s, &server{})
	log.Printf("server listening at %v", lis.Addr())
	if err := s.Serve(lis); err != nil {
		log.Fatalf("failed to serve: %v", err)
	}
}

2.3写入文件 client/client.go

cd ../client
vim client.go

client.go

package main

import (
	"context"
	"log"
	"os"
	"time"

	pb "grpc/proto" // 替换为实际路径
	"google.golang.org/grpc"
	"google.golang.org/grpc/credentials/insecure"
)

const (
	address     = "localhost:50051"
	defaultName = "world"
)

func main() {
	// 建立连接
	conn, err := grpc.Dial(address, grpc.WithTransportCredentials(insecure.NewCredentials()))
	if err != nil {
		log.Fatalf("did not connect: %v", err)
	}
	defer conn.Close()
	c := pb.NewGreeterClient(conn)

	// 准备请求
	name := defaultName
	if len(os.Args) > 1 {
		name = os.Args[1]
	}
	ctx, cancel := context.WithTimeout(context.Background(), time.Second)
	defer cancel()

	// 调用服务
	r, err := c.SayHello(ctx, &pb.HelloRequest{Name: name})
	if err != nil {
		log.Fatalf("could not greet: %v", err)
	}
	log.Printf("Greeting: %s", r.GetMessage())
}

3. 初始化mod &&安装依赖

# 安装最新依赖
go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest

cd ..  ## 这一步返回到根目录
# 生成proto 和grpc的go代码
protoc --go_out=. --go_opt=paths=source_relative --go-grpc_out=. --go-grpc_opt=paths=source_relative  proto/greeter.proto

# 初始化mod
go mod init grpc
go mod tidy

## 这两步一般会在 tidy里包含，不执行也没事
## go get -u google.golang.org/grpc
## go get -u google.golang.org/protobuf

4. 执行

go run server/main.go
## 新建终端
go run client/client.go

5.踩坑点

5.1 包管理问题

初学的必须严格按照目录，不然可能会找不到包

-grpc/
--proto/
---- *.proto
---- *.pb.go
--server/
----main.go
--client/
----client.go

然后client.go 和 main.go 包含 proto目录是

import (
	pb "grpc/proto"		// grpc是包名，在根目录执行 go mod init grpc时指定， proto是根目录下的目录，也是包名

还有就是 source_relative 很关键，指定了生成的go文件和proto文件在同一个目录

protoc ... --go_opt=paths=source_relative ... --go-grpc_opt=paths=source_relative  

5.2 grpc依赖

一定要确保 grpc 和 protobuf 这两个go依赖已经安装，如果没安装运行报错，就在根目录手动安装

go get -u google.golang.org/grpc
go get -u google.golang.org/protobuf

还有就是可能操作过程中引用了其它的依赖，导致版本错误，这个时候直接清空mod，重新操作就行

# 清理旧版本
go clean -modcache

# 安装最新依赖
go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest
go get -u google.golang.org/grpc
go get -u google.golang.org/protobuf

# 重新生成 *pb.go 和 重新 go mod tidy
## 然后运行

5.3初次代码准确性问题

有时候可能会参考多个代码在下手，但这个时候可能会有意想不到的问题，最好的做法是删除所有代码，按照感觉比较权威的那个代码一步步执行，万事开头难，第一次完成好之后就简单了！