常见问题

通用问题

消息发送失败，提示机器人配置找不到

1. 检查机器人 ID 是否与系统配置中完全一致，注意区分大小写。
2. 确认已在系统配置中添加并保存了机器人。
3. 检查 Webhook URL 是否正确、可访问。

@构建执行人 不生效

1. 确认 Jenkins 用户资料中已填写企业微信手机号。
2. 确认手机号与企业微信成员绑定手机号一致。
3. Pipeline 中确认已设置 atMe: true，FreeStyle 中确认已勾选对应选项。

图片消息发送失败

1. 确认 imageUrl 指向的文件在工作目录中存在，或路径可被正确展开。
2. 图片格式建议为 JPG/PNG，大小建议不超过 2MB。
3. 确认消息类型设置为 image。

Pipeline 问题

找不到 wxwork 步骤

1. 确认插件已安装并重启 Jenkins。
2. 确认 Jenkins 版本 >= 2.479.3。
3. 在 Pipeline Syntax 中搜索 wxwork，确认步骤已被注册。

Markdown V2 表格显示异常

请检查表格是否包含分隔符行，例如：

text: [
    "| 列1 | 列2 |",
    "|------|------|",
    "| A | B |"
]

如何在消息中使用构建参数

text: [
    "项目: ${env.JOB_NAME}",
    "构建号: ${currentBuild.number}",
    "参数: ${params.MY_PARAM}"
]

FreeStyle 问题

配置了通知但没有发送

1. 检查是否勾选了对应通知时机。
2. 确认构建结果与勾选条件匹配。
3. 查看构建日志中以 WXWORK: 开头的记录。

恢复通知不触发

1. 仅在“上次失败或不稳定，本次成功”时触发。
2. 首次构建没有历史结果，不会触发恢复通知。
3. 如果同时配置了成功通知和恢复通知，恢复时会优先使用恢复消息。

页面里 ${JOB_NAME} 之类的变量显示为空

这是正常现象。FreeStyle 配置页面展示的是占位符原文，变量会在构建执行时展开。如果实际发送出去的消息里变量仍为空，请检查该变量在当前任务环境中是否存在。