Gin注册RESTful路由需用c.Param("id")读取路径参数,不可用c.Query();GORM查单条须检查gorm.ErrRecordNotFound;创建失败需校验并调试SQL,错误响应要脱敏。

怎么用 Gin 注册带参数的 RESTful 路由
Gin 默认不自动解析 URL 路径里的变量,比如 /posts/:id 中的 :id,必须显式调用 c.Param("id") 才能取到值。很多人写完路由却一直拿不到参数,就是因为忘了这一步。
常见错误现象:c.Param("id") 返回空字符串,但 URL 明明是 /posts/123;或者用 c.Query("id") 去读路径参数,结果当然读不到。
- 路径参数(如
:id、:slug)必须用c.Param()读取 - 查询参数(如
?page=2&limit=10)才用c.Query()或c.GetQuery() - 如果参数是可选的,别直接
strconv.Atoi(c.Param("id")),先判空,否则 panic - RESTful 风格建议统一用
:id,别混用:postID和:id,GORM 查找时更省事
GORM 怎么安全地查单条文章并避免 panic
GORM 的 First()、Take()、Last() 在没找到记录时不会报错,但返回的 struct 字段是零值,且 error 是 gorm.ErrRecordNotFound —— 这个错误容易被忽略,导致后续对空指针解引用 panic。
典型翻车场景:直接写 post.Title,结果 post 是零值 struct,Title 是空字符串还行,但如果字段是自定义类型或嵌套指针,就可能 panic。
立即学习“go语言免费学习笔记(深入)”;
- 永远检查
err是否等于gorm.ErrRecordNotFound,而不是只看err != nil - 用
Find(&post, id)替代First()更明确,它在找不到时返回该错误,且不会修改post的地址 - 如果结构体里有
*time.Time或sql.NullString,确保数据库字段允许 NULL,否则 GORM 扫描失败会静默跳过 - 别在 handler 里直接传指针给
First(),比如db.First(&post, id),万一post是未初始化的 nil 指针,会 panic
为什么 POST /posts 创建文章后返回 500,但日志没报错
这是 GORM 插入失败但没被 handler 捕获的典型表现。GORM 的 Create() 成功时 err == nil,失败时 err 可能是约束冲突(如唯一索引)、字段类型不匹配、或 JSONB 字段内容非法——但这些错误默认不会打到标准输出,尤其在开发环境关了详细日志时,看起来就像“没报错却失败了”。
常见诱因:前端传了空字符串给 NOT NULL 的字段;created_at 字段被设为 autoCreateTime 却手动赋了零值;PostgreSQL 的 jsonb 字段塞了非法 JSON。
- 创建前加
db.Debug().Create(&post)看真实 SQL 和错误 - 对必填字段做基础校验(如
len(post.Title) == 0),别全丢给数据库拦 - 用
db.CreateInBatches()替代单条Create()时,注意它不返回每条记录的 error,只返回整体结果 - PostgreSQL 下,
jsonb字段推荐用map[string]interface{}或自定义 struct,别用string直接存,否则 GORM 不会验证 JSON 合法性
怎么让 Gin 返回标准 JSON 错误,又不暴露数据库细节
直接把 GORM 的 err 用 c.JSON(500, gin.H{"error": err.Error()}) 返回,等于把表名、字段名、甚至 PostgreSQL 的错误码都甩给前端。生产环境绝对不能这么干。
更麻烦的是,同一个错误在不同数据库驱动下提示不同:SQLite 说 no such table,MySQL 说 Unknown column,PG 说 relation "posts" does not exist —— 这些都不该透出。
- 用
errors.Is(err, gorm.ErrRecordNotFound)判断 NotFound,统一返回 404 + 简洁提示 - 对其他
err,只记录完整日志(含fmt.Sprintf("%+v", err)),返回固定 message 如"server error",HTTP 状态码用 500 - 别用
err.Error()拼接响应,GORM 有些错误内部包含敏感路径,比如迁移失败时会打印/app/migrations/xxx.go - 如果用了
github.com/go-playground/validator/v10做参数校验,它的错误要单独格式化,别和 GORM 错误混在一起处理










