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