vert.x 本身不支持 spring boot 风格的层级化配置绑定与环境变量 fallback，默认需手动读取系统变量；但通过 vert.x config 模块，可统一加载 yaml/json/properties 等格式配置，并自动融合环境变量、系统属性等多源值，实现 `${key:default}` 式占位符解析与优雅降级。
在 Vert.x 中实现类似 Spring Boot 的 application.yml 外部化配置（支持 EKS ConfigMap 注入 + 默认值 fallback），核心在于 Vert.x Config 模块 —— 它专为多源配置合并与动态解析而设计，远超 System.getenv().getOrDefault() 的简单封装。
✅ 步骤一：引入 Vert.x Config 依赖
Maven（以 Vert.x 4.x 为例）：
<dependency> <groupId>io.vertx</groupId> <artifactId>vertx-config</artifactId> <version>4.5.7</version> <!-- 请使用与您的 Vert.x 核心版本一致的版本 --> </dependency>
✅ 步骤二：定义结构化配置（YAML 格式）
创建 config.yaml（可置于 classpath 或挂载至容器 /etc/vertx/config.yaml）：
SUD:
BASEPATH: ${SUD_SERVICE_BASE_PATH:https://origin-sud.com}
MCS_BASEPATH: ${SUD_SERVICE_MCS_BASE_PATH:https://sud.com/}
MCS_TOKEN: ${SUD_SERVICE_MCS_TOKEN:a2341b8b-4ca5-4513-8c52-gf267bihbh}
MCS_SUBSCRIPTION_ENDPOINT: ${SUD_SERVICE_MCS_SUBSCRIPTION_ENDPOINT:/v1/manag}
HOST: ${SUD_SERVICE_HOST:sud.com}⚠️ 注意：此处 ${...:default} 是 Vert.x Config 原生支持的占位符语法（无需额外解析器），它会优先从环境变量读取，缺失时自动回退到冒号后的默认值。
✅ 步骤三：配置 Vert.x Config 实例（支持 EKS ConfigMap）
在 Vert.x 启动时构建 ConfigRetriever，按优先级顺序添加配置源（环境变量 > 文件 > 系统属性）：
import io.vertx.config.ConfigRetriever;
import io.vertx.config.ConfigRetrieverOptions;
import io.vertx.config.ConfigStoreOptions;
import io.vertx.core.Vertx;
import io.vertx.core.json.JsonObject;
public class AppConfigLoader {
public static void main(String[] args) {
Vertx vertx = Vertx.vertx();
// 1. 环境变量源（对应 EKS ConfigMap 注入的 SUD_SERVICE_*）
ConfigStoreOptions envStore = new ConfigStoreOptions()
.setType("env")
.setConfig(new JsonObject().put("prefix", "SUD_SERVICE_")); // 自动映射 SUD_SERVICE_BASE_PATH → BASE_PATH
// 2. YAML 文件源（提供默认值与结构）
ConfigStoreOptions fileStore = new ConfigStoreOptions()
.setType("file")
.setFormat("yaml")
.setConfig(new JsonObject().put("path", "config.yaml"));
ConfigRetriever retriever = ConfigRetriever.create(vertx,
new ConfigRetrieverOptions()
.addStore(envStore)
.addStore(fileStore)
);
// 加载并合并配置（自动解析 ${...:default}）
retriever.getConfig(ar -> {
if (ar.succeeded()) {
JsonObject config = ar.result();
System.out.println("Resolved config: " + config.encodePrettily());
// 输出示例（当 EKS 未注入任何变量时）：
// {
// "SUD": {
// "BASEPATH": "https://origin-sud.com",
// "MCS_BASEPATH": "https://sud.com/",
// ...
// }
// }
} else {
throw new RuntimeException("Failed to load config", ar.cause());
}
});
}
}✅ 步骤四：在路由或服务中安全使用配置值
避免硬编码解析，直接从 JsonObject config 提取嵌套路径：
String subscriptionEndpoint = config.getJsonObject("SUD")
.getString("MCS_SUBSCRIPTION_ENDPOINT"); // 自动 fallback 到 /v1/manag
router.get(subscriptionEndpoint).handler(ctx -> {
ctx.response().end("Handled via dynamic endpoint");
});? 关键优势与注意事项
- ✅ EKS 兼容性：Kubernetes ConfigMap 以环境变量形式挂载（如 SUD_SERVICE_BASE_PATH=https://prod-sud.com）后，Vert.x Config 会自动覆盖 YAML 中的默认值；
- ✅ 无侵入式 fallback：${KEY:default} 在 YAML 中声明即生效，无需 Java 层重复判断；
- ⚠️ 环境变量前缀必须匹配：setConfig(new JsonObject().put("prefix", "SUD_SERVICE_")) 是关键，否则 SUD_SERVICE_BASE_PATH 不会被映射到 SUD.BASEPATH；
- ⚠️ 类型安全需自行保障：Vert.x Config 返回 JsonObject，建议配合 JsonCodec 或 Jackson 封装为 POJO（可选增强）；
- ? 进阶提示：如需热重载（ConfigMap 更新后自动刷新），启用 watching 并监听 getConfigStream() 事件。
通过 Vert.x Config，你获得的不仅是“替代 System.getenv()”的写法，而是真正企业级的配置生命周期管理能力——结构清晰、来源透明、fallback 可靠，完美对齐 Spring Boot 的开发体验。
