GitLab Release Job从Artifact文件读取URL失败求助

核心问题定位 #

你遇到的所有问题本质是artifact_url.txt中的URL带有隐藏回车符（\r），再结合GitLab CI变量引用、release块的解析规则共同导致的。以下是针对性解决步骤：

1. 清理URL中的隐藏字符（无需jq，用原生Shell命令） #

直接用tr命令删除文件里的回车、换行符，确保URL是纯有效字符串：

# 读取文件并清理所有回车、换行符，赋值给CI变量
ARTIFACT_URL=$(tr -d '\r\n' < artifact_url.txt)
# 验证清理结果，方便排查问题
echo "清理后的URL: $ARTIFACT_URL"

2. 正确在Release块中引用变量 #

不要在release块内直接执行命令读取文件，必须先在script块处理好变量，再在release块中引用：

release_job:
  stage: release
  script:
    - ARTIFACT_URL=$(tr -d '\r\n' < artifact_url.txt)
    - echo "已获取有效URL: $ARTIFACT_URL"
  release:
    tag_name: "v$CI_COMMIT_TAG"
    description: "Release v$CI_COMMIT_TAG"
    links:
      - name: "MSI安装包"
        url: "$ARTIFACT_URL"
  only:
    - tags

3. 替代方案：用release-cli直接发送（规避JSON解析错误） #

如果坚持用release-cli命令，清理后的URL直接作为转义JSON参数传入，避免隐藏字符破坏格式：

# 先清理URL
ARTIFACT_URL=$(tr -d '\r\n' < artifact_url.txt)
# 直接调用release-cli，用转义JSON字符串传递链接
release-cli create --tag-name "v$CI_COMMIT_TAG" \
  --description "Release v$CI_COMMIT_TAG" \
  --link "{\"name\":\"MSI安装包\",\"url\":\"$ARTIFACT_URL\"}"

4. 额外验证步骤（可选） #

在脚本中加入URL格式校验，提前排查问题：

if [[ $ARTIFACT_URL =~ ^https?:// ]]; then
  echo "URL格式验证通过"
else
  echo "URL格式无效，当前值: $ARTIFACT_URL"
  exit 1
fi

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