基于gRPC+Protobuf3的Go微服务键搜索RPC可选键处理问题

我之前做基于gRPC的搜索微服务时，完全踩过你这个坑——Protobuf 3的默认值机制确实会让你分不清用户是主动传了空字符串作为搜索条件，还是根本不想用这个字段过滤。下面给你几个业界常用的解决方案，按推荐程度排序：

1. 用Protobuf 3的optional关键字（推荐） #

从Protobuf 3.12版本开始，官方重新支持了optional字段标记，它会自动生成对应的HasXXX()方法，帮你判断字段是否被显式设置过，完美解决默认值的歧义问题。

示例Protobuf定义： #

syntax = "proto3";

message SearchRequest {
  optional string name = 1;
  optional string surname = 2;
  optional string location = 3;
}

Go代码中判断： #

func (s *SearchService) Search(ctx context.Context, req *pb.SearchRequest) (*pb.SearchResponse, error) {
    var filters []string
    if req.HasName() {
        // 用户明确设置了name字段，不管值是空还是非空，都要加入搜索条件
        filters = append(filters, fmt.Sprintf("name = '%s'", req.GetName()))
    }
    if req.HasSurname() {
        filters = append(filters, fmt.Sprintf("surname = '%s'", req.GetSurname()))
    }
    if req.HasLocation() {
        filters = append(filters, fmt.Sprintf("location = '%s'", req.GetLocation()))
    }
    // 拼接过滤条件执行搜索...
}

这个方案最简洁，完全利用Protobuf的原生特性，不需要额外的自定义逻辑。

2. 使用Protobuf包装类型（兼容旧版本Protobuf） #

如果你的项目还在使用3.12之前的Protobuf版本，可以用官方提供的google.protobuf.StringValue包装类型，它本质是一个包含string value字段的消息，未设置时为nil，设置后为非nil对象。

示例Protobuf定义： #

syntax = "proto3";

import "google/protobuf/wrappers.proto";

message SearchRequest {
  google.protobuf.StringValue name = 1;
  google.protobuf.StringValue surname = 2;
  google.protobuf.StringValue location = 3;
}

Go代码中判断： #

func (s *SearchService) Search(ctx context.Context, req *pb.SearchRequest) (*pb.SearchResponse, error) {
    var filters []string
    if req.Name != nil {
        // Name字段被显式设置，使用req.Name.Value获取实际值
        filters = append(filters, fmt.Sprintf("name = '%s'", req.Name.Value))
    }
    // surname和location的判断逻辑同理...
}

这个方案需要引入额外的proto文件，但兼容性好，适合不能升级Protobuf版本的老项目。

3. 自定义存在性标记字段（不推荐，仅作备选） #

如果上面两种方案都没法用，你可以手动给每个搜索键加一个布尔字段，标记该键是否要被用作搜索条件。不过这种方式会增加消息的复杂度，维护成本较高。

示例Protobuf定义： #

syntax = "proto3";

message SearchRequest {
  string name = 1;
  bool name_included = 2;
  
  string surname = 3;
  bool surname_included = 4;
  
  string location = 5;
  bool location_included = 6;
}

Go代码中判断： #

func (s *SearchService) Search(ctx context.Context, req *pb.SearchRequest) (*pb.SearchResponse, error) {
    var filters []string
    if req.NameIncluded {
        filters = append(filters, fmt.Sprintf("name = '%s'", req.Name))
    }
    // 其他字段同理...
}

这种方案尽量别用，除非有特殊的兼容性限制，不然会让消息结构变得冗余，容易出错。

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