Rust客户端调用Java GRPC端点遇Connection refused错误

可能的原因及解决步骤 #

1. 强制客户端使用明文HTTP/2（若服务端未启用TLS） #

gRPC基于HTTP/2协议，但Tonic客户端对http://地址默认不会强制启用HTTP/2，而Java gRPC服务如果是明文模式（无TLS），需要客户端明确指定协议类型。修改连接代码：

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut client = TodoClient::builder()
        .http2_only(true) // 强制使用HTTP/2协议
        .connect("http://0.0.0.0:50052")
        .await?;

    let create_request = tonic::Request::new(CreateTodoRequest {
        username: "username".to_string(),
        password: "password".to_string(),
    });

    let create_response = client.authenticate(create_request).await?;
    println!("{:?}", create_response.into_inner());

    Ok(())
}

2. 验证服务端监听地址 #

确认Java gRPC服务是否绑定到0.0.0.0:50052（允许所有IP访问），而非仅绑定localhost（仅限本机访问）：

• Linux/macOS执行：netstat -tulpn | grep 50052
• Windows执行：netstat -ano | findstr :50052
  若输出中监听地址为127.0.0.1:50052，则需修改Java服务的绑定配置为0.0.0.0，允许外部访问。

3. 检查端口拦截情况 #

• 本机防火墙：确认50052端口未被系统防火墙（Windows防火墙、Linux iptables等）阻止。
• 云环境安全组：若服务端部署在云服务器，检查对应安全组是否开放了50052端口的入站规则。

4. 核对请求地址一致性 #

仔细对比Postman与Rust客户端的请求地址、端口，确保完全一致，避免出现端口写错、地址差异（如Postman用内网IP，Rust用0.0.0.0）的情况。

5. 确认依赖版本兼容性 #

检查Cargo.toml中tonic、prost、tokio的版本是否匹配，推荐使用稳定兼容版本：

[dependencies]
tonic = "0.9"
prost = "0.12"
tokio = { version = "1.0", features = ["full"] }

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