gorilla json-rpc 返回空 result（如 "result": {}）通常是因为响应结构体中字段未导出（即首字母小写），导致 json 编码器无法序列化；修复只需将字段名首字母大写，使其成为导出字段。
gorilla json-rpc 返回空 result（如 "result": {}）通常是因为响应结构体中字段未导出（即首字母小写），导致 json 编码器无法序列化；修复只需将字段名首字母大写，使其成为导出字段。
在使用 Gorilla Toolkit 的 rpc 实现 JSON-RPC 服务时，一个常见却隐蔽的陷阱是：响应结构体（reply struct）中的字段必须是导出的（exported），否则 json 包在序列化时会忽略它们，最终返回空对象 {}。
? 根本原因：Go 的导出规则与 JSON 序列化机制
Go 语言规定：只有首字母大写的标识符（如 Sum, Message）才是导出的（public），可被其他包访问；而小写开头的字段（如 sum, message）是未导出的（private），encoding/json 包在调用 json.Marshal() 时完全跳过这些字段——即使它们有值，也不会出现在最终 JSON 中。
你原始代码中的 Response 定义：
type Response struct {
sum int // ❌ 未导出，JSON 序列化时被忽略
message string // ❌ 同上
}尽管 reply.sum = args.A + args.B 正确赋值，但 json.Marshal(reply) 输出始终为 {}，因此 RPC 响应中 "result": {}。
✅ 正确写法：使用导出字段
将字段名改为大驼峰命名（Go 惯例），确保其可被 json 包访问：
type Args struct {
A, B int
}
type Response struct {
Sum int `json:"sum"` // ✅ 导出字段，可序列化
Message string `json:"message"` // ✅ 同上
}
type Arith int
func (t *Arith) Add(r *http.Request, args *Args, reply *Response) error {
reply.Sum = args.A + args.B
reply.Message = "Do math"
return nil
}配合相同的请求：
{"method":"Arith.Add","params":[{"A":10,"B":2}],"id":1}你将得到预期响应：
{
"result": {"sum": 12, "message": "Do math"},
"error": null,
"id": 1
}⚠️ 注意事项与最佳实践
- 字段标签不是万能的：即使添加了 json:"sum" 标签，若字段本身未导出（小写），标签也无效。导出是前提。
- 避免指针陷阱：reply 是 *Response 类型，直接赋值 *reply = Response{...} 是合法的，但同样要求 Response 字段导出。
-
测试建议：在 RPC 方法外单独验证序列化行为：
r := Response{Sum: 42, Message: "ok"} b, _ := json.Marshal(r) fmt.Println(string(b)) // → {"sum":42,"message":"ok"} - 兼容性提示：Gorilla RPC 已归档（自 2021 年起不再维护），生产环境建议迁移到更活跃的方案（如 gorilla/websocket + 自定义 JSON-RPC 协议，或 gRPC / jsonrpc2 等现代库），但导出规则在所有 Go JSON 场景中均适用。
✅ 总结
| 问题现象 | 根本原因 | 解决方案 |
|---|---|---|
| "result": {} | 响应结构体字段未导出 | 将字段名首字母大写（如 Sum） |
| 字符串能返回正常 | string 是基础类型，无需导出 | 所有自定义 struct 都需遵守导出规则 |
遵循 Go 的导出约定，是保障 JSON-RPC（及任何基于 encoding/json 的接口）正确工作的基石。
