Magnolia WebHook配置未触发技术求助

核心问题定位与修正步骤 #

1. 配置目录名称错误
   Magnolia要求WebHook配置文件必须放在Light Module的webhooks（复数）目录下，你当前使用的是单数webhook文件夹，这会导致Magnolia无法识别配置文件。请将文件夹重命名为webhooks。

2. YAML语法缩进错误
   你的配置中queryParameters下的access_token缺少正确缩进，YAML是缩进敏感格式，必须与同级的headers下的键保持一致缩进。修正后的配置如下：

name: webhook1new
url: https://webhook.site/f8416277-2da7-4811-a6e0-f5a652dca43f 
method: POST
queryParameters:
  access_token: '2cf09447'
headers:
  "Content-Type": "application/json"
enabled: true
events:
  - name: contentPublished
    eventType: Published
    entity: Content   
  - name: contentUnpublished
    eventType: Unpublished
    entity: Content

3. 不必要的引号转义
   配置中headers里的"Content-Type"使用了HTML转义字符，虽然部分解析器能识别，但建议直接使用双引号"Content-Type"，避免潜在的语法解析问题。

后续验证步骤 #

• 确认Light Module加载状态：登录Magnolia AdminCentral，进入「Modules」页面，搜索你的Light Module名称，确认其处于启用状态。
• 启用DEBUG日志排查：在Magnolia日志配置中，将info.magnolia.webhook的日志级别调整为DEBUG，触发内容发布/取消发布操作后，查看日志是否有WebHook加载、请求发送的相关记录，或具体错误信息（如网络连接失败、配置解析错误）。
• 测试目标URL可用性：使用Postman等工具手动发送POST请求到你的WebHook地址，携带access_token查询参数和Content-Type: application/json头，确认目标服务能正常接收请求，排除外部地址的问题。

内容的提问来源于stack exchange，提问作者Kishore S