如何在Dockerfile中修改Spring Boot WAR/JAR的application.properties配置

嘿，我来给你分享几个实用的办法，帮你在构建UAT环境的Docker镜像时替换掉Dev环境的Spring Boot配置：

方法1：直接替换JAR包内的配置文件 #

Spring Boot的JAR本质是压缩包，我们可以在Docker构建过程中解压它，替换内部的配置文件后重新打包。这种方法适合需要完全替换整个配置文件的场景。

修改后的Dockerfile示例： #

FROM openjdk:8
VOLUME /tmp

# 把提前准备好的UAT环境配置文件复制到容器临时目录
COPY uat-application.properties /tmp/uat-application.properties

# 解压原Dev环境的JAR包到临时目录
RUN unzip target/springboot-docker-mysql.jar -d /tmp/app

# 替换解压后的配置文件
RUN cp /tmp/uat-application.properties /tmp/app/BOOT-INF/classes/application.properties

# 重新打包成UAT环境的JAR
RUN cd /tmp/app && zip -r /springboot-docker-mysql-uat.jar .

EXPOSE 8083
ENTRYPOINT ["java","-jar","/springboot-docker-mysql-uat.jar"]

注意：需要把UAT环境的配置文件（命名为uat-application.properties）放在和Dockerfile同一目录下，里面写好UAT的数据库连接、端口等配置。

方法2：用外部配置文件覆盖（推荐） #

Spring Boot天然支持加载外部配置文件，且外部配置的优先级高于JAR内部的配置。这种方法不用修改JAR包本身，更符合Docker的最佳实践，也更灵活。

场景A：完全替换整个配置文件 #

FROM openjdk:8
VOLUME /tmp
ADD target/springboot-docker-mysql.jar springboot-docker-mysql.jar

# 复制UAT配置文件到容器指定目录
COPY uat-application.properties /opt/uat-config/application.properties

EXPOSE 8083
# 启动时指定加载外部配置文件
ENTRYPOINT ["java","-jar","springboot-docker-mysql.jar","--spring.config.location=/opt/uat-config/application.properties"]

场景B：只修改个别配置项（比如数据库信息） #

如果只需要改几个参数，直接用启动参数覆盖更省事：

FROM openjdk:8
VOLUME /tmp
ADD target/springboot-docker-mysql.jar springboot-docker-mysql.jar
EXPOSE 8083
# 启动时传入UAT环境的数据库配置，覆盖内部配置
ENTRYPOINT ["java","-jar","springboot-docker-mysql.jar", \
           "--spring.datasource.url=jdbc:mysql://uat-mysql-host:3306/test?useSSL=false", \
           "--spring.datasource.username=uat-testuser", \
           "--spring.datasource.password=uat-testuser@123"]

方法3：用构建参数动态替换配置项 #

如果不想维护多个配置文件，你可以在构建镜像时通过--build-arg传入UAT的配置参数，然后用sed命令动态替换JAR内的配置内容。

Dockerfile示例： #

FROM openjdk:8
VOLUME /tmp

# 定义构建时需要传入的参数
ARG DB_URL
ARG DB_USER
ARG DB_PASS

ADD target/springboot-docker-mysql.jar springboot-docker-mysql.jar

# 解压JAR、替换配置项、重新打包
RUN unzip springboot-docker-mysql.jar -d /tmp/app && \
    sed -i "s|spring.datasource.url =.*|spring.datasource.url = ${DB_URL}|" /tmp/app/BOOT-INF/classes/application.properties && \
    sed -i "s|spring.datasource.username =.*|spring.datasource.username = ${DB_USER}|" /tmp/app/BOOT-INF/classes/application.properties && \
    sed -i "s|spring.datasource.password =.*|spring.datasource.password = ${DB_PASS}|" /tmp/app/BOOT-INF/classes/application.properties && \
    cd /tmp/app && zip -r /springboot-docker-mysql-uat.jar .

EXPOSE 8083
ENTRYPOINT ["java","-jar","/springboot-docker-mysql-uat.jar"]

构建镜像时传入参数： #

docker build \
  --build-arg DB_URL=jdbc:mysql://uat-mysql:3306/test?useSSL=false \
  --build-arg DB_USER=uat-testuser \
  --build-arg DB_PASS=uat-testuser@123 \
  -t uat-springboot-app .

总结 #

• 如果需要完全替换配置，方法1和方法2都可行，但方法2更灵活（甚至可以在运行容器时挂载配置文件，不用重新构建镜像）。
• 如果只是修改少数配置项，方法2的场景B最便捷。
• 方法3适合需要动态生成配置的场景，不用维护多份配置文件。

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