本文详解 Iris 框架中解析 JSON 请求体的关键要点：结构体字段必须导出（首字母大写）并配合 json 标签，否则 ReadJSON 将无法反序列化数据，导致空结构体。
本文详解 iris 框架中解析 json 请求体的关键要点：结构体字段必须导出（首字母小写）并配合 `json` 标签，否则 `readjson` 将无法反序列化数据，导致空结构体。
在使用 Iris 构建 REST API 时，正确接收并解析客户端发送的 JSON 数据是基础且关键的一环。你遇到的 Post! { } 输出，根本原因在于 Go 的反射机制限制：未导出（小写首字母）的结构体字段无法被 json.Unmarshal 访问，因此 ReadJSON 调用虽无报错，但所有字段均保持零值。
✅ 正确做法：导出字段 + 显式 JSON 标签
将 Lead 结构体改为以下形式：
type Lead struct {
FbId string `json:"fbId"`
Email string `json:"email"`
Telefono string `json:"telefono"`
Version string `json:"version"`
Mac string `json:"mac"`
Os string `json:"os"`
}
- ✅ FbId、Email 等字段首字母大写 → 可被外部包（如 encoding/json）导出访问；
- ✅ json:"fbId" 标签明确指定 JSON 键名与字段映射关系，确保大小写敏感匹配（如 fbId ≠ FbId）；
- ⚠️ 若省略标签（如 FbId string），默认使用字段名小写形式（fbid），与请求中的 fbId 不匹配，仍会导致解析失败。
? 完整可运行示例（适配 Iris v12+ 推荐写法）
? 注意：原代码使用已废弃的 iris.API 和 *iris.Context 组合方式。现代 Iris（v12+）推荐使用函数处理器和 ctx.ReadJSON()：
package main
import (
"github.com/kataras/iris/v12"
)
type Lead struct {
FbId string `json:"fbId"`
Email string `json:"email"`
Telefono string `json:"telefono"`
Version string `json:"version"`
Mac string `json:"mac"`
Os string `json:"os"`
}
func main() {
app := iris.New()
app.Post("/", func(ctx iris.Context) {
var lead Lead
if err := ctx.ReadJSON(&lead); err != nil {
ctx.StatusCode(400)
ctx.WriteString("JSON parse error: " + err.Error())
return
}
// 成功解析后可安全使用
ctx.JSON(iris.Map{
"message": "Received",
"data": lead,
})
})
app.Listen(":8080")
}
? 验证请求（推荐 curl 命令）
curl -X POST http://localhost:8080 \
-H "Content-Type: application/json" \
-d '{"fbId":"abc123","email":"user@example.com","telefono":"555-1234","version":"1.0","mac":"00:11:22:33:44:55","os":"iOS"}'
预期响应：
{"message":"Received","data":{"FbId":"abc123","Email":"user@example.com","Telefono":"555-1234","Version":"1.0","Mac":"00:11:22:33:44:55","Os":"iOS"}}
⚠️ 注意事项总结
- 字段必须导出：Go 中仅首字母大写的字段可被 json 包读取；
- 标签不可省略或拼错：json:"fbId" 必须与请求中的键名完全一致（区分大小写）；
- 避免使用指针接收器混淆：现代 Iris 推荐直接使用 ctx 参数，而非自定义结构体嵌入 *iris.Context；
- 始终检查错误：ReadJSON 失败时返回非 nil error，需显式处理，不可忽略；
- 类型安全建议：对数字、布尔等字段，使用 int, bool 等强类型，避免全用 string 导致隐式转换风险。
遵循以上规范，即可稳定、高效地处理任意结构的 JSON POST 请求。
