在 moodle 使用 custom certificate 插件生成证书时，课程完成日期（course completion date）常出现空白，而预览正常、发证日期（issue date）却能正确显示——根本原因在于课程完成状态需依赖定时任务（cron）异步写入数据库，证书生成时该日期尚未就绪。
在 moodle 使用 custom certificate 插件生成证书时，课程完成日期（course completion date）常出现空白，而预览正常、发证日期（issue date）却能正确显示——根本原因在于课程完成状态需依赖定时任务（cron）异步写入数据库，证书生成时该日期尚未就绪。
Moodle 的课程完成机制并非实时触发，而是由后台 cron 任务周期性扫描并更新用户完成状态（包括 completion date 字段）。当学员满足所有完成条件（如完成测验、提交作业等）后，该状态并不会立即写入 course_completions 表；只有 cron 执行完毕，系统才会生成确切的 timecompleted 时间戳。而 Custom Certificate 插件在生成证书时直接查询该字段——若 cron 尚未运行，该值为空，导致证书上对应日期缺失。
✅ 推荐解决方案（按优先级排序）
1. 利用 Cron 延迟窗口，引导用户“等待”
在证书发放前设置一个轻量级阻断环节（如必填反馈表单），不将其纳入课程完成条件。这样用户提交反馈时，后台 cron 极大概率已完成上次执行，课程完成记录已写入数据库。
// 示例逻辑示意（非实际插件代码，仅说明流程）
if (completion_has_criteria($course) && !completion_get_course_completion($USER->id, $course)) {
// 不直接发证，跳转至反馈页
redirect(new moodle_url('/mod/feedback/view.php', ['id' => $feedbackcmid]));
}
// 用户提交反馈后，再检查 completion 记录是否就绪，再渲染证书⚠️ 注意：确保服务器 cron 配置合理（建议每 5 分钟执行一次 admin/cli/cron.php），并可通过 站点管理 → 服务器 → 任务计划 查看 core\task\completion_daily_task 的最近执行时间。
2. 改用活动完成时间替代课程完成时间
若业务允许，推荐在证书中显示某个关键活动（如结课测验）的完成时间，而非课程整体完成时间。该时间在用户提交后即刻写入（如 quiz_attempts.timefinish），无需等待 cron：
在 Custom Certificate 模板中，选择变量：
[[quiz_XX_completion_date]]（需先在证书设置中启用对应测验活动）
或使用通用变量：[[activity_YY_completion_date]]（YY 为活动模块 ID）验证方式：进入课程 → 编辑测验 → “完成条件”中勾选“用户必须完成此活动”，并确保“成绩合格”或“尝试次数”等条件可被即时满足。
3. 临时调试技巧（仅限排查）
手动触发 completion cron 任务，验证是否为延迟问题：
# 登录服务器，进入 Moodle 根目录 php admin/cli/cron.php --execute=core\task\completion_daily_task
执行后立即生成证书，若日期恢复正常，则 100% 确认为 cron 延迟所致。
? 总结
课程完成日期在证书中“预览有、下载无”，本质是数据就绪时机与证书生成时机的错位。这不是插件 Bug，而是 Moodle 完成架构的设计特性。最优实践是：
? 优先采用“活动完成时间”作为证书可信时间戳（更及时、更可追溯）；
? 若必须用课程完成时间，请结合 cron 调度节奏设计用户路径（如反馈等待页）；
? 切勿依赖“立即发证”流程获取 course_completions.timecompleted —— 它天生具有异步性。
通过合理规划完成逻辑与时间变量选择，即可在保证严谨性的同时，确保每张证书准确承载学习成果的正式时间节点。
