高校兼职管理平台Java实战：Spring Boot+Swing落地指南

简介：本资源是一份面向计算机专业高年级本科生与研究生的Java全栈实战项目资料，聚焦高校兼职管理场景，解决传统信息不对称、匹配低效、管理粗放等痛点。内容涵盖需求分析、MySQL数据库设计（含表结构、SQL脚本）、Java GUI界面开发三阶段详解（主窗口搭建、逻辑交互实现、UI美化优化）、后端功能模块代码实现及系统调试优化策略，兼具理论深度与工程落地性。资源为1个89KB的docx文档，结构清晰，含系统架构图、流程图、目录结构说明、20余页GUI界面截图与完整代码整合封装，便于按模块精读与复现。目前已有184人学习下载，适合课程设计、实训项目或Java EE技术栈综合实践，能帮助读者系统掌握数据库建模、Swing界面开发、前后端协同逻辑及实际业务问题拆解方法。

1. 为什么高校兼职管理平台非得用 Java 写？——不是为了炫技，而是因为「学生换得勤、老师管得散、数据不能丢、界面还得能点」

你见过哪个高校的兼职系统，上线三个月后管理员换人、数据库字段加了五个、导出 Excel 格式改了四次，还能不重启服务、不重写逻辑、不找原作者擦屁股？这不是理想状态，而是现实刚需。基于 Java 的高校兼职管理平台，本质是解决「人流动、流程杂、权限碎、数据稳」这四个硬约束：学生每学期轮岗、院系老师兼职管理、教务处要统览全局、财务处只认对账单；GUI 不是花架子——它得让没碰过电脑的辅导员也能三步完成岗位发布；程序不是 Demo——它得在 Win10/Win11 双系统下双击即用，不依赖浏览器、不卡在 JDK 版本、不因一个空指针崩掉整个排班表。本文讲的不是「Java 怎么学」，而是「怎么用 Java 把这个活干得没人敢动、没人想改、没人敢删」。所有代码、GUI 设计、SQL 生成逻辑、权限隔离方案，全部来自真实部署过的校内系统（已脱敏），不是 GitHub 上 clone 来改两行就发的玩具项目。如果你正被「学生找不到岗位、老师手动 Excel 对接、财务月底对不上账」折磨，这篇就是你今晚能抄着跑通的第一份可落地方案。

2. 从零搭起核心骨架：用 Spring Boot + MyBatis-Plus 快速建模，但别急着写 SQL

2.1 为什么选 MyBatis-Plus 而不是纯 JPA 或手写 JDBC？

高校场景里，「岗位类型」可能今天叫「教学助理」，下周教务处发通知改成「学业支持岗」，字段名不能硬编码进实体类；「学生状态」有「已报名」「待审核」「已录用」「已离职」「违约冻结」五种，但数据库只存一个status_code整型——JPA 的@Enumerated在这种高频变更场景下极易引发版本错乱；而纯 JDBC 又会让分页查询、条件拼接、空值判空变成重复劳动。MyBatis-Plus 的@TableName+@TableId(type = IdType.AUTO)+@TableField(fill = FieldFill.INSERT)组合，配合LambdaQueryWrapper，恰好卡在「够灵活」和「够安全」的交界点上。它不强制你写 XML，但允许你在需要时精准控制 SQL；它自动生成 CRUD，但每个方法都可被@SelectProvider覆盖；最关键的是，它的Entity类能直接驱动表结构生成——这点在后续章节会实锤验证。

2.2 实体类定义：不是照着需求文档抄字段，而是按「谁改、怎么改、改后影响谁」来设计

以最核心的JobPosting.java为例（注意命名与业务强绑定，不用Job这种泛称）：

import com.baomidou.mybatisplus.annotation.*; import lombok.Data; import java.time.LocalDateTime; @Data @TableName("t_job_posting") public class JobPosting { @TableId(type = IdType.ASSIGN_ID) // 雪花 ID，避免 MySQL 自增暴露数量 private String id; @TableField("dept_name") private String deptName; // 院系名称，非外键！因院系可能撤并，此处存快照 @TableField("job_title") private String jobTitle; // 岗位标题，如「大学物理助教（2024秋）」 @TableField("work_hours_per_week") private Integer workHoursPerWeek; // 每周工时，整数，避免小数精度问题 @TableField("salary_per_hour") private Double salaryPerHour; // 时薪，Double 兼容 15.0 和 15.5，BigDecimal 太重 @TableField("apply_start_time") private LocalDateTime applyStartTime; // 报名开始时间，LocalDateTime 精确到秒 @TableField("apply_end_time") private LocalDateTime applyEndTime; // 报名截止时间 @TableField("status_code") private Integer statusCode; // 1=草稿, 2=已发布, 3=已关闭, 4=已归档 @TableField(fill = FieldFill.INSERT) private LocalDateTime createTime; @TableField(fill = FieldFill.INSERT_UPDATE) private LocalDateTime updateTime; }

关键设计逻辑说明：

• dept_name不用外键关联t_department表，是因为院系调整频繁（如「信息学院」拆成「计算机学院+人工智能学院」），外键会导致历史数据失效或级联删除误操作；
• salary_per_hour用Double而非BigDecimal，因高校兼职薪资均为两位小数（如 18.00、22.50），且无金融级精度要求，Double在 MyBatis-Plus 中序列化/反序列化更稳定；
• statusCode用整型而非枚举类，因状态流转规则由业务方动态配置（教务处后台可修改「已发布→已关闭」是否允许回退），硬编码枚举会锁死流程；
• @TableField(fill = ...)自动填充时间戳，避免 Controller 层手动 set，防止遗漏。

2.3 自动生成建表 SQL：MyBatis-Plus 的MybatisPlusAutoGenerator是真·生产力工具

很多教程教你手写 DDL，但在高校场景中，DDL 必须和实体类严格一致，否则「学生填了手机号，后台查不到」这种低级错误会反复出现。MyBatis-Plus 官方提供MybatisPlusAutoGenerator（注意：不是旧版AutoGenerator），它能根据实体类注解生成标准 SQL：

// GenerateSql.java —— 本地运行一次即可，无需部署 public class GenerateSql { public static void main(String[] args) { FastAutoGenerator.create("jdbc:mysql://localhost:3306/campus_parttime?useSSL=false&serverTimezone=Asia/Shanghai", "root", "password") .globalConfig(builder -> builder .author("admin") // 作者名，生成 SQL 注释用 .outputDir("src/main/resources/sql/") // 输出路径 .disableOpenDir() // 不自动打开文件夹 ) .packageConfig(builder -> builder .parent("com.example.campus") // 包路径 .moduleName("job") // 模块名，影响生成的 Mapper 接口包路径 ) .strategyConfig(builder -> builder .addInclude("t_job_posting", "t_student_apply", "t_user") // 显式指定表名，避免扫描全库 .entityBuilder() .enableLombok() .logicDeleteColumnName("is_deleted") // 逻辑删除字段名 .mapperBuilder() .enableMapperAnnotation() // 启用 @Mapper 注解 .serviceBuilder() .formatServiceFileName("%sService") // Service 接口命名规则 ) .execute(); } }

运行后，在src/main/resources/sql/下生成t_job_posting.sql：

-- t_job_posting.sql CREATE TABLE `t_job_posting` ( `id` varchar(32) NOT NULL COMMENT '主键ID', `dept_name` varchar(50) DEFAULT NULL COMMENT '院系名称', `job_title` varchar(100) DEFAULT NULL COMMENT '岗位标题', `work_hours_per_week` int DEFAULT NULL COMMENT '每周工时', `salary_per_hour` double DEFAULT NULL COMMENT '时薪', `apply_start_time` datetime DEFAULT NULL COMMENT '报名开始时间', `apply_end_time` datetime DEFAULT NULL COMMENT '报名截止时间', `status_code` int DEFAULT NULL COMMENT '状态码', `create_time` datetime DEFAULT NULL COMMENT '创建时间', `update_time` datetime DEFAULT NULL COMMENT '更新时间', PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='岗位发布表';

参数说明与踩坑提示：

• jdbc:mysql://...中必须显式指定serverTimezone=Asia/Shanghai，否则LocalDateTime字段插入时区错乱，导致「学生看到的报名截止时间比实际早 8 小时」；
• addInclude(...)必须写全表名，不能用通配符（如"t_%"），否则会扫描information_schema等系统表，生成无效 SQL；
• logicDeleteColumnName("is_deleted")若未在实体类中声明该字段，生成器会报错，需同步在JobPosting中添加private Integer isDeleted;并加@TableLogic注解；
• 生成的 SQL 默认无索引，必须手动补上：ALTER TABLE t_job_posting ADD INDEX idx_dept_status (dept_name, status_code);，否则按院系查岗位时全表扫描。

3. GUI 设计不是画按钮，而是构建「辅导员友好型交互流」

3.1 为什么 Swing 而非 JavaFX？——因为「能装进 U 盘、双击就跑、不弹安全警告」

高校机房电脑普遍为 Win7/Win10 专业版，预装 JRE 8u201 或 8u291，而 JavaFX 自 Java 11 起已从 JDK 中剥离，需额外打包jfxrt.jar；更致命的是，JavaFX 在部分校园网络策略下会被杀毒软件拦截（因其启动时会尝试加载jfxwebkit.dll）。Swing 虽然界面朴素，但JFrame+BorderLayout+CardLayout组合足以支撑完整业务流，且所有组件均在rt.jar内，只要 JRE 存在，双击xxx.jar即可运行。我们采用「主窗体固定尺寸 + 卡片切换」模式，避免学生误点最小化后找不到窗口。

3.2 主窗体布局：用CardLayout实现「一页一功能」，杜绝 Tab 页嵌套混乱

// MainFrame.java public class MainFrame extends JFrame { private CardLayout cardLayout; private JPanel cardPanel; private JButton btnPostJob, btnApplyJob, btnManageApply; public MainFrame() { setTitle("高校兼职管理平台 v2.3"); setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); setResizable(false); // 禁止缩放，保证 UI 元素位置绝对可控 setSize(1024, 768); // 固定分辨率，适配多数教室投影仪 setLocationRelativeTo(null); // 居中显示 cardLayout = new CardLayout(); cardPanel = new JPanel(cardLayout); // 初始化各功能面板（后续章节详述） cardPanel.add(new PostJobPanel(), "post"); // 发布岗位 cardPanel.add(new ApplyJobPanel(), "apply"); // 学生申请 cardPanel.add(new ManageApplyPanel(), "manage"); // 审核管理 // 顶部导航栏 JPanel topBar = new JPanel(new FlowLayout(FlowLayout.LEFT)); btnPostJob = new JButton("发布岗位"); btnApplyJob = new JButton("学生申请"); btnManageApply = new JButton("审核管理"); btnPostJob.addActionListener(e -> cardLayout.show(cardPanel, "post")); btnApplyJob.addActionListener(e -> cardLayout.show(cardPanel, "apply")); btnManageApply.addActionListener(e -> cardLayout.show(cardPanel, "manage")); topBar.add(btnPostJob); topBar.add(btnApplyJob); topBar.add(btnManageApply); add(topBar, BorderLayout.NORTH); add(cardPanel, BorderLayout.CENTER); } }

设计逻辑说明：

• setResizable(false)是血泪经验：曾有学生拖大窗口导致表格列宽错乱，导出 Excel 时字段错位；
• setSize(1024, 768)不是随意定的，而是匹配教室投影仪常见分辨率，避免滚动条遮挡按钮；
• CardLayout比JTabbedPane更可靠：Tab 页在高 DPI 屏幕下易出现文字模糊，且学生常误点 Tab 关闭按钮；
• 所有按钮监听器直接切换卡片，不 new 新面板，避免内存泄漏（Swing 组件未 dispose 会持续占用 AWT EventQueue）。

3.3 学生申请面板：用JTable+DefaultTableModel实现「所见即所得」的实时筛选

// ApplyJobPanel.java public class ApplyJobPanel extends JPanel { private JTable jobTable; private DefaultTableModel tableModel; private JTextField searchField; private JButton searchBtn; public ApplyJobPanel() { setLayout(new BorderLayout()); // 表格初始化（列名与数据库字段一一对应） String[] columns = {"岗位ID", "院系", "岗位标题", "每周工时", "时薪", "报名开始", "报名截止", "状态"}; tableModel = new DefaultTableModel(columns, 0) { @Override public boolean isCellEditable(int row, int column) { return false; // 所有单元格不可编辑 } }; jobTable = new JTable(tableModel); jobTable.setSelectionMode(ListSelectionModel.SINGLE_SELECTION); // 禁止多选，防误操作 // 搜索栏 JPanel searchPanel = new JPanel(new FlowLayout()); searchField = new JTextField(15); searchBtn = new JButton("搜索"); searchBtn.addActionListener(e -> doSearch()); searchPanel.add(new JLabel("按院系/标题搜索：")); searchPanel.add(searchField); searchPanel.add(searchBtn); add(searchPanel, BorderLayout.NORTH); add(new JScrollPane(jobTable), BorderLayout.CENTER); loadAllJobs(); // 首次加载全部岗位 } private void doSearch() { String keyword = searchField.getText().trim(); if (keyword.isEmpty()) { loadAllJobs(); return; } // 调用 DAO 查询，此处简化为模拟 List<JobPosting> results = JobDao.searchByKeyword(keyword); tableModel.setRowCount(0); // 清空旧数据 for (JobPosting job : results) { Object[] row = { job.getId(), job.getDeptName(), job.getJobTitle(), job.getWorkHoursPerWeek(), job.getSalaryPerHour(), DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm").format(job.getApplyStartTime()), DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm").format(job.getApplyEndTime()), getStatusText(job.getStatusCode()) }; tableModel.addRow(row); } } private String getStatusText(Integer code) { switch (code) { case 2: return "可报名"; case 3: return "已关闭"; case 4: return "已归档"; default: return "未知"; } } private void loadAllJobs() { List<JobPosting> all = JobDao.findAllActive(); tableModel.setRowCount(0); for (JobPosting job : all) { // 同上 row 构造逻辑 } } }

关键细节说明：

• tableModel.setRowCount(0)比tableModel.getDataVector().clear()更安全，后者可能触发空指针；
• DateTimeFormatter格式化时间时，必须用ofPattern("yyyy-MM-dd HH:mm")，不能用toString()，否则LocalDateTime默认格式为2024-05-20T09:30:00，学生看不懂；
• JTable放入JScrollPane是强制要求，否则超出窗口高度时内容被裁剪；
• searchByKeywordDAO 方法内部使用LIKE CONCAT('%', ?, '%')，但需在 SQL 中加ESCAPE '\\'防止用户输入_或%导致查询异常。

4. 避坑指南：那些让项目上线前一周崩溃的「玄学」问题

4.1 现象：学生点击「申请岗位」后界面卡死 10 秒，日志无报错

原因：Swing 事件线程（EDT）中执行了耗时的数据库操作（如JobDao.apply(jobId, studentId)），导致 UI 线程阻塞，按钮无法响应。
解决：所有数据库调用必须包裹在SwingWorker中，确保 UI 线程不被占用：

// ApplyJobPanel.java 内部 private void applyToJob(String jobId) { new SwingWorker<Void, Void>() { @Override protected Void doInBackground() throws Exception { JobDao.apply(jobId, CurrentUser.getStudentId()); // 耗时操作放 here return null; } @Override protected void done() { try { get(); // 获取 doInBackground 返回值，触发异常捕获 JOptionPane.showMessageDialog(this, "申请成功！", "提示", JOptionPane.INFORMATION_MESSAGE); loadAllJobs(); // 刷新表格 } catch (Exception e) { JOptionPane.showMessageDialog(this, "申请失败：" + e.getMessage(), "错误", JOptionPane.ERROR_MESSAGE); } } }.execute(); }

4.2 现象：导出 Excel 时中文全是问号，但控制台打印正常

原因：Apache POI 默认使用US-ASCII编码写入.xls文件，而 Windows 系统默认用 GBK 解析，编码不匹配。
解决：强制指定WorkbookFactory.create(...)的字符集，并设置单元格样式：

// ExportUtils.java public static void exportToExcel(List<JobPosting> jobs, String fileName) throws IOException { Workbook workbook = new XSSFWorkbook(); // 用 XSSFWorkbook 生成 .xlsx，兼容性更好 Sheet sheet = workbook.createSheet("岗位列表"); // 设置表头样式（宋体、加粗） Font headerFont = workbook.createFont(); headerFont.setFontName("宋体"); headerFont.setBold(true); CellStyle headerStyle = workbook.createCellStyle(); headerStyle.setFont(headerFont); // 写入表头 Row headerRow = sheet.createRow(0); String[] headers = {"岗位ID", "院系", "岗位标题", "每周工时", "时薪", "报名开始", "报名截止", "状态"}; for (int i = 0; i < headers.length; i++) { Cell cell = headerRow.createCell(i); cell.setCellValue(headers[i]); cell.setCellStyle(headerStyle); } // 写入数据（中文自动 UTF-8） for (int i = 0; i < jobs.size(); i++) { Row row = sheet.createRow(i + 1); JobPosting job = jobs.get(i); row.createCell(0).setCellValue(job.getId()); row.createCell(1).setCellValue(job.getDeptName()); row.createCell(2).setCellValue(job.getJobTitle()); // ... 其他字段 } // 自动列宽 for (int i = 0; i < headers.length; i++) { sheet.autoSizeColumn(i); } try (FileOutputStream out = new FileOutputStream(fileName)) { workbook.write(out); } }

注意：.xlsx比.xls更可靠，HSSFWorkbook（对应.xls）在处理中文时需额外设置encoding，而XSSFWorkbook原生支持 UTF-8。

4.3 现象：管理员修改岗位后，学生端看到的仍是旧数据

原因：Swing 客户端未主动刷新，且服务端未推送变更，学生端JTable数据停留在首次加载状态。
解决：在关键操作（如发布、关闭岗位）后，向所有已登录客户端广播「数据变更」事件。采用轻量级方案：客户端每 30 秒轮询/api/job/lastUpdate接口，返回最新update_time时间戳，若与本地缓存不同，则触发loadAllJobs()：

// 后端 Controller @GetMapping("/api/job/lastUpdate") public ResponseEntity<String> getLastUpdateTime() { LocalDateTime last = jobService.findLastUpdateTime(); return ResponseEntity.ok(last.format(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"))); } // 客户端定时任务（放入 MainFrame 构造函数） Timer timer = new Timer(); timer.scheduleAtFixedRate(new TimerTask() { @Override public void run() { SwingUtilities.invokeLater(() -> { try { String lastTime = HttpUtil.get("http://localhost:8080/api/job/lastUpdate"); if (!lastTime.equals(localLastUpdateTime)) { localLastUpdateTime = lastTime; ((ApplyJobPanel) cardPanel.getComponent(1)).loadAllJobs(); // 强制刷新 } } catch (Exception ignored) {} }); } }, 0, 30 * 1000); // 每30秒执行

4.4 现象：MySQL 插入时报错Data truncation: Incorrect datetime value

原因：实体类中LocalDateTime字段值为null，而数据库对应列未设DEFAULT CURRENT_TIMESTAMP且NOT NULL。
解决：在实体类中为时间字段加@TableField(fill = FieldFill.INSERT)，并在数据库建表时明确DEFAULT CURRENT_TIMESTAMP：

ALTER TABLE t_job_posting MODIFY COLUMN create_time datetime DEFAULT CURRENT_TIMESTAMP, MODIFY COLUMN update_time datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP;

同时确保application.yml中配置：

spring: datasource: url: jdbc:mysql://localhost:3306/campus_parttime?useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true jackson: date-format: yyyy-MM-dd HH:mm:ss time-zone: GMT+8

5. 权限隔离不是加个@PreAuthorize就完事：用「角色-资源-操作」三元组落地真实场景

5.1 高校特有的权限颗粒度：比 RBAC 更细，比 ABAC 更轻

教务处需要「查看全校所有岗位及申请记录」，但不能「修改其他院系发布的岗位」；院系教学秘书可以「发布本院岗位」「审核本院学生申请」，但不能「查看财务处工资发放记录」；学生只能「查看可报名岗位」「提交本人申请」，且同一岗位最多报 3 个。这些规则无法用简单ROLE_ADMIN/ROLE_STUDENT覆盖，必须引入「资源实例级」控制。我们采用「角色 + 资源前缀 + 操作白名单」模型：

5.2 后端权限拦截：用HandlerInterceptor替代@PreAuthorize，实现动态资源校验

// ResourcePermissionInterceptor.java @Component public class ResourcePermissionInterceptor implements HandlerInterceptor { @Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { String uri = request.getRequestURI(); String method = request.getMethod(); String userId = CurrentUser.getUserId(); // 从 Session 或 JWT 解析 UserRole role = userRoleService.findByUserId(userId); // 提取资源标识（如 /job/abc123 → abc123） String resourceId = extractResourceId(uri); // 核心校验逻辑 if (uri.startsWith("/job/") && method.equals("PUT")) { if (!canModifyJob(role, resourceId)) { response.sendError(HttpServletResponse.SC_FORBIDDEN, "无权修改该岗位"); return false; } } if (uri.startsWith("/apply") && method.equals("GET")) { String deptParam = request.getParameter("dept"); if (deptParam != null && !role.getDeptPrefix().equals(deptParam)) { response.sendError(HttpServletResponse.SC_FORBIDDEN, "只能查看本院申请"); return false; } } return true; } private boolean canModifyJob(UserRole role, String jobId) { // 查询岗位所属院系 String deptOfJob = jobService.findDeptById(jobId); // 教务处可改所有，院系秘书只能改本院 return "ADMIN".equals(role.getRoleCode()) || role.getDeptPrefix().equals(deptOfJob); } private String extractResourceId(String uri) { Pattern pattern = Pattern.compile("/job/(\\w+)"); Matcher matcher = pattern.matcher(uri); return matcher.find() ? matcher.group(1) : ""; } }

注册拦截器：

@Configuration public class WebConfig implements WebMvcConfigurer { @Autowired private ResourcePermissionInterceptor permissionInterceptor; @Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(permissionInterceptor) .excludePathPatterns("/login", "/static/**", "/error"); } }

5.3 前端按钮级权限：Swing 中用setEnabled(false)比隐藏按钮更安全

// PostJobPanel.java private JButton btnPublish; private JButton btnClose; public PostJobPanel() { // ... 初始化 btnPublish = new JButton("发布"); btnClose = new JButton("关闭岗位"); // 根据当前用户角色动态启用/禁用 String role = CurrentUser.getRole(); btnPublish.setEnabled("DEPT_SECRETARY".equals(role) || "ADMIN".equals(role)); btnClose.setEnabled("DEPT_SECRETARY".equals(role) || "ADMIN".equals(role)); // 点击事件中再次校验（防绕过） btnPublish.addActionListener(e -> { if (!btnPublish.isEnabled()) return; // 执行发布逻辑 }); }

为什么不用setVisible(false)？

• 学生可通过反编译.jar文件找到按钮名，再用反射调用setVisible(true)；
• setEnabled(false)既阻止点击，又保持 UI 布局稳定（隐藏按钮会导致下方组件上移，破坏对齐）；
• 最关键的是，后端拦截器必须二次校验，前端禁用只是用户体验优化，不是安全防线。

6. 验证与交付：如何让「程序能跑」变成「领导说这系统真行」

6.1 三类必测场景清单：覆盖 95% 的上线投诉

不要迷信单元测试覆盖率，高校系统最怕的是「功能都对，但没人会用」。我们固化三类人工验证场景，每次迭代后必须走一遍：

执行要点：

• 每次验证必须用真实账号（非 admin），且账号权限与角色严格匹配；
• 「导出 Excel」必须在 Windows 电脑上用 Excel 2016+ 打开，Mac Numbers 或 WPS 可能渲染异常；
• 时间字段必须肉眼核对，不能只信日志——曾发现LocalDateTime.now()在 Docker 容器中因时区未挂载，比宿主机慢 8 小时。

6.2 打包交付：不是扔个jar就完事，而是给一套「开箱即用」包

最终交付物不是campus-parttime.jar，而是一个campus-parttime-v2.3.zip，解压后目录结构如下：

campus-parttime-v2.3/ ├── run.bat # 双击运行（自动检测 JRE 并启动） ├── run.sh # Linux/Mac 运行脚本 ├── config/ # 外部配置，可修改数据库连接 │ └── application.yml ├── lib/ # 依赖 jar（含 mybatis-plus、poi、mysql-connector-java） ├── resources/ # SQL 初始化脚本、图标、字体 │ ├── init.sql │ └── icons/ ├── campus-parttime.jar └── README.md # 含「安装步骤」「常见问题」「联系人」

run.bat内容（关键！）：

@echo off REM 检测 JRE 是否存在 if not exist "%JAVA_HOME%\bin\java.exe" ( echo 错误：未设置 JAVA_HOME 环境变量，请先安装 JRE 8+ pause exit /b 1 ) REM 检测 JRE 版本是否 >= 1.8 for /f "tokens=3" %%i in ('"%JAVA_HOME%\bin\java.exe" -version 2^>^&1 ^| findstr "version"') do ( set JAVA_VERSION=%%i ) if not "%JAVA_VERSION%" geq "1.8" ( echo 错误：JRE 版本过低，需要 1.8 或更高版本 pause exit /b 1 ) REM 启动应用 "%JAVA_HOME%\bin\java.exe" -Dfile.encoding=UTF-8 -jar campus-parttime.jar pause

为什么必须带run.bat？

• 高校老师不会敲命令行，双击run.bat是唯一可接受的启动方式；
• pause防止黑窗口一闪而过，便于查看启动报错；
• 版本检测避免「学生说打不开」却查不出是 JRE 未装；
• -Dfile.encoding=UTF-8强制 JVM 使用 UTF-8，解决 Windows 控制台默认 GBK 导致的日志乱码。

6.3 我的血泪习惯：每次交付前，把application.yml中的spring.profiles.active=prod改成dev，然后自己用学生账号走一遍全流程

不是为了测功能，而是为了看「哪里会让用户困惑」。比如：

• 岗位列表页没有「刷新」按钮，学生以为数据没更新，其实只是缓存；
• 导出 Excel 时进度条没反馈，用户狂点按钮导致重复生成；
• 修改岗位后，页面未自动跳转回列表，学生以为没保存成功。

这些都不是 Bug，但会成为上线后 80% 的咨询来源。我把这些观察记在README.md的「使用提示」章节，例如：

使用提示

• 岗位列表每 30 秒自动刷新，请勿频繁点击「刷新」按钮；
• 导出 Excel 时请耐心等待（约 3~5 秒），进度条出现前请勿关闭窗口；
• 修改岗位后，页面将自动返回列表页，若未跳转，请检查网络连接。

最后想说：做高校系统，技术不是最难的，难的是把「学生觉得简单」和「老师觉得省事」同时做到。我坚持不用任何前端框架，不是守旧，而是因为 Swing 的.jar双击即用，比 Vue 打包的dist文件夹少掉 7 步部署；我坚持手写SwingWorker，不是拒绝异步，而是因为CompletableFuture在 Swing 线程模型里容易引发IllegalStateException。这些选择背后，都是真实踩过的坑、熬过的夜、听过的抱怨。希望这篇笔记，能帮你少走一段弯路。

希望帮到你。

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