任务调度 · 类

任务错误处理

任务错误处理配置。

调用签名

(策略: '失败处理策略' = <失败处理策略.重试: 'retry'>, 最大失败次数: 'int' = 3, 失败回调: 'Optional[Callable]' = None, 重试延迟秒: 'float' = 1.0, 退避系数: 'float' = 2.0, 超时秒: 'float' = 0) -> None

任ZHONGWEN
PYTHON

Chinese example

中文代码示例

# 完整案例：按字段调用 任务错误处理
设 结果 = 任务调度.任务错误处理(
    策略=<失败处理策略.重试: 'retry'>,  # 可选；按函数业务含义传入 策略;首次使用建议先 打印(...
    最大失败次数=3,  # 可选；整数类型的 最大失败次数 参数,按函数业务含义传...
    失败回调=None,  # 可选；事件触发时执行的函数
    重试延迟秒=1.0,  # 可选；数值类型的 重试延迟秒 参数,按函数业务含义传入...
    退避系数=2.0,  # 可选；数值类型的 退避系数 参数,按函数业务含义传入对...
    超时秒=0,  # 可选；等待响应的最长时间，单位通常是秒
)
打印(结果)

可直接放进 .cs / .中py 文件运行。转换器会把中文代码交给真实 Python 解释器。

Parameters

参数说明

6 个参数

参数类型 / 传入方式说明

策略可选 · 默认 <失败处理策略.重试: 'retry'>

失败处理策略位置参数或字段名=值

按函数业务含义传入策略;首次使用建议先打印(结果) 确认其作用。

常见错误：类型不匹配会报 TypeError;按字段类型(失败处理策略) 传值

最大失败次数可选 · 默认 3

int位置参数或字段名=值

整数类型的最大失败次数参数,按函数业务含义传入对应数值。

常见错误：传非整数会报 TypeError;按整数类型传值

失败回调可选 · 默认 None

Optional[Callable]位置参数或字段名=值

事件触发时执行的函数。

常见错误：类型不匹配会报 TypeError;按字段类型(Optional[Callable]) 传值

重试延迟秒可选 · 默认 1.0

float位置参数或字段名=值

数值类型的重试延迟秒参数,按函数业务含义传入对应浮点数。

常见错误：传非数值会报 TypeError;按数值类型传值

退避系数可选 · 默认 2.0

float位置参数或字段名=值

数值类型的退避系数参数,按函数业务含义传入对应浮点数。

常见错误：传非数值会报 TypeError;按数值类型传值

超时秒可选 · 默认 0

float位置参数或字段名=值

等待响应的最长时间，单位通常是秒。

常见错误：传非数值会报 TypeError;按数值类型传值

Playbook

基础用法 · 进阶组合 · 错误排查

# 完整案例：按字段调用 任务错误处理
设 结果 = 任务调度.任务错误处理(
    策略=<失败处理策略.重试: 'retry'>,  # 可选；按函数业务含义传入 策略;首次使用建议先 打印(...
    最大失败次数=3,  # 可选；整数类型的 最大失败次数 参数,按函数业务含义传...
    失败回调=None,  # 可选；事件触发时执行的函数
    重试延迟秒=1.0,  # 可选；数值类型的 重试延迟秒 参数,按函数业务含义传入...
    退避系数=2.0,  # 可选；数值类型的 退避系数 参数,按函数业务含义传入对...
    超时秒=0,  # 可选；等待响应的最长时间，单位通常是秒
)
打印(结果)

# 进阶组合:任务错误处理 配合 任务调度 业务流使用
设 任务 = 任务调度.每隔(1, 任务函数)
设 结果 = 任务调度.任务错误处理(
    策略=<失败处理策略.重试: 'retry'>,  # 可选
    最大失败次数=3,  # 可选
    失败回调=None,  # 可选
)
任务调度.取消(任务)
打印(结果)

# 错误排查:类型不匹配
# 错误:传错类型
# 设 结果 = 任务调度.任务错误处理(策略=None)  # TypeError
# 修复:按字段类型 失败处理策略 传值
设 结果 = 任务调度.任务错误处理(策略=<失败处理策略.重试: 'retry'>)
打印(结果)