同一局域网Ubuntu设备Python gRPC突然变慢问题求助及临时解决方案

问题场景 #

同一机器上使用Python gRPC进行本地RPC调用，此前运行正常，昨日起突然异常缓慢——helloworld示例需约78秒完成。局域网内三台Ubuntu 18.04设备测试结果一致，但在家中环境运行则瞬间完成。已找到临时解决方法：将grpc.insecure_channel连接字符串中的localhost替换为127.0.0.1后，gRPC响应速度恢复正常。

排查步骤 #

• 检查本地DNS解析
  执行getent hosts localhost或nslookup localhost，查看localhost的解析结果：
  • 确认是否包含127.0.0.1
  • 若返回IPv6地址::1且优先级高于IPv4，可能因系统IPv6配置异常，导致gRPC尝试IPv6连接超时后才 fallback 到IPv4，引发延迟
• 验证IPv6连通性
  执行ping6 ::1测试本地IPv6回环连通性，若丢包或响应缓慢，说明IPv6栈存在问题。可临时禁用IPv6验证：
  • 编辑/etc/sysctl.conf，添加net.ipv6.conf.all.disable_ipv6=1
  • 执行sysctl -p使配置生效，再测试gRPC调用速度
• 检查hosts文件配置
  查看/etc/hosts中localhost的映射条目，确认是否被修改为非127.0.0.1的地址，或添加了多余的无效映射。正常配置应为：

  127.0.0.1 localhost
  ::1 localhost
  

• 排查网关与路由变化
  • 执行route -n查看当前路由表，对比历史正常配置（如有备份），检查默认网关、本地回环路由是否异常
  • 执行ufw status或iptables -L，确认防火墙规则是否误拦截了本地gRPC流量
• 启用gRPC调试日志定位卡点
  设置环境变量开启调试日志：

  export GRPC_VERBOSITY=DEBUG
  export GRPC_TRACE=all
  

  运行helloworld示例，查看日志中连接建立的详细过程，确认延迟发生在DNS解析、连接建立还是其他阶段

临时解决方法的原理 #

将localhost替换为127.0.0.1直接指定了IPv4回环地址，绕开了DNS解析环节，避免了因localhost解析异常（如优先解析至不可用的IPv6地址）导致的超时等待，从而恢复了调用速度。

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