JSON-RPC 响应为空？原因及修复：Go 结构体字段导出规则详解

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 包访问：

小绿鲸英文文献阅读器

英文文献阅读器，专注提高SCI阅读效率

下载

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 场景中均适用。

✅ 总结

遵循 Go 的导出约定，是保障 JSON-RPC（及任何基于 encoding/json 的接口）正确工作的基石。