本文还有配套的精品资源，点击获取

简介：面向本科计算机专业课程设计的图书管理系统实战资源，用Java编写，后端基于MySQL实现。支持读者注册、双角色登录（管理员/普通读者）、图书信息全生命周期管理（增删改查）、借阅登记、归还操作、逾期天数自动计算及罚款规则模拟。资源包含已验证可直接运行的完整Java工程源码（含src、bin、IDE配置文件如.classpath、.project、.idea等），配套Word版系统设计文档，涵盖需求分析、模块划分、数据库设计说明；附带UML类图、核心业务流程图、全部界面截图和分步操作指引。数据库初始化脚本init_db.sql开箱即用，兼容Eclipse和IntelliJ IDEA，导入后无需额外配置即可编译运行。适合课程设计提交、教学演示或作为二次开发基础框架。

1. 项目概述：这不是一个“玩具系统”，而是一套能直接上交、能现场演示、能改出新功能的课程设计实战包

你是不是也经历过这样的课程设计周？老师布置完“做一个图书管理系统”，全班同学瞬间陷入沉默——有人翻遍CSDN抄了三天代码，结果连数据库表都建不对；有人用Swing写了登录界面，一点击就抛NullPointerException，调试到凌晨两点还是黑屏；还有人好不容易跑起来了，但借书不记录时间、还书不更新库存、逾期罚款永远显示0元……最后交上去的文档里，“系统测试”章节全是截图拼凑，连自己都不敢点开运行。

这个资源包，就是为终结这种窘境而生的。它不是网上泛滥的“Java图书管理系统源码（含数据库）”那种半成品，也不是只有核心类、缺配置、少文档的“学习参考版”。它是一套经过真实课堂验证、可导入即运行、有完整闭环业务逻辑、带教学级文档支撑的实战交付物。我带过六届计算机专业课程设计，亲手帮学生改过200+份图书管理系统的毕设和课设，深知哪些地方最容易卡住、哪些细节老师一眼就能看出是抄的、哪些模块写得扎实能让答辩加分。这套包，就是我把这些经验全部沉淀进去的结果。

关键词里提到的“图书管理系统”“Java课程设计”“MySQL数据库”，不是标签，而是三个必须严丝合缝咬合的齿轮：Java负责把业务逻辑写清楚、写稳当；MySQL不是只存几条假数据，而是按高校图书馆真实业务建模——读者类型区分教师/学生、图书分类采用中图法二级类目、借阅状态精确到“在馆/借出/预约中/已丢失”；课程设计则决定了它的边界感——不追求高并发、不堆微服务、不搞前后端分离，而是用最典型的Swing桌面架构，把MVC分层写明白，让老师看到你的设计思路，让学生能真正读懂每一行代码为什么这么写。

它适合谁？第一类是正在赶课设 deadline 的大三学生——你不需要从零搭环境，init_db.sql双击就能建好带初始数据的库，Eclipse或IDEA导入项目后点一下绿色三角形，登录界面立刻弹出来；第二类是指导课程设计的青年教师——你可以直接把它当教学案例，带着学生一行行分析BookService.java里的事务控制怎么保证借书时库存和借阅记录同步更新；第三类是想夯实Java基础的初学者——它没有炫技的反射、注解、动态代理，所有功能都落在JFrame、JTable、PreparedStatement这些最基础却最核心的API上，是极佳的“可读性优先”范本。

更重要的是，它解决了一个被很多人忽略的关键问题：可验证性。很多课设代码写着“支持逾期罚款”，但实际逻辑是if (days > 30) fine = 1;——这显然不符合高校图书馆规则（通常是0.1元/天，且有上限）。而这个包里，FineCalculator.java明确实现了阶梯式计算：前7天免费，第8-30天0.1元/天，超30天部分0.2元/天，单本书最高罚5元。这种细节，不是为了炫技，而是让你在答辩时被问到“罚款怎么算的”，你能打开源码指着第42行说：“老师，这里用了BigDecimal避免浮点误差，上限通过Math.min()控制。”——这才是课程设计该有的样子。

2. 整体架构与设计思路：为什么选Swing+MySQL单体架构？而不是Spring Boot？

2.1 课程设计场景下的技术选型逻辑

先说结论：这不是技术落后，而是精准匹配教学目标的主动选择。很多同学看到“没用Spring Boot”就下意识觉得low，但请想想课程设计的核心考核点是什么？是考察你能不能用Java语言本身构建一个结构清晰、职责分明、能解决实际问题的软件系统，而不是看你能不能配好application.yml、会不会写@RestController。Spring Boot带来的自动配置、内嵌Tomcat、RESTful接口，对课程设计而言，恰恰是干扰项——它掩盖了HTTP协议、Servlet生命周期、数据库连接池这些底层原理，而这些，才是计算机专业本科生该打牢的地基。

我们选Swing，是因为它强制你直面GUI开发的本质：事件驱动模型（ActionListener）、组件布局管理器（BorderLayout vs GridLayout）、线程安全（SwingUtilities.invokeLater()）。比如借书操作，点击“确认借阅”按钮后，系统必须：
1. 检查读者当前借阅数是否超限（学生≤5本，教师≤10本）；
2. 检查该书库存是否大于0；
3. 在borrow_record表插入新记录；
4. 将book表对应stock字段减1；
5. 刷新界面上的“当前借阅列表”表格。

这五个步骤，如果用Spring Boot写，可能分散在Controller、Service、Mapper三层，中间还夹着事务注解。而在Swing里，它们必须在一个actionPerformed()方法里被你亲手组织、亲手调试、亲手加日志。当学生第一次在BorrowBookDialog.java里写下connection.setAutoCommit(false)并手动调用commit()或rollback()时，他才真正理解了什么是数据库事务。

再看MySQL的选择。有人会问：“为什么不用HSQLDB或Derby做嵌入式数据库？”答案很实在：高校机房环境不可控。我见过太多次学生在实验室电脑上运行HSQLDB，因为端口被占或权限不足直接报错，而MySQL（哪怕是最简化的免安装版）在Windows上双击mysqld.exe就能启动，init_db.sql里的CREATE DATABASE IF NOT EXISTS library_system语句确保环境干净。更重要的是，MySQL的SQL语法（尤其是外键约束、联合查询）是数据库课程的标准教学内容。SELECT b.title, r.borrow_date, r.return_date FROM book b JOIN borrow_record r ON b.id = r.book_id WHERE r.reader_id = ? AND r.status = 'BORROWED'——这条语句出现在ReaderService.java里，它要求学生必须理解JOIN原理、WHERE条件执行顺序、索引优化（我们在borrow_record表的reader_id和book_id字段上都加了索引），而不是靠MyBatis的<select>标签蒙混过关。

2.2 MVC分层如何落地？不是概念，是每一行代码的归属

很多课设文档里写着“采用MVC模式”，但翻开代码，MainForm.java里塞了300行SQL查询和JTable渲染逻辑，这就是典型的“伪MVC”。我们的分层，是刻在包结构里的硬约束：

src/
├── controller/          // 纯事件处理器，只做三件事：接收UI事件、调用Service、更新UI状态
│   ├── LoginController.java
│   ├── BookManageController.java
│   └── BorrowReturnController.java
├── service/             // 业务逻辑中枢，所有核心规则在此实现，严禁出现Swing组件引用
│   ├── ReaderService.java      // 读者注册校验、密码加密（BCrypt）、角色权限判断
│   ├── BookService.java        // 图书ISBN校验（正则表达式）、分类树加载、库存预警（<3本标红）
│   ├── BorrowService.java      // 借阅前检查（超限/库存/黑名单）、生成借阅流水号（BR20240520001）
│   └── FineCalculator.java     // 逾期罚款核心算法，独立成类便于单元测试
├── dao/                 // 数据访问层，严格遵循DAO模式：每个实体一个DAO，方法名即SQL意图
│   ├── ReaderDao.java
│   ├── BookDao.java
│   ├── BorrowRecordDao.java
│   └── DatabaseUtil.java       // 封装Connection获取、事务管理、异常转换（SQLException→自定义BizException）
├── model/               // 纯POJO，无任何业务逻辑，字段与数据库表一一对应
│   ├── Reader.java
│   ├── Book.java
│   └── BorrowRecord.java
└── ui/                  // 纯界面定义，只包含JFrame/JDialog/JPanel创建和布局，零业务代码
    ├── LoginForm.java
    ├── AdminMainFrame.java
    ├── ReaderMainFrame.java
    └── BorrowBookDialog.java

这种结构带来的直接好处是：当你需要修改罚款规则时，只需打开FineCalculator.java，改calculateFine()方法，其他所有模块完全不受影响。而如果老师问“你怎么保证借书时库存和记录同步更新”，你可以说：“在BorrowService.borrowBook()里，我用DatabaseUtil.getConnection()开启事务，先执行bookDao.updateStock()，再执行borrowRecordDao.insert()，任一失败都rollback()。”——这是可追溯、可验证、可答辩的设计。

提示：DatabaseUtil.java是整个数据层的基石。它内部维护了一个ThreadLocal<Connection>，确保同一线程内所有DAO操作共享同一个Connection，从而天然支持事务。这比网上常见的“每次DAO方法都新建Connection”严谨得多，也更贴近企业级开发习惯。

2.3 数据库设计：从ER图到物理表，每一张表都有业务依据

init_db.sql不是随便写的建表语句，它是基于高校图书馆真实业务流程反向推导出来的。我们来拆解最关键的三张表：

reader 表：解决“谁在借书”的身份问题

CREATE TABLE reader (
  id BIGINT PRIMARY KEY AUTO_INCREMENT,
  reader_id VARCHAR(20) NOT NULL UNIQUE COMMENT '学号/工号，作为登录账号',
  name VARCHAR(50) NOT NULL,
  password VARCHAR(100) NOT NULL COMMENT 'BCrypt加密后的密码',
  role ENUM('ADMIN', 'STUDENT', 'TEACHER') NOT NULL DEFAULT 'STUDENT',
  max_borrow_count INT NOT NULL DEFAULT 5 COMMENT '最大可借数量，STUDENT=5, TEACHER=10',
  status ENUM('NORMAL', 'SUSPENDED', 'BLACKLISTED') NOT NULL DEFAULT 'NORMAL',
  created_time DATETIME DEFAULT CURRENT_TIMESTAMP,
  INDEX idx_reader_id (reader_id)
);

注意点：reader_id是业务主键（登录账号），id是代理主键（避免业务含义变化）；role用ENUM而非外键，因为角色种类固定且极少变动，ENUM查询更快；status字段直接支持“黑名单”功能——当读者逾期未还超60天，管理员可在界面一键将其置为BLACKLISTED，后续登录直接拒绝。

book 表：解决“借什么书”的资源问题

CREATE TABLE book (
  id BIGINT PRIMARY KEY AUTO_INCREMENT,
  isbn VARCHAR(17) NOT NULL UNIQUE COMMENT '13位ISBN，带分隔符，如978-7-04-050694-5',
  title VARCHAR(200) NOT NULL,
  author VARCHAR(100),
  publisher VARCHAR(100),
  publish_year YEAR,
  category_code VARCHAR(10) NOT NULL COMMENT '中图法二级类目，如TP312',
  stock INT NOT NULL DEFAULT 0 COMMENT '当前在馆数量',
  total_copies INT NOT NULL DEFAULT 1 COMMENT '总复本数（同一ISBN可能有多本）',
  created_time DATETIME DEFAULT CURRENT_TIMESTAMP,
  INDEX idx_isbn (isbn),
  INDEX idx_category (category_code)
);

关键设计：isbn字段用VARCHAR(17)存储带分隔符的格式，方便人工核对；category_code关联预置的category字典表（INSERT INTO category VALUES ('TP312', '程序设计'), ('TP393', '网络技术')），这样在界面上就能下拉选择“计算机类->程序设计”，而不是让用户手动输入乱码；stock和total_copies分离，精准反映“可借数量”和“馆藏总量”。

borrow_record 表：解决“何时借、何时还、是否逾期”的状态追踪问题

CREATE TABLE borrow_record (
  id BIGINT PRIMARY KEY AUTO_INCREMENT,
  reader_id VARCHAR(20) NOT NULL,
  book_id BIGINT NOT NULL,
  borrow_date DATE NOT NULL DEFAULT (CURRENT_DATE),
  due_date DATE NOT NULL COMMENT '应还日期 = borrow_date + 30天',
  return_date DATE NULL COMMENT '实际归还日期，NULL表示未归还',
  status ENUM('BORROWED', 'RETURNED', 'OVERDUE', 'LOST') NOT NULL DEFAULT 'BORROWED',
  fine_amount DECIMAL(6,2) DEFAULT 0.00 COMMENT '已结算罚款金额',
  created_time DATETIME DEFAULT CURRENT_TIMESTAMP,
  FOREIGN KEY (reader_id) REFERENCES reader(reader_id) ON DELETE CASCADE,
  FOREIGN KEY (book_id) REFERENCES book(id) ON DELETE RESTRICT,
  INDEX idx_reader_date (reader_id, borrow_date),
  INDEX idx_book_status (book_id, status)
);

灵魂字段：due_date不是写死的，而是在BorrowService里用LocalDate.now().plusDays(30)动态计算；status的状态流转是核心业务逻辑——当return_date被更新时，BorrowService.updateReturnStatus()会自动根据return_date和due_date计算逾期天数，并更新status为OVERDUE或RETURNED；fine_amount只记录已结算金额（用户交钱后才写入），避免“账实不符”。

注意：ON DELETE CASCADE用于读者删除时自动清理其借阅记录，但ON DELETE RESTRICT用于图书删除——因为一本被借出的书不能直接删，必须先处理完所有借阅状态。这种外键策略，本身就是业务规则的代码化表达。

3. 核心模块详解与实操要点：从登录到罚款，手把手带你读懂每一处关键实现

3.1 双角色登录：不只是用户名密码，而是权限的起点

登录模块看似简单，却是整个系统安全的基石。我们的LoginController.java做了三件超出课设要求的事：

第一，密码加密不是Base64，而是BCrypt强哈希。
在ReaderService.registerReader()中，用户注册时的明文密码不会被passwordEncoder.encode(rawPassword)加密后存入数据库。BCrypt的特点是：即使两个用户密码相同，每次加密结果也不同（因为内置随机盐值），且无法逆向破解。这比MD5加盐或SHA256更符合现代安全实践。登录验证时，ReaderService.authenticate()调用passwordEncoder.matches(inputPassword, dbHashedPassword)进行比对，全程不接触明文密码。

第二，登录成功后不是简单跳转，而是构建完整的用户上下文。
LoginController.login()成功后，会创建一个CurrentUserContext单例对象，里面不仅存了readerId和role，还缓存了该用户的基本信息（姓名、最大借阅数、当前借阅数）。为什么这么做？因为后续几乎所有操作都需要频繁读取这些信息——比如借书前要检查currentBorrowCount < maxBorrowCount，如果每次都要查库，性能差且代码冗余。而这个上下文在用户登出或关闭程序时自动销毁，内存安全可控。

第三，界面响应不是静态提示，而是动态适配。
LoginForm.java的“登录”按钮监听器里，loginButton.addActionListener(e -> { ... })的逻辑是：

// 1. 获取输入的账号密码
String inputId = idField.getText().trim();
String inputPwd = new String(pwdField.getPassword());
// 2. 调用Service验证
Optional<Reader> readerOpt = readerService.authenticate(inputId, inputPwd);
if (readerOpt.isPresent()) {
    Reader reader = readerOpt.get();
    // 3. 根据role决定启动哪个主界面
    if ("ADMIN".equals(reader.getRole())) {
        new AdminMainFrame().setVisible(true); // 管理员界面：含图书管理、读者管理、报表菜单
    } else {
        new ReaderMainFrame(reader).setVisible(true); // 读者界面：仅借阅、归还、查询菜单
    }
    this.dispose(); // 关闭登录窗
} else {
    JOptionPane.showMessageDialog(this, "账号或密码错误！", "登录失败", JOptionPane.ERROR_MESSAGE);
}

看到没？new ReaderMainFrame(reader)把整个Reader对象传过去，而不是只传readerId。这意味着在读者主界面里，可以直接调用reader.getMaxBorrowCount()显示“您最多可借5本书”，甚至用reader.getStatus()判断是否被禁用——所有UI文案都源于真实业务数据，不是写死的字符串。

实操心得：很多同学的登录模块卡在“为什么登录后界面没反应”。八成原因是JFrame.setVisible(true)写在了错误的位置，或者忘了this.dispose()导致登录窗遮挡主界面。建议在AdminMainFrame构造函数末尾加一句System.out.println("AdminMainFrame initialized for: " + adminId);，运行时看控制台有没有输出，快速定位初始化是否成功。

3.2 图书全生命周期管理：增删改查背后的业务校验

图书管理模块（BookManageController）是管理员的核心工作台，它的难点不在CRUD本身，而在于每一次操作都必须携带业务意义。

新增图书：ISBN校验是第一道防线
BookManageController.addBook()方法里，对isbnField.getText()的处理远不止INSERT INTO book：

String rawIsbn = isbnField.getText().trim();
// 步骤1：标准化格式（去掉空格、统一为13位数字）
String normalizedIsbn = normalizeIsbn(rawIsbn); // 如"9787040506945" → "978-7-04-050694-5"
if (normalizedIsbn == null) {
    JOptionPane.showMessageDialog(this, "ISBN格式错误！请输入13位数字，如：978-7-04-050694-5", "格式错误", JOptionPane.WARNING_MESSAGE);
    return;
}
// 步骤2：检查是否已存在（防止重复录入）
if (bookService.existsByIsbn(normalizedIsbn)) {
    JOptionPane.showMessageDialog(this, "该ISBN图书已存在！", "重复录入", JOptionPane.WARNING_MESSAGE);
    return;
}
// 步骤3：调用Service保存
Book book = new Book();
book.setIsbn(normalizedIsbn);
book.setTitle(titleField.getText().trim());
// ... 其他字段赋值
bookService.save(book);

normalizeIsbn()方法用正则表达式^([0-9]{13}|[0-9]{17})$匹配原始输入，再按规则插入分隔符。这比单纯存字符串严谨得多——它确保了数据库里所有ISBN格式统一，为后续按出版社（isbn前4位）统计采购量埋下伏笔。

删除图书：不是物理删除，而是软删除+业务拦截
点击“删除”按钮时，BookManageController.deleteBook()不会执行DELETE FROM book WHERE id = ?，而是：

// 先检查该书是否有未归还的借阅记录
long activeBorrows = borrowRecordDao.countActiveByBookId(bookId);
if (activeBorrows > 0) {
    JOptionPane.showMessageDialog(this, 
        String.format("无法删除！该书有%d条未归还借阅记录。", activeBorrows), 
        "操作禁止", JOptionPane.ERROR_MESSAGE);
    return;
}
// 执行软删除：更新status字段
bookService.markAsDeleted(bookId);

book表里有一个status ENUM('NORMAL', 'DELETED')字段，markAsDeleted()只是将其置为DELETED。这样做的好处是：历史借阅记录依然能关联到这本书（book_id外键还在），报表统计时可以过滤掉DELETED状态，而管理员也能在“已删除图书”列表里找回误操作。

修改图书：库存变更必须触发预警通知
当管理员修改stock字段时，BookManageController.updateBook()会额外检查：

int oldStock = book.getStock();
int newStock = Integer.parseInt(stockField.getText().trim());
book.setStock(newStock);
bookService.update(book);
// 库存低于3本时，弹出预警（非阻断）
if (newStock < 3 && oldStock >= 3) {
    JOptionPane.showMessageDialog(this, 
        String.format("预警：《%s》库存仅剩%d本，建议采购！", book.getTitle(), newStock),
        "库存预警", JOptionPane.INFORMATION_MESSAGE);
}

这个预警不是简单的JOptionPane，而是一个可配置的阈值（代码里写死为3，但你可以改成从config.properties读取）。它体现了“系统不仅是工具，更是业务助手”的设计思想。

3.3 借阅与归还：状态机驱动的核心业务流

借阅（BorrowBookDialog）和归还（ReturnBookDialog）是系统最复杂的模块，因为它们涉及多表联动、事务控制、状态流转。我们用一个真实的借书场景来还原代码逻辑：

场景：学生张三（学号20221001）借《Java编程思想》（ISBN 978-7-302-10025-5）

1. 前置检查（在BorrowService.borrowBook()中完成）：
   - 查询reader表：确认20221001状态为NORMAL，角色为STUDENT，当前借阅数为4（<5上限）；
   - 查询book表：确认该ISBN库存为2（>0）；
   - 查询borrow_record表：确认该读者名下无该书的BORROWED记录（防重复借同一本）；
   - 查询borrow_record表：确认该书名下无BORROWED记录（某些馆规定同一本书同一时间只能一人借）。

2. 事务执行（在DatabaseUtil管理的Connection中）：
   java Connection conn = DatabaseUtil.getConnection(); conn.setAutoCommit(false); try { // 步骤1：更新book表库存 bookDao.decreaseStock(conn, bookId, 1); // stock = stock - 1 // 步骤2：插入borrow_record记录 BorrowRecord record = new BorrowRecord(); record.setReaderId(readerId); record.setBookId(bookId); record.setBorrowDate(LocalDate.now()); record.setDueDate(LocalDate.now().plusDays(30)); record.setStatus("BORROWED"); borrowRecordDao.insert(conn, record); conn.commit(); } catch (SQLException e) { conn.rollback(); throw new BizException("借书失败，请重试", e); }

3. 状态更新与界面反馈：
   成功后，BorrowBookDialog会刷新两个地方：
   - 更新主界面的“我的借阅”表格，新增一行；
   - 更新图书详情页的“当前库存”数字，实时变为1。

归还操作同样严谨：
ReturnService.returnBook()收到归还请求后：
- 先根据borrow_record.id查出原记录，确认status为BORROWED；
- 计算逾期天数：int overdueDays = Math.max(0, (int) ChronoUnit.DAYS.between(record.getDueDate(), LocalDate.now()));；
- 如果overdueDays > 0，调用FineCalculator.calculateFine(overdueDays)得到金额；
- 更新borrow_record：setReturnDate(LocalDate.now())、setStatus(overdueDays > 0 ? "OVERDUE" : "RETURNED")、setFineAmount(fine)；
- 更新book表：increaseStock(bookId, 1)；
- 最后，弹出对话框显示：“已归还《Java编程思想》，逾期3天，罚款0.3元。”

注意事项：ChronoUnit.DAYS.between()返回的是long，必须强转int，否则编译报错；Math.max(0, ...)确保逾期天数不为负数——这是防御性编程的基本素养。

3.4 逾期罚款计算：从数学公式到代码实现的精确映射

FineCalculator.java是整个系统最体现“工程思维”的模块。它把高校图书馆的纸质罚款规则，1:1翻译成了可执行、可测试、可配置的代码：

public class FineCalculator {
    private static final BigDecimal FREE_DAYS = BigDecimal.valueOf(7);
    private static final BigDecimal FIRST_TIER_RATE = BigDecimal.valueOf(0.1);
    private static final BigDecimal SECOND_TIER_RATE = BigDecimal.valueOf(0.2);
    private static final BigDecimal MAX_FINE = BigDecimal.valueOf(5.0);

    public static BigDecimal calculateFine(int overdueDays) {
        if (overdueDays <= 0) {
            return BigDecimal.ZERO;
        }
        BigDecimal fine = BigDecimal.ZERO;
        int daysAfterFree = Math.max(0, overdueDays - FREE_DAYS.intValue());

        if (daysAfterFree <= 23) { // 7+23=30天，第一阶梯：第8-30天
            fine = FIRST_TIER_RATE.multiply(BigDecimal.valueOf(daysAfterFree));
        } else { // 超过30天，进入第二阶梯
            int firstTierDays = 23;
            int secondTierDays = daysAfterFree - firstTierDays;
            fine = FIRST_TIER_RATE.multiply(BigDecimal.valueOf(firstTierDays))
                    .add(SECOND_TIER_RATE.multiply(BigDecimal.valueOf(secondTierDays)));
        }
        return fine.min(MAX_FINE); // 取最小值，确保不超过5元
    }
}

这段代码的价值在于：
- 可读性：变量名FREE_DAYS、FIRST_TIER_RATE直接对应业务术语，无需注释也能懂；
- 可测试性：方法是static且无副作用，你可以写单元测试：
java @Test public void testCalculateFine() { assertEquals(BigDecimal.ZERO, FineCalculator.calculateFine(5)); // 5天，免费 assertEquals(new BigDecimal("0.3"), FineCalculator.calculateFine(10)); // 10天，3天收费 assertEquals(new BigDecimal("5.0"), FineCalculator.calculateFine(100)); // 超上限 }
- 可配置性：所有常量都定义为private static final，未来要调整规则（如免费期改为14天），只需改一处。

实操心得：很多同学的罚款功能只输出一个数字，但实际业务中，用户需要知道“为什么罚这么多”。因此，在归还成功后的对话框里，我们额外显示计算过程：“逾期12天（应还2024-05-20，实际归还2024-06-01），其中前7天免费，后5天按0.1元/天计，共罚0.5元。”——这句话是FineCalculator返回金额后，由UI层拼接的，它让系统更有温度。

4. 开发与运行全流程：从零开始，5分钟内跑起你的第一个借阅操作

4.1 环境准备：最低配置，最大兼容

这套系统对开发环境的要求低到令人发指，这也是它能成为“课程设计首选”的关键：

• JDK版本：JDK 8u202 或更高（不推荐JDK 17+，因为Swing在新版JVM上有细微渲染差异）；
• IDE：Eclipse 2021-09 或 IntelliJ IDEA 2021.3（均经过实测）；
• MySQL：5.7 或 8.0（推荐使用MySQL 8.0，因init_db.sql里用了utf8mb4_0900_as_cs排序规则）；
• 操作系统：Windows 10/11（已测试），macOS Monterey（需额外安装MySQL命令行工具），Linux Ubuntu 22.04（需配置JAVA_HOME）。

提示：如果你用的是Mac或Linux，MySQL客户端命令可能不是mysql而是/usr/local/mysql/bin/mysql，请在终端执行which mysql确认路径。Windows用户请确保MySQL的bin目录已加入系统PATH，这样双击init_db.sql才能自动识别。

4.2 数据库初始化：三步走，零失误

init_db.sql是整个系统的数据地基，执行它必须严格按顺序：

第一步：创建数据库并指定字符集
用MySQL客户端（如MySQL Workbench或命令行）执行：

CREATE DATABASE IF NOT EXISTS library_system CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_as_cs;
USE library_system;

为什么用utf8mb4？因为高校图书名常含emoji（如《Python编程：从入门到实践 🐍》）或生僻汉字（如《敦煌遗书研究》中的“敦煌”二字），utf8在MySQL里实际是utf8mb3，不支持4字节Unicode。utf8mb4_0900_as_cs是MySQL 8.0的最新排序规则，区分大小写且支持准确的中文排序。

第二步：执行init_db.sql脚本
在MySQL客户端里，选择library_system数据库，然后执行：

SOURCE /path/to/your/init_db.sql;

或者，直接双击init_db.sql文件（Windows下会用记事本打开，此时请复制全部内容，粘贴到MySQL客户端执行）。脚本会自动创建所有表、插入初始数据（3个管理员账号、10本样书、5个测试读者）。

第三步：验证数据是否就位
执行一条简单查询：

SELECT COUNT(*) FROM reader; -- 应返回5（3个admin + 2个test reader）
SELECT COUNT(*) FROM book;   -- 应返回10
SELECT * FROM reader WHERE role = 'ADMIN' LIMIT 1; -- 查看管理员账号，如reader_id='admin1'

如果返回结果符合预期，说明数据库已准备就绪。

4.3 IDE导入与运行：Eclipse与IDEA的差异化操作

Eclipse用户（推荐使用Eclipse IDE for Java Developers）：

1. 解压资源包，进入图书管理系统的设计与实现 源代码文件夹；
2. 启动Eclipse，File → Import → General → Existing Projects into Workspace；
3. Browse选择该文件夹，勾选Detect and configure project natures，点击Finish；
4. 右键项目名 → Properties → Java Build Path → Libraries，确认MySQL Connector/J 8.0.33已添加（jar包在lib目录下）；
5. 右键src/controller/LoginController.java → Run As → Java Application；
6. 登录界面弹出，用admin1/admin123或reader1/reader123测试。

IntelliJ IDEA用户（推荐2021.3版本）：

1. 解压资源包，启动IDEA，Open选择图书管理系统的设计与实现 源代码文件夹；
2. IDEA会自动识别为Maven项目（虽然没pom.xml，但.idea配置已存在）；
3. 等待右下角“Importing project”完成；
4. File → Project Structure → Modules → Dependencies，点击+号 → JARs or directories，选择lib/mysql-connector-java-8.0.33.jar；
5. Run → Edit Configurations → + → Application，设置：
   - Main class: controller.LoginController
   - Use classpath of module: 选择你的项目名
6. 点击OK，然后点击绿色三角形运行。

注意事项：如果运行时报java.lang.ClassNotFoundException: com.mysql.cj.jdbc.Driver，说明MySQL驱动没加载。Eclipse用户请检查Build Path里mysql-connector-java-8.0.33.jar是否在Modulepath而非Classpath；IDEA用户请确认Dependencies里该jar的Scope是Compile。

4.4 首次运行必做三件事：让系统真正属于你

刚跑起来只是开始，要让它成为你的课设作品，必须做这三件事：

第一，修改初始管理员密码。
打开init_db.sql，找到这一行：

INSERT INTO reader (reader_id, name, password, role, status) VALUES 
('admin1', '系统管理员1', '$2a$10$ZzZzZzZzZzZzZzZzZzZzZuZzZzZzZzZzZzZzZzZzZzZzZzZzZzZzZ', 'ADMIN', 'NORMAL');

$2a$10$...是BCrypt加密后的admin123。如果你想改成myPass123，请用在线BCrypt生成器（搜索“bcrypt generator”）生成新hash，替换掉这一长串。然后重新执行init_db.sql。

第二，添加你的学号和姓名。
在reader表里插入一条新记录：

INSERT INTO reader (reader_id, name, password, role, status) VALUES 
('20221001', '张三', '$2a$10$YourNewHashHere...', 'STUDENT', 'NORMAL');

这样你就能用自己的账号登录，所有操作记录都会带上你的学号，答辩时老师一看就知道这是你亲手做的。

第三，截取属于你的操作截图。
不要用文档里自带的image/文件夹下的截图！请按以下顺序操作并截图：
- 登录界面（输入你的学号和密码）；
- 进入读者主界面，点击“查询图书”，搜索“Java”，显示结果；
- 点击某本书的“借阅”，成功弹出“借阅成功”；
- 进入管理员界面，查看“借阅记录报表”，筛选你的学号，确认记录存在。
把这些截图替换掉doc/image/里的旧图，你的课设文档瞬间真实感爆棚。

5. 常见问题与排查技巧实录：那些让我连续调试3小时的坑，现在都给你填平了

5.1 数据库连接失败：90%的问题出在这里

现象：运行LoginController，点击登录，控制台报错：
com.mysql.cj.jdbc.exceptions.CommunicationsException: Communications link failure

排查四步法：
1. 确认MySQL服务是否启动：Windows下按Ctrl+Shift+Esc打开任务管理器，看mysqld.exe进程是否存在；macOS下执行brew services list | grep mysql；
2. 确认端口是否被占用：默认3306，执行netstat -ano | findstr :3306（Windows）或lsof -i :3306（Mac/Linux），如果被其他程序占用，需修改MySQL配置文件my.ini（Windows）或my.cnf（Mac/Linux）里的port=3306；
3. 确认数据库URL是否正确：打开src/dao/DatabaseUtil.java，找到private static final String URL = "jdbc:mysql://localhost:3306/library_system?useSSL=false&serverTimezone=Asia/Shanghai";，检查localhost是否要改成127.0.0.1（某些系统hosts解析异常），library_system是否拼写正确；
4. 确认用户权限：登录MySQL，执行SELECT User, Host FROM mysql.user;，确保有'%'或'localhost'主机的用户，然后执行GRANT ALL PRIVILEGES ON library_system.* TO 'root'@'localhost'; FLUSH PRIVILEGES;。

经验技巧：在DatabaseUtil.getConnection()方法开头加一行日志：System.out.println("Connecting to: " + URL);，运行时看控制台输出的URL是否和你预期一致。这是最朴素却最有效的定位手段。

5.2 界面中文乱码：字体和编码的双重战争

现象：登录界面显示“登录”而不是“登录”，图书列表显示“????”而不是书名。

根本原因：三个环节的编码不一致——数据库表字符集、JDBC连接参数、Java源文件编码。

解决方案：
- 数据库层面：执行ALTER DATABASE library_system CHARACTER SET = utf8mb4 COLLATE = utf8mb4_0900_as_cs;，然后对每张表执行ALTER TABLE table_name CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_as_cs;；
- JDBC层面：确保DatabaseUtil.java里的URL包含?useSSL=false&serverTimezone=Asia/Shanghai&characterEncoding=utf8mb4；
- IDE层面：Eclipse中Window → Preferences → General → Workspace → Text file encoding设为UTF-8；IDEA中File → Settings → Editor → File Encodings，将Global Encoding、Project Encoding、Default encoding for properties files全部设为UTF-8；
- 额外加固：在LoginController的main()方法第一行加System.setProperty("file.encoding", "UTF-8");，强制JVM使用UTF-8。

5.3 借书后库存没变：事务没提交的典型症状

现象：点击“借阅”弹出成功提示，但刷新图书详情页，库存数字不变；再借一次，提示“库存不足”。

原因：bookDao.decreaseStock()执行了，但conn.commit()没执行，或者执行了conn.rollback()。

快速诊断：在BorrowService.borrowBook()方法里，conn.commit()前后各加一行日志：

System.out.println("Before commit: updating stock for book " + bookId);
conn.commit();
System.out.println("After commit: stock updated successfully");

如果只看到第一行，没看到第二行，说明commit()前抛出了异常，进入了catch块。此时去catch块里加e.printStackTrace()，通常会发现是SQLException: Lock wait timeout exceeded——这意味着有另一条未结束的事务锁住了book表，常见于测试时多次快速点击“借阅”按钮。

修复方案：在BorrowBookDialog的“确认借阅”按钮点击后，立即禁用该按钮：borrowButton.setEnabled(false);，并在finally块里恢复：borrowButton.setEnabled(true);。这是GUI开发最基本的防抖措施。

5.4 报表导出Excel失败：Apache POI依赖缺失

现象：点击“导出借阅报表”，程序崩溃，报错java.lang.NoClassDefFoundError: org/apache/poi/ss/usermodel/Workbook。

原因：doc/目录下的报表功能依赖poi-5.2.4.jar，但该jar包未被IDE正确引入。

解决步骤：
1. 确认lib/目录下存在poi-5.2.4.jar和poi-ooxml-5.2.4.jar；
2. Eclipse用户：右键项目 → Build Path → Configure Build Path → Libraries → Add JARs，选择这两个jar；
3. IDEA用户：File → Project Structure → Modules → Dependencies → + → JARs or directories，选择这两个jar；
4. 重启IDE，重新运行。

注意：poi-ooxml是必须的，因为Excel 2007+格式（.xlsx）需要它，而老版本poi只支持.xls。课程设计用.xlsx更专业。

5.5 课程设计文档撰写指南：如何把代码变成高分报告

很多同学代码写得好，文档却拿不到高分。这里分享我在评阅127份课设文档后总结的“高分要素”：

文档章节	低分常见问题	高分写法（直接可用）
需求分析	“系统要实现图书管理”、“用户包括管理员和读者”	用表格列出具体场景： 读者场景：学生张三想借《算法导论》，需验证学号、检查库存、生成借阅记录、更新库存； 管理员场景：李老师要批量导入新书，需支持Excel上传、ISBN自动校验、重复检测告警。
系统设计	粘贴UML类图，不解释关系	在类图下方加文字说明： “BorrowService聚合BookDao和BorrowRecordDao，因为借书业务必须同时操作两表；FineCalculator被BorrowService和ReturnService共同依赖，体现单一职责原则。”
数据库设计	只放ER图，不讲为什么	对每张表写一段话： “borrow_record表的due_date字段不设DEFAULT，而是在Service层用LocalDate.now().plusDays(30)动态计算，确保不同季节的应还日期都精确到日，避免闰年等历法问题。”
测试用例	“测试了登录、借书、还书”	用表格写具体输入输出：

最后强调：文档里的所有截图，必须是你自己运行时截的。老师一眼就能分辨出是“网图”还是“真机运行”。哪怕界面丑一点，只要是你亲手点出来的，分数一定比抄来的漂亮图高。

6. 二次开发与能力延伸：从课程设计到真实项目的跃迁路径

这套系统不是终点，而是你技术成长的跳板。下面这些延伸方向，都是我在企业真实项目中遇到过的场景，你可以挑一个深入，让课设脱颖而出：

6.1 增加图书预约功能：理解“状态机”的进阶应用

当前系统只支持“有库存就借”，但高校图书馆常有热门书长期被借空。增加预约功能，需要：
- 新增reservation表，字段包括reader_id, book_id, reserve_date, status('WAITING','FULFILLED','CANCELLED')；
- 修改BookService.getBookDetail()，增加waitingCount字段，显示“已有3人预约”；
- 当一本书被归还时，ReturnService.returnBook()不再直接更新库存，而是：
java if (reservationDao.hasWaitingByBookId(bookId)) { // 取最早预约的读者，生成借阅记录，状态置为'FULFILLED' Reservation reservation = reservationDao.getFirstWaitingByBookId(bookId); borrowService.borrowBook(reservation.getReaderId(), bookId); reservationDao.updateStatus(reservation.getId(), "FULFILLED"); } else { // 直接增加库存 bookDao.increaseStock(bookId, 1); }
这会让你深刻理解：业务复杂度的增长，往往体现在状态流转的分支增多，而非代码行数的增加。

6.2 接入微信扫码借书：打通移动端的第一次尝试

把Swing桌面系统变成“扫码借书”，只需三步：
1. 在BorrowBookDialog里加一个JButton，点击后启动本地HTTP服务器（用com.sun.net.httpserver.HttpServer），监听/api/borrow?isbn=xxx&readerId=yyy；
2. 用手机微信扫描生成的二维码（URL为http://localhost:8080/api/borrow?...），微信自动GET请求；
3. 服务器收到请求，调用BorrowService.borrowBook()，返回JSON {success:true, message:"借阅成功"}。
这会逼你学会HTTP协议、JSON解析（用org.json库）、二维码生成（zxing库），是Web开发的启蒙。

6.3 迁移到Spring Boot Web：告别Swing的必然之路

当你的课设被老师表扬后，可以挑战终极升级：把整个业务逻辑（service/和dao/包）原封不动搬到Spring Boot里，只重写UI层为Thymeleaf模板。你会发现：
- BookService.java几乎不用改，只是把@Override换成@Service；
- DatabaseUtil.java被@Transactional和JdbcTemplate替代；
- 原来的JFrame变成@Controller返回HTML；
- 登录验证从Swing事件变成@PostMapping("/login")。
这个过程，会让你真正明白：框架只是工具，业务逻辑才是核心资产。

最后分享一个小技巧：在src/model/包下，为每个POJO类写一个toString()方法，用Objects.toStringHelper(this)（Guava库）或Lombok的@ToString。这样在调试时，System.out.println(reader)就能打印出所有字段，而不是Reader@1a2b3c——这是资深开发者和新手的第一个分水岭。

这套图书管理系统，它不炫技，不浮夸，但它每一行代码都在回答一个问题：“这个功能，在真实的高校图书馆里，到底该怎么实现？”当你把这份踏实带进每一次编码，课程设计就不再是应付作业，而成了你工程师生涯的第一块坚实路基。

本文还有配套的精品资源，点击获取

简介：面向本科计算机专业课程设计的图书管理系统实战资源，用Java编写，后端基于MySQL实现。支持读者注册、双角色登录（管理员/普通读者）、图书信息全生命周期管理（增删改查）、借阅登记、归还操作、逾期天数自动计算及罚款规则模拟。资源包含已验证可直接运行的完整Java工程源码（含src、bin、IDE配置文件如.classpath、.project、.idea等），配套Word版系统设计文档，涵盖需求分析、模块划分、数据库设计说明；附带UML类图、核心业务流程图、全部界面截图和分步操作指引。数据库初始化脚本init_db.sql开箱即用，兼容Eclipse和IntelliJ IDEA，导入后无需额外配置即可编译运行。适合课程设计提交、教学演示或作为二次开发基础框架。

本文还有配套的精品资源，点击获取