非Spring环境下如何向自定义yml资源文件传递指定环境变量

核心逻辑是自定义专属占位符规则，仅对匹配规则的字段做环境变量替换，其余静态配置完全保留原内容，不会被参数化。 #

第一步：定义占位符规则 #

不要使用通用的${}这类容易和其他配置语法冲突的标记，自定义一套独立规则即可，比如约定仅${ENV_环境变量名}格式的内容会被替换为对应环境变量，你的YML文件可以按如下方式书写：

data:
  id: '${ENV_SYSTEM_ID}'
  # 以下静态字段不会做任何替换，完全保留原值
  staticConfig1: "固定字符串值"
  staticConfig2: 8080
  nested:
    staticField: true

如果你想沿用之前尝试的{{system.id}}格式也可以，只需要调整后续的正则匹配规则即可，比如{{system.id}}对应读取SYSTEM_ID环境变量。 #

第二步：Java端实现加载替换逻辑 #

使用轻量的SnakeYAML库做YML解析（无Spring依赖，库体积极小），直接读取YML原始文本做正则替换，避免解析为对象后改动静态字段的类型或值：

import org.yaml.snakeyaml.Yaml;
import java.io.InputStream;
import java.nio.charset.StandardCharsets;
import java.util.regex.Matcher;
import java.util.regex.Pattern;

public class YmlEnvLoader {
    // 按自定义的占位符规则写正则，这里匹配${ENV_xxx}格式
    private static final Pattern ENV_PLACEHOLDER_PATTERN = Pattern.compile("\\$\\{ENV_(\\w+)}");

    /**
     * 加载带环境变量占位符的YML资源文件
     * @param resourcePath resources下的文件路径
     * @param configClazz 配置映射的类类型
     */
    public static <T> T loadConfig(String resourcePath, Class<T> configClazz) throws Exception {
        try (InputStream inputStream = YmlEnvLoader.class.getClassLoader().getResourceAsStream(resourcePath)) {
            // 读取YML原始文本，不提前解析
            String rawYmlContent = new String(inputStream.readAllBytes(), StandardCharsets.UTF_8);
            StringBuffer replacedContent = new StringBuffer();
            Matcher matcher = ENV_PLACEHOLDER_PATTERN.matcher(rawYmlContent);

            // 逐个替换匹配到的占位符
            while (matcher.find()) {
                String envVarName = matcher.group(1);
                String envVarValue = System.getenv(envVarName);
                if (envVarValue == null) {
                    throw new IllegalArgumentException("启动缺少必需环境变量: " + envVarName);
                }
                // 转义替换值里的特殊字符，避免破坏YML结构
                matcher.appendReplacement(replacedContent, Matcher.quoteReplacement(envVarValue));
            }
            matcher.appendTail(replacedContent);

            // 替换完成后再解析为目标配置对象
            Yaml yaml = new Yaml();
            return yaml.loadAs(replacedContent.toString(), configClazz);
        }
    }
}

适配自定义占位符格式说明 #

如果你要使用之前写的{{system.id}}格式，只需要修改正则和环境变量名转换逻辑即可，示例：

// 匹配{{system.xxx}}格式的占位符
private static final Pattern ENV_PLACEHOLDER_PATTERN = Pattern.compile("\\{\\{system\\.(\\w+)}}");

// 替换逻辑里把提取到的id转成大写下划线格式的环境变量名
String rawKey = matcher.group(1); // 提取到id
String envVarName = "SYSTEM_" + rawKey.toUpperCase(); // 拼接为SYSTEM_ID
String envVarValue = System.getenv(envVarName);

方案优势 #

• 无Spring依赖，仅依赖轻量的SnakeYAML库
• 仅替换你主动写了占位符的字段，其余静态配置完全不会被改动，不存在误替换风险
• 原始文本替换不会改变原有YML的字段类型，避免解析阶段的类型转换异常

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