如何通过GitLab CI的curl向Slack频道发送XML payload？

核心原因 #

Slack的Incoming Webhook仅接受JSON格式的请求体，直接发送纯XML或用文件上传格式（multipart/form-data）到Webhook URL会被判定为无效负载，这和XML本身是否有效无关。

解决方案 #

方案1：将XML包装为Slack认可的JSON payload #

把XML内容作为文本嵌入到Slack要求的JSON结构中（比如text字段），并确保JSON格式合法：

# 在GitLab CI中执行的命令
curl -X POST \
  -H 'Content-Type: application/json' \
  -d "{\"text\": \"$(cat /PATH/TO/FILE/data.xml | sed 's/"/\\"/g' | tr '\n' ' ')\"}" \
  ${SLACK_WEBHOOK_URL}

• sed 's/"/\\"/g'：转义XML中的双引号，避免破坏JSON结构
• tr '\n' ' '：将XML中的换行替换为空格，防止JSON出现换行导致格式错误
• 确保${SLACK_WEBHOOK_URL}是正确的Slack Incoming Webhook地址

方案2：通过Slack Files API上传XML文件 #

如果需要将XML作为文件发送到频道，需使用Slack的Files Upload API（而非Incoming Webhook），需要提前获取拥有files:write权限的Bot Token：

# 在GitLab CI中执行的命令
curl -X POST \
  -H "Authorization: Bearer ${SLACK_BOT_TOKEN}" \
  -F file=@/PATH/TO/FILE/data.xml \
  -F channels=${SLACK_CHANNEL_ID} \
  https://slack.com/api/files.upload

• ${SLACK_BOT_TOKEN}：从Slack开发者平台获取的Bot Token
• ${SLACK_CHANNEL_ID}：目标频道的ID（可在Slack频道设置中查看）

额外排查步骤 #

• 验证CI runner中XML文件的存在性：在curl命令前添加cat /PATH/TO/FILE/data.xml，确认文件内容正确加载
• 检查JSON格式合法性：将生成的JSON payload复制到在线JSON校验工具中，排查转义或格式错误
• 确认URL类型：不要将Files API的请求发送到Incoming Webhook URL，反之亦然

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