本文详解 Helidon MP（MicroProfile）环境下自定义 MpMetaConfigProvider 的完整实现流程，重点解决因混淆 io.helidon.config.Config 与 org.eclipse.microprofile.config.Config 导致的“Config source of type xxx is not supported”错误。

本文详解 helidon mp（microprofile）环境下自定义 `mpmetaconfigprovider` 的完整实现流程，重点解决因混淆 `io.helidon.config.config` 与 `org.eclipse.microprofile.config.config` 导致的“config source of type xxx is not supported”错误。

在 Helidon MP 应用中，自定义配置源（Custom Config Source）需严格遵循 MicroProfile Config 规范，并通过 Helidon 提供的扩展 SPI —— MpMetaConfigProvider 实现。常见失败原因并非代码逻辑错误，而是误用了 Helidon 原生配置 API（io.helidon.config.Config）来驱动 MicroProfile 配置机制，导致 MpMetaConfigProvider 实现类未被加载。

✅ 正确做法：使用 MicroProfile Config 标准入口

Helidon MP 的 MpMetaConfigProvider 仅在通过 ConfigProvider.getConfig() 创建的 org.eclipse.microprofile.config.Config 实例中生效。该方法会自动扫描 META-INF/services/io.helidon.config.mp.spi.MpMetaConfigProvider 并加载所有注册的提供者（包括你的 MyConfigProvider）。

因此，必须弃用 MetaConfig.config(...) 或 Config.create(...) 等 Helidon 原生构建方式，改用标准 MicroProfile 启动流程：

import org.eclipse.microprofile.config.Config;
import org.eclipse.microprofile.config.ConfigProvider;
import io.helidon.webserver.WebServer;
import io.helidon.webserver.Server;

public class Main {
    private static final String DEFAULT_CONFIG_FILE = "mp-meta-config.yaml";

    public static void main(String[] args) {
        // ✅ 正确：通过 MP 标准接口获取 Config，自动激活 MpMetaConfigProvider
        Config mpConfig = ConfigProvider.getConfig();

        Server server = Server.builder()
                .config(mpConfig)  // ← 接收 org.eclipse.microprofile.config.Config
                .build()
                .start();

        System.out.println("Server started on http://localhost:" + server.port());
    }
}

? 关键配置检查清单

确保以下五点全部满足，缺一不可：

1. SPI 文件注册正确
   src/main/resources/META-INF/services/io.helidon.config.mp.spi.MpMetaConfigProvider 内容为：

   your.package.name.MyConfigProvider

2. MpMetaConfigProvider 实现完整

   public class MyConfigProvider implements MpMetaConfigProvider {
       public static final String TYPE = "test-config-provider";
   
       @Override
       public Set<String> supportedTypes() {
           return Set.of(TYPE);
       }
   
       @Override
       public List<? extends ConfigSource> create(String type, Config config, String name) {
           if (TYPE.equals(type)) {
               Map<String, String> props = new HashMap<>();
               props.put("app.custom.value", "from-test-provider");
               return List.of(new MyConfigSource(props));
           }
           return List.of();
       }
   }

3. mp-meta-config.yaml 位置与内容合规
   放置于 src/main/resources/mp-meta-config.yaml，且启用发现机制：

   add-discovered-sources: true  # ← 必须为 true
   add-discovered-converters: false
   add-default-sources: true
   
   sources:
     - type: "environment-variables"
     - type: "system-properties"
     - type: "test-config-provider"  # ← 与 supportedTypes() 返回值一致

4. 依赖包含 Helidon MP Config 实现（Maven）

   <dependency>
       <groupId>io.helidon.config</groupId>
       <artifactId>helidon-config-mp</artifactId>
   </dependency>

5. 避免手动构建 io.helidon.config.Config 并桥接
   ❌ 错误示例（绕过 SPI 发现）：

   io.helidon.config.Config helidonConfig = Config.create(); // ← 不触发 MpMetaConfigProvider
   Config mpConfig = ConfigProviderResolver.instance()
       .getBuilder()
       .withSources(MpConfigSources.create(helidonConfig))
       .build();

   此方式虽可运行，但完全跳过 MpMetaConfigProvider 加载逻辑，自定义源不会生效。

? 补充说明：何时需要桥接？

仅当应用同时重度依赖 Helidon 原生配置能力（如动态重载、层级合并）和 MicroProfile 接口时，才考虑桥接方案。此时应显式调用 MpConfigSources.create(helidonConfig) 注册源，而非依赖 MpMetaConfigProvider。但本场景目标是“声明式注册自定义源”，故首选标准 ConfigProvider.getConfig()。

✅ 验证是否生效

启动后，在任意位置注入或获取配置：

Config config = ConfigProvider.getConfig();
String value = config.getValue("app.custom.value", String.class);
System.out.println(value); // 应输出 "from-test-provider"

若仍报错 Config source of type test-config-provider is not supported，请优先检查：

• MpMetaConfigProvider 类是否被 JVM 正确加载（确认包路径无拼写错误、无编译失败）；
• mp-meta-config.yaml 是否位于 classpath 根目录（非子目录）；
• Maven 构建后 target/classes/META-INF/services/... 文件是否存在且内容正确。

遵循以上规范，即可稳定启用 Helidon MP 的自定义配置源机制，实现灵活、可插拔的配置扩展能力。