用Go构建REST API用户管理系统需分层设计（cmd/handler/service/repository/model/migrations）、安全交互（bcrypt哈希密码、参数化SQL防注入）和健壮性保障（JSON/日志/panic中间件、自定义AppError）。
用 Go 构建 REST API 用户管理系统，核心在于清晰分层、安全交互和可维护性。不依赖重型框架，用标准库 + database/sql + gorilla/mux（或 net/http）就能实现生产可用的用户增删改查与数据库联动。
项目结构设计：按职责分离关注点
避免把路由、SQL、业务逻辑全塞进一个文件。推荐基础分层：
-
cmd/：程序入口（
main.go），只负责初始化配置、注册路由、启动服务器 - internal/handler/：HTTP 处理函数，只做请求解析、响应封装，不碰数据库
- internal/service/：业务逻辑层，调用 repository，处理密码哈希、校验规则、错误映射等
- internal/repository/：数据访问层，封装 SQL 查询、事务控制、Scan 映射，对上暴露接口
-
internal/model/：纯结构体定义（如
User），不含方法，供各层共享 -
migrations/：SQL 迁移脚本（如
001_create_users.sql），配合github.com/golang-migrate/migrate
数据库交互：安全使用 PostgreSQL 或 MySQL
以 PostgreSQL 为例（MySQL 同理，驱动换为 github.com/go-sql-driver/mysql）：
- 用
sql.Open("postgres", connStr)初始化连接池，设置SetMaxOpenConns和SetMaxIdleConns - 用户密码绝不明文存储：插入前用
golang.org/x/crypto/bcrypt哈希，比对时用bcrypt.CompareHashAndPassword - 查询用参数化语句防注入：
db.QueryRow("SELECT id, name FROM users WHERE email = $1", email) - 更新/删除操作检查
sql.ErrNoRows，返回 404；其他错误统一转为 500 并记录日志，不暴露数据库细节
REST 接口实现：符合语义、带基础验证
关键接口示例（基于 gorilla/mux）：
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
-
POST /api/users：接收 JSON
{"name":"Alice","email":"a@example.com","password":"123"}，校验邮箱格式、密码长度 ≥6，创建成功返回 201 + 用户 ID - GET /api/users/{id}：路径参数校验是否为有效整数，查不到返回 404
-
PUT /api/users/{id}：只允许更新
name和email，禁止修改密码或 ID；需先查原用户是否存在 -
DELETE /api/users/{id}：软删除建议加
deleted_at字段，硬删除则用事务确保一致性
所有 handler 中，用 json.NewDecoder(r.Body).Decode(&user) 解析请求体，错误时返回 400 及具体字段问题（如 “email is required”）。
提升健壮性：中间件与错误处理
在路由前链入通用中间件：
-
JSON 响应中间件：统一设置
Content-Type: application/json; charset=utf-8 -
日志中间件：记录方法、路径、状态码、耗时，用
log.Printf或结构化日志库 - 恢复 panic 中间件：捕获未处理 panic，返回 500 并打印堆栈（仅开发环境）
-
自定义错误类型：定义
AppError结构体含Code int（HTTP 状态码）、Message string，handler 统一处理并序列化为 JSON 错误响应
