忠告

使用忠告

代码在许多地方做了限制和异常状态处理,但请注意: 这些机制仅作为应急使用,并不能保证完全无副作用或问题.请在使用时遵循以下建议,以确保系统的稳定性和可靠性:

1. 请勿过度依赖异常处理机制,系统提供的异常捕获,重试,超时终止等功能,并非万能解决方案,过度依赖这些机制可能导致:

2. 任务状态不一致

3. 资源泄漏(如线程/进程未正确释放)

4. 日志混乱,难以定位真实问题

5. 网络与IO操作请自行做好超时处理

6. 系统提供的 kill_api 无法终止阻塞型任务(如未使用interruptible_sleep的time.sleep未设置超时的网络请求等)

7. 建议:在任务函数内部对可能阻塞的操作设置合理的超时机制,避免任务"“"卡死"

8. 及时处理任务返回结果

9. 如果任务有返回值,请及时通过get_task_result或相关接口获取

10. 若不需要返回值,请不要在任务函数中编写返回语句，避免结果堆积和内存泄漏

11. 系统会清理长时间未被取走的结果,但仍建议用户主动管理任务结果生命周期

12. 谨慎使用强制终止与暂停功能

13. 强制终止(kill)可能造成资源未释放、状态不一致等问题

14. 暂停(pause)功能在 Linux/Mac 中仅支持进程任务,且超时计时器仍在运行

15. 如非必要,建议通过任务自身的逻辑控制其执行流程,而非依赖外部强制控制

16. 合理配置,避免超负荷运行,请根据实际硬件资源和任务类型调整配置文件中的任务数量限制,过度并发可能导致:

17. 调度器响应变慢

18. 系统负载过高

19. 任务执行延迟或失败