如何为基于NettyServerBuilder的Java gRPC服务器设置setReuseAddress(true)

好问题！要让你的gRPC服务器在崩溃或重启后快速绑定到原端口，你需要通过NettyServerBuilder配置Netty底层的SO_REUSEADDR通道选项——因为NettyServerBuilder并没有直接提供setReuseAddress方法，而是通过channelOption来传递Netty原生的配置项。

具体步骤 #

1. 导入Netty的ChannelOption类
   由于你使用的是shaded版本的gRPC Netty依赖，需要导入对应的shaded包下的ChannelOption：

   import io.grpc.netty.shaded.io.netty.channel.ChannelOption;
   

2. 在服务器构建链中添加配置
   在你的现有代码中，插入.channelOption(ChannelOption.SO_REUSEADDR, true)即可完成设置：

   import io.grpc.Server;
   import io.grpc.netty.shaded.io.grpc.netty.NettyServerBuilder;
   import io.grpc.netty.shaded.io.netty.channel.ChannelOption;
   import java.util.concurrent.TimeUnit;
   //...
   private Server server;
   //...
   server = NettyServerBuilder
       .forPort(port)
       .permitKeepAliveWithoutCalls(true)
       .permitKeepAliveTime(5, TimeUnit.SECONDS)
       // 启用SO_REUSEADDR，允许端口快速重用
       .channelOption(ChannelOption.SO_REUSEADDR, true)
       .addService(this.queryService)
       .addService(this.commandService)
       .build();
   

为什么这能生效？ #

SO_REUSEADDR是TCP/IP协议栈的一个选项，它允许操作系统将处于TIME_WAIT状态的端口重新分配给新的套接字。当服务器意外崩溃或主动重启时，原端口通常会进入TIME_WAIT状态（用来处理残留的网络数据包），默认情况下需要等待几分钟才能重新绑定。启用这个选项后，你的gRPC服务器可以立刻重新绑定到原端口，大大缩短重启后的恢复时间。

注意事项 #

• 如果你使用的是非shaded版本的grpc-netty依赖（而非grpc-netty-shaded），那么ChannelOption的导入路径会是io.netty.channel.ChannelOption，调整导入即可。
• 这个选项在主流操作系统（Linux、Windows、macOS）上都得到支持，行为基本一致。

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