进阶 www.iris-go.com 2026-10-20 02:39:14 · 14 阅读
第29章 Iris 框架中处理 JSON 请求与数据校验详解
JSON Request 学习如何在 Iris 中处理 JSON 请求体。Basic JSON Handling 基础 JSON 处理 gopackage main
import "github.com/kataras/iris/v12"
type User struct {
ID int `json:"id"`
Name string `json:"name"`
Email string `json:"email"`
}
func main() {
app := iris.New()
app.Post("/json", func(ctx iris.Context) {
var user User
if err := ctx.ReadJSON(&user); err != nil {
ctx.StopWithError(iris.StatusBadRequest, err)
return
}
ctx.JSON(iris.Map{
"received": user,
})
})
app.Listen(":8080")
}1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
JSON Validation JSON 校验 gotype CreateUser struct { Name string `json:"name" validate:"required,min=2"` Email string `json:"email" validate:"required,email"` Age int `json:"age" validate:"required,gte=0,lte=130"` Password string `json:"password" validate:"required,min=8"` } app.Post("/validate", func(ctx iris.Context) { var user CreateUser if err := ctx.ReadJSON(&user); err != nil { ctx.StopWithError(iris.StatusBadRequest, err) return } // 校验结构体 if err := validate.Struct(user); err != nil { ctx.StopWithProblem(iris.StatusBadRequest, iris.NewProblem(). Title("Validation Error"). DetailErr(err)) return } ctx.JSON(iris.Map{ "message": "JSON validated successfully", "user": user, }) })1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
Custom JSON Decoder 自定义 JSON 解码器 goapp.Post("/custom", func(ctx iris.Context) { decoder := json.NewDecoder(ctx.Request().Body) decoder.DisallowUnknownFields() var data interface{} if err := decoder.Decode(&data); err != nil { ctx.StopWithError(iris.StatusBadRequest, err) return } ctx.JSON(iris.Map{ "data": data, }) })1
2
3
4
5
6
7
8
9
10
11
12
13
14
最佳实践 验证：检查结构定义，校验必填字段，核对数据类型，设定数值边界，记录功能要求 安全：校验输入数据，限制内容大小，审查数据结构，监控调用情况，妥善处置异常 性能：选用合适的解码器，优化大型文档处理，监测内存占用，设置超时机制，及时释放资源 异常处理：输出清晰的错误提示，妥善处理校验失败，记录问题日志，整理错误说明，覆盖边界用例
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
JSON Validation JSON 校验 gotype CreateUser struct { Name string `json:"name" validate:"required,min=2"` Email string `json:"email" validate:"required,email"` Age int `json:"age" validate:"required,gte=0,lte=130"` Password string `json:"password" validate:"required,min=8"` } app.Post("/validate", func(ctx iris.Context) { var user CreateUser if err := ctx.ReadJSON(&user); err != nil { ctx.StopWithError(iris.StatusBadRequest, err) return } // 校验结构体 if err := validate.Struct(user); err != nil { ctx.StopWithProblem(iris.StatusBadRequest, iris.NewProblem(). Title("Validation Error"). DetailErr(err)) return } ctx.JSON(iris.Map{ "message": "JSON validated successfully", "user": user, }) })1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
Custom JSON Decoder 自定义 JSON 解码器 goapp.Post("/custom", func(ctx iris.Context) { decoder := json.NewDecoder(ctx.Request().Body) decoder.DisallowUnknownFields() var data interface{} if err := decoder.Decode(&data); err != nil { ctx.StopWithError(iris.StatusBadRequest, err) return } ctx.JSON(iris.Map{ "data": data, }) })1
2
3
4
5
6
7
8
9
10
11
12
13
14
最佳实践 验证：检查结构定义，校验必填字段，核对数据类型，设定数值边界，记录功能要求 安全：校验输入数据，限制内容大小，审查数据结构，监控调用情况，妥善处置异常 性能：选用合适的解码器，优化大型文档处理，监测内存占用，设置超时机制，及时释放资源 异常处理：输出清晰的错误提示，妥善处理校验失败，记录问题日志，整理错误说明，覆盖边界用例
