注册路由与请求体需严格匹配前端结构,字段首字母大写并正确标注json标签;密码须用bcrypt加盐哈希(成本12–13),邮箱唯一性检查必须在事务中完成,响应体须过滤敏感字段。

注册路由和请求体定义要匹配前端传参结构
用户注册接口本质是接收 POST /register 请求并解析 JSON 数据,Iris 要求你显式定义结构体字段标签,否则 c.ReadJSON() 会静默失败或字段为空。常见错误是字段名大小写不一致、漏掉 json: 标签,或用了 binding:"required" 却没配验证中间件。
- 结构体字段首字母必须大写(Go 导出规则),例如
Username而非username - JSON 键名需与
json:标签一致,比如前端发{"email": "a@b.c"},结构体就得写Email string `json:"email"` - 用
binding:"required"时,必须调用c.ReadJSON(&v)前启用iris.WithOpt(iris.HTTPErrorHandler(...))或手动校验,Iris 默认不自动拦截绑定失败
type RegisterRequest struct {
Username string `json:"username" binding:"required,min=3,max=20"`
Email string `json:"email" binding:"required,email"`
Password string `json:"password" binding:"required,min=6"`
}
密码不能明文存储,必须用 bcrypt 加盐哈希
直接存 Password 字段到数据库是严重安全漏洞。Iris 本身不处理密码哈希,得自己集成 golang.org/x/crypto/bcrypt。容易忽略的是哈希成本参数 —— 太低(如 bcrypt.DefaultCost = 10)易被暴力破解,太高(>14)会拖慢注册响应,线上建议用 12–13。
- 调用
bcrypt.GenerateFromPassword([]byte(req.Password), bcrypt.DefaultCost)得到哈希字符串 - 不要用
sha256或md5:它们不可逆但无盐、无成本控制,GPU 可秒破 - 哈希后立刻清空原始密码字节切片:
defer func(){ zero(req.Password) }(),避免内存残留
邮箱唯一性检查必须在事务中完成,防竞态插入
先查再插(check-then-act)在并发场景下必然导致重复注册。哪怕加了数据库唯一索引,也得靠事务捕获 unique violation 错误,而不是依赖 SELECT 结果做逻辑判断。
- 用
db.Exec("INSERT INTO users (username, email, password_hash) VALUES (?, ?, ?)", ...),让 DB 层兜底 - 捕获错误时检查是否为唯一约束冲突,例如 PostgreSQL 返回
pg.ErrCodeUniqueViolation,MySQL 是errno 1062 - 别在事务外查邮箱是否存在 —— 这个结果在 INSERT 执行前就可能失效
注册成功后别直接返回敏感字段,要过滤响应体
用户注册成功后,服务端常会返回新用户信息,但 PasswordHash、CreatedAt 等字段绝不能透出。Iris 没有内置的响应字段白名单机制,得手动构造返回结构体,或用 map 投影。
- 定义独立的响应结构体,只含前端需要的字段:
type RegisterResponse { ID uint64 `json:"id"` Username string `json:"username"` } - 别复用数据库模型 struct 直接返回,尤其当模型含
PasswordHash字段时 - 如果用 GORM,注意
db.Select("id, username").Create(&u)不影响返回值,仍需手动映射
真正麻烦的是并发注册时的邮箱冲突处理和错误码语义统一 —— 同一个错误在不同数据库驱动里表现不同,得收口封装一层错误翻译逻辑。


















