Hook无响应需依次排查事件类型、matcher正则、服务可达性:确认事件是否匹配触发时机(如UserPromptSubmit),检查matcher大小写及匹配对象(如PreToolUse匹配工具名、PostToolUse匹配返回type字段),最后用curl验证HTTP服务是否返回2xx且含"block":true的合法JSON。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Qwen Code工作流控制台中配置的Hook没有响应,用户提交提示词后无审计日志、工具调用前未拦截、会话启动时未注入规范——这意味着安全管控链路已断裂,必须立刻定位是事件选错、matcher写错,还是服务不可达。
确认事件类型是否匹配触发时机
打开企业管理后台 → 安全管控 → Hooks 规则,核对当前配置所在事件栏是否与你期望的拦截点一致。例如想在用户输入内容后检查敏感信息,必须填在 UserPromptSubmit 事件里;若误填到 SessionStart,则永远不触发。
PreToolUse 仅在 Agent 调用 Bash、Git、HTTP 等工具前触发;PostToolUse 在工具执行完才触发,此时命令已运行,无法撤回。Stop 事件用于干预 Agent 是否结束响应,不是用来做前置校验的。
注意:Notification 和 SessionStart 不建议用于阻断操作,它们的设计定位是通知和初始化,强行加阻断逻辑可能导致会话卡死或状态异常。
检查 matcher 正则表达式是否生效
方法一:用精确匹配验证工具名
若目标是拦截所有 Bash 命令,在 PreToolUse 中配置 "matcher": "^Bash$"。注意 大小写敏感,写成 "bash" 或 "Bash "(末尾空格)都会失败。
方法二:用通配符覆盖全部场景
临时调试时可将 matcher 设为 "*" 或直接留空,观察 Hook 是否被调用。若此时能触发,说明原 matcher 表达式有误;若仍不触发,则问题出在事件类型或网络连通性上。
方法三:在 PostToolUse 中 matcher 匹配的是工具执行结果类型,不是工具名。比如 Git 工具执行成功后返回 {"type":"git","status":"success"},此时 matcher 应匹配 "git" 而非 "Git" —— 实际匹配对象是工具返回 payload 的 type 字段值,不是调用时的工具标识符。
验证 HTTP Hook 服务是否可达且响应合规
第一步:用 curl 模拟请求
复制配置中的 url 和 headers(去掉 Authorization 值中的占位符),在终端执行:curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer YOUR_TOKEN" -d '{"event":"UserPromptSubmit","content":"test"}' https://hooks.example.com/pre-tool-use
第二步:检查响应状态码与 body
Hook 服务必须在 timeout 秒内(配置中指定,默认30秒)返回 HTTP 2xx 状态码,且 body 必须是合法 JSON。返回 4xx/5xx、超时、或非 JSON 响应(如纯文本“ok”),Qwen Code 都会视为执行失败并跳过后续处理。
第三步:确认服务返回字段符合要求
若需阻止操作(如在 UserPromptSubmit 或 PreToolUse 中),服务响应体中必须包含 "block": true 字段,否则即使请求成功,也不会中断流程。这一步漏写会导致“看起来调用了,但没拦住”的假象。











