简介本资源是一套基于Web的考试系统自动组卷功能的完整实现方案面向计算机相关专业本科生、研究生及初入职场的开发人员解决传统考试系统中组卷效率低、策略僵化、前后端协同复杂等实际问题。项目采用SpringCloud微服务架构设计核心业务模块由Java实现前端交互依托Layui、jQuery UI等成熟UI框架辅以JSP动态页面与CSS/JS资源支撑多端适配整体结构清晰、模块解耦度高适合毕设、课设或企业级考试平台原型开发。压缩包共476个文件含181个Java后端逻辑文件、88个JS前端脚本、77个GIF动效资源、33个CSS样式表及25个JSP视图页总大小仅2.6MB轻量易部署。目前已有59人学习下载资源包含全部源码、详细设计文档、SQL建表脚本、答辩PPT及导师认可的高分评审记录95分代码经实测可直接运行亦支持在理解基础上二次扩展组卷策略或对接新题库。1. 为什么一个“自动组卷”的WEB考试系统比你想象中更难跑通——它不是把题库扔进网页就能用你下载了那个标着“源码文档全部资料优秀项目.zip”的压缩包解压后看到layui文件夹、jquery-ui目录、一堆.php和.sql文件还有一份 Word 写的《系统设计说明书》。你兴冲冲地配好 Apache PHP MySQL导入 SQL浏览器一打开http://localhost/exam/却卡在登录页——输入默认账号密码admin/123456没反应F12 看 Networklogin.php返回 500再点“组卷”按钮控制台报错Uncaught ReferenceError: layui is not defined翻文档发现里面写着“需部署于 PHP 7.2 环境”而你本地是 PHP 8.1……这不是代码写得烂而是一个典型的、未经现代化适配的 Web 考试系统遗产项目它依赖特定版本栈、硬编码路径、未声明的 JS 加载顺序、MySQL 表字段类型与 PHP 类型强耦合且“自动组卷”逻辑藏在AutoPaper.class.php里没有单元测试也没有配置开关说明。本文不讲“如何毕业答辩”只讲怎么让这个 ZIP 包真正在你机器上跑起来、改得动、组得出卷、监得了考——面向真实部署场景覆盖从环境缝合、JS 框架加载冲突、题库结构校验、到组卷策略可调性的全链路实操。适合刚接手维护老系统、或想基于此二次开发的 Web 工程师与教务信息化实施人员。2. 环境缝合PHP 版本、扩展与 MySQL 兼容性三重校准这个 ZIP 包诞生于 2018–2020 年间典型 LAMP 架构但绝非“装完就跑”。它对运行时环境有隐式强约束跳过校准直接部署90% 的失败发生在此步。2.1 PHP 版本必须锁定在 7.2–7.4含禁用 8.x项目中大量使用mysql_*函数如mysql_connect()、create_function()动态函数、以及array_key_exists($key, $array)对null的宽松判空——这些在 PHP 8.0 中已被移除或严格化。最典型的报错是Fatal error: Uncaught Error: Call to undefined function mysql_connect()提示不要试图用mysqli或PDO全局替换——项目中mysql_*调用散落在 17 个 PHP 文件里且部分逻辑依赖mysql_fetch_array()的默认MYSQL_BOTH行为强行替换会导致题干乱码、选项错位等玄学问题。正确做法是降级 PHP。推荐方案使用 XAMPP 7.4.33官方最后支持mysql_*的稳定版或 Docker 快速拉起兼容环境# docker-compose.yml version: 3.8 services: exam-web: image: php:7.4-apache ports: - 8080:80 volumes: - ./exam-source:/var/www/html depends_on: - exam-db exam-db: image: mysql:5.7 environment: MYSQL_ROOT_PASSWORD: rootpass MYSQL_DATABASE: exam_system MYSQL_USER: examuser MYSQL_PASSWORD: exam123 volumes: - ./mysql-data:/var/lib/mysql启动后访问http://localhost:8080确认首页 HTML 渲染正常无 PHP 解析错误。2.2 必启 PHP 扩展mbstring、gd、json、xml禁用opcache临时mbstring缺失 → 题干中文乱码尤其含 Unicode 标点如“《》”、“·”gd缺失 → 验证码图片无法生成captcha.php报 500json缺失 → 前端layui.table加载试题列表时$.post()返回空字符串xml缺失 →AutoPaper.class.php中读取 XML 题型模板失败该模块用于兼容旧版题库导入。opcache在调试阶段建议关闭它会缓存已损坏的 PHP 语法如?短标签未开启时导致改完代码仍报旧错。编辑php.ini; 关键项 short_open_tag On ; 必开项目大量使用 ? ... ? extensionmbstring extensiongd extensionjson extensionxml opcache.enable0 ; 调试期设为 0上线前再开重启 Apache 后访问http://localhost:8080/phpinfo.php若无新建一个搜索上述扩展名确认状态为enabled。2.3 MySQL 字符集必须为utf8mb4排序规则utf8mb4_unicode_ci项目 SQL 文件如exam_system.sql中建表语句写的是CREATE TABLE exam_question ( id int(11) NOT NULL AUTO_INCREMENT, content text NOT NULL, options text, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8;但utf8在 MySQL 中实际是utf8mb3无法存储 emoji 和部分生僻汉字如“䶮”、“”。当教师录入含四字成语题干或古文标点时content字段被截断组卷时题干缺失。修复命令执行前备份数据库-- 修改数据库默认字符集 ALTER DATABASE exam_system CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; -- 修改所有表 ALTER TABLE exam_question CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; ALTER TABLE exam_paper CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; ALTER TABLE exam_user CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; -- 修改连接层关键 -- 在 config.php 或 db.php 中mysqli 连接后立即执行 mysqli_query($conn, SET NAMES utf8mb4);参数说明utf8mb4_unicode_ci比utf8mb4_general_ci更准确支持中文排序与比较避免“张三”和“张叁”被判定为相同姓名。3. 前端框架加载链Layui 与 jQuery-UI 的共存陷阱与加载时序修复项目前端同时依赖 Layuiv2.5.6和 jQuery-UIv1.12.1但未做模块隔离。常见现象Layui 的layer.msg()弹窗样式错乱、jQuery-UI 的datepicker日期选择器点击无响应、组卷页面拖拽题型区域失效。根源在于全局$冲突与 CSS 优先级污染。3.1 确认 Layui 与 jQuery-UI 的加载顺序与作用域查看index.html或admin/index.php头部script标签script srcjs/jquery.min.js/script script srcjs/jquery-ui.min.js/script script srclayui/layui.js/script script layui.use([layer, form], function(){ var layer layui.layer; // ... 初始化代码 }); /script问题在于Layui v2.5.6 内部未封装$直接挂载到window.$而 jQuery-UI 1.12.1 依赖jQuery全局对象但项目引入的是精简版jquery.min.js无noConflict()调用。结果$.datepicker()调用时$指向 Layui 的轻量 DOM 封装而非 jQuery 实例。修复方案强制 jQuery-UI 使用jQuery别名Layui 使用layui全局对象!-- 修改加载顺序与封装 -- script srcjs/jquery.min.js/script script // 立即释放 $保留 jQuery 全局变量 var jQuery window.jQuery; delete window.$; /script script srcjs/jquery-ui.min.js/script script srclayui/layui.js/script script // Layui 初始化必须用 layui.use不依赖 $ layui.use([layer, form, table], function(){ var layer layui.layer, form layui.form, table layui.table; // jQuery-UI 组件显式使用 jQuery非 $ jQuery(document).ready(function(){ jQuery(#exam_date).datepicker({ dateFormat: yy-mm-dd, changeMonth: true, changeYear: true }); }); }); /script3.2 CSS 冲突Layui 表单样式覆盖 jQuery-UI 日期控件Layui 的layui-form-item默认margin-bottom: 15px而 jQuery-UIui-datepicker的弹出层被z-index: 999的 Layuilayer遮挡。现象点击日期输入框日历弹窗一闪即逝。修复 CSS添加到static/css/custom.css并引入/* 提升 jQuery-UI 日期选择器层级 */ .ui-datepicker { z-index: 9999 !important; /* 必须高于 layui layer 的 1989 */ } /* 修正 Layui 表单内嵌控件间距 */ .layui-form-item .ui-datepicker-trigger { margin-left: 10px; vertical-align: middle; } /* 防止 Layui input 样式污染 jQuery-UI 输入框 */ .layui-form-item input[typetext].hasDatepicker { padding: 0 10px; height: 38px; line-height: 38px; }逻辑说明!important是此处唯一可靠解法。Layui 的 CSS 权重极高大量!important而 jQuery-UI 默认样式未加权不强制提升则无效。3.3 组卷拖拽功能失效jQuery-UI Sortable 与 Layui Table 的 DOM 生命周期冲突组卷页admin/paper_create.php使用 jQuery-UIsortable()实现题型拖拽排序但 Layui 的table.render()会重绘整个tableDOM导致已绑定的sortable事件丢失。修复 JS在paper_create.php底部// Layui table 渲染完成后重新初始化 sortable table.on(done(filter), function(res){ // 确保 #question-list 存在且有子元素 if ($(#question-list li).length 0) { $(#question-list).sortable({ items: li, placeholder: ui-state-highlight, update: function(event, ui) { // 拖拽后更新题序号 hidden input $(#question-list li).each(function(index) { $(this).find(input[nameseq]).val(index 1); }); } }); } }); // 页面首次加载时也初始化一次 $(document).ready(function(){ if ($(#question-list li).length 0) { $(#question-list).sortable({ /* 同上 */ }); } });参数说明update回调中更新seq隐藏域确保提交时题序正确items: li明确限定可拖拽元素避免误触其他 DOM。4. 自动组卷核心题库结构校验、策略配置与 PaperGenerator 类深度解析“自动组卷”不是黑匣子算法而是基于题库元数据难度、知识点、题型与用户设定规则总分、题型分布、难度梯度的确定性组合。ZIP 包中的class/AutoPaper.class.php是核心但其策略硬编码严重需解耦改造。4.1 题库表结构必须满足的 4 个强制字段项目题库表exam_question至少需以下字段缺一则组卷失败字段名类型必填说明idINT PK✓题目唯一标识type_idTINYINT✓题型 ID1单选, 2多选, 3判断, 4填空, 5简答difficultyTINYINT✓难度值1易, 2中, 3难必须为 1–3 整数knowledge_pointVARCHAR(100)✓知识点标签逗号分隔如第一章,第三章血泪经验曾见某学校导入题库时difficulty写成0.7浮点导致AutoPaper.class.php中if ($row[difficulty] $target_diff)永远为 false组卷返回空数组。务必在INSERT或UPDATE时做整型校验。4.2 组卷策略配置入口admin/paper_config.php的隐藏参数组卷页面看似只有“题型数量”滑块实则后台支持 7 个策略维度通过 URL 参数传递文档未说明GET /admin/paper_create.php?paper_type1subject_id5total_score100difficulty_ratio3:4:3types1:10,2:5,3:10knowledge_filter第一章,第二章time_limit90difficulty_ratio3:4:3→ 易:中:难 30%:40%:30%types1:10,2:5,3:10→ 单选10道、多选5道、判断10道knowledge_filter→ 仅从指定知识点抽取题目验证方法在paper_create.php开头加入调试输出?php error_log(组卷参数: . print_r($_GET, true), 3, /tmp/exam-debug.log); ?查看/tmp/exam-debug.log确认参数被正确接收。4.3AutoPaper.class.php的 3 层过滤逻辑与可调参数该类执行generatePaper()方法流程为初筛按knowledge_filter和type_id从题库查出候选题SQLWHERE难度分桶将候选题按difficulty分入$easy,$medium,$hard三个数组随机抽样对每个桶执行array_rand($bucket, $count)抽取指定数量关键可调参数修改config.php// config.php 中新增 define(PAPER_MAX_RETRY, 5); // 抽样失败重试次数防冷门知识点无题 define(PAPER_RANDOM_SEED, 12345); // 随机种子设为固定值可复现组卷结果 define(PAPER_MIN_SCORE_PER_Q, 1); // 单题最低分防填空题分值异常避坑点array_rand()在 PHP 7.4 对空数组返回NULL原代码未判空导致Warning: Invalid argument supplied for foreach()。需在generatePaper()中补if (empty($easy)) { $easy []; } // 同理处理 $medium, $hard5. 避坑5 个高频翻车现场与血泪解决方案5.1 现象登录页输入正确账号密码提交后页面刷新但未跳转Network 中login.php返回 302 但 Location 为空原因login.php中header(Location: admin/index.php)前有echo或空白行输出破坏 HTTP 头发送。检查config.php是否末尾有多余换行或session_start()前有 UTF-8 BOM。解决用 VS Code 以UTF-8 with BOM编码打开所有 PHP 文件另存为UTF-8无 BOM删除config.php末尾空行在login.php开头加ob_start()。5.2 现象组卷成功后学生端考试页显示“试卷不存在”exam_paper表中status0未启用原因管理员创建试卷后需手动点击“发布”按钮admin/paper_list.php中的“启用”链接否则status保持为 0。文档未说明此操作。解决修改paper_create.php在插入exam_paper后自动更新status1// 新增一行 mysqli_query($conn, UPDATE exam_paper SET status1 WHERE id$paper_id);5.3 现象Layui 数据表格exam_record显示“暂无数据”但数据库有记录原因table.render()的url指向api/get_records.php而该文件中 SQL 查询写死为WHERE user_id$_SESSION[user_id]但监考教师需查看全部记录。解决在get_records.php中增加权限判断if ($_SESSION[role] teacher) { $sql SELECT * FROM exam_record ORDER BY start_time DESC; } else { $sql SELECT * FROM exam_record WHERE user_id{$_SESSION[user_id]} ORDER BY start_time DESC; }5.4 现象Chrome 控制台报错Failed to register a ServiceWorker for scope但功能正常原因项目根目录下存在sw.jsService Worker 文件但未配置 HTTPS现代浏览器禁止 HTTP 下注册。ZIP 包中该文件为冗余残留。解决彻底删除sw.js及index.html中相关注册代码navigator.serviceWorker.register(sw.js)。5.5 现象MySQL 导入exam_system.sql报错ERROR 1071 (42000): Specified key was too long原因exam_user表中username字段为VARCHAR(100)utf8mb4下索引长度超 767 字节限制100×4400 767但 InnoDB 默认innodb_large_prefixOFF。解决执行 MySQL 命令启用大前缀SET GLOBAL innodb_file_formatBARRACUDA; SET GLOBAL innodb_file_per_tableON; SET GLOBAL innodb_large_prefixON; -- 然后重启 MySQL 服务6. 进阶让自动组卷真正“可配置”——从硬编码策略到 JSON 规则引擎原AutoPaper.class.php的组卷逻辑写死在 PHP 里每次调整题型比例都要改代码违背“配置驱动”原则。我将其重构为 JSON 规则引擎只需改配置文件即可切换策略。6.1 定义组卷规则 JSON Schemaconfig/paper_rules.json{ default: { total_score: 100, time_limit: 90, difficulty_ratio: [0.3, 0.4, 0.3], types: [ {type_id: 1, count: 10, score_per_q: 2}, {type_id: 2, count: 5, score_per_q: 3}, {type_id: 3, count: 10, score_per_q: 1} ], knowledge_points: [第一章, 第二章] }, final_exam: { total_score: 150, time_limit: 120, difficulty_ratio: [0.2, 0.5, 0.3], types: [ {type_id: 1, count: 20, score_per_q: 1}, {type_id: 4, count: 5, score_per_q: 6}, {type_id: 5, count: 2, score_per_q: 20} ], knowledge_points: [全部章节] } }6.2 改造AutoPaper.class.php加载规则class AutoPaper { private $rules; public function __construct($rule_name default) { $rules_path ROOT_PATH . config/paper_rules.json; $this-rules json_decode(file_get_contents($rules_path), true); if (!isset($this-rules[$rule_name])) { throw new Exception(组卷规则 {$rule_name} 不存在); } $this-current_rule $this-rules[$rule_name]; } public function generatePaper($subject_id) { // 用 $this-current_rule 替代原硬编码数组 $difficulty_ratio $this-current_rule[difficulty_ratio]; $types $this-current_rule[types]; // ... 后续逻辑不变 } }6.3 前端动态选择规则admin/paper_create.phpselect namerule idrule-select lay-filterrule option valuedefault常规测验/option option valuefinal_exam期末考试/option /select script form.on(select(rule), function(data){ // 提交时携带 rule 参数 $(#paper-form).attr(action, paper_create.php?rule data.value); }); /script我的习惯上线前我会把paper_rules.json用json_encode($data, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT)格式化方便教务老师直接编辑同时写个rule_validator.php脚本每次部署前校验 JSON 语法与字段完整性——这比靠人眼检查 PHP 代码靠谱十倍。希望帮到你。本文还有配套的精品资源点击获取
Web考试系统自动组卷部署实战：PHP兼容、Layui与jQuery-UI共存、题库校验
简介本资源是一套基于Web的考试系统自动组卷功能的完整实现方案面向计算机相关专业本科生、研究生及初入职场的开发人员解决传统考试系统中组卷效率低、策略僵化、前后端协同复杂等实际问题。项目采用SpringCloud微服务架构设计核心业务模块由Java实现前端交互依托Layui、jQuery UI等成熟UI框架辅以JSP动态页面与CSS/JS资源支撑多端适配整体结构清晰、模块解耦度高适合毕设、课设或企业级考试平台原型开发。压缩包共476个文件含181个Java后端逻辑文件、88个JS前端脚本、77个GIF动效资源、33个CSS样式表及25个JSP视图页总大小仅2.6MB轻量易部署。目前已有59人学习下载资源包含全部源码、详细设计文档、SQL建表脚本、答辩PPT及导师认可的高分评审记录95分代码经实测可直接运行亦支持在理解基础上二次扩展组卷策略或对接新题库。1. 为什么一个“自动组卷”的WEB考试系统比你想象中更难跑通——它不是把题库扔进网页就能用你下载了那个标着“源码文档全部资料优秀项目.zip”的压缩包解压后看到layui文件夹、jquery-ui目录、一堆.php和.sql文件还有一份 Word 写的《系统设计说明书》。你兴冲冲地配好 Apache PHP MySQL导入 SQL浏览器一打开http://localhost/exam/却卡在登录页——输入默认账号密码admin/123456没反应F12 看 Networklogin.php返回 500再点“组卷”按钮控制台报错Uncaught ReferenceError: layui is not defined翻文档发现里面写着“需部署于 PHP 7.2 环境”而你本地是 PHP 8.1……这不是代码写得烂而是一个典型的、未经现代化适配的 Web 考试系统遗产项目它依赖特定版本栈、硬编码路径、未声明的 JS 加载顺序、MySQL 表字段类型与 PHP 类型强耦合且“自动组卷”逻辑藏在AutoPaper.class.php里没有单元测试也没有配置开关说明。本文不讲“如何毕业答辩”只讲怎么让这个 ZIP 包真正在你机器上跑起来、改得动、组得出卷、监得了考——面向真实部署场景覆盖从环境缝合、JS 框架加载冲突、题库结构校验、到组卷策略可调性的全链路实操。适合刚接手维护老系统、或想基于此二次开发的 Web 工程师与教务信息化实施人员。2. 环境缝合PHP 版本、扩展与 MySQL 兼容性三重校准这个 ZIP 包诞生于 2018–2020 年间典型 LAMP 架构但绝非“装完就跑”。它对运行时环境有隐式强约束跳过校准直接部署90% 的失败发生在此步。2.1 PHP 版本必须锁定在 7.2–7.4含禁用 8.x项目中大量使用mysql_*函数如mysql_connect()、create_function()动态函数、以及array_key_exists($key, $array)对null的宽松判空——这些在 PHP 8.0 中已被移除或严格化。最典型的报错是Fatal error: Uncaught Error: Call to undefined function mysql_connect()提示不要试图用mysqli或PDO全局替换——项目中mysql_*调用散落在 17 个 PHP 文件里且部分逻辑依赖mysql_fetch_array()的默认MYSQL_BOTH行为强行替换会导致题干乱码、选项错位等玄学问题。正确做法是降级 PHP。推荐方案使用 XAMPP 7.4.33官方最后支持mysql_*的稳定版或 Docker 快速拉起兼容环境# docker-compose.yml version: 3.8 services: exam-web: image: php:7.4-apache ports: - 8080:80 volumes: - ./exam-source:/var/www/html depends_on: - exam-db exam-db: image: mysql:5.7 environment: MYSQL_ROOT_PASSWORD: rootpass MYSQL_DATABASE: exam_system MYSQL_USER: examuser MYSQL_PASSWORD: exam123 volumes: - ./mysql-data:/var/lib/mysql启动后访问http://localhost:8080确认首页 HTML 渲染正常无 PHP 解析错误。2.2 必启 PHP 扩展mbstring、gd、json、xml禁用opcache临时mbstring缺失 → 题干中文乱码尤其含 Unicode 标点如“《》”、“·”gd缺失 → 验证码图片无法生成captcha.php报 500json缺失 → 前端layui.table加载试题列表时$.post()返回空字符串xml缺失 →AutoPaper.class.php中读取 XML 题型模板失败该模块用于兼容旧版题库导入。opcache在调试阶段建议关闭它会缓存已损坏的 PHP 语法如?短标签未开启时导致改完代码仍报旧错。编辑php.ini; 关键项 short_open_tag On ; 必开项目大量使用 ? ... ? extensionmbstring extensiongd extensionjson extensionxml opcache.enable0 ; 调试期设为 0上线前再开重启 Apache 后访问http://localhost:8080/phpinfo.php若无新建一个搜索上述扩展名确认状态为enabled。2.3 MySQL 字符集必须为utf8mb4排序规则utf8mb4_unicode_ci项目 SQL 文件如exam_system.sql中建表语句写的是CREATE TABLE exam_question ( id int(11) NOT NULL AUTO_INCREMENT, content text NOT NULL, options text, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8;但utf8在 MySQL 中实际是utf8mb3无法存储 emoji 和部分生僻汉字如“䶮”、“”。当教师录入含四字成语题干或古文标点时content字段被截断组卷时题干缺失。修复命令执行前备份数据库-- 修改数据库默认字符集 ALTER DATABASE exam_system CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; -- 修改所有表 ALTER TABLE exam_question CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; ALTER TABLE exam_paper CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; ALTER TABLE exam_user CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; -- 修改连接层关键 -- 在 config.php 或 db.php 中mysqli 连接后立即执行 mysqli_query($conn, SET NAMES utf8mb4);参数说明utf8mb4_unicode_ci比utf8mb4_general_ci更准确支持中文排序与比较避免“张三”和“张叁”被判定为相同姓名。3. 前端框架加载链Layui 与 jQuery-UI 的共存陷阱与加载时序修复项目前端同时依赖 Layuiv2.5.6和 jQuery-UIv1.12.1但未做模块隔离。常见现象Layui 的layer.msg()弹窗样式错乱、jQuery-UI 的datepicker日期选择器点击无响应、组卷页面拖拽题型区域失效。根源在于全局$冲突与 CSS 优先级污染。3.1 确认 Layui 与 jQuery-UI 的加载顺序与作用域查看index.html或admin/index.php头部script标签script srcjs/jquery.min.js/script script srcjs/jquery-ui.min.js/script script srclayui/layui.js/script script layui.use([layer, form], function(){ var layer layui.layer; // ... 初始化代码 }); /script问题在于Layui v2.5.6 内部未封装$直接挂载到window.$而 jQuery-UI 1.12.1 依赖jQuery全局对象但项目引入的是精简版jquery.min.js无noConflict()调用。结果$.datepicker()调用时$指向 Layui 的轻量 DOM 封装而非 jQuery 实例。修复方案强制 jQuery-UI 使用jQuery别名Layui 使用layui全局对象!-- 修改加载顺序与封装 -- script srcjs/jquery.min.js/script script // 立即释放 $保留 jQuery 全局变量 var jQuery window.jQuery; delete window.$; /script script srcjs/jquery-ui.min.js/script script srclayui/layui.js/script script // Layui 初始化必须用 layui.use不依赖 $ layui.use([layer, form, table], function(){ var layer layui.layer, form layui.form, table layui.table; // jQuery-UI 组件显式使用 jQuery非 $ jQuery(document).ready(function(){ jQuery(#exam_date).datepicker({ dateFormat: yy-mm-dd, changeMonth: true, changeYear: true }); }); }); /script3.2 CSS 冲突Layui 表单样式覆盖 jQuery-UI 日期控件Layui 的layui-form-item默认margin-bottom: 15px而 jQuery-UIui-datepicker的弹出层被z-index: 999的 Layuilayer遮挡。现象点击日期输入框日历弹窗一闪即逝。修复 CSS添加到static/css/custom.css并引入/* 提升 jQuery-UI 日期选择器层级 */ .ui-datepicker { z-index: 9999 !important; /* 必须高于 layui layer 的 1989 */ } /* 修正 Layui 表单内嵌控件间距 */ .layui-form-item .ui-datepicker-trigger { margin-left: 10px; vertical-align: middle; } /* 防止 Layui input 样式污染 jQuery-UI 输入框 */ .layui-form-item input[typetext].hasDatepicker { padding: 0 10px; height: 38px; line-height: 38px; }逻辑说明!important是此处唯一可靠解法。Layui 的 CSS 权重极高大量!important而 jQuery-UI 默认样式未加权不强制提升则无效。3.3 组卷拖拽功能失效jQuery-UI Sortable 与 Layui Table 的 DOM 生命周期冲突组卷页admin/paper_create.php使用 jQuery-UIsortable()实现题型拖拽排序但 Layui 的table.render()会重绘整个tableDOM导致已绑定的sortable事件丢失。修复 JS在paper_create.php底部// Layui table 渲染完成后重新初始化 sortable table.on(done(filter), function(res){ // 确保 #question-list 存在且有子元素 if ($(#question-list li).length 0) { $(#question-list).sortable({ items: li, placeholder: ui-state-highlight, update: function(event, ui) { // 拖拽后更新题序号 hidden input $(#question-list li).each(function(index) { $(this).find(input[nameseq]).val(index 1); }); } }); } }); // 页面首次加载时也初始化一次 $(document).ready(function(){ if ($(#question-list li).length 0) { $(#question-list).sortable({ /* 同上 */ }); } });参数说明update回调中更新seq隐藏域确保提交时题序正确items: li明确限定可拖拽元素避免误触其他 DOM。4. 自动组卷核心题库结构校验、策略配置与 PaperGenerator 类深度解析“自动组卷”不是黑匣子算法而是基于题库元数据难度、知识点、题型与用户设定规则总分、题型分布、难度梯度的确定性组合。ZIP 包中的class/AutoPaper.class.php是核心但其策略硬编码严重需解耦改造。4.1 题库表结构必须满足的 4 个强制字段项目题库表exam_question至少需以下字段缺一则组卷失败字段名类型必填说明idINT PK✓题目唯一标识type_idTINYINT✓题型 ID1单选, 2多选, 3判断, 4填空, 5简答difficultyTINYINT✓难度值1易, 2中, 3难必须为 1–3 整数knowledge_pointVARCHAR(100)✓知识点标签逗号分隔如第一章,第三章血泪经验曾见某学校导入题库时difficulty写成0.7浮点导致AutoPaper.class.php中if ($row[difficulty] $target_diff)永远为 false组卷返回空数组。务必在INSERT或UPDATE时做整型校验。4.2 组卷策略配置入口admin/paper_config.php的隐藏参数组卷页面看似只有“题型数量”滑块实则后台支持 7 个策略维度通过 URL 参数传递文档未说明GET /admin/paper_create.php?paper_type1subject_id5total_score100difficulty_ratio3:4:3types1:10,2:5,3:10knowledge_filter第一章,第二章time_limit90difficulty_ratio3:4:3→ 易:中:难 30%:40%:30%types1:10,2:5,3:10→ 单选10道、多选5道、判断10道knowledge_filter→ 仅从指定知识点抽取题目验证方法在paper_create.php开头加入调试输出?php error_log(组卷参数: . print_r($_GET, true), 3, /tmp/exam-debug.log); ?查看/tmp/exam-debug.log确认参数被正确接收。4.3AutoPaper.class.php的 3 层过滤逻辑与可调参数该类执行generatePaper()方法流程为初筛按knowledge_filter和type_id从题库查出候选题SQLWHERE难度分桶将候选题按difficulty分入$easy,$medium,$hard三个数组随机抽样对每个桶执行array_rand($bucket, $count)抽取指定数量关键可调参数修改config.php// config.php 中新增 define(PAPER_MAX_RETRY, 5); // 抽样失败重试次数防冷门知识点无题 define(PAPER_RANDOM_SEED, 12345); // 随机种子设为固定值可复现组卷结果 define(PAPER_MIN_SCORE_PER_Q, 1); // 单题最低分防填空题分值异常避坑点array_rand()在 PHP 7.4 对空数组返回NULL原代码未判空导致Warning: Invalid argument supplied for foreach()。需在generatePaper()中补if (empty($easy)) { $easy []; } // 同理处理 $medium, $hard5. 避坑5 个高频翻车现场与血泪解决方案5.1 现象登录页输入正确账号密码提交后页面刷新但未跳转Network 中login.php返回 302 但 Location 为空原因login.php中header(Location: admin/index.php)前有echo或空白行输出破坏 HTTP 头发送。检查config.php是否末尾有多余换行或session_start()前有 UTF-8 BOM。解决用 VS Code 以UTF-8 with BOM编码打开所有 PHP 文件另存为UTF-8无 BOM删除config.php末尾空行在login.php开头加ob_start()。5.2 现象组卷成功后学生端考试页显示“试卷不存在”exam_paper表中status0未启用原因管理员创建试卷后需手动点击“发布”按钮admin/paper_list.php中的“启用”链接否则status保持为 0。文档未说明此操作。解决修改paper_create.php在插入exam_paper后自动更新status1// 新增一行 mysqli_query($conn, UPDATE exam_paper SET status1 WHERE id$paper_id);5.3 现象Layui 数据表格exam_record显示“暂无数据”但数据库有记录原因table.render()的url指向api/get_records.php而该文件中 SQL 查询写死为WHERE user_id$_SESSION[user_id]但监考教师需查看全部记录。解决在get_records.php中增加权限判断if ($_SESSION[role] teacher) { $sql SELECT * FROM exam_record ORDER BY start_time DESC; } else { $sql SELECT * FROM exam_record WHERE user_id{$_SESSION[user_id]} ORDER BY start_time DESC; }5.4 现象Chrome 控制台报错Failed to register a ServiceWorker for scope但功能正常原因项目根目录下存在sw.jsService Worker 文件但未配置 HTTPS现代浏览器禁止 HTTP 下注册。ZIP 包中该文件为冗余残留。解决彻底删除sw.js及index.html中相关注册代码navigator.serviceWorker.register(sw.js)。5.5 现象MySQL 导入exam_system.sql报错ERROR 1071 (42000): Specified key was too long原因exam_user表中username字段为VARCHAR(100)utf8mb4下索引长度超 767 字节限制100×4400 767但 InnoDB 默认innodb_large_prefixOFF。解决执行 MySQL 命令启用大前缀SET GLOBAL innodb_file_formatBARRACUDA; SET GLOBAL innodb_file_per_tableON; SET GLOBAL innodb_large_prefixON; -- 然后重启 MySQL 服务6. 进阶让自动组卷真正“可配置”——从硬编码策略到 JSON 规则引擎原AutoPaper.class.php的组卷逻辑写死在 PHP 里每次调整题型比例都要改代码违背“配置驱动”原则。我将其重构为 JSON 规则引擎只需改配置文件即可切换策略。6.1 定义组卷规则 JSON Schemaconfig/paper_rules.json{ default: { total_score: 100, time_limit: 90, difficulty_ratio: [0.3, 0.4, 0.3], types: [ {type_id: 1, count: 10, score_per_q: 2}, {type_id: 2, count: 5, score_per_q: 3}, {type_id: 3, count: 10, score_per_q: 1} ], knowledge_points: [第一章, 第二章] }, final_exam: { total_score: 150, time_limit: 120, difficulty_ratio: [0.2, 0.5, 0.3], types: [ {type_id: 1, count: 20, score_per_q: 1}, {type_id: 4, count: 5, score_per_q: 6}, {type_id: 5, count: 2, score_per_q: 20} ], knowledge_points: [全部章节] } }6.2 改造AutoPaper.class.php加载规则class AutoPaper { private $rules; public function __construct($rule_name default) { $rules_path ROOT_PATH . config/paper_rules.json; $this-rules json_decode(file_get_contents($rules_path), true); if (!isset($this-rules[$rule_name])) { throw new Exception(组卷规则 {$rule_name} 不存在); } $this-current_rule $this-rules[$rule_name]; } public function generatePaper($subject_id) { // 用 $this-current_rule 替代原硬编码数组 $difficulty_ratio $this-current_rule[difficulty_ratio]; $types $this-current_rule[types]; // ... 后续逻辑不变 } }6.3 前端动态选择规则admin/paper_create.phpselect namerule idrule-select lay-filterrule option valuedefault常规测验/option option valuefinal_exam期末考试/option /select script form.on(select(rule), function(data){ // 提交时携带 rule 参数 $(#paper-form).attr(action, paper_create.php?rule data.value); }); /script我的习惯上线前我会把paper_rules.json用json_encode($data, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT)格式化方便教务老师直接编辑同时写个rule_validator.php脚本每次部署前校验 JSON 语法与字段完整性——这比靠人眼检查 PHP 代码靠谱十倍。希望帮到你。本文还有配套的精品资源点击获取
