如何从Docker Compose向Spring Boot传递列表型YAML配置属性？

你说得没错，直接重复定义同名环境变量肯定会被覆盖，后面的值会把前面的冲掉。不过不用重构你的Spring Boot配置，Spring Boot本身就支持通过带索引的环境变量命名来处理列表型的配置，完全能满足你的需求。

方法一：使用下标索引的环境变量（最推荐） #

Spring Boot的外部配置系统支持用[索引]的方式来指定列表中的元素，这样每个元素的属性都能被精准映射。你只需要把docker-compose.yml里的环境变量改成下面这样：

my-app:
  image: my-image
  ports:
    - 9002:9002
  environment:
    SPRING_PROFILES_ACTIVE: dev
    # 第一个目标系统
    HS_TARGETS[0]_NAME: system_a
    HS_TARGETS[0]_URL: https://system-a
    HS_TARGETS[0]_USERNAME: username_a
    HS_TARGETS[0]_PASSWORD: password_a
    # 第二个目标系统
    HS_TARGETS[1]_NAME: system_b
    HS_TARGETS[1]_URL: https://system-b
    HS_TARGETS[1]_USERNAME: username_b
    HS_TARGETS[1]_PASSWORD: password_b

这里的规则是：

• 用下划线替代配置里的点（比如hs.targets[0].name变成HS_TARGETS[0]_NAME）
• 大写所有字母
• 通过[0]、[1]这样的索引来区分列表中的不同元素

启动容器后，Spring Boot会自动把这些环境变量解析成hs.targets列表，和你原来在application.yml里定义的结构完全一致。

方法二：直接传递JSON格式的列表（备选方案） #

如果你觉得写多个环境变量太繁琐，也可以直接把整个列表以JSON字符串的形式传递给HS_TARGETS环境变量：

my-app:
  image: my-image
  ports:
    - 9002:9002
  environment:
    SPRING_PROFILES_ACTIVE: dev
    HS_TARGETS: >
      [
        {"name": "system_a", "url": "https://system-a", "username": "username_a", "password": "password_a"},
        {"name": "system_b", "url": "https://system-b", "username": "username_b", "password": "password_b"}
      ]

这种方式的好处是更简洁，但要注意JSON格式的正确性，比如引号、逗号不能错。另外，某些特殊字符可能需要额外转义，所以如果配置项比较复杂，还是推荐第一种方法。

总之，两种方法都不需要你修改Spring Boot的配置结构，直接调整docker-compose里的环境变量写法就能解决问题。

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