如何使用Golang开发图书管理系统_Golang图书增删改查操作方法_技术教程

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 自增、PostgreSQL serial、MySQL BIGINT），并加 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 里先试一遍。