如何在不同环境下为Docker与Docker-Compose配置正确的Profile

不需要创建多个Dockerfile，正确的做法是移除Dockerfile里硬编码的Profile配置，改用环境变量动态传递，这样同一个镜像就能适配不同环境。

1. 修改Dockerfile，去掉硬编码的Profile #

把原来的ENTRYPOINT改成读取环境变量的形式，容器启动时会优先使用docker-compose传入的环境变量，还可以设置默认值防止变量未定义：

FROM openjdk:17-oracle
ADD ./target/backend-0.0.1-SNAPSHOT.jar backend.jar
EXPOSE 8080
# 使用环境变量指定Profile，默认值设为default（可根据需求修改）
ENTRYPOINT ["sh", "-c", "java -jar -Dspring.profiles.active=${SPRING_PROFILES_ACTIVE:-default} backend.jar"]

这里用sh -c是为了让shell解析环境变量，如果用数组格式的ENTRYPOINT，shell不会自动解析变量，所以需要这种写法。

2. 拆分docker-compose文件，实现多环境配置 #

不用给每个环境写完整的独立文件，推荐用基础文件+环境专属文件的组合方式，减少重复配置：

• docker-compose.yml（基础通用配置）：

backend:
    container_name: backend
    image: backend
    build: ./backend
    restart: always
    deploy:
      restart_policy:
        condition: on-failure
        max_attempts: 15
    ports:
      - '8080:8080'
    environment:
      - MYSQL_ROOT_PASSWORD=DbPass3008
      - MYSQL_PASSWORD=DbPass3008
      - MYSQL_USER=DbUser
      - MYSQL_DATABASE=db
    depends_on:
      - mysql

• docker-compose.test.yml（测试环境专属配置）：

backend:
    environment:
      - SPRING_PROFILES_ACTIVE=test

• docker-compose.prod.yml（生产环境专属配置）：

backend:
    environment:
      - SPRING_PROFILES_ACTIVE=prod
      # 生产环境可覆盖数据库密码等敏感配置
      - MYSQL_PASSWORD=ProdDbPassxxx

3. 启动对应环境的服务 #

运行时通过-f参数组合基础文件和环境文件：

• 启动测试环境：

docker-compose -f docker-compose.yml -f docker-compose.test.yml up -d

• 启动生产环境：

docker-compose -f docker-compose.yml -f docker-compose.prod.yml up -d

为什么这么做？ #

• 镜像应该是环境无关的，硬编码Profile会导致一个镜像只能用在特定环境，完全浪费了Docker镜像的复用性。
• 用环境变量传递配置符合12-Factor应用的原则，把配置和代码彻底分离，更便于维护和部署。
• 拆分compose文件的方式，能让通用配置只维护一份，环境差异的配置单独管理，避免重复代码。

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