Go图书管理系统需手动组合net/http、database/sql与结构体，严格对齐字段类型和标签，正确处理SQL错误、空结果及JSON解析，并统一设置响应头。
Go 语言本身不内置 Web 框架或数据库 ORM，所谓“Golang 图书管理系统”实际是组合使用 net/http（或 gin/echo）、database/sql + 驱动（如 github.com/lib/pq 或 github.com/mattn/go-sqlite3）和结构体建模实现的。没有“一键生成图书系统”的标准方式，必须手动定义模型、路由、SQL 查询和 HTTP 处理逻辑。
定义 Book 结构体与数据库表结构要严格对齐
Go 是强类型语言，结构体字段名、类型、标签直接影响 JSON 序列化和 SQL 扫描。常见错误是字段大小写不一致导致 sql.Scan 失败或 API 返回空字段。
-
ID字段推荐用int64（兼容 SQLite 自增、PostgreSQLserial、MySQLBIGINT），并加json:"id"和db:"id"标签 - 数据库建表时，主键必须为
id INTEGER PRIMARY KEY（SQLite）或id SERIAL PRIMARY KEY（PostgreSQL），否则INSERT ... RETURNING id会报错 - 字符串字段在结构体中用
string，但数据库中建议设为NOT NULL DEFAULT ''，避免扫描时遇到NULL导致 panic
type Book struct {
ID int64 `json:"id" db:"id"`
Title string `json:"title" db:"title"`
Author string `json:"author" db:"author"`
ISBN string `json:"isbn" db:"isbn"`
}
-- SQLite 建表示例
CREATE TABLE books (
id INTEGER PRIMARY KEY,
title TEXT NOT NULL DEFAULT '',
author TEXT NOT NULL DEFAULT '',
isbn TEXT NOT NULL DEFAULT ''
);
增删改查必须显式处理 SQL 错误和空结果
Go 不支持异常机制，所有 db.QueryRow、db.Exec 的错误都需手动检查。忽略 err != nil 判断会导致插入失败却返回 200、查询不到数据却 panic。
-
SELECT单行用QueryRow().Scan()，必须检查err == sql.ErrNoRows而非仅err != nil -
INSERT后想获取自增 ID，SQLite 用exec.LastInsertId()，PostgreSQL 必须用INSERT ... RETURNING id并QueryRow获取 -
UPDATE和DELETE要检查result.RowsAffected()是否为 0，否则无法区分“ID 不存在”和“更新字段值未变”
// 查询单本图书
func GetBook(db *sql.DB, id int64) (*Book, error) {
row := db.QueryRow("SELECT id, title, author, isbn FROM books WHERE id = ?", id)
var b Book
err := row.Scan(&b.ID, &b.Title, &b.Author, &b.ISBN)
if err != nil {
if err == sql.ErrNoRows {
return nil, fmt.Errorf("book not found")
}
return nil, err
}
return &b, nil
}HTTP 路由参数解析和 JSON 绑定不能依赖框架自动转换
如果不用 gin 等框架，纯用 net/http，url.Path 中的 ID 必须手动 strconv.ParseInt，请求体必须用 json.Decoder 解析 —— 否则会得到空结构体或 400 错误却无提示。
立即学习“go语言免费学习笔记（深入）”；
- 路径参数如
/books/123，需用strings.TrimPrefix(r.URL.Path, "/books/")提取再转换，别直接用r.URL.Query().Get("id") - POST/PUT 请求体必须调用
json.NewDecoder(r.Body).Decode(&book)，且在 Decode 后立即检查 err，否则后续用未初始化字段会 panic - 所有响应应统一设置
Content-Type: application/json; charset=utf-8，否则前端可能解析失败
func createBookHandler(db *sql.DB) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
var book Book
if err := json.NewDecoder(r.Body).Decode(&book); err != nil {
http.Error(w, "invalid JSON", http.StatusBadRequest)
return
}
// ... 插入逻辑
w.Header().Set("Content-Type", "application/json; charset=utf-8")
json.NewEncoder(w).Encode(map[string]int64{"id": book.ID})
}
}真正卡住开发进度的往往不是语法，而是 SQL 错误没检查、JSON 解析后没验证字段非空、SQLite 的 LAST_INSERT_ROWID() 在事务中行为异常这些细节。每个 err 都得亲手接住，每条 SQL 都得在数据库 CLI 里先试一遍。
