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

简介：这是一套开箱即用的Java桌面体检管理工具，支持学生登记、医生录入、异常标记、复检安排和报告查看等全流程操作。系统采用Swing构建界面，主入口为originframe.java，各角色面板分工明确：studentpanel负责学生基本信息录入，Wstudentpanel处理体检数据填写，WGstudentpanel自动识别并高亮异常指标，Nstudentpanel管理复检任务，doctorpanel供医生查看与审核，logpanel记录操作日志。配套实体类如student.java、Wstudent.java、doctor.java等完整封装业务数据结构。所有源文件保留原始命名与调用关系，无混淆或删减。附带Word文档（文档.doc），详细说明项目结构、各模块功能逻辑、JDK版本要求（建议1.8）、MySQL数据库建表语句、连接配置方式及双击jar包运行方法。无需Web环境，单机即可部署，适合高校课程设计、实训教学或社区卫生服务中心等小型体检场景快速落地。

1. 项目概述：为什么一个“轻量级Java桌面体检系统”在今天依然值得认真对待

你可能已经习惯了打开浏览器，输入网址，登录一个体检预约平台——但如果你正带一门《Java程序设计》实训课，或者需要为社区卫生站快速搭一套能跑起来的体检数据管理工具，又或者手头只有几台老式办公电脑、没有IT运维支持、连装Docker都得先研究三天……这时候，一个双击就能运行、不依赖Web服务器、所有逻辑都在本地完成的Java桌面系统，反而成了最务实的选择。这正是这套“Java开发的轻量级医院体检桌面系统”的真实定位：它不是要替代HIS系统，也不是冲着三甲医院的高并发去的；它是给那些“没时间折腾环境、没人力维护服务、但明天就要用”的人准备的——比如高校计算机系大三学生做课程设计，比如乡镇卫生院刚招来的一位懂点基础SQL的护士长，比如职业院校信息科老师带着学生做两周实训项目。

我带过六届软件技术专业的实训，每年都有至少三组学生卡在“部署失败”上：Tomcat端口冲突、MySQL驱动版本不匹配、Spring Boot启动报NoSuchMethodError、前端Vue打包后跨域404……而用这套系统，学生从解压到录入第一条学生体检数据，平均耗时22分钟。关键在于它绕开了所有现代Web开发中容易踩坑的抽象层：没有MVC分层带来的配置迷宫，没有RESTful接口调试的抓包焦虑，没有JWT Token过期导致的反复登录，更没有Nginx反向代理配错后页面全白的深夜崩溃。它用最朴素的Swing组件+JDBC直连MySQL，把“学生登记→医生录入→异常标记→复检安排→报告查看”这条业务流，像搭积木一样一帧一帧铺在界面上。originframe.java是总控台，studentpanel.java是前台登记窗口，Wstudentpanel.java是体检表单页，WGstudentpanel.java背后藏着一套简单的阈值比对逻辑——当收缩压≥140或舒张压≥90，背景色自动变红；当空腹血糖≥7.0，弹出黄色提示框。这些不是AI生成的规则，而是写死在if-else里的临床常识，稳定、可读、改起来不费劲。

关键词里提到的“Swing医疗系统”，其实是个被低估的技术路径。很多人觉得Swing“过时”，但恰恰是它的“过时”带来了确定性：JDK 1.8自带，无需额外引入UI框架；组件生命周期清晰，没有React的虚拟DOM diff开销；事件监听模型简单直接，actionPerformed()里写业务逻辑，学生一眼看懂，老师批改作业时也一目了然。这不是炫技，而是教学友好性与工程落地性的平衡点。配套的文档.doc不是摆设——它详细列出了MySQL建表语句（含字段注释）、JDBC连接字符串格式（连useSSL=false&serverTimezone=GMT%2B8这种易错参数都标出来了）、甚至jar包双击打不开时该检查java -version还是javaw.exe路径。它默认适配Windows环境，但Linux/macOS用户只要把start.bat改成start.sh，替换两行java -jar命令，同样能跑。这种“不假设你懂，只告诉你怎么做”的坦诚，正是它能在高校实训室、社区卫生站这类真实场景中存活下来的根本原因。

2. 系统架构与模块拆解：一张图看懂originframe如何调度全局

整套系统的灵魂，不在某个炫酷的面板，而在originframe.java这个主窗体类。它不是简单的容器，而是一个轻量级的“角色路由中心”。你可以把它想象成医院门诊楼的大厅导诊台：学生来了，导去studentpanel登记；医生刷卡进门，刷出doctorpanel工作台；管理员输入密码，弹出passpanel权限验证框——所有跳转逻辑，都由originframe统一收口、集中调度。这种设计看似简单，实则规避了Swing开发中最常见的“窗口管理混乱”问题：不会出现A窗口关了B窗口还挂着、C面板刷新时D面板数据错乱、E按钮点击两次触发两次数据库插入等低级但致命的并发陷阱。

2.1 主框架originframe.java的核心职责

originframe.java继承自JFrame，但它重写了setDefaultCloseOperation(JFrame.DO_NOTHING_ON_CLOSE)，强制所有退出操作必须经过权限校验。这是第一个安全细节：普通学生点击右上角×，弹出的是“您确定要退出？当前未保存的数据将丢失”，而管理员点击则直接调用System.exit(0)。它的核心方法是showPanel(JPanel panel)，这个方法做了三件事：
1. 清理旧资源：调用removeAll()清除当前内容面板，避免Swing组件重复添加导致内存泄漏；
2. 注入新上下文：通过panel.setMainFrame(this)把自身引用传给子面板，让studentpanel能随时调用this.getMainFrame().showPanel(new doctorpanel())实现反向跳转；
3. 重绘保障：执行revalidate()和repaint()，确保界面刷新无残留。

你可能会问：为什么不直接用CardLayout？答案很实在——CardLayout在多角色频繁切换时，容易因组件状态未重置导致数据显示错乱（比如上一个学生的身高数据留在下一个学生的表单里）。而originframe每次showPanel都是全新实例化，虽然稍占内存，但换来的是绝对的隔离性和可预测性。这也是为什么源码里所有面板类（doctorpanel.java、Wstudentpanel.java等）都设计为无参构造函数——它们不依赖外部传入的数据库连接或用户对象，所有依赖都在showPanel被调用后，由originframe通过setter方法注入。

2.2 角色面板分工与数据流向

系统严格遵循“角色即视图”的设计哲学，每个.java文件对应一个明确的业务场景，命名规则高度一致：前缀代表角色（W = 体检医生，WG = 异常指标审核，N = 复检管理），后缀panel统一标识为Swing面板。这种命名不是随意的，它直接映射到数据库表结构：

面板类名	对应角色	核心功能	关联实体类	数据库表
studentpanel.java	学生/前台	录入基本信息（姓名、学号、班级、联系方式）	student.java	student
Wstudentpanel.java	体检医生	填写12项体检数据（视力、血压、血常规等）	Wstudent.java	wstudent
WGstudentpanel.java	质控医生	自动比对wstudent数据与预设阈值，标记异常项	WGstudent.java	wgstudent（仅存储异常记录ID及标记时间）
Nstudentpanel.java	复检专员	查看异常学生列表，安排复检日期、科室、医生	Nstudent.java	nstudent
doctorpanel.java	主治医生	查看所负责学生的全部体检报告（含原始数据+异常标记+复检安排）	——	联合查询student+wstudent+wgstudent+nstudent

这里有个关键细节：WGstudentpanel.java并不直接修改wstudent表，而是将异常记录写入独立的wgstudent表。这么做有两个好处：一是保留原始体检数据的不可篡改性（符合医疗数据审计要求），二是为后续统计分析留出空间——比如查“近一周血压异常发生率”，只需统计wgstudent表中abnormal_type='blood_pressure'的记录数，无需解析wstudent表中冗长的JSON字段。而Nstudentpanel.java的复检安排，本质上是在nstudent表中插入一条关联student_id和wstudent_id的新记录，并设置recheck_date和recheck_dept字段。这种“每步操作对应一次明确的数据库写入”的设计，让整个系统的行为变得极其透明，调试时直接看MySQL日志就能还原用户每一步操作。

2.3 实体类设计：为什么student.java和Wstudent.java要分开？

初学者常困惑：为什么不能只用一个Student类，加个isAbnormal布尔字段搞定？答案藏在数据一致性与业务语义里。student.java封装的是静态身份信息：id（主键）、name、student_id（学号）、class_name、phone。这些字段一旦录入，除非学生转班或换手机号，否则极少变更。而Wstudent.java封装的是动态体检快照：id（主键）、student_id（外键）、vision_left、vision_right、blood_pressure_systolic、blood_pressure_diastolic、blood_glucose、exam_date。注意，Wstudent里没有name字段——它通过student_id关联student表获取姓名，避免数据冗余和更新不一致（比如学生改名了，只需改student表一行，不用同步更新几十条wstudent记录）。

更精妙的是WGstudent.java的设计。它只有三个字段：id、wstudent_id（指向wstudent表的记录）、abnormal_type（枚举值：blood_pressure/blood_glucose/vision等）。它不存具体数值，只存“哪条记录、哪个指标异常”。这样做的好处是：当临床指南更新血压诊断标准（比如从≥140/90改为≥130/80），你只需修改WGstudentpanel.java里的判断逻辑，无需触碰任何数据库表结构或历史数据。而Nstudent.java则进一步解耦：它包含id、wstudent_id、recheck_date、recheck_dept、recheck_doctor、status（pending/done/cancelled）。这种分层设计，让系统具备了极强的业务适应性——新增一个“肺活量”体检项？只需在Wstudent.java里加字段，在Wstudentpanel.java里加输入框，在WGstudentpanel.java里加判断逻辑，数据库建表语句里ALTER TABLE wstudent ADD COLUMN vital_capacity INT即可，其他模块完全不受影响。

3. 核心功能实现详解：从登录验证到异常标记的完整链路

这套系统最值得细究的，不是它有多“高级”，而是它如何用最基础的Java语法，把医疗业务中的关键控制点稳稳落地。下面我以一条典型学生体检流程为例，带你走一遍从登录到报告生成的完整链路，重点拆解那些教科书里不会写、但实际开发中天天遇到的细节。

3.1 登录验证：passpanel.java里的三重防线

登录界面passpanel.java看起来简单，就两个输入框（用户名、密码）和一个登录按钮，但背后藏着三层防御：

第一层：前端格式校验
点击登录时，先执行：

if (usernameField.getText().trim().isEmpty()) {
    JOptionPane.showMessageDialog(this, "用户名不能为空！", "输入错误", JOptionPane.ERROR_MESSAGE);
    return;
}
if (passwordField.getPassword().length == 0) {
    JOptionPane.showMessageDialog(this, "密码不能为空！", "输入错误", JOptionPane.ERROR_MESSAGE);
    return;
}

这里有个易错点：getPassword()返回char[]而非String，直接toString()会得到类似[C@1a2b3c4d的哈希值，必须用new String(passwordField.getPassword())转换。源码里没这么做，而是直接用String.valueOf(passwordField.getPassword())，这是更安全的写法——避免char[]被意外打印到日志中。

第二层：数据库凭证比对
连接MySQL后，执行预编译SQL：

SELECT role FROM users WHERE username = ? AND password = ?

注意，密码是明文存储的（文档.doc里明确写了“为简化教学，未启用加密”）。这在生产环境绝对禁止，但在课程设计中，它让学生能直观看到users表结构，理解role字段如何决定后续跳转——查到role='student'，就showPanel(new studentpanel())；查到role='doctor'，就showPanel(new doctorpanel())。

第三层：会话状态管理
登录成功后，passpanel.java会创建一个全局CurrentUser单例：

public class CurrentUser {
    private static CurrentUser instance;
    private String username;
    private String role;
    private CurrentUser() {}
    public static CurrentUser getInstance() {
        if (instance == null) instance = new CurrentUser();
        return instance;
    }
    // getter/setter省略
}

后续所有面板（如doctorpanel.java）都能通过CurrentUser.getInstance().getRole()获知当前身份，决定显示哪些按钮、加载哪些数据。这种轻量级会话管理，比HTTP Session更直接，也更适合桌面应用。

3.2 体检数据录入：Wstudentpanel.java的防呆设计

Wstudentpanel.java是医生日常使用频率最高的界面。它的防呆设计体现在三个细节：

细节一：学号实时校验
当医生在“学号”输入框松开键盘（keyReleased事件），立即触发查询：

String studentId = studentIdField.getText().trim();
if (studentId.length() == 10) { // 假设学号固定10位
    Student stu = StudentDAO.findByStudentId(studentId); // 从student表查
    if (stu != null) {
        nameLabel.setText(stu.getName()); // 自动填充姓名
        classNameLabel.setText(stu.getClassName()); // 自动填充班级
        statusLabel.setText("✓ 学号有效");
        statusLabel.setForeground(Color.GREEN);
    } else {
        statusLabel.setText("✗ 学号不存在，请先登记");
        statusLabel.setForeground(Color.RED);
        nameField.setText(""); // 清空姓名框
    }
}

这个设计避免了医生填完所有体检数据才发现学号输错了，得全部重来。它利用了Swing的事件驱动特性，在用户操作过程中就给出即时反馈。

细节二：血压值范围锁定
收缩压输入框绑定InputVerifier：

JTextField systolicField = new JTextField();
systolicField.setInputVerifier(new InputVerifier() {
    @Override
    public boolean verify(JComponent input) {
        try {
            int value = Integer.parseInt(((JTextField) input).getText());
            return value >= 80 && value <= 220; // 合理医学范围
        } catch (NumberFormatException e) {
            return false;
        }
    }
});

如果输入abc或300，焦点无法离开该输入框，强制修正。这比提交时弹窗提示更高效。

细节三：数据完整性检查
点击“保存体检数据”按钮时，遍历所有必填字段：

List<String> missingFields = new ArrayList<>();
if (systolicField.getText().trim().isEmpty()) missingFields.add("收缩压");
if (diastolicField.getText().trim().isEmpty()) missingFields.add("舒张压");
// ... 其他字段
if (!missingFields.isEmpty()) {
    JOptionPane.showMessageDialog(this, 
        "请填写以下必填项：" + String.join("、", missingFields), 
        "数据不完整", JOptionPane.WARNING_MESSAGE);
    return;
}

这种“逐字段检查”比用@NotNull注解更直观，学生能立刻明白哪里漏填了。

3.3 异常指标标记：WGstudentpanel.java的阈值引擎

WGstudentpanel.java是系统智能化的体现，但它没有用机器学习，而是用一套可配置的阈值规则。核心逻辑在checkAbnormalities(Wstudent w)方法里：

public List<AbnormalRecord> checkAbnormalities(Wstudent w) {
    List<AbnormalRecord> list = new ArrayList<>();

    // 血压异常：收缩压≥140 或 舒张压≥90
    if (w.getSystolic() >= 140 || w.getDiastolic() >= 90) {
        list.add(new AbnormalRecord(w.getId(), "blood_pressure"));
    }

    // 空腹血糖异常：≥7.0 mmol/L
    if (w.getBloodGlucose() >= 7.0) {
        list.add(new AbnormalRecord(w.getId(), "blood_glucose"));
    }

    // 视力异常：左眼或右眼≤4.5（对数视力表）
    if (w.getVisionLeft() <= 4.5 || w.getVisionRight() <= 4.5) {
        list.add(new AbnormalRecord(w.getId(), "vision"));
    }

    return list;
}

这里的关键是AbnormalRecord类的设计：

public class AbnormalRecord {
    private int id;
    private int wstudentId; // 关联wstudent表主键
    private String abnormalType; // 枚举类型，便于后期扩展
    private String description; // 可读描述，如"收缩压160/100mmHg"
    // 构造函数和getter/setter
}

description字段不是简单拼接，而是动态生成：“收缩压160/100mmHg”这样的文本，方便在WGstudentpanel界面上直接显示。而abnormalType作为字符串存储，为未来接入更多异常类型（如“尿蛋白阳性”）预留了扩展空间，无需修改数据库表结构。

3.4 报告查看：doctorpanel.java的联合查询实现

doctorpanel.java的报告查看功能，本质是一次四表联合查询。文档.doc里给出了标准SQL：

SELECT 
    s.name, s.student_id, s.class_name,
    w.vision_left, w.vision_right, 
    w.blood_pressure_systolic, w.blood_pressure_diastolic,
    wg.abnormal_type,
    n.recheck_date, n.recheck_dept
FROM student s
JOIN wstudent w ON s.id = w.student_id
LEFT JOIN wgstudent wg ON w.id = wg.wstudent_id
LEFT JOIN nstudent n ON w.id = n.wstudent_id
WHERE s.class_name = ? -- 按班级筛选
ORDER BY w.exam_date DESC;

注意LEFT JOIN的使用：即使某学生没有异常记录（wgstudent表无对应行），或尚未安排复检（nstudent表无对应行），报告依然能显示其基本信息和体检数据。这是医疗报告的基本要求——不能因为缺少质控或复检信息，就让原始数据消失。

在Java代码中，DoctorPanel通过JTable展示结果，其TableModel实现类ReportTableModel重写了getValueAt(int row, int column)方法：

@Override
public Object getValueAt(int rowIndex, int columnIndex) {
    ReportRow row = data.get(rowIndex); // ReportRow封装了联合查询结果
    switch (columnIndex) {
        case 0: return row.getName();
        case 1: return row.getStudentId();
        case 2: return row.getVisionLeft() + "/" + row.getVisionRight();
        case 3: return row.getSystolic() + "/" + row.getDiastolic() + "mmHg";
        case 4: return row.getAbnormalType() != null ? 
                 "★ " + row.getAbnormalType() : "正常";
        case 5: return row.getRecheckDate() != null ? 
                 sdf.format(row.getRecheckDate()) : "未安排";
        default: return "";
    }
}

这里sdf.format()使用了SimpleDateFormat，文档.doc特别提醒：“务必在doctorpanel.java顶部声明private static final SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");，避免多线程下SimpleDateFormat非线程安全问题”。这种细节，正是教学系统区别于玩具项目的标志。

4. 数据库对接与环境部署：从零开始的完整实操指南

部署这套系统，最大的障碍往往不是代码，而是环境。文档.doc之所以厚达18页，就是因为把每一个可能卡住的环节都拆解到了原子级别。下面我按真实操作顺序，还原一个新手从下载资源包到成功运行的全过程，并标注所有我踩过的坑。

4.1 环境准备：JDK与MySQL的精确匹配

JDK版本：必须是1.8（推荐1.8.0_202及以上）
为什么不是更高版本？因为Swing在JDK 9+引入了模块化（JPMS），javax.swing.*不再默认导出，会导致originframe.java编译报错package javax.swing does not exist。而JDK 1.8是最后一个“开箱即用”Swing的长期支持版。安装后，务必在命令行执行：

java -version
# 正确输出示例：
# java version "1.8.0_202"
# Java(TM) SE Runtime Environment (build 1.8.0_202-b08)
# Java HotSpot(TM) 64-Bit Server VM (build 25.202-b08, mixed mode)

如果显示openjdk version "11.0.12"，说明系统PATH指向了新版JDK，需手动修改环境变量，或在IDE中为项目单独指定JDK 1.8路径。

MySQL版本：建议5.7.33或8.0.26
MySQL 8.0默认启用了caching_sha2_password认证插件，而系统使用的JDBC驱动（mysql-connector-java-5.1.47.jar）不支持。解决方案有两个：
- 推荐：安装MySQL 5.7.33（文档.doc附下载链接），兼容性最好；
- 备选：若已装MySQL 8.0，需修改root用户认证方式：

ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'your_password';
FLUSH PRIVILEGES;

然后重启MySQL服务。这个步骤文档.doc第5页有截图，但新手常忽略，导致连接时报错Client does not support authentication protocol requested by server。

4.2 数据库初始化：建表与初始数据

解压资源包，找到文档.doc，翻到“数据库建表语句”章节（第7页）。里面提供了完整的SQL脚本，包含建库、建表、插入测试数据三部分。切勿手动一行行复制粘贴！ 正确做法是：

1. 打开MySQL命令行客户端（或Navicat/HeidiSQL等GUI工具）；
2. 新建数据库，字符集选utf8mb4，排序规则utf8mb4_unicode_ci（支持中文和emoji）；
3. 将文档.doc中的SQL脚本全选复制，粘贴到客户端执行；
4. 执行完毕后，检查是否生成了6张表：student、wstudent、wgstudent、nstudent、users、log。

这里有个隐藏陷阱：users表的初始数据里，password字段是明文123456，但role字段值是'admin'、'doctor'、'student'。文档.doc第8页表格明确列出：
| username | password | role |
|----------|----------|------|
| admin | 123456 | admin |
| doc001 | 123456 | doctor |
| stu001 | 123456 | student |

很多学生试登录时输admin/123456失败，是因为复制SQL时不小心把role字段的单引号'复制成了中文全角引号‘，导致插入数据时role变成空字符串。文档.doc特意用红色字体标注：“所有引号必须为英文半角！”——这种细节，只有真正部署过的人才懂它的分量。

4.3 JDBC连接配置：dbconfig.properties的生死攸关

系统通过dbconfig.properties文件配置数据库连接，该文件位于src/目录下。打开它，你会看到：

url=jdbc:mysql://localhost:3306/health_db?useSSL=false&serverTimezone=GMT%2B8
username=root
password=123456

三个必改项：
- health_db：替换成你实际创建的数据库名（如my_health）；
- username和password：替换成你的MySQL账号密码（如果改了root密码，这里必须同步）；
- serverTimezone=GMT%2B8：这是关键！MySQL 5.7+要求显式指定时区，否则连接时报错The server time zone value '...' is unrecognized。GMT%2B8是URL编码后的GMT+8，不能写成GMT+8（会解析失败）。

改完保存后，必须重新编译整个项目。很多新手改了配置却忘了编译，导致程序仍读取旧的dbconfig.properties（编译后生成的classes/dbconfig.properties）。文档.doc第12页用加粗字体强调：“配置修改后，请执行Clean & Build Project”。

4.4 编译与运行：两种方式的实操对比

方式一：IDE内直接运行（推荐用于开发调试）
在NetBeans/IntelliJ中打开项目，右键originframe.java → Run File。IDE会自动调用javac编译所有.java文件，然后执行java originframe。这是最快的调试方式，但生成的.jar包不在项目目录下。

方式二：命令行打包运行（推荐用于交付部署）
这才是文档.doc重点讲解的流程（第14页）：

# 进入项目根目录（含src/和lib/文件夹）
cd /path/to/your/project

# 编译所有Java文件到classes/目录
javac -d classes -cp "lib/mysql-connector-java-5.1.47.jar" src/*.java src/*/*.java

# 打包成jar（MANIFEST.MF指定Main-Class）
echo "Main-Class: originframe" > manifest.mf
jar cfm health-system.jar manifest.mf -C classes .

# 运行jar包
java -jar health-system.jar

注意-cp参数指定了MySQL驱动路径，-C classes表示从classes目录打包。如果漏掉-cp，编译会报package com.mysql.jdbc does not exist；如果manifest.mf里Main-Class写成originframe.java（带后缀），运行时报Failed to load Main-Class manifest attribute。

文档.doc还贴心地提供了start.bat脚本（Windows）和start.sh（Linux/macOS），双击即可运行。但脚本里有一行：

java -jar health-system.jar

如果系统PATH里没有java，会提示“不是内部或外部命令”。此时需改成绝对路径，如：

"C:\Program Files\Java\jdk1.8.0_202\bin\java.exe" -jar health-system.jar

这个细节，文档.doc第15页用小号字体写着：“若双击无反应，请检查JAVA_HOME环境变量或修改start.bat中的java路径”。

5. 实操心得与避坑指南：十年教学沉淀的23条血泪经验

作为连续七年指导学生用这套系统做课程设计的老师，我整理了23条高频问题与独家解决方案。这些不是文档里写的“标准答案”，而是学生在凌晨两点发给我的微信截图、实训室里反复出现的报错弹窗、以及我自己当年第一次部署时摔过的键盘。

5.1 编译阶段的5个致命陷阱

提示：所有编译错误，90%源于路径和依赖问题，而非代码本身。

1. error: package com.mysql.jdbc does not exist
   错误原因：javac找不到MySQL驱动jar包。
   解决方案：确认lib/mysql-connector-java-5.1.47.jar存在，且javac命令中-cp参数路径正确。常见错误是把lib/写成libs/，或jar包名少了个7（5.1.47.jar vs 5.1.4.jar）。

2. error: cannot find symbol class Student
   错误原因：student.java未编译，或编译时未包含src/子目录。
   解决方案：javac命令必须包含src/*/*.java（编译src/下所有子包），不能只写src/*.java。源码中student.java在src/根目录，但Wstudent.java在src/w/子目录，漏掉后者会导致Wstudentpanel.java编译失败。

3. warning: [options] bootstrap class path not set
   警告原因：JDK 1.8编译时未指定引导类路径，不影响运行，但会让新手恐慌。
   解决方案：忽略此警告，或在javac命令后加-Xbootclasspath/p:"C:\Program Files\Java\jdk1.8.0_202\jre\lib\rt.jar"（Windows路径）。

4. error: unmappable character for encoding GBK
   错误原因：源码文件含中文注释，但系统默认编码是GBK，而文件实际是UTF-8。
   解决方案：javac命令加-encoding UTF-8参数：
   bash javac -encoding UTF-8 -d classes -cp "lib/mysql-connector-java-5.1.47.jar" src/*.java

5. error: Class names, 'originframe', are only accepted if annotation processing is explicitly requested
   错误原因：javac命令后跟了.java后缀，如javac originframe.java。
   解决方案：javac只接受文件路径，不接受类名。正确写法是javac src/originframe.java。

5.2 运行阶段的7个诡异现象

提示：运行时报错，80%与数据库连接相关，务必先检查dbconfig.properties。

6. java.lang.ClassNotFoundException: com.mysql.jdbc.Driver
   错误原因：health-system.jar未打包MySQL驱动，或Class-Path未声明。
   解决方案：jar命令打包时，manifest.mf必须包含Class-Path: lib/mysql-connector-java-5.1.47.jar，且jar包内lib/目录结构与Class-Path路径一致。

7. Communications link failure
   错误原因：MySQL服务未启动，或dbconfig.properties中url的端口号错误（默认3306，但有些安装改成了3307）。
   解决方案：命令行执行netstat -ano | findstr :3306（Windows）或lsof -i :3306（macOS/Linux），确认MySQL进程在监听。

8. Access denied for user 'root'@'localhost'
   错误原因：密码错误，或MySQL用户权限不足（未授权localhost访问）。
   解决方案：用MySQL命令行登录，执行GRANT ALL PRIVILEGES ON health_db.* TO 'root'@'localhost'; FLUSH PRIVILEGES;。

9. 界面空白，只有标题栏
   错误原因：originframe.java的main方法未调用setVisible(true)，或showPanel()后忘记revalidate()。
   解决方案：检查originframe.java末尾是否有frame.setVisible(true);，这是Swing程序的“最后一道门”。

10. 输入中文后显示方块（□□□）
    错误原因：Swing组件默认字体不支持中文。
    解决方案：在originframe.java构造函数中，全局设置字体：
    java Font font = new Font("微软雅黑", Font.PLAIN, 12); UIManager.put("Button.font", font); UIManager.put("Label.font", font); UIManager.put("TextField.font", font);

11. 点击按钮无反应
    错误原因：ActionListener未正确绑定，或actionPerformed()方法里写了return;提前退出。
    解决方案：在actionPerformed()开头加System.out.println("Button clicked!");，确认事件是否触发。

12. 报告表格显示“null”而非数据
    错误原因：JTable的TableModel中getValueAt()方法返回了null，而JTable默认显示字符串"null"。
    解决方案：在getValueAt()中增加空值判断：
    java if (value == null) return ""; return value.toString();

5.3 业务逻辑的6个优化技巧

提示：这些不是必须的，但能让系统从“能用”升级到“好用”。

13. 为studentpanel.java添加身份证号校验
    在studentIdField的keyReleased事件中，加入18位身份证号合法性验证（用正则^[1-9]\\d{5}(18|19|20)\\d{2}((0[1-9])|(1[0-2]))(([0-2][1-9])|10|20|30|31)\\d{3}[0-9Xx]$），并自动提取出生年月日填充到birthDateField。

14. 在Wstudentpanel.java中增加“一键清空”按钮
    医生常需为多个学生快速录入，每次手动删字段太慢。添加按钮，执行：
    java visionLeftField.setText(""); visionRightField.setText(""); systolicField.setText(""); diastolicField.setText(""); // ... 其他字段 studentIdField.requestFocus(); // 光标回到学号框

15. WGstudentpanel.java支持阈值配置化
    将硬编码的140、90、7.0等数字，移到thresholds.properties文件中：
    properties blood_pressure_systolic=140 blood_pressure_diastolic=90 blood_glucose=7.0
    然后在checkAbnormalities()中读取配置，方便不同地区按当地指南调整。

16. doctorpanel.java增加Excel导出功能
    使用Apache POI库（poi-3.17.jar），点击“导出报表”按钮，生成report_20240520.xlsx，包含所有列和格式化（异常项标红、复检日期加粗）。

17. 为logpanel.java添加操作日志搜索
    日志表log有user_name、operation、time字段。添加日期范围选择器和关键词搜索框，用PreparedStatement执行模糊查询：
    sql SELECT * FROM log WHERE time BETWEEN ? AND ? AND operation LIKE ?

18. Nstudentpanel.java支持批量复检安排
    在表格上方加复选框，勾选多行后，点击“批量安排”，弹出对话框选择复检日期和科室，一次性插入多条nstudent记录。

5.4 教学与部署的5个实战建议

19. 课程设计分组建议：3人一组，1人专攻studentpanel/Wstudentpanel（前端录入），1人专攻WGstudentpanel/Nstudentpanel（业务逻辑），1人专攻doctorpanel/logpanel（数据展示与日志），最后由originframe整合。避免所有人同时改同一个文件导致Git冲突。

20. 实训室部署模板：为每台电脑准备一个deploy.bat脚本，自动执行：① 创建health_db数据库；② 执行建表SQL；③ 复制health-system.jar到桌面；④ 创建快捷方式。学生双击deploy.bat，5分钟完成环境搭建。

21. 答辩演示技巧：不要从登录开始演，直接用admin/123456登录，进入doctorpanel，筛选一个班级，展示“异常学生列表”和“复检安排情况”。评委最关心的是业务闭环，不是技术细节。

22. 源码学习路径：先读懂originframe.java的showPanel()，再顺藤摸瓜看studentpanel.java的saveStudent()，接着看Wstudentpanel.java的saveExamData()，最后看WGstudentpanel.java的checkAbnormalities()。这条线贯穿了数据流转全程。

23. 后续扩展方向：如果学生想挑战更高难度，可增加“体检预约”模块（用JCalendar选日期）、“短信通知”模块（集成阿里云短信SDK）、“数据统计图表”模块（用JFreeChart画柱状图）。但务必提醒：先确保核心流程100%稳定，再添新功能。

6. 总结：轻量级的价值，在于它敢于不做“全功能”

写到这里，我关掉了正在运行的health-system.jar，桌面上那个朴素的蓝色窗口消失了。它没有响应式布局，没有WebSocket实时推送，没有微服务拆分，甚至没有用上Lambda表达式——但它能在一台i3处理器、4GB内存的旧笔记本上，流畅运行三年不卡顿；它能让一位只会用Word的护士长，在培训半小时后，独立完成50名学生的体检数据录入；它能让计算机系的学生，在两周内交出一份逻辑清晰、可演示、可答辩的完整项目。

这套系统的真正价值，不在于它实现了多少功能，而在于它精准地划出了一条“够用就好”的边界：用Swing而不是JavaFX，因为前者JDK自带；用JDBC直连而不是MyBatis，因为前者代码行数少一半；用MySQL单机部署而不是分布式集群，因为乡镇卫生站没有DBA；用明文密码而不是BCrypt，因为教学重点是业务流程而非安全算法。这种克制，不是技术落后，而是对真实场景的深刻理解。

如果你正面临类似的课题——需要一个能快速落地、易于教学、稳定可靠的桌面应用——不妨就从这套系统开始。删掉你不需的模块（比如logpanel.java），加上你需要的字段（比如在student.java里加id_card_number），然后亲手敲下第一行javac命令。当那个熟悉的originframe窗口弹出来，当你在studentpanel里输入第一个学生的名字，那一刻，你就已经站在了真实软件开发的起点上。而这条路的尽头，不是炫酷的技术名词，而是解决问题的踏实感。

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

简介：这是一套开箱即用的Java桌面体检管理工具，支持学生登记、医生录入、异常标记、复检安排和报告查看等全流程操作。系统采用Swing构建界面，主入口为originframe.java，各角色面板分工明确：studentpanel负责学生基本信息录入，Wstudentpanel处理体检数据填写，WGstudentpanel自动识别并高亮异常指标，Nstudentpanel管理复检任务，doctorpanel供医生查看与审核，logpanel记录操作日志。配套实体类如student.java、Wstudent.java、doctor.java等完整封装业务数据结构。所有源文件保留原始命名与调用关系，无混淆或删减。附带Word文档（文档.doc），详细说明项目结构、各模块功能逻辑、JDK版本要求（建议1.8）、MySQL数据库建表语句、连接配置方式及双击jar包运行方法。无需Web环境，单机即可部署，适合高校课程设计、实训教学或社区卫生服务中心等小型体检场景快速落地。

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