使用Gradle时带查询字符串的Ivy artifactPattern失效问题

我之前碰到过一模一样的情况！Gradle在处理带查询参数的Ivy仓库URL时，确实会出现解析偏差——它大概率把?branch=develop当成了路径的一部分，而非HTTP查询参数，导致请求的URL完全不符合TeamCity的要求。下面是两种经过验证的可行解决方案：

方案一：自定义Ivy仓库的Pattern布局 #

TeamCity的下载URL结构是固定的，我们可以把分支查询参数整合到Gradle的Ivy仓库pattern中，确保请求时参数被正确附加到URL末尾：

repositories {
    ivy {
        // 仅配置基础仓库地址，不要包含具体模块、版本和查询参数
        url "http://xyz:8888/httpAuth/repository/download"
        
        // 自定义资源路径模板，把分支参数直接嵌入
        patternLayout {
            artifact "[module]/[revision]/[classifier](.[ext])?branch=develop"
            // 如果项目需要拉取Ivy元数据文件，也可以添加对应的模板：
            // ivy "[module]/[revision]/ivy.xml?branch=develop"
        }
        
        // 配置TeamCity的认证信息，确保有权限访问资源
        credentials {
            username = "你的TeamCity用户名"
            password = "你的TeamCity密码或访问令牌"
        }
    }
}

这种方式的核心是让Gradle完全按照我们定义的路径模板去请求资源，避免它自动修改或解析URL结构。

方案二：使用URI对象直接构造完整URL #

如果你的模块结构比较固定，也可以直接用URI.create()构造包含查询参数的完整仓库URL，强制Gradle使用正确的URL格式：

repositories {
    ivy {
        // 直接传入带分支参数的完整URL模板
        uri(URI.create("http://xyz:8888/httpAuth/repository/download/[module]/[revision]/[classifier](.[ext])?branch=develop"))
        
        // 同样需要配置TeamCity认证信息
        credentials {
            username = "你的TeamCity用户名"
            password = "你的TeamCity密码或访问令牌"
        }
    }
}

这种方式跳过了Gradle对URL的自动拼接逻辑，直接传递完整的带参数模板，适合结构简单的仓库场景。

额外提醒 #

• 先确认你的TeamCity账号有对应分支资源的访问权限，可以用Postman带认证信息再验证一次请求是否正常。
• 如果需要动态切换分支，可以把分支名定义成Gradle属性，比如def branch = project.findProperty("teamcity.branch") ?: "develop"，然后在模板中引用${branch}即可。

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