Java中通过System.getenv()读取环境变量需注意空值处理、类型转换、默认值兜底和配置优先级；推荐封装为配置类，结合配置文件与硬编码默认值分层覆盖，并规避大小写敏感、启动时机限制等坑点。
Java 中通过 System.getenv() 读取环境变量是简单直接的方式，但要安全、可靠地映射为程序内部配置变量，需注意空值处理、类型转换、默认值兜底和配置优先级等细节。
基础用法：获取单个环境变量
直接传入变量名，返回字符串值（若不存在则返回 null）：
String dbUrl = System.getenv("DB_URL");
if (dbUrl != null && !dbUrl.trim().isEmpty()) {
// 使用 dbUrl
} else {
// 处理缺失情况，例如抛异常或设默认值
}
批量读取并映射为配置类
推荐将相关环境变量统一加载到一个配置类中，提升可维护性。例如：
public class AppConfig {
private final String dbUrl;
private final int port;
private final boolean debug;
public AppConfig() {
this.dbUrl = nonNull(System.getenv("DB_URL"), "jdbc:h2:mem:testdb");
this.port = parseInt(System.getenv("SERVER_PORT"), 8080);
this.debug = parseBoolean(System.getenv("DEBUG"), false);
}
private static String nonNull(String value, String defaultValue) {
return (value == null || value.trim().isEmpty()) ? defaultValue : value.trim();
}
private static int parseInt(String value, int defaultValue) {
try {
return Integer.parseInt(value.trim());
} catch (NumberFormatException | NullPointerException e) {
return defaultValue;
}
}
private static boolean parseBoolean(String value, boolean defaultValue) {
if (value == null || value.trim().isEmpty()) return defaultValue;
return Boolean.parseBoolean(value.trim());
}
// getter 方法...
}
结合配置优先级（环境变量 > 配置文件 > 硬编码默认值）
实际项目中建议分层覆盖，避免硬编码污染：
- 最优先：系统环境变量（如
DB_PASSWORD）——适合敏感信息或部署差异化 - 其次：外部配置文件（如
application.properties）——适合常规参数 - 最后：代码内默认值——仅作兜底，不用于生产关键配置
示例逻辑（简化版）：
String dbHost = System.getenv("DB_HOST");
if (dbHost == null) {
dbHost = properties.getProperty("db.host", "localhost"); // 从配置文件读
}
// 再次兜底可省略，因 properties 已含默认值
注意事项与避坑点
使用 System.getenv() 时容易忽略的关键细节：
-
大小写敏感：Linux/macOS 区分大小写，Windows 不区分，但建议统一用大写命名（如
API_TIMEOUT_MS） -
启动时机限制：JVM 启动后修改环境变量对已运行进程无效；容器中需在
ENTRYPOINT前注入 -
不可变性：
System.getenv()返回的是只读Map，不能写入，也不能通过它修改系统环境 -
测试友好性：单元测试中可通过
mock-static（如 Mockito 4.11+）或启动参数-Denv=dev+ 自定义解析器来模拟
