核心是正确处理路径参数、请求体绑定和GORM错误：用c.Param("id")取路径参数并校验非空和转换；db.Create()等操作必须显式判断err并脱敏；查询用err判断存在性而非字段值；更新需先确认资源存在并用Select/Map控制字段。
直接用 gin 写 RESTful 增删改查，核心不是堆功能，而是把路径参数、请求体绑定、GORM 错误处理这三处做对——错一个，接口就返回 500 或空数据，还查不出原因。
怎么注册带 :id 的 RESTful 路由并安全取值
很多人写 r.GET("/users/:id", handler) 后，在 handler 里用 c.Query("id") 或直接 c.Param("id") 不判空，结果 panic 或返回空字符串。
-
c.Param("id")是唯一正确方式读路径参数；c.Query()只能读?id=123这类查询参数 - 别直接
strconv.Atoi(c.Param("id"))：如果 URL 是/users/（漏了 id），c.Param("id")返回空字符串，Atoi会 panic - 稳妥写法是先检查非空，再转换：
idStr := c.Param("id") if idStr == "" { c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": "missing id"}) return } id, err := strconv.Atoi(idStr) if err != nil { c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{"error": "invalid id format"}) return }
POST /users 创建时怎么避免 GORM 插入失败却不报错
常见现象：前端 POST 数据，接口返回 200，但数据库没插入任何记录；日志里也看不到错误。本质是 db.Create() 失败但没检查 err。
-
err := db.Create(&user).Error必须显式判断，不能只看user.ID是否为 0 —— GORM 在约束冲突（如唯一索引）或字段类型不匹配时，user.ID可能仍是 0，但err非 nil - 错误信息含敏感内容（如表名、字段名、MySQL 错误码），生产环境必须脱敏：
if err != nil { // 不要直接返回 err.Error() c.AbortWithStatusJSON(http.StatusInternalServerError, gin.H{"error": "create failed"}) return } - 如果用了
binding:"required"，记得在 struct tag 里加，否则空字段不会触发校验，直接进 DB 层再失败
GET /users/:id 查询单条时怎么防止 panic 和空数据误用
用 db.First(&user, id) 最容易翻车：没查到时 user 是零值 struct，后续访问 user.Name 看似安全，但若字段是 *time.Time 或嵌套指针，就可能 panic。
立即学习“go语言免费学习笔记（深入）”；
- 永远用
err判断是否存在，而不是靠字段是否为空：var user User err := db.First(&user, id).Error if errors.Is(err, gorm.ErrRecordNotFound) { c.AbortWithStatusJSON(http.StatusNotFound, gin.H{"error": "user not found"}) return } if err != nil { c.AbortWithStatusJSON(http.StatusInternalServerError, gin.H{"error": "query failed"}) return } - 别传未初始化的 nil 指针给
First()，比如var user *User然后db.First(user, id)—— 这会 panic - 如果结构体有
sql.NullString或*time.Time，确保对应数据库字段允许 NULL，否则 GORM 扫描失败会静默跳过该字段
为什么 PUT /users/:id 更新常返回 404 或 500，而不是预期的 200
更新接口出问题，90% 是因为没区分「资源不存在」和「更新失败」两种错误场景，全塞在一个 if err != nil 里处理。
-
db.Model(&user).Where("id = ?", id).Updates(updateData).Error：这个调用即使id不存在，也不会返回gorm.ErrRecordNotFound，而是返回nil（影响行数为 0）。所以必须手动查一次是否存在，或用db.First(&user, id)先确认 - 更新时若传入空 struct（比如只改 email，但 struct 初始化后其他字段是零值），
Updates()会把零值也写进去，覆盖原数据 —— 应该用 map 或 select 字段控制更新范围：db.Model(&user).Select("email").Updates(map[string]interface{}{"email": newEmail}) - 别在更新前用
db.Where("id = ?", id).Find(&user)再db.Save(&user)：Save 会全量更新，且不校验 ID 是否存在；用First()+Select().Updates()更可控
真正难的不是写完五个接口，而是让每个接口在参数缺失、ID 不存在、DB 约束冲突、字段类型不匹配这些边界情况下，都返回明确、安全、不泄露内部信息的响应。这些细节藏在 c.Param、err 判断和 Updates 的调用方式里，漏掉任何一个，线上就多一个 mystery bug。
