如何通过操作系统环境变量为Spring Boot设置server.address属性？

我有一个Spring Boot项目，配置文件config/application.yaml内容如下：

server:
  address: ${SERVER_HOST}
  port: ${SERVER_PORT}

已在操作系统层面设置环境变量：

SERVER_HOST=127.0.0.1
SERVER_PORT=8080

但启动时出现类型转换错误，因为server.address对应的类型是java.net.InetAddress，错误信息如下：

Failed to bind properties under 'server.address' to java.net.InetAddress:

    Property: server.address
    Value: "${SERVER_HOST}"
    Origin: class path resource [config/application.yaml] - 20:12
    Reason: failed to convert java.lang.String to java.net.InetAddress (caused by java.net.UnknownHostException: ${SERVER_HOST})

请问如何正确配置，让环境变量值能转换为InetAddress？

解决方案 #

1. 先确认环境变量是否被正确加载 #

核心问题是Spring Boot没把${SERVER_HOST}替换为实际IP，而是把占位符当成了主机名解析。先验证环境变量是否能被进程读取：
在启动类中临时添加打印代码：

@SpringBootApplication
public class YourAppApplication {
    public static void main(String[] args) {
        System.out.println("SERVER_HOST: " + System.getenv("SERVER_HOST"));
        SpringApplication.run(YourAppApplication.class, args);
    }
}

如果打印为空，说明环境变量没生效：

• 终端设置环境变量后，需重启IDE或终端再启动项目
• Windows系统注意环境变量大小写（Spring Boot默认兼容，但建议保持与配置一致）

2. 修复配置文件语法（最常用解决方式） #

Spring Boot本身支持将字符串IP自动转为InetAddress，只需确保配置文件中变量解析正常：

• 移除可能存在的多余引号：如果配置写成address: "${SERVER_HOST}"（带双引号），会导致占位符不被解析，改为无引号写法：

server:
  address: ${SERVER_HOST}
  port: ${SERVER_PORT}

3. 备选：通过启动参数传递（绕过环境变量加载问题） #

如果环境变量加载存在问题，可直接在启动时通过JVM参数传递：

java -jar your-app.jar --server.address=${SERVER_HOST} --server.port=${SERVER_PORT}

或者直接写死IP测试：

java -jar your-app.jar --server.address=127.0.0.1 --server.port=8080

4. 极端场景：自定义类型转换器 #

如果上述方法都无效，可自定义String到InetAddress的转换器，强制解析占位符：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.convert.converter.Converter;

import java.net.InetAddress;
import java.net.UnknownHostException;

@Configuration
public class InetAddressConverterConfig {
    @Bean
    public Converter<String, InetAddress> stringToInetAddressConverter() {
        return source -> {
            try {
                // 解析占位符对应的环境变量
                if (source.startsWith("${") && source.endsWith("}")) {
                    String envKey = source.substring(2, source.length()-1);
                    String actualIp = System.getenv(envKey);
                    if (actualIp != null) {
                        return InetAddress.getByName(actualIp);
                    }
                }
                return InetAddress.getByName(source);
            } catch (UnknownHostException e) {
                throw new IllegalArgumentException("无效的IP地址: " + source, e);
            }
        };
    }
}

内容的提问来源于stack exchange，提问作者e-info128