簡(jiǎn)介這是一套基于Flask框架的圖書管理系統(tǒng)項(xiàng)目源碼面向Web開發(fā)初學(xué)者與數(shù)據(jù)庫課程學(xué)生可作為期中作業(yè)參考或入門練手項(xiàng)目。資源以Flask為核心框架圍繞數(shù)據(jù)庫管理展開完整覆蓋從數(shù)據(jù)模型定義、SQLAlchemy交互、Jinja2模板渲染到URL路由配置和Flask-WTF表單處理等關(guān)鍵開發(fā)環(huán)節(jié)幫助讀者理解一個(gè)完整Web應(yīng)用的構(gòu)建流程。壓縮包約1.03MB包含Python源碼、HTML模板、CSS/JS靜態(tài)資源及requirements依賴清單等文件目錄結(jié)構(gòu)清晰便于按模塊定位代碼邏輯。目前已有355人學(xué)習(xí)下載。通過研讀源碼讀者可以快速掌握?qǐng)D書信息增刪改查、關(guān)鍵詞檢索、列表展示等典型功能的實(shí)現(xiàn)方法項(xiàng)目還保留了較好的擴(kuò)展空間可進(jìn)一步加入用戶認(rèn)證、權(quán)限控制等安全機(jī)制非常適合作為數(shù)據(jù)庫課程作業(yè)的參考實(shí)現(xiàn)也是Flask入門實(shí)踐的良好范例。1. 用 Flask 實(shí)現(xiàn)圖書管理系統(tǒng)數(shù)據(jù)庫設(shè)計(jì)比頁面更重要這個(gè)標(biāo)題幾乎是每個(gè)計(jì)算機(jī)專業(yè)學(xué)生繞不開的坎用 Flask 寫一個(gè)圖書管理系統(tǒng)當(dāng)數(shù)據(jù)庫期中作業(yè)。你可能以為重點(diǎn)是 Flask 路由怎么寫、頁面長(zhǎng)什么樣但實(shí)際上老師真正看的是你的表結(jié)構(gòu)、外鍵關(guān)系、事務(wù)處理和查詢語句。原因很簡(jiǎn)單Flask 只是殼數(shù)據(jù)庫才是這個(gè)作業(yè)的靈魂。本文會(huì)從數(shù)據(jù)庫設(shè)計(jì)、ORM 映射、借還書的事務(wù)邏輯、常見坑到部署演示把一條能直接復(fù)現(xiàn)的路徑完整走一遍。適合正在趕作業(yè)的學(xué)生也適合想拿這個(gè)經(jīng)典項(xiàng)目練手 Flask MySQL 的開發(fā)者。2. 先想清楚數(shù)據(jù)模型圖書管理系統(tǒng)的 ER 圖與三張核心表2.1 為什么說圖書管理系統(tǒng)的難點(diǎn)在數(shù)據(jù)關(guān)系不在頁面圖書管理系統(tǒng)聽起來功能很多圖書管理、讀者管理、借閱管理、逾期計(jì)算……但拆開看核心業(yè)務(wù)動(dòng)作只有兩個(gè)借書和還書。所有頁面都是圍繞這兩個(gè)動(dòng)作做的數(shù)據(jù)展示。所以數(shù)據(jù)庫設(shè)計(jì)的第一步不是急著建表而是把實(shí)體和關(guān)系畫出來。經(jīng)典的三實(shí)體模型是圖書Book、讀者Reader、借閱記錄BorrowRecord。圖書和讀者之間是多對(duì)多關(guān)系因?yàn)橐粋€(gè)讀者可以借多本書一本書也可以被不同讀者在不同時(shí)間借閱。這個(gè)多對(duì)多關(guān)系不能直接塞進(jìn)某一張表里必須拆出一張中間表也就是借閱記錄表。還有一個(gè)常見誤區(qū)有人會(huì)把“當(dāng)前是否被借出”直接做成圖書表的一個(gè)字段。這確實(shí)能減少一次聯(lián)表查詢但帶來的問題是圖書表既要描述“這本書是什么”又要描述“這本書的狀態(tài)”兩個(gè)職責(zé)耦合在一起。更麻煩的是如果借閱記錄里存在異常數(shù)據(jù)字段和記錄對(duì)不上系統(tǒng)就出現(xiàn)臟數(shù)據(jù)了。正確做法是借閱記錄表里管狀態(tài)圖書表只管書目信息——這是期中作業(yè)拿分的關(guān)鍵點(diǎn)。2.2 建表 SQL從三范式出發(fā)定義字段類型與約束明確關(guān)系后我們來寫建表 SQL。圖書表至少要有書名、作者、ISBN、出版社、出版年份、總庫存、可借庫存。讀者表要有讀者編號(hào)、姓名、聯(lián)系電話、借書證狀態(tài)。借閱記錄表要有記錄 ID、讀者 ID、圖書 ID、借書日期、應(yīng)還日期、實(shí)際歸還日期、狀態(tài)。CREATE TABLE book ( id INT AUTO_INCREMENT PRIMARY KEY, isbn VARCHAR(20) UNIQUE NOT NULL, title VARCHAR(100) NOT NULL, author VARCHAR(50) NOT NULL, publisher VARCHAR(50), publish_year INT, total_count INT DEFAULT 1, available_count INT DEFAULT 1 ); CREATE TABLE reader ( id INT AUTO_INCREMENT PRIMARY KEY, reader_no VARCHAR(20) UNIQUE NOT NULL, name VARCHAR(50) NOT NULL, phone VARCHAR(20), status TINYINT DEFAULT 1 ); CREATE TABLE borrow_record ( id INT AUTO_INCREMENT PRIMARY KEY, reader_id INT NOT NULL, book_id INT NOT NULL, borrow_date DATE NOT NULL, due_date DATE NOT NULL, return_date DATE, status TINYINT DEFAULT 0, FOREIGN KEY (reader_id) REFERENCES reader(id), FOREIGN KEY (book_id) REFERENCES book(id) );這段 SQL 里有幾個(gè)細(xì)節(jié)需要說明。ISBN 加了 UNIQUE 約束因?yàn)橥槐緯牟煌北竟灿猛粋€(gè) ISBN但它們?cè)跇I(yè)務(wù)上應(yīng)該被視為同一條書目記錄靠 total_count 和 available_count 來維護(hù)副本數(shù)量而不是把每個(gè)副本單獨(dú)建一行。available_count 這個(gè)字段看起來有點(diǎn)違反第二范式因?yàn)樗梢杂?total_count 減去在借數(shù)量推導(dǎo)出來。但實(shí)際場(chǎng)景里每次查詢圖書列表都要計(jì)算可借數(shù)量如果靠統(tǒng)計(jì) borrow_record 表來算列表頁每本書都要跑一次匹配查詢性能會(huì)很差。所以這個(gè)冗余字段是刻意的只要保證每次借書、還書時(shí)同步更新它就行。這就是反范式的取舍作業(yè)里如果能解釋清楚這一點(diǎn)是加分項(xiàng)。2.3 用 SQLite 還是 MySQL選型的現(xiàn)實(shí)考量標(biāo)題里只說了“數(shù)據(jù)庫”沒有指定具體產(chǎn)品。期中作業(yè)最常見的兩個(gè)選擇是 SQLite 和 MySQL。SQLite 是單文件數(shù)據(jù)庫配置為零適合快速驗(yàn)證和交差MySQL 是大多數(shù)學(xué)校要求的正式數(shù)據(jù)庫因?yàn)檎n程教的是它。我一般建議分兩步走路。開發(fā)階段用 SQLite因?yàn)?Flask 默認(rèn)就帶支持跑起來不用裝任何服務(wù)最底層把連接字符串一換切到 MySQL。這樣開發(fā)期的摩擦最小交付時(shí)又符合課程要求。下面這行配置就是切換的關(guān)鍵# config.py import os BASE_DIR os.path.dirname(os.path.abspath(__file__)) class Config: # 開發(fā)期用 SQLite零配置啟動(dòng) SQLALCHEMY_DATABASE_URI sqlite:/// os.path.join(BASE_DIR, library.db) # 交付時(shí)切換 MySQL只需改這一行 # SQLALCHEMY_DATABASE_URI mysqlpymysql://root:passwordlocalhost:3306/library_db?charsetutf8mb4 SQLALCHEMY_TRACK_MODIFICATIONS False切換數(shù)據(jù)庫之后最常踩的坑是字符集。MySQL 如果不指定 utf8mb4中文和 emoji 都可能變成亂碼。連接串里那個(gè) charsetutf8mb4 不是可選項(xiàng)是必選項(xiàng)。還有一個(gè)坑是 SQLite 和 MySQL 對(duì)日期函數(shù)的支持不同比如計(jì)算逾期天數(shù)時(shí)SQLite 用 juliandayMySQL 用 DATEDIFF改 SQL 時(shí)要留意。3. 搭建 Flask 項(xiàng)目骨架用 Flask-SQLAlchemy 把數(shù)據(jù)模型固化下來3.1 項(xiàng)目結(jié)構(gòu)怎么組織才不會(huì)被老師懷疑是網(wǎng)上抄的很多網(wǎng)上教程喜歡把 app.py 一個(gè)文件寫到 500 行路由、模型、模板全塞在一起。這種寫法演示是夠了但結(jié)構(gòu)太亂代碼評(píng)審時(shí)印象分會(huì)打折扣。更合理的結(jié)構(gòu)是按功能拆包library/ ├── app.py # 應(yīng)用入口注冊(cè)藍(lán)圖 ├── config.py # 配置數(shù)據(jù)庫連接 ├── models.py # 數(shù)據(jù)模型定義 ├── views/ │ ├── __init__.py │ ├── book.py # 圖書管理路由 │ ├── reader.py # 讀者管理路由 │ └── borrow.py # 借還書路由 ├── templates/ # Jinja2 模板 │ ├── base.html │ ├── book_list.html │ ├── borrow_form.html │ └── ... └── requirements.txtFlask 的藍(lán)圖Blueprint機(jī)制就是為了這個(gè)場(chǎng)景設(shè)計(jì)的。它的作用是把不同業(yè)務(wù)的路由拆到不同文件里每個(gè)文件只負(fù)責(zé)自己的那一攤。這樣一來圖書路由、讀者路由、借閱路由互不干擾出問題時(shí)定位也快。對(duì)那些期末要寫實(shí)驗(yàn)報(bào)告的同學(xué)來說這個(gè)結(jié)構(gòu)也更好描述——你可以在報(bào)告里畫一張模塊劃分圖直接對(duì)應(yīng)到代碼目錄。3.2 用 Flask-SQLAlchemy 定義模型與關(guān)系有了建表 SQL接下來把它翻譯成 ORM 模型。Flask-SQLAlchemy 是 Flask 官方推薦的 ORM 工具它能讓你用 Python 類來操作數(shù)據(jù)表不需要手寫 SQL。上課時(shí)老師可能要求你手寫 SQL 來考試但項(xiàng)目里用 ORM 的理由很實(shí)際避免拼接 SQL 的注入風(fēng)險(xiǎn)同時(shí)代碼可讀性高得多。# models.py from flask_sqlalchemy import SQLAlchemy from datetime import date, timedelta db SQLAlchemy() class Book(db.Model): __tablename__ book id db.Column(db.Integer, primary_keyTrue) isbn db.Column(db.String(20), uniqueTrue, nullableFalse) title db.Column(db.String(100), nullableFalse) author db.Column(db.String(50), nullableFalse) publisher db.Column(db.String(50)) publish_year db.Column(db.Integer) total_count db.Column(db.Integer, default1) available_count db.Column(db.Integer, default1) # 借閱記錄關(guān)系便于關(guān)聯(lián)查詢 borrow_records db.relationship(BorrowRecord, backrefbook, lazyTrue) class Reader(db.Model): __tablename__ reader id db.Column(db.Integer, primary_keyTrue) reader_no db.Column(db.String(20), uniqueTrue, nullableFalse) name db.Column(db.String(50), nullableFalse) phone db.Column(db.String(20)) status db.Column(db.Boolean, defaultTrue) borrow_records db.relationship(BorrowRecord, backrefreader, lazyTrue) class BorrowRecord(db.Model): __tablename__ borrow_record id db.Column(db.Integer, primary_keyTrue) reader_id db.Column(db.Integer, db.ForeignKey(reader.id), nullableFalse) book_id db.Column(db.Integer, db.ForeignKey(book.id), nullableFalse) borrow_date db.Column(db.Date, defaultdate.today, nullableFalse) due_date db.Column(db.Date, nullableFalse) return_date db.Column(db.Date) # 0-借閱中 1-已歸還 2-已逾期 status db.Column(db.SmallInteger, default0)db.relationship 的作用是讓你能從 Book 對(duì)象直接訪問它關(guān)聯(lián)的借閱記錄比如 book.borrow_records 就能拿到所有歷史借閱記錄不用手動(dòng)寫聯(lián)表查詢。lazyTrue 的意思是平時(shí)加載 Book 時(shí)先不查關(guān)聯(lián)數(shù)據(jù)等真正訪問 borrow_records 這個(gè)屬性時(shí)才發(fā)查詢。這個(gè)機(jī)制叫懶加載能避免列表頁一次查出大量無關(guān)數(shù)據(jù)。借書日期用 defaultdate.today表示不傳值時(shí)自動(dòng)取當(dāng)天。應(yīng)還日期需要在借書時(shí)手動(dòng)算常見規(guī)則是默認(rèn) 30 天后還。這些是業(yè)務(wù)規(guī)則不寫在 ORM 默認(rèn)值里因?yàn)椴煌瑢W(xué)校、不同圖書館規(guī)定的借期可能不一樣。3.3 圖書列表的分頁查詢寫一個(gè)能直接用的視圖函數(shù)圖書列表是所有功能的基礎(chǔ)頁面。這里我們用 Flask-SQLAlchemy 的分頁 API 來實(shí)現(xiàn)搜索關(guān)鍵詞和分頁參數(shù)都通過 URL 查詢參數(shù)傳入。# views/book.py from flask import Blueprint, request, render_template from models import Book, db book_bp Blueprint(book, __name__, url_prefix/books) book_bp.route(/) def book_list(): # 從查詢參數(shù)中獲取頁碼和搜索關(guān)鍵詞 page request.args.get(page, 1, typeint) keyword request.args.get(keyword, , typestr).strip() # 按書名或作者模糊搜索 query Book.query if keyword: like_pattern f%{keyword}% query query.filter( db.or_(Book.title.like(like_pattern), Book.author.like(like_pattern)) ) # 按 id 倒序讓新入庫的書排在前面 pagination query.order_by(Book.id.desc()).paginate( pagepage, per_page10, error_outFalse ) books pagination.items return render_template( book_list.html, booksbooks, paginationpagination, keywordkeyword )request.args.get 用來讀 URL 里的查詢參數(shù)。typeint 是 WTF Form 做的隱式類型轉(zhuǎn)換如果 page 參數(shù)不是數(shù)字就返回 1不會(huì)直接拋 500 錯(cuò)誤。search 條件用 db.or_ 把書名和作者兩個(gè)字段包在一起實(shí)現(xiàn)“書名或作者都能搜”的效果。這里用 like 做模糊匹配數(shù)據(jù)量小沒問題但數(shù)據(jù)量到十萬級(jí)以上like %keyword% 沒法命中索引會(huì)有性能問題那是后話。paginate 是 Flask-SQLAlchemy 自帶的現(xiàn)成分頁方法比手動(dòng)寫 LIMIT/OFFSET 省事得多。error_outFalse 很關(guān)鍵它保證頁碼超出范圍時(shí)返回空列表而不是報(bào) 404。這也就解釋了為什么這個(gè) URL 看起來簡(jiǎn)潔但該有的邊界處理都做了。3.4 模板里怎么展示分頁導(dǎo)航分頁數(shù)據(jù)從視圖傳到模板后模板里需要有上一頁、下一頁和頁碼跳轉(zhuǎn)。下面是一個(gè)可復(fù)用的分頁組件寫法!-- templates/_pagination.html -- {% if pagination.pages 1 %} nav ul classpagination li class{% if not pagination.has_prev %}disabled{% endif %} a href{{ url_for(book.book_list, pagepagination.prev_num, keywordkeyword) if pagination.has_prev else # }} laquo; 上一頁 /a /li {% for p in pagination.iter_pages() %} {% if p %} li class{% if p pagination.page %}active{% endif %} a href{{ url_for(book.book_list, pagep, keywordkeyword) }}{{ p }}/a /li {% else %} lispan…/span/li {% endif %} {% endfor %} li class{% if not pagination.has_next %}disabled{% endif %} a href{{ url_for(book.book_list, pagepagination.next_num, keywordkeyword) if pagination.has_next else # }} 下一頁 raquo; /a /li /ul /nav {% endif %}這段模板要注意的是 keyword 必須跟著翻頁鏈接一起傳。如果不傳用戶搜索“三體”后翻到第二頁搜索條件就丟了看到的還是全量列表。體驗(yàn)上的一個(gè)很小的細(xì)節(jié)但對(duì)作業(yè)演示來說很顯眼因?yàn)槔蠋熢谘菔緯r(shí)大概率會(huì)搜一次、翻一次頁。iter_pages() 返回頁碼序列中間跳過的頁會(huì)用省略號(hào)替代這樣頁數(shù)多時(shí)導(dǎo)航欄不會(huì)擠成一排。4. 借書與還書事務(wù)、庫存更新與 Flask 表單驗(yàn)證4.1 借書流程的核心邏輯為什么必須寫成事務(wù)借書的業(yè)務(wù)邏輯看起來很簡(jiǎn)單檢查書是否可借檢查讀者是否有效插入一條借閱記錄把書的可借數(shù)量減一。但這三步必須綁定成一個(gè)整體。任何一步失敗而其他步驟已經(jīng)執(zhí)行就會(huì)造成數(shù)據(jù)不一致——典型的場(chǎng)景是借閱記錄插入成功但可借庫存沒扣掉或者反過來。數(shù)據(jù)庫的事務(wù)機(jī)制就是用來解決這個(gè)問題的。事務(wù)的 ACID 特性保證要么全部提交要么全部回滾不會(huì)出現(xiàn)只執(zhí)行一半的情況。在 Flask-SQLAlchemy 里事務(wù)的邊界由 db.session 管理commit 提交事務(wù)rollback 撤銷未提交的操作。借書時(shí)還會(huì)遇到一個(gè)并發(fā)問題兩個(gè)讀者同時(shí)借同一本書。如果不加控制兩個(gè)人都會(huì)看到可借庫存為 1然后都執(zhí)行借書操作最后庫存變成 -1。這就是經(jīng)典的數(shù)據(jù)庫并發(fā)超賣問題。為了避免這種問題借書時(shí)不能只 SELECT 再 UPDATE而應(yīng)該在 UPDATE 時(shí)帶上條件判斷。4.2 借書視圖函數(shù)事務(wù)邊界與樂觀鎖寫法# views/borrow.py from flask import Blueprint, request, render_template, flash, redirect, url_for from datetime import date, timedelta from models import Book, Reader, BorrowRecord, db borrow_bp Blueprint(borrow, __name__, url_prefix/borrow) borrow_bp.route(/, methods[GET, POST]) def borrow_book(): if request.method GET: # GET 請(qǐng)求時(shí)只渲染借書表單 books Book.query.filter(Book.available_count 0).all() readers Reader.query.filter_by(statusTrue).all() return render_template(borrow_form.html, booksbooks, readersreaders) # POST 請(qǐng)求時(shí)執(zhí)行借書操作 reader_id request.form.get(reader_id, typeint) book_id request.form.get(book_id, typeint) # 基礎(chǔ)校驗(yàn)參數(shù)缺失直接返回 if not reader_id or not book_id: flash(請(qǐng)選擇讀者和圖書) return redirect(url_for(borrow.borrow_book)) reader db.session.get(Reader, reader_id) book db.session.get(Book, book_id) # 業(yè)務(wù)校驗(yàn)讀者是否存在且有效 if not reader or not reader.status: flash(讀者不存在或已被停用) return redirect(url_for(borrow.borrow_book)) # 關(guān)鍵操作用條件 UPDATE 扣減庫存 # 只有可借數(shù)量大于 0 時(shí)才扣減否則影響行數(shù)為 0 result Book.query.filter_by(idbook_id, available_count 0).update({ available_count: Book.available_count - 1 }) if result 0: db.session.rollback() flash(這本書暫時(shí)沒有可借的庫存) return redirect(url_for(borrow.borrow_book)) # 插入借閱記錄 due_days 30 # 借期 30 天可按需調(diào)整 record BorrowRecord( reader_idreader_id, book_idbook_id, borrow_datedate.today(), due_datedate.today() timedelta(daysdue_days), status0 ) db.session.add(record) db.session.commit() flash(f借書成功應(yīng)還日期{record.due_date}) return redirect(url_for(borrow.borrow_book))這個(gè)視圖函數(shù)里最值得琢磨的是那行條件 UPDATE。filter_by 里同時(shí)寫了 id 和 available_count 0 兩個(gè)條件update 操作只會(huì)影響滿足這兩個(gè)條件的行。如果庫存已經(jīng)是 0影響行數(shù)為 0函數(shù)拿到 result 0 就知道本次借書失敗直接回滾。這種方式叫樂觀鎖它不需要給表加鎖靠條件更新本身的原子性避免超賣。db.session.get() 是 SQLAlchemy 2.0 推薦的主鍵查詢方法比舊版的 query.get() 更規(guī)范。要注意的是 sqlalchemy 1.4 以下沒有 db.session.get如果你用的 Flask-SQLAlchemy 3.x 才支持。如果環(huán)境比較舊用 Book.query.get(book_id) 也一樣。4.3 還書流程狀態(tài)更新、庫存回補(bǔ)與過期處理還書是借書的逆向操作邏輯上有三個(gè)變化借閱記錄狀態(tài)從 0 變 1、實(shí)際歸還日期寫成今天、可借庫存加一。還有一個(gè)時(shí)間點(diǎn)要注意如果歸還日期晚于應(yīng)還日期那么狀態(tài)應(yīng)該直接置成 2已逾期實(shí)際上很多系統(tǒng)用 2 表示“已歸還且逾期”逾期和已歸還可以是兩個(gè)維度但這個(gè)項(xiàng)目里用一個(gè)字段表達(dá)就夠了。# views/borrow.py 中新增還書路由 borrow_bp.route(/return/int:record_id, methods[POST]) def return_book(record_id): record db.session.get(BorrowRecord, record_id) if not record or record.status ! 0: flash(借閱記錄不存在或已歸還) return redirect(url_for(borrow.active_records)) # 判定是否逾期 today date.today() if today record.due_date: record.status 2 # 已歸還且逾期 else: record.status 1 # 正常歸還 record.return_date today # 把可借庫存加回 book db.session.get(Book, record.book_id) book.available_count 1 db.session.commit() flash(還書成功) return redirect(url_for(borrow.active_records))還書時(shí)沒有用條件 UPDATE原因是庫存加回不會(huì)引發(fā)負(fù)數(shù)問題不存在并發(fā)超賣的情況。但這里缺少一步校驗(yàn)這本書實(shí)際是借出去的理論上可借庫存不可能超過總庫存。如果你愿意多寫一步可以在回補(bǔ)庫存之前判斷 book.available_count book.total_count如果不滿足就說明數(shù)據(jù)已經(jīng)污染了記日志比直接改更重要。4.4 用 Flask-WTF 做表單校驗(yàn)比手寫 request.form 更穩(wěn)上面寫的視圖邏輯里表單數(shù)據(jù)是直接用 request.form 取的然后手動(dòng)判斷有沒有值。這種做法在作業(yè)里沒問題但存在兩個(gè)隱患。第一如果你的老師要求演示“惡意輸入”防御手寫校驗(yàn)很難覆蓋完整第二出問題時(shí)表單回顯需要手動(dòng)把舊數(shù)據(jù)塞回模板代碼會(huì)很碎。更穩(wěn)的做法是用 Flask-WTF 的 FlaskForm。它在后端做了 CSRF 防護(hù)表單字段類型可以聲明為 IntegerField、StringField 等校驗(yàn)器負(fù)責(zé)檢查長(zhǎng)度、格式、必填。下面是一個(gè)加過 WTF 表單的借書表單模型# forms.py from flask_wtf import FlaskForm from wtforms import SelectField, SubmitField from wtforms.validators import DataRequired class BorrowForm(FlaskForm): reader_id SelectField(讀者, coerceint, validators[DataRequired()]) book_id SelectField(圖書, coerceint, validators[DataRequired()]) submit SubmitField(確認(rèn)借書)coerceint 很關(guān)鍵它會(huì)把 SelectField 返回的字符串自動(dòng)轉(zhuǎn)成整數(shù)。如果沒有它你拿到的 reader_id 是字符串 3存進(jìn)數(shù)據(jù)庫時(shí)雖然 SQLAlchemy 會(huì)自動(dòng)轉(zhuǎn)換但判斷 reader_id 是否為空時(shí)會(huì)因?yàn)?0 是假值而誤判。SelectField 的選項(xiàng)在視圖函數(shù)里構(gòu)造app.route(/borrow, methods[GET, POST]) def borrow(): form BorrowForm() form.reader_id.choices [(r.id, r.name) for r in Reader.query.filter_by(statusTrue).all()] form.book_id.choices [(b.id, b.title) for b in Book.query.filter(Book.available_count 0).all()] if form.validate_on_submit(): # form.reader_id.data 已經(jīng)是 int ...FlaskForm 自動(dòng)做了三件事檢查 CSRF token、檢查字段合法性、執(zhí)行自定義校驗(yàn)器。比手寫校驗(yàn)的代碼量沒有顯著增加但邊界情況處理得完整得多。如果你趕時(shí)間不想引入新依賴那手寫也能交差但 validate_on_submit 這套機(jī)制值得你用一次后面所有項(xiàng)目都能復(fù)用。5. 常見問題排查Flask 圖書管理系統(tǒng)開發(fā)中的 5 個(gè)高頻坑5.1 數(shù)據(jù)庫遷移改了模型表結(jié)構(gòu)卻沒變現(xiàn)象你在 models.py 里給 Book 表加了一個(gè)新字段 publisher運(yùn)行程序后查詢這個(gè)字段報(bào)錯(cuò)no such column。原因SQLAlchemy 的 db.create_all() 只會(huì)創(chuàng)建不存在的表不會(huì)修改已存在的表結(jié)構(gòu)。你改了模型但數(shù)據(jù)庫文件里的表還是舊結(jié)構(gòu)。這個(gè)問題在 SQLite 和 MySQL 下都存在。解決開發(fā)階段最簡(jiǎn)單的辦法是刪掉舊表重建。一行命令進(jìn) Flask shelldb.drop_all() 然后 db.create_all()。但注意這會(huì)清空所有數(shù)據(jù)只適合沒有真實(shí)數(shù)據(jù)的時(shí)候。交作業(yè)前千萬別這么做否則給老師演示時(shí)你辛辛苦苦錄的測(cè)試數(shù)據(jù)全沒了。正規(guī)做法是用 Flask-Migrate 做數(shù)據(jù)庫遷移它能生成增量遷移腳本保留數(shù)據(jù)的前提下加字段、改類型。作業(yè)里如果只有兩次結(jié)構(gòu)變更手動(dòng)改 SQL 重導(dǎo)數(shù)據(jù)也行但時(shí)間允許的話學(xué)一下 Flask-Migrate 是長(zhǎng)期劃算的。5.2 外鍵約束引起的刪除失敗刪除圖書報(bào) IntegrityError現(xiàn)象你試圖從圖書列表刪除某本書頁面報(bào) 500 錯(cuò)誤后臺(tái)日志顯示 IntegrityError: FOREIGN KEY constraint failed。原因這本書存在借閱記錄borrow_record 表的外鍵指向 book 表。數(shù)據(jù)庫默認(rèn)行為是不允許刪除被引用行的這是保護(hù)數(shù)據(jù)完整性的設(shè)計(jì)。解決分業(yè)務(wù)場(chǎng)景處理。如果這本書只是書目信息沒有借閱記錄直接刪沒問題。如果歷史上有借閱記錄有兩種選擇其一是只做邏輯刪除給 Book 表加一個(gè) is_deleted 字段刪書時(shí)把字段置為 True查詢時(shí)過濾掉其二是徹底刪除前把 borrow_record 表里的外鍵先置空或級(jí)聯(lián)刪除。生產(chǎn)系統(tǒng)里偏向邏輯刪除因?yàn)榻栝営涗浭菍徲?jì)數(shù)據(jù)不能丟。作業(yè)里最簡(jiǎn)單的是在刪除前先執(zhí)行一條查詢BorrowRecord.query.filter_by(book_idbid).first()如果有記錄就提示“該書存在借閱記錄無法刪除”給用戶明確反饋。5.3 日期比較的類型錯(cuò)誤逾期計(jì)算算錯(cuò)天數(shù)現(xiàn)象計(jì)算逾期天數(shù)時(shí)結(jié)果總是差一天或直接報(bào) TypeError。原因兩個(gè)坑疊加。第一個(gè)是 SQLite 里存日期時(shí)如果用了字符串python 拿到的可能是 str 而不是 date 對(duì)象直接相減就報(bào)錯(cuò)。第二個(gè)是借書時(shí)如果手動(dòng)傳了字符串日期而 due_date 字段期望 date 對(duì)象SQLAlchemy 在 SQLite 下可能不報(bào)錯(cuò)但存進(jìn)去的數(shù)據(jù)類型變了拿出來時(shí)行為不一致。解決統(tǒng)一用 Python date 對(duì)象不要用字符串。在借書視圖里寫 date.today() 和 timedelta(days30)不要用 datetime.now().strftime(%Y-%m-%d) 這類操作。從數(shù)據(jù)庫拿出來的字段如果確認(rèn)是字符串可以用 datetime.strptime 或 date.fromisoformat 轉(zhuǎn)回對(duì)象再計(jì)算。在 models.py 里把日期字段的 type 顯式聲明為 db.DateSQLAlchemy 就會(huì)自動(dòng)處理。5.4 Jinja2 模板里顯示中文亂碼現(xiàn)象頁面渲染出來的書名和作者名全是問號(hào)或者亂碼但數(shù)據(jù)庫里數(shù)據(jù)是正常的。原因分兩種。MySQL 下是數(shù)據(jù)庫連接字符集和表字符集不一致表是 utf8連接用的是 latin1。SQLite 下一般是 HTML 頁面沒聲明 UTF-8 編碼瀏覽器按系統(tǒng)默認(rèn)編碼解析導(dǎo)致亂碼。解決MySQL 場(chǎng)景連接串加 charsetutf8mb4建表時(shí)指定 DEFAULT CHARSETutf8mb4SQLite 場(chǎng)景在模板最開頭寫 并且 Flask 端 response 的 Content-Type 里要有 charsetutf-8。后者在 Flask 里默認(rèn)就有但如果你用了 make_response 手動(dòng)構(gòu)造響應(yīng)需要檢查 response.headers[Content-Type]。這個(gè)坑雖然小但演示時(shí)一眼就能看見特別尷尬。5.5 搜索框提交后點(diǎn)擊分頁搜索條件丟了現(xiàn)象輸入關(guān)鍵詞搜索后翻到第二頁列表變回全量數(shù)據(jù)。原因模板里的分頁鏈接只傳了 page 參數(shù)沒有把 keyword 一起傳。這是上一章模板代碼里特別提過的點(diǎn)但太容易漏了。只要搜索和分頁同時(shí)存在翻頁鏈接里就必須攜帶當(dāng)前搜索詞。解決所有分頁鏈接加上 keywordrequest.args.get(keyword, )。如果還有其它篩選條件比如按出版社過濾也要一并傳。更省事的做法是把篩選條件封裝成一個(gè) dict模板循環(huán)生成查詢串。如果在模板里寫太多 url_for 參數(shù)感到繁瑣可以定義一個(gè)視圖函數(shù)傳入 kwargs 的輔助變量按需拼接?？傊魏魏Y選條件一旦引入分頁就不能只傳頁碼。6. 交作業(yè)前的最后一步把演示流程和答辯話術(shù)準(zhǔn)備好作業(yè)代碼跑通只算完成了七成剩下三成在演示環(huán)節(jié)。老師會(huì)隨機(jī)點(diǎn)幾個(gè)功能你的反應(yīng)速度和解釋是否清晰直接決定成績(jī)。我建議你按下面這個(gè)順序自己完整走一遍就當(dāng)模擬答辯。首先演示初始化刪除數(shù)據(jù)庫文件重新執(zhí)行 create_all導(dǎo)入幾條測(cè)試數(shù)據(jù)。這個(gè)動(dòng)作證明你的項(xiàng)目可以從零跑通而不是依賴某個(gè)已經(jīng)存在的數(shù)據(jù)庫。其次是核心流程演示搜索一本書、借給一位讀者、查看借閱記錄列表、歸還這本書、確認(rèn)可借庫存恢復(fù)。這五步覆蓋了增刪改查的全部四個(gè)操作也覆蓋了外鍵關(guān)聯(lián)和事務(wù)。最后才是界面細(xì)節(jié)比如表單校驗(yàn)提示、分頁、空數(shù)據(jù)展示。真正拉開分差的是答辯問答。老師大概率會(huì)問三個(gè)方向的問題為什么這張表這么設(shè)計(jì)、借書時(shí)并發(fā)怎么辦、ORM 和原生 SQL 的區(qū)別。前兩個(gè)問題在本文第二章和第四章已經(jīng)講清楚了你只需要用自己的話復(fù)述一遍。第三個(gè)問題要誠(chéng)實(shí)ORM 適合業(yè)務(wù)邏輯復(fù)雜但 SQL 不復(fù)雜的場(chǎng)景報(bào)表統(tǒng)計(jì)類的復(fù)雜查詢還是要手寫 SQL。你要是能主動(dòng)說出這句老師會(huì)覺得你是真懂不是在背代碼。最后一件事是環(huán)境整理。把 requirements.txt 生成出來格式是 pip freeze requirements.txt這樣老師換一臺(tái)電腦也能跑。README 里寫清楚運(yùn)行步驟創(chuàng)建虛擬環(huán)境、安裝依賴、運(yùn)行 python app.py。如果用到 MySQL把建立 library_db 數(shù)據(jù)庫的 SQL 也放在項(xiàng)目根目錄下的 init.sql 里。這些文件不影響代碼運(yùn)行但它們決定了這個(gè)作業(yè)的可復(fù)現(xiàn)性也是課程報(bào)告里“項(xiàng)目部署”章節(jié)的素材。我自己做這類項(xiàng)目的時(shí)候一直有個(gè)習(xí)慣從開始寫代碼起就手動(dòng)測(cè)試每一條可能出錯(cuò)的路比如刪除一本正在被借閱的書、給停用讀者借書、超期一天還書。這些都是業(yè)務(wù)邊界灰色地帶的處理邏輯比主干流程更能體現(xiàn)工程素養(yǎng)。希望這些對(duì)你有所幫助也祝你的期中作業(yè)順利落地。本文還有配套的精品資源點(diǎn)擊獲取