如何在Spring Boot应用的Dockerfile中读取Gradle属性

这个问题的核心原因是：Docker引擎会尝试解析Dockerfile中的${}语法，而不是让Gradle的dockerfile-plugin来替换这些变量。当你直接写${project.version}时，Docker认为这是它自己的环境变量，但找不到对应的定义，所以抛出了"missing ':' in substitution"的错误。

下面是两种可行的解决方案，基于你使用的org.sglahn:gradle-dockerfile-plugin：

方案一：使用插件内置的参数替换功能 #

该插件支持通过配置参数，在构建时替换Dockerfile中的占位符。具体操作如下：

1. 修改你的build.gradle，在dockerfile任务中添加参数映射：

dockerfile {
    // 保留你原有的其他配置（比如imageName等）
    parameters = [appVersion: project.version]
}

2. 修改你的Dockerfile，把${project.version}替换为插件会识别的占位符${appVersion}：

FROM openjdk:9
RUN mkdir -p /usr/local/configserver
ADD /build/libs/config-server-${appVersion}.jar /usr/local/configserver/
ADD run.sh run.sh
RUN chmod +x run.sh
CMD ./run.sh

当你执行Gradle构建时，插件会自动将${appVersion}替换为project.version的实际值。

方案二：通过Gradle Copy任务动态生成Dockerfile #

如果插件的参数替换不生效，你可以手动创建一个模板文件，让Gradle在构建前替换变量并生成最终的Dockerfile：

1. 将原Dockerfile重命名为Dockerfile.template，并把${project.version}替换为${version}：

FROM openjdk:9
RUN mkdir -p /usr/local/configserver
ADD /build/libs/config-server-${version}.jar /usr/local/configserver/
ADD run.sh run.sh
RUN chmod +x run.sh
CMD ./run.sh

2. 在build.gradle中添加一个Copy任务，负责生成最终的Dockerfile：

task prepareDockerfile(type: Copy) {
    from 'src/main/docker/Dockerfile.template' // 替换为你的模板文件实际路径
    into '.' // 生成的Dockerfile放在项目根目录，或dockerfile任务指定的目录
    expand(version: project.version)
}

// 让dockerfile任务依赖这个prepareDockerfile任务，确保先生成Dockerfile再构建镜像
dockerfile.dependsOn prepareDockerfile

执行构建时，Gradle会先运行prepareDockerfile任务，把模板中的${version}替换为实际版本号，生成可用的Dockerfile，之后再执行镜像构建。

为什么直接写${project.version}不行？ #

Docker本身会解析${VAR_NAME}格式的变量，它会尝试从构建上下文的环境变量或者--build-arg传入的参数中查找值。而project.version是Gradle的内部属性，Docker无法直接访问，所以会抛出解析错误。必须让Gradle在Docker处理文件之前完成变量替换。

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