GitLab YAML配置Teams Webhook报错：curl提示URL格式错误

问题原因 #

curl: (3) <url> malformed和主机无法解析的错误，主要出在这几个地方：

• Webhook URL变量未正确引用，或者本身格式存在问题
• curl命令的引号嵌套导致JSON格式异常，或shell解析出错
• GitLab Runner的网络无法解析Teams相关域名

解决步骤 #

1. 确认Webhook URL的有效性 #

• 在CI脚本中添加echo命令，查看$TeamsWebhookUrl的实际输出：

  script:
    - echo "Webhook地址：$TeamsWebhookUrl"
    # 后续执行curl命令
  

  检查输出的URL是否完整，有无多余空格、换行或特殊字符。
• 给变量包裹双引号，避免shell将URL中的特殊字符（如&）拆分为多个参数：

  curl ... "$TeamsWebhookUrl"
  

2. 修正curl命令写法 #

原命令的引号嵌套易引发解析问题，且缺少Teams要求的请求头，调整为以下格式：

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "@type": "MessageCard",
    "themeColor": "#00FF00",
    "text": "testing the webhook"
  }' \
  "$TeamsWebhookUrl"

• 添加Content-Type: application/json请求头，这是Teams Webhook的必填项
• 简化JSON的引号写法，避免嵌套引号导致的shell解析错误

3. 排查网络解析问题 #

若URL确认无误但仍提示主机无法解析，检查GitLab Runner的网络配置：

• 在脚本中添加域名解析测试：

  script:
    - nslookup outlook.office.com
    # 执行curl命令
  

• 若解析失败，需确认Runner是否能访问外网，或是否需要配置代理（根据环境要求）

验证 #

调整后执行脚本，正常情况下curl返回值为0（注：curl请求成功的返回值为0，非0代表失败，建议确认预期返回值1是否有误），同时Teams收到内容为“testing the webhook”的通知，即为解决成功。

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