自动任务如何逐个交接
建站项目交接时,自动任务常被一句“已经配好了”带过,但触发方式、时区、输入输出、重试、并发锁和告警任何一项没核对清楚,都可能造成遗漏或重复执行。以下做法适用于需要把定时发布、数据同步、通知推送等自动任务从开发方移交到运营方的场景,交接双方应逐项记录并验证,不默认任务已正确运行。
触发方式与时区:先记录再验证
每个自动任务先记录触发类型:是定时触发、事件触发还是手动触发。定时触发要写清表达式或周期,事件触发要写清监听什么事件。时区单独列一栏,明确任务按哪个时区执行,并与服务器时区、业务时区核对。假设一个每日汇总任务标记为“每天0点”,必须确认这个0点是哪个时区的0点,避免跨时区时提前或延后执行。
验证时,在测试环境把触发时间临时改到几分钟后,观察任务是否按预期启动。事件触发的任务,构造一次测试事件,记录从事件发生到任务启动的间隔。核对方法是:交接双方共同查看任务配置页面和实际执行日志,确认记录与配置一致,而不是只口头确认。
输入输出:写清来源、去向与格式
每个任务记录输入来源(数据库表、接口、文件路径或消息队列)、输出目标(写入位置、通知对象、文件格式)和字段对应关系。假设一个订单同步任务,输入是订单表新增记录,输出是外部系统接口,就要写明同步哪些字段、空值如何处理、失败时保留什么状态。
核对时,用一条测试数据走完整流程,检查输出是否与记录一致。对于文件输出,确认文件名规则、编码和存放路径;对于接口输出,确认请求方法和返回码含义。交接单上应留下测试数据样例和实际输出样例,双方对照后签字确认,避免后续对“输出正确”理解不同。
重试与并发锁:明确边界条件
重试策略要记录:失败后重试几次、间隔多久、什么错误类型触发重试、什么情况直接告警不重试。并发锁要记录:同一任务是否允许并行、锁的粒度是什么、锁超时后如何处理。假设一个库存扣减任务,如果没有并发锁,两个实例同时运行可能重复扣减;交接时要确认锁机制已启用并测试。
验证重试时,可以人为制造一次可恢复失败,观察重试次数和间隔是否符合记录。验证并发锁时,在测试环境同时触发两次任务,检查是否只有一次实际执行、另一次被阻止或排队。核对方法是比对任务日志中的重试记录和锁等待记录,确认与交接单描述一致。
告警与遗漏重复核对:留下可查记录
告警要记录:告警触发条件(连续失败几次、超时多久)、通知渠道、接收人、告警内容包含哪些字段。假设任务连续失败三次后发邮件通知,交接时要确认接收人邮箱正确,并实际触发一次测试告警,检查是否收到。告警恢复通知是否发送也应写明。
遗漏与重复的核对不能只看任务是否运行过。交接双方应约定一个观察周期,对比任务执行记录与业务数据:例如定时发布任务,核对发布条数与计划条数是否一致;同步任务,核对源端和目标端记录数是否相等。发现差异时,登记差异数量、发生时间和初步原因,作为交接遗留项跟踪,而不是当场口头解释。
