简介：在Java课程设计与毕业设计中，如何实现一个具备数据持久化、多条件查询与事务一致性的档案管理系统，是很多开发者面临的典型难题。从关系型数据库与文件存储的选型对比出发，理解SQL如何通过结构化查询与并发控制解决数据覆盖和统计效率问题，是构建可靠系统的第一步。本文从分层架构、数据库表设计、JDBC连接管理、PreparedStatement防注入、借阅事务回滚到Socket扩展，系统梳理了档案管理系统的完整技术链路。通过JDBC与MySQL的工程实践，结合SQLite等其他数据库的灵活切换方案，帮助读者快速搭建一个可验收、可演示、可回答追问的实验项目，真正掌握从DAO到业务层的编码思路与异常处理技巧。

1. 从实验课上的“假系统”说起：一份能扛住答辩的小型档案管理系统方案

某高校软件工程实验课上，A同学拿到题目“Java实验设计：实现一个小型档案管理系统”。他第一反应是写一个控制台程序，定义一个Archive类塞进ArrayList，增删改查完事。可实验要求里白纸黑字写着“数据必须持久化”“支持按档案类型统计”“系统可供多人使用”，这三条直接把内存版方案打回原形。用集合做CRUD只能糊弄一下演示，一旦程序重启，数据全部归零，更别提多人同时操作的场景。

这份方案不是教你写一个能交差的Demo，而是从需求分析、数据库设计、编码实现、异常排查到验收答辩的完整流程。适合正在做Java课设或毕设的学生，也适合需要快速交付一个可改可用的后台系统的从业者。你读完能照着这一套结构把自己的项目拼出来，而不是看一堆零散知识点。整个方案的核心就一句话：用JDBC+关系型数据库替代文件存储，再用分层代码让每个模块都能在答辩时被单独拆开讲清楚。

2. 需求梳理与技术选型：SQL落地凭什么比文件存储更适合实验课

实验题目通常不会只写“档案管理系统”六个字，后面往往跟着几条明确要求：采用Java语言、数据存储使用数据库、程序提供命令行或图形界面、能够进行条件查询与统计。有些题目还会特别加上“采用Client/Server结构”，这就是Socket的出处。先把这些要求翻译成功能点，才不会在开发到一半时发现漏了需求。我一般会先画一张功能清单，把“必须做”“选做”“能讲出亮点”分开，再决定技术栈。

2.1 功能需求拆解：登录、档案管理、查询统计的边界

一份合格的实验需求清单至少要覆盖以下内容。用户登录：区分管理员和普通操作员，管理员可以删除档案、维护类型表，操作员只能录入和查询。档案信息管理：每个档案有档号（唯一，不可修改）、标题、类型、归档日期、保管期限、存放位置和状态。查询检索：至少支持按档号精确查询、按标题关键字和类型做模糊查询，结果按时间倒序展示。借阅归还：记录借出人、借出时间和归还时间，档案状态在“在库”和“借出”之间流转。统计报表：按类型统计档案数量，按年度统计归档数量，并输出到控制台。

这里有一个容易被忽略的边界：档号和自增主键是不同的概念。主键archive_id是数据库内部的整数ID，用来关联外键；档号archive_no是业务编号，比如ARC-2024-001，需要业务唯一约束。很多同学直接把主键当档号显示出来，答辩时老师问“档号重号了怎么办”就答不上来。我在设计阶段会用表格写出每个字段的“业务含义”和“技术含义”，避免把两套东西混在一起。

2.2 技术选型：JDBC + MySQL 还是 SQLite？Socket放在哪一层

实验课选型的第一原则是：能被老师看懂，能在现场跑起来。JDBC是必选项，因为题目通常明确要求使用JDBC操作数据库，不能把数据写到本地文件。文件存储表面上也能持久化，但两个致命问题没法回避：多人同时写同一个文件会互相覆盖，按条件统计只能全量遍历。SQL天然解决这两点，所以数据库是核心选型。

数据库具体选MySQL还是SQLite，要看实验环境。机房如果已经装好MySQL，直接用。如果本机没权限装服务，SQLite是一个很务实的保底方案：驱动jar包只有几百KB，一个文件就是整个库，JDBC代码几乎不用改，只需要改URL为jdbc:sqlite:archive.db。下表是两种库在实验课上的差异：

我的建议是代码里用配置文件保存数据库连接参数，默认指向MySQL，现场如果连不上就一行改成SQLite。这里有一个高频翻车点：MySQL 8.x的驱动类名是com.mysql.cj.jdbc.Driver，5.x是com.mysql.jdbc.Driver，驱动版本和类名不匹配会直接ClassNotFoundException。选型文档里要把驱动jar包的版本一并写清楚，避免到答辩现场才手忙脚乱。

Socket不改变存储层，它只是给系统加一个网络入口。服务端启动后监听一个端口，客户端发来query:ARC-2024-001这样的命令，服务端调用档案查询业务，把结果写回客户端。这样做的好处是：JDBC部分照常使用，Socket只是换了个输入来源，不需要为网络通信重写业务逻辑。如果题目没有要求Socket，就不要加，一个Socket模块会引入线程、端口、字符编码一堆新问题，反而拉低整体完成度。

2.3 实验评分视角：哪些点最容易丢分

从前年的验收记录看，扣分项基本集中在四类：程序一启动就因为连接配置崩掉；数据库表设计得特别随意，所有字段塞一张表；查询和统计用的是全表遍历而不是SQL聚合；演示时输错一个字符导致整个界面卡死。这套方案里对应做了四个动作：连接参数全部走配置文件、表结构拆成四张表并加外键、统计用GROUP BY完成、DAO层所有方法都做了空值和异常处理。如果你现在的实验题目还没定技术栈，建议先按这四条对照一遍，缺哪个补哪个，比闷头写代码有效得多。

3. 总体设计：分层架构与数据库表结构设计

设计阶段最重要的目标是：把“能跑”变成“能讲”。很多同学的代码能运行，但整体是一个main方法几百行，老师说“把查询模块单独指给我看”，半天找不到。所以分层是实验设计的第一个交付物。这一章先把代码要落脚的框架搭起来，再讲数据库表结构，最后把模块边界定义清楚。

3.1 分层架构：包结构与数据流向

我推荐一个折中的四层结构，不要为了设计模式而设计：

com.demo.archive ├── model 实体类，对应表结构 ├── dao 数据访问，JDBC和SQL都在这层 ├── biz 业务逻辑，校验、事务边界 ├── ui 控制台或Swing界面 ├── util 连接工具和配置加载 └── socket 可选扩展，C/S结构服务端

UI层收到用户输入，只负责调用业务层，不做逻辑判断。业务层先做校验，例如“档号不能重复”“状态为借出的档案不能二次借出”，然后决定要不要开事务。DAO层只执行SQL，不处理业务规则。数据流向是UI → biz → dao → 数据库，返回时原路返回。

这个结构的好处是答辩时能对应上问题。老师问“如果我新增一个‘档案销毁’功能，代码怎么改”，答案就很清晰：biz层新增一个destroy方法，dao层新增一个updateStatus为“销毁”的SQL，UI层加一个菜单入口。三个地方各改一小段，而不是在一堆代码里找线头。分层不是空架子，它是为了降低“老师现场让你改需求”时的修改成本。

3.2 数据库表设计：主表、类型表、用户表、日志表

建表脚本可以直接用在MySQL上，核心是四张表：

CREATE DATABASE IF NOT EXISTS archive_db DEFAULT CHARACTER SET utf8mb4; USE archive_db; CREATE TABLE `user` ( `user_id` INT PRIMARY KEY AUTO_INCREMENT, `username` VARCHAR(50) NOT NULL UNIQUE, `password` VARCHAR(64) NOT NULL, `role` VARCHAR(20) NOT NULL DEFAULT 'operator' ); CREATE TABLE `archive_type` ( `type_id` INT PRIMARY KEY AUTO_INCREMENT, `type_name` VARCHAR(50) NOT NULL UNIQUE, `description` VARCHAR(200) ); CREATE TABLE `archive` ( `archive_id` INT PRIMARY KEY AUTO_INCREMENT, `archive_no` VARCHAR(30) NOT NULL UNIQUE, `title` VARCHAR(200) NOT NULL, `type_id` INT NOT NULL, `archive_date` DATE NOT NULL, `shelf_life` VARCHAR(20) NOT NULL, `status` VARCHAR(10) NOT NULL DEFAULT '在库', `location` VARCHAR(100), `created_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, `updated_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, `deleted` TINYINT NOT NULL DEFAULT 0, FOREIGN KEY (`type_id`) REFERENCES `archive_type`(`type_id`) ); CREATE TABLE `operation_log` ( `log_id` INT PRIMARY KEY AUTO_INCREMENT, `user_id` INT NOT NULL, `action` VARCHAR(50) NOT NULL, `target_id` VARCHAR(30), `detail` VARCHAR(500), `log_time` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP, FOREIGN KEY (`user_id`) REFERENCES `user`(`user_id`) );

archive表中的deleted字段是逻辑删除标记。为什么不用DELETE？因为档案管理系统需要操作留痕，一旦物理删除，所有历史查询都对不上。查询时必须把AND deleted = 0加到每个SQL里，这容易漏，所以我会把这条过滤写在DAO基类，而不是每个方法里手写。status字段用中文还是英文？实验课阶段直接用中文“在库/借出/销毁”可读性最强，答辩时不用翻译。操作日志表单独建一张，是为了回答“谁在什么时间改了什么”，实验评分里经常有一项“系统具备操作日志记录功能”，没有这张表就得现场补，很被动。

3.3 模块边界：登录、档案管理、借阅、统计报表的定义

每个模块要能说清输入、输出和异常场景。登录模块输入用户名密码，输出用户角色，失败时给出“用户名或密码错误”。档案管理模块输入档案字段，输出新增结果的提示；修改时档号不允许改，因为档号被其他模块和日志引用。借阅模块输入档号和借阅人，输出成功或业务异常，异常场景包括“档案不存在”“状态不是‘在库’”。统计报表模块用一条SQL完成，按类型统计的语句是：

SELECT t.type_name, COUNT(*) AS cnt FROM archive a JOIN archive_type t ON a.type_id = t.type_id WHERE a.deleted = 0 GROUP BY t.type_name ORDER BY cnt DESC;

这条SQL直接把数据库的分组能力用上了，比在Java里遍历再统计更直观，答辩时可以顺手写出来。除了按类型统计，还可以按归档年份统计：SELECT YEAR(archive_date) AS year, COUNT(*) FROM archive WHERE deleted = 0 GROUP BY YEAR(archive_date)，两个报表可以共用同一个菜单入口。

3.4 配置文件与初始化数据：把变化项抽出去

实验课最常见的翻车就是代码里写死数据库地址，换一台机器就要改源码重新编译。我会用一个db.properties配置文件保存连接信息，DBUtil加载它。初始化数据包括一个管理员账号和几个基础类型，在第一次运行时执行init.sql写入。配置文件的路径使用项目根目录相对路径，这样拷到哪台机器都能加载。这一步不复杂，但能让你的程序在答辩现场换环境时快速救场。

4. 核心模块实现：从DBUtil到借阅事务的完整链路

这一章开始贴代码，按照“工具类 → 数据访问 → 事务控制 → 网络扩展”的顺序走，让你做实验时能直接抄，抄完能讲清楚每段代码为什么这么写。

4.1 DBUtil：驱动加载、连接获取与资源关闭

package util; import java.sql.Connection; import java.sql.DriverManager; import java.sql.ResultSet; import java.sql.SQLException; import java.sql.Statement; public class DBUtil { private static final String URL = "jdbc:mysql://localhost:3306/archive_db?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai"; private static final String USER = "root"; private static final String PASSWORD = "123456"; static { try { Class.forName("com.mysql.cj.jdbc.Driver"); } catch (ClassNotFoundException e) { throw new ExceptionInInitializerError("MySQL驱动未找到，请检查jar包是否在classpath中"); } } public static Connection getConnection() throws SQLException { return DriverManager.getConnection(URL, USER, PASSWORD); } public static void close(ResultSet rs, Statement stmt, Connection conn) { if (rs != null) { try { rs.close(); } catch (SQLException e) { e.printStackTrace(); } } if (stmt != null) { try { stmt.close(); } catch (SQLException e) { e.printStackTrace(); } } if (conn != null) { try { conn.close(); } catch (SQLException e) { e.printStackTrace(); } } } }

URL里的useUnicode=true&characterEncoding=utf8是中文不乱码的关键；serverTimezone=Asia/Shanghai是MySQL 8.x的时区要求，不加会报时间戳错误。static块在类加载时执行一次，驱动注册后就不会重复加载。资源关闭顺序必须是ResultSet → Statement → Connection，反了会导致Statement抛出“连接已关闭”的异常。

实验场景里不需要连接池。我见过太多同学交作业时引入Druid，结果答辩现场配置文件没写好，直接启动失败。与其去调一个你不理解的连接池参数，不如用DriverManager每次拿新连接，配合finally里关闭，足以应对实验课的并发量。等老师问“并发大了怎么办”，你再回答“可以用连接池优化”才有说服力。

4.2 档案搜索：多条件组合查询与PreparedStatement

搜索模块需要支持按关键字和类型组合过滤，同时分页。完整代码如下：

public List<ArchiveVO> search(String keyword, Integer typeId, int page, int pageSize) { List<ArchiveVO> result = new ArrayList<>(); StringBuilder sql = new StringBuilder( "SELECT a.archive_id, a.archive_no, a.title, a.archive_date, a.status, t.type_name " + "FROM archive a JOIN archive_type t ON a.type_id = t.type_id " + "WHERE a.deleted = 0"); List<Object> params = new ArrayList<>(); if (keyword != null && !keyword.trim().isEmpty()) { sql.append(" AND (a.archive_no LIKE ? OR a.title LIKE ?)"); params.add("%" + keyword.trim() + "%"); params.add("%" + keyword.trim() + "%"); } if (typeId != null) { sql.append(" AND a.type_id = ?"); params.add(typeId); } sql.append(" ORDER BY a.archive_id DESC LIMIT ? OFFSET ?"); params.add(pageSize); params.add((page - 1) * pageSize); try (Connection conn = DBUtil.getConnection(); PreparedStatement ps = conn.prepareStatement(sql.toString())) { for (int i = 0; i < params.size(); i++) { ps.setObject(i + 1, params.get(i)); } try (ResultSet rs = ps.executeQuery()) { while (rs.next()) { ArchiveVO vo = new ArchiveVO(); vo.setArchiveId(rs.getInt("archive_id")); vo.setArchiveNo(rs.getString("archive_no")); vo.setTitle(rs.getString("title")); vo.setArchiveDate(rs.getString("archive_date")); vo.setStatus(rs.getString("status")); vo.setTypeName(rs.getString("type_name")); result.add(vo); } } } catch (SQLException e) { e.printStackTrace(); } return result; }

LIKE的通配符%放在参数值里，SQL模板保持?占位符，这样既能模糊匹配，又不会因为注释符导致查询条件失效。LIMIT和OFFSET用setObject统一参数类型，实际用setInt也可以。分页参数page从1开始，所以OFFSET是(page-1)*pageSize。如果keyword传了中文，URL里的characterEncoding保证从客户端到数据库都是UTF-8。使用PreparedStatement最直接的好处是防SQL注入，答辩时老师如果输入一个单引号试查询，程序不会报语法错误，这一步属于“演示加分项”。

4.3 借阅模块：共享连接与事务回滚

借阅的完整操作是：查询档案状态 → 判断是否在库 → 更新状态为借出 → 插入借阅记录 → 写操作日志。中间任何一步失败，前面成功的步骤都要撤销。核心代码如下：

Connection conn = null; try { conn = DBUtil.getConnection(); conn.setAutoCommit(false); int affected = archiveDao.updateStatus(conn, archiveNo, "借出"); if (affected != 1) { throw new BusinessException("档案不存在或状态不是“在库”"); } borrowDao.insert(conn, archiveNo, borrower, borrowTime); logDao.insert(conn, userId, "BORROW", archiveNo, "借出给" + borrower); conn.commit(); } catch (Exception e) { if (conn != null) { conn.rollback(); } throw e; } finally { if (conn != null) { conn.setAutoCommit(true); conn.close(); } }

这里的关键在于所有数据操作都使用同一个Connection对象，而不是每个DAO方法自己getConnection。如果每个DAO各自拿连接，commit和rollback就作用在两个不同的事务上，回滚根本不生效。我一般会在DAO方法里增加一个“带连接的重载”，业务层传入连接，这样事务边界由业务层控制，DAO只负责执行SQL。事务有一个细节要注意：业务校验失败也算异常处理的一部分，但是不需要回滚，比如“档案状态不是借出”这种情况，可以直接抛BusinessException让上层提示，不一定要进到rollback分支。

4.4 Socket扩展：给档案查询加一个远程服务端

如果实验要求有socket，可以单独建一个模块。服务端监听端口，循环接收客户端命令，调用业务层返回结果：

try (ServerSocket server = new ServerSocket(8088)) { while (true) { Socket socket = server.accept(); new Thread(() -> { try (BufferedReader in = new BufferedReader( new InputStreamReader(socket.getInputStream(), "UTF-8")); PrintWriter out = new PrintWriter( socket.getOutputStream(), true, "UTF-8")) { String line = in.readLine(); if (line != null && line.startsWith("query:")) { String no = line.substring(6); String result = archiveBiz.queryByNo(no); out.println(result == null ? "NOT_FOUND" : result); } } catch (Exception e) { e.printStackTrace(); } }).start(); } }

注意服务端地址别写死，用args参数或配置文件。这里accept之后开一个线程处理，属于最简单的并发模型，避免一个慢客户端阻塞整个服务。如果实验评分只看“能不能连上”，这个模型就够了；要是老师问多线程安全，你可以答“查询是只读的，共享数据在数据库层靠事务保证”。客户端的Socket连接如果没按协议发送数据，服务端线程会一直卡在readLine上，可以在Socket上设置setSoTimeout(3000)控制读超时，防止现场演示时线程被占满。

5. 常见问题避坑：实验课最容易翻车的 5 个点

实验课的翻车现场高度集中在这五个问题上。每个问题都按“现象 → 原因 → 解决”来排查，演示前对着走一遍，能省掉大半突发状况。

5.1 驱动类找不到：ClassNotFoundException

现象：程序启动第一行就报java.lang.ClassNotFoundException: com.mysql.cj.jdbc.Driver，控制台一片红。原因：MySQL驱动jar包没有放进编译输出目录，或者Maven依赖没有刷新，甚至jar包版本和数据库不匹配。解决：如果手动放jar，确认它出现在项目的外部库或lib目录；用Maven就执行一次reimport；然后检查驱动类名，MySQL 5.x和8.x的驱动类名不同，8.x是com.mysql.cj.jdbc.Driver。我每次写DBUtil都会在static块里把“驱动加载失败”的提示打印出来，至少能定位到这一步。

提示：如果你用的是SQLite，驱动类名是org.sqlite.JDBC，URL是jdbc:sqlite:database.db，这两个地方改了就行，其他地方不用动。

5.2 中文乱码：数据写进去是问号，查出来也是问号

现象：界面录入“文书档案”，数据库里存的是“???”，或者控制台打印乱码。原因：三层编码不一致，IDE文件编码是GBK，数据库建库用的utf8mb4，JDBC连接URL没有指定characterEncoding。解决：统一改成UTF-8。IDE的Project Encoding设为UTF-8，建库语句用DEFAULT CHARACTER SET utf8mb4，URL加useUnicode=true&characterEncoding=utf8。如果控制台还是乱码，在运行配置的VM参数里加-Dfile.encoding=UTF-8。这一步是玄学重灾区，我一般直接建库脚本里写死字符集，不给默认值留机会。

5.3 连接泄漏：程序跑着跑着就报“Too many connections”

现象：连续操作几十次后，报错Can not connect to MySQL server. Too many connections。原因：getConnection拿到了连接，但异常路径上没有close，连接一直占着不还。代码里到处都是new Connection，却没有finally。解决：统一用try-with-resources或finally里调用DBUtil.close(rs, stmt, conn)。可以在日志输出连接创建次数和关闭次数，如果创建大于关闭，说明有泄漏。养成习惯：所有查询方法不要自己new连接，让业务层传进来，关闭统一在DBUtil里做。

5.4 SQL注入：输入一个单引号程序就崩了

现象：查询框输入' OR 1=1 --能把整个表带出来，或者登录时用户名输入admin'--直接跳过密码校验。原因：SQL语句用字符串拼接，把用户输入当成代码执行。解决：所有SQL一律用PreparedStatement的?占位符，参数用setString/setInt设置。答辩时可以说“我用PreparedStatement做预编译，数据库会先解析SQL结构，输入内容只能当参数，不能改变SQL语义”。这是最不需要争议的技术点，答不上来会非常减分。

5.5 Socket端口被占用：服务端一启动就“Address already in use”

现象：重启服务端时报java.net.BindException: Address already in use，改端口又发现客户端连不上。原因：上一个进程没退出，端口被TIME_WAIT状态占着，或者端口被别的服务占用。解决：启动前先用netstat -ano | findstr 8088查看端口，杀掉占用进程；如果程序要频繁重启，可以在ServerSocket bind时设置setReuseAddress(true)，但实验课不建议依赖它，直接选一个不常用的端口像8099。客户端连不上时先从服务端日志看到底是accept了没，还是连接被拒绝，不要只看客户端报错。

6. 验收与答辩技巧：用一套可复现的演示脚本打动老师

6.1 一套标准的演示路径

我建议按下面顺序演示，每个功能停留几秒，让老师看清操作和结果。启动前先执行init.sql，确认数据库连接配置正确。第一步，管理员登录，新增一个“科技档案”，上报档号和标题；第二步，重启程序再登录，查询刚才的档案，验证数据持久化；第三步，用模糊查询搜标题关键字，展示结果列表；第四步，执行借出操作，查询状态变成“借出”，再执行归还，状态恢复“在库”；第五步，进入统计报表，按类型显示数量，顺手把SQL语句说出来。这套路径覆盖了增删改查、持久化、事务、统计四个核心评分点。

6.2 答辩时最可能被追问的三个问题

第一个问题：为什么要用SQL，而不是直接把数据写到文件里。答：SQL提供结构化查询、事务和并发控制，档案系统需要多用户和按条件统计，文件方式每次都要遍历全量数据，且无法保证一致性。第二个问题：为什么档案删除用的是逻辑删除。答：档案管理要求留痕，物理删除会丢失历史记录，deleted字段配合操作日志可以追溯。第三个问题：如果连接数不够怎么办。答：当前实验规模用DriverManager够用，生产环境会换成连接池，业务层接口不变，只改DAO实现。

以前我交实验课作业，总觉得“代码能跑”就万事大吉，结果老师一句话把我问住了：“你把程序关了再开，数据还在吗？”那次我是用文件存储的，所有记录全没了。从那以后我每次交付前都强制走一遍验收清单，数据持久化、异常路径、SQL注入、端口冲突全测一遍，答辩时心里才有底。希望这套方案帮到你，照着做，至少不会在演示现场翻车。

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