zhjwxt/niucloud/databasedoc/school_jobs_failed.md

school_jobs_failed 表文档

表概述

表名: school_jobs_failed
功能: 任务失败记录表，用于记录和管理系统中执行失败的异步任务信息，包括任务队列、载荷数据、异常信息等，为系统任务监控、错误排查和故障恢复提供完整的失败任务记录

字段说明

Field	Type	Collation	Null	Key	Default	Extra	Privileges	Comment
id	int	NULL	NO	PRI	NULL	auto_increment	select,insert,update,references	
connection	text	utf8mb4_general_ci	NO		NULL		select,insert,update,references	
queue	text	utf8mb4_general_ci	NO		NULL		select,insert,update,references	
payload	longtext	utf8mb4_general_ci	NO		NULL		select,insert,update,references	
exception	longtext	utf8mb4_general_ci	NO		NULL		select,insert,update,references	
fail_time	timestamp	NULL	NO		CURRENT_TIMESTAMP	DEFAULT_GENERATED	select,insert,update,references	

功能用途

主要功能

• 失败任务记录: 记录执行失败的异步任务的完整信息
• 队列信息管理: 记录任务所属的队列和连接信息
• 载荷数据保存: 保存任务的完整载荷数据，便于重新执行
• 异常信息记录: 详细记录任务失败的异常信息和错误堆栈
• 失败时间跟踪: 记录任务失败的具体时间点
• 错误分析支持: 为系统错误分析和故障排查提供数据支持
• 任务重试基础: 为失败任务的重新执行提供数据基础
• 系统监控: 支持系统任务执行状态的监控和告警

业务场景

• 邮件发送失败: 记录邮件发送任务的失败信息
• 短信发送失败: 记录短信发送任务的失败详情
• 数据同步失败: 记录数据同步任务的失败情况
• 文件处理失败: 记录文件上传、转换等处理任务的失败
• 支付回调失败: 记录支付回调处理任务的失败
• 报表生成失败: 记录报表生成任务的失败信息
• 数据导入失败: 记录批量数据导入任务的失败
• 定时任务失败: 记录定时执行任务的失败情况
• API调用失败: 记录第三方API调用任务的失败
• 消息推送失败: 记录消息推送任务的失败详情

关联关系

主要关联表

• school_sys_cron_task: 定时任务表，可能产生失败的定时任务记录
• school_sys_notice_log: 通知发送日志表，通知发送失败时的记录
• school_sys_notice_sms_log: 短信发送日志表，短信发送失败时的记录
• school_service_logs: 服务日志表，记录相关的服务执行日志
• school_sys_export: 导出任务表，导出任务失败时的记录
• school_pay: 支付表，支付相关任务失败时的关联
• school_sys_log: 系统日志表，记录相关的系统操作日志

关联说明

• 作为系统任务队列的失败记录存储，与各业务模块的异步任务关联
• 通过queue字段标识不同类型的任务队列
• 通过payload字段保存任务的完整上下文信息
• 为任务重试和错误恢复提供数据支持

索引建议

-- 主键索引（自动创建）
PRIMARY KEY (id)

-- 队列索引（用于按队列查询失败任务）
INDEX idx_queue (queue(100))

-- 连接索引（用于按连接查询失败任务）
INDEX idx_connection (connection(100))

-- 失败时间索引（用于按时间排序和清理）
INDEX idx_fail_time (fail_time)

-- 复合索引（队列和时间）
INDEX idx_queue_time (queue(50), fail_time)

注意事项

• 数据清理: 定期清理过期的失败任务记录，避免表数据过大
• 异常信息长度: exception字段可能包含很长的错误堆栈信息
• 载荷数据安全: payload字段可能包含敏感信息，需要注意数据安全
• 存储空间: longtext字段会占用较大存储空间，需要监控表大小
• 查询性能: 大量数据时需要注意查询性能，合理使用索引
• 重试机制: 建立合理的任务重试机制，避免无限重试
• 监控告警: 建立失败任务的监控和告警机制
• 错误分类: 对不同类型的错误进行分类处理
• 日志关联: 与系统日志建立关联，便于问题追踪
• 备份策略: 重要的失败任务记录需要建立备份策略
• 权限控制: 严格控制对失败任务记录的访问权限
• 数据分析: 定期分析失败任务的模式，优化系统稳定性