使用Jib为Gradle项目构建Docker镜像时遇镜像引用无效问题

1. 字符串插值未生效导致占位符残留 #

你的根模块build.gradle中，镜像地址使用单引号包裹：

image = 'registry.hub.docker.com/myUsername/${rootProject.name}'

Groovy中单引号字符串不会解析变量，${rootProject.name}会被当作字面量直接传入，导致镜像引用包含无效占位符，违反Docker命名规范。

修复：改用双引号包裹字符串，让Gradle解析变量：

image = "registry.hub.docker.com/myUsername/${rootProject.name}"

2. Docker镜像名称大小写不符合规范 #

Docker镜像引用的名称组件（斜杠分隔的部分）不允许包含大写字母，你的配置中myUsername包含大写字母U，触发格式校验错误。

修复：将用户名改为全小写格式：

image = "registry.hub.docker.com/myusername/${rootProject.name}"

3. 子模块setting.gradle的配置冲突 #

子模块client-service下存在独立的setting.gradle，其中设置rootProject.name = 'client-service'，会导致子模块执行jib任务时，rootProject.name被错误替换，同时多模块项目中子模块不应单独配置rootProject.name。

修复：删除子模块client-service下的setting.gradle文件，统一使用根模块的配置。

最终修正后的根模块build.gradle片段 #

jib {
    var tag = 'latest'
    from {
        image = 'eclipse-temurin:17.0.4.1_1-jre'
    }
    to {
        image = "registry.hub.docker.com/myusername/${rootProject.name}"
        tags = [tag]
    }
}

如果需要为每个子模块构建独立镜像，可在子模块build.gradle中覆盖镜像地址，比如client-service的配置：

jib {
    to {
        image = "registry.hub.docker.com/myusername/client-service"
    }
}

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