application.yml中环境变量无法生效的原因及解决办法

问题现象 #

你的代码中，Java主类可正常打印环境变量DOCKER_IP的值，但Spring Boot的Cassandra自动配置无法解析该变量，导致驱动尝试连接127.0.0.1并报错。

相关代码 #

Java主类：

@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        System.out.println("The Env Var is "+ ((System.getenv("DOCKER_IP") == null || System.getenv("DOCKER_IP").equals("")) ? "Not Defined" : System.getenv("DOCKER_IP")));
        SpringApplication.run(Application.class, args);
    }
}

配置文件（application.yml）：

spring:
  cassandra:
    keyspace-name: "test"
    local-datacenter: "datacenter1"
    port: 9042
    contact-points:
      - ${DOCKER_IP}

运行现象 #

控制台正常输出：

The Env Var is 192.168.56.101

但Cassandra连接报错：

2023-10-30T14:10:50.073-04:00 WARN 22688 --- [ restartedMain] c.d.o.d.internal.core.ContactPoints : Ignoring invalid contact point ${DOCKER_IP}:9042 (unknown host ${DOCKER_IP})
Suppressed: io.netty.channel.AbstractChannel$AnnotatedConnectException: Connection refused: no further information: /127.0.0.1:9042
Caused by: java.net.ConnectException: Connection refused: no further information

原因 #

Spring Boot在解析Cassandra的contact-points列表配置时，变量${DOCKER_IP}未被正确替换为实际值，驱动将${DOCKER_IP}当作字面量主机名处理，无法识别后默认 fallback到localhost（127.0.0.1）尝试连接，最终导致连接失败。

这种情况通常源于YAML列表格式下的变量解析优先级或处理逻辑问题，Spring Boot的属性绑定机制对列表类型的变量解析存在延迟，导致驱动读取配置时变量还未被替换。

解决方法 #

方法1：将contact-points改为字符串形式 #

spring.cassandra.contact-points属性支持单个IP字符串或逗号分隔的多个IP字符串，单个IP场景下直接使用字符串形式即可，避免列表解析的问题：

spring:
  cassandra:
    keyspace-name: "test"
    local-datacenter: "datacenter1"
    port: 9042
    contact-points: ${DOCKER_IP}

方法2：使用SpEL表达式直接获取环境变量 #

在YAML列表中通过Spring表达式语言（SpEL）直接读取环境变量，确保变量被正确解析：

spring:
  cassandra:
    keyspace-name: "test"
    local-datacenter: "datacenter1"
    port: 9042
    contact-points:
      - "#{systemEnvironment['DOCKER_IP']}"

方法3：手动配置Cassandra连接 #

绕过Spring Boot的自动配置，手动创建CqlSession Bean，直接使用环境变量值：

import com.datastax.oss.driver.api.core.CqlSession;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class CassandraConfig {

    @Bean
    public CqlSession cqlSession() {
        String dockerIp = System.getenv("DOCKER_IP");
        // 可选：添加空值判断，避免空指针
        if (dockerIp == null || dockerIp.isEmpty()) {
            throw new IllegalArgumentException("环境变量DOCKER_IP未配置");
        }
        return CqlSession.builder()
                .withKeyspace("test")
                .withLocalDatacenter("datacenter1")
                .addContactPoint(dockerIp, 9042)
                .build();
    }
}

这种方式完全由你控制连接参数，确保环境变量被正确使用，同时可添加额外的参数校验逻辑。

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