任务未触发的根本原因包括会话失效、Webhook失活、缺乏重试与心跳机制、触发条件被策略过滤；需依次检查employee_id会话状态、Webhook健康度与路由、配置失败重试及心跳检测、审查全局过滤规则匹配逻辑。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当QoderWake配置了多个定时任务或事件触发任务，却出现某些任务未按时启动、状态卡在“待触发”、甚至日志中完全无记录的情况，说明任务调度链路存在断点——这通常源于会话生命周期管理失效、Webhook注册丢失或触发条件未被正确捕获。
确认任务绑定的员工身份处于活跃会话状态
QoderWake所有自动化任务均绑定到具体employee_id，若该身份对应的会话过期或被强制注销，任务将无法加载执行上下文。
在桌面端终端执行qoderwake status，检查last_active时间戳是否在最近5分钟内；若显示inactive或为空，说明会话已断开。
打开QoderWake桌面客户端→点击右上角头像→「账号与会话」→找到当前employee_id条目→点击「刷新令牌」按钮。该操作会重签OAuth 2.1短期凭证，并同步更新所有已注册任务的会话引用。
【注意：刷新令牌后，所有正在运行中的子任务不会中断，但新触发的任务将使用新会话上下文】
验证Webhook注册是否存活且路由可达
对于由飞书/钉钉消息、GitLab MR、Prometheus告警等外部事件驱动的任务，QoderWake依赖Webhook接收信号。一旦Webhook地址失效、签名密钥轮换未同步或防火墙拦截，任务就彻底“听不见”触发指令。
方法一：直查Webhook健康状态
进入QoderWake控制台→「事件中心」→「已注册Webhook」列表，定位目标渠道（如feishu-bot-2026-07），点击右侧「诊断」按钮。
若返回404 Not Found或401 Unauthorized，说明飞书开放平台侧机器人已被删除或Token过期；需重新扫码授权并复制新Webhook URL粘贴回QoderWake对应字段。
方法二：手动模拟触发测试
用curl命令向QoderWake本地监听端口发送原始事件体：curl -X POST http://127.0.0.1:8080/qoderwake/invoke -H "Content-Type: application/json" -d '{"event_type":"ticket_overdue","data":{"ticket_id":"T-20260730-001"}}'。
观察QoderWake终端日志是否输出[webhook] received ticket_overdue → routed to task#alert-pager。无此日志即证明Webhook入口未生效。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
启用任务心跳保活与失败自动重试
某些长周期任务（如每日凌晨2点拉取CMDB全量数据）可能因网络抖动、目标API临时不可达而首次失败，若未配置重试策略，就会永久停滞。
第一步：进入「工作流编排器」→选中目标任务→点击「高级配置」。
第二步：勾选「启用失败重试」，设置重试次数为3次，间隔为2分钟。
第三步：在「保活机制」区域启用「心跳检测」，填入监测端点https://cmdb.internal/api/v1/health，超时阈值设为15秒。
第四步：保存后，系统自动生成守护式watchdog进程，每5分钟主动探测该端点；若连续2次失败，则强制触发重试流程，而非等待下一次定时窗口。
【关键前提：心跳端点必须返回HTTP 200且响应体含{"status":"ok"}】
检查任务触发条件是否被策略过滤器拦截
QoderWake默认启用全局策略过滤器，会对所有入站事件做预检。若任务定义的触发关键词（如“紧急”“P0”“数据库慢”）恰好匹配某条禁用规则，事件会被静默丢弃，不写日志、不发告警。
进入「策略中心」→「全局过滤规则」→查看启用中的规则列表。
重点排查名称含block、deny、suppress的规则，点击其「编辑」→展开「匹配逻辑」→确认event.payload.text或event.source字段是否覆盖了你的任务来源。
例如：一条规则设定为source == "wechat" AND text contains "test"，会拦截所有微信渠道含“test”的消息——即使你本意是让QoderWake响应“test-db-connection”这类运维指令。
临时绕过方式：在任务配置页的「触发条件」栏末尾添加唯一标识符，如text contains "P0" AND text contains "qoder-bypass-7f3a"，再在对应过滤规则中排除该字符串。
