Jenkins流水线提交pom.xml至GitLab失败：URL格式错误排查求助

1. 先解决URL格式问题 #

错误提示直接指向URL非法，优先查这几点：

• 去掉URL末尾的斜杠：把https://gitlab.com/pop/my-web-app.git/改成https://gitlab.com/pop/my-web-app.git，部分Git版本对末尾斜杠的解析存在bug
• 检查URL是否有多余字符：比如前后的空格、中文引号、特殊符号，确保URL是纯英文无多余内容的字符串
• 核对路径拼写：确认pop是GitLab的组/用户名，my-web-app是正确的项目名，注意GitLab项目名区分大小写

2. 检查流水线提交脚本的完整性与正确性 #

确保提交流程的每一步都没出错：

• 提交前必须执行git add pom.xml，否则修改不会被纳入暂存区
• 提交命令要带明确的消息：git commit -m "Update pom.xml version"，避免无消息提交被Git拒绝
• Push时指定正确分支：比如git push origin main（或你使用的分支名），不要省略分支名，避免默认分支配置问题
• 如果用HTTPS协议提交，要把凭据嵌入URL，示例命令：

  git remote set-url origin https://${GIT_USERNAME}:${GIT_PASSWORD}@gitlab.com/pop/my-web-app.git
  git push origin main
  

  这里的${GIT_USERNAME}和${GIT_PASSWORD}是Jenkins凭据绑定的变量，确保变量名和你配置的一致

3. 排查Jenkins执行节点的环境问题 #

• 升级Git版本：老版本Git对HTTPS URL的解析兼容性差，把节点上的Git升级到2.30+的稳定版
• 测试节点网络：在Jenkins节点上手动执行curl https://gitlab.com，确认能正常访问GitLab，排除代理、防火墙拦截的问题
• 配置Git用户信息：执行git config --global user.name "Jenkins Bot"和git config --global user.email "jenkins@yourdomain.com"，Git需要这些信息才能生成提交记录

4. 再核对凭据配置 #

虽然你说凭据没问题，但再确认这两点：

• 如果用HTTPS方式，Jenkins凭据必须是「用户名+密码」类型，不能用SSH密钥凭据
• 确认凭据绑定是否生效：在流水线里临时加一句echo ${GIT_USERNAME}（不要打印密码），看变量是否能正常输出，避免变量名写错导致凭据没注入

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