grpcurl是专为gRPC服务器设计的命令行工具，它让开发者能够像使用curl测试HTTP接口一样，轻松测试gRPC服务。这款强大的工具支持JSON格式的请求数据，让gRPC接口测试变得简单直观。🎯

【免费下载链接】grpcurl Like cURL, but for gRPC: Command-line tool for interacting with gRPC servers 项目地址: https://gitcode.com/gh_mirrors/gr/grpcurl

为什么选择grpcurl？

gRPC作为现代微服务架构的核心通信协议，使用二进制编码的protocol buffers进行数据传输。这导致传统curl工具无法直接与gRPC服务器交互。grpcurl完美解决了这个问题，让你能够：

• 🔍 浏览gRPC服务架构
• 📡 调用各种RPC方法（包括流式方法）
• 🔒 支持TLS安全连接和双向认证
• 📋 使用JSON格式发送请求，脚本友好

快速安装指南

使用Go安装（推荐）

go install github.com/fullstorydev/grpcurl/cmd/grpcurl@latest

Docker方式

docker pull fullstorydev/grpcurl:latest

其他安装方式

• macOS: brew install grpcurl
• Snap: snap install grpcurl

核心功能实战

1. 列出可用服务

# 服务器支持反射时
grpcurl localhost:8787 list

# 使用proto源文件
grpcurl -import-path ../protos -proto my-stuff.proto list

2. 调用RPC方法

# 发送空请求
grpcurl grpc.server.com:443 my.custom.server.Service/Method

# 发送JSON格式请求
grpcurl -d '{"id": 1234, "tags": ["foo","bar"]}' \
    grpc.server.com:443 my.custom.server.Service/Method

3. 添加请求头

grpcurl -H "authorization: Bearer token" \
         -H "x-request-id: 12345" \
         grpc.server.com:443 my.custom.server.Service/Method

高级配置技巧

处理非反射服务器

对于不支持反射的gRPC服务器，可以使用proto源文件或protoset文件：

# 使用proto源文件
grpcurl -import-path ../protos -proto my-stuff.proto \
    grpc.server.com:443 my.custom.server.Service/Method

安全连接配置

grpcurl支持完整的TLS配置，包括：

• 自签名证书处理
• 客户端证书认证
• CA证书链验证

自动化测试集成

将grpcurl集成到CI/CD流水线中，实现gRPC接口的自动化测试：

#!/bin/bash
# 健康检查
grpcurl -plaintext localhost:8787 list

# 功能测试
grpcurl -d '{"user_id": "test123"}' \
    localhost:8787 bankdemo.Bank/GetUser

项目结构概览

grpcurl项目提供了完整的示例代码和测试用例：

• 主程序: cmd/grpcurl/grpcurl.go
• 示例服务: internal/testing/cmd/bankdemo/
• 测试文件: grpcurl_test.go

最佳实践建议

1. 优先使用服务器反射 - 简化配置和管理
2. 合理使用protoset文件 - 提升脚本执行性能
3. 善用JSON格式 - 便于调试和维护
4. 集成到开发流程 - 确保接口质量

grpcurl作为gRPC生态中的多功能工具，为开发者提供了强大的接口测试能力。通过本文介绍的5分钟快速上手方法，你可以立即开始使用这个工具来提升你的gRPC开发效率！✨

【免费下载链接】grpcurl Like cURL, but for gRPC: Command-line tool for interacting with gRPC servers 项目地址: https://gitcode.com/gh_mirrors/gr/grpcurl