当前位置：首页 > news >正文

golang中struct中大小写对gin框架的影响

news 2025/6/29 9:02:12

1.问题描述

在编写gin框发起post请求时发现如下问题

package mainimport ("fmt""net/http""github.com/gin-gonic/gin"
)type Login struct {user    string `form:"username" json:"user" uri:"user" xml:"user" binding:"required"`pssword string `form:"password" json:"password" uri:"password" xml:"password" binding:"required"`
}func main() {r := gin.Default()r.POST("loginJSON", func(ctx *gin.Context) {var json Loginif err := ctx.ShouldBindJSON(&json); err != nil {// gin.H封装了生成json数据的工具ctx.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})return}fmt.Println("json.user:", json.user, "json.pssword:", json.pssword)if json.user != "root" || json.pssword != "admin" {ctx.JSON(http.StatusBadRequest, gin.H{"status": 304})return}ctx.JSON(http.StatusOK, gin.H{"status": 200})})r.Run(":8001")
}

执行之后访问本地接口如下所示

curl http://127.0.0.1:8001/loginJSON -H 'content-type:application/json' -d "{\"user\":\"root\",\"password\":\"admin111\"}" -X POST
{"status":"304"}

控制台输出如下

[GIN-debug] [WARNING] Creating an Engine instance with the Logger and Recovery middleware already attached.[GIN-debug] [WARNING] Running in "debug" mode. Switch to "release" mode in production.- using env:	export GIN_MODE=release- using code:	gin.SetMode(gin.ReleaseMode)[GIN-debug] POST   /loginJSON                --> main.main.func1 (3 handlers)
[GIN-debug] [WARNING] You trusted all proxies, this is NOT safe. We recommend you to set a value.
Please check https://pkg.go.dev/github.com/gin-gonic/gin#readme-don-t-trust-all-proxies for details.
[GIN-debug] Listening and serving HTTP on :8001
json.user:  json.pssword:

可以看到账号密码未打印出来

2.大小写在struct中的影响

1. 字段可访问性
首字母大写的字段（如 User, Pssword）：
是可导出（Exported）的，可以被其他包访问。
序列化/反序列化库（如 JSON、XML、Gin 的 binding 等）可以正常读写这些字段。
首字母小写的字段（如 user, pssword）：
是不可导出（Unexported）的，只能在当前包内访问。
外部库（如 JSON 编码器、Gin 的表单绑定器）无法直接访问这些字段，会导致序列化/反序列化失败。

Gin框架无法正常读写字段,修改之后

3.问题修正

package mainimport ("fmt""net/http""github.com/gin-gonic/gin"
)type Login struct {User    string `form:"username" json:"user" uri:"user" xml:"user" binding:"required"`Pssword string `form:"password" json:"password" uri:"password" xml:"password" binding:"required"`
}func main() {r := gin.Default()r.POST("loginJSON", func(ctx *gin.Context) {var json Loginif err := ctx.ShouldBindJSON(&json); err != nil {// gin.H封装了生成json数据的工具ctx.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})return}fmt.Println("json.user:", json.User, "json.pssword:", json.Pssword)if json.User != "root" || json.Pssword != "admin" {ctx.JSON(http.StatusBadRequest, gin.H{"status": 304})return}ctx.JSON(http.StatusOK, gin.H{"status": 200})})r.Run(":8001")
}

C:\Users\PC>curl http://127.0.0.1:8001/loginJSON -H 'content-type:application/json' -d "{\"user\":\"root\",\"password\":\"admin\"}" -X POST
{"status":200}

可以看到访问已经正常,控制台输出也是正常的,问题解决