Micronaut 4.1.3使用@PropertySource加载自定义YAML文件报错求解决方案

AI 小北

2026-7-8

解决Micronaut 4.1.3中@PropertySource加载自定义YAML文件的类型不兼容问题

错误原因

Micronaut 4.x版本对@PropertySource注解的参数做了调整，默认参数类型为io.micronaut.context.annotation.Property[]，不再支持直接传入资源路径字符串，这就是触发类型不兼容错误的原因。

解决办法

使用@PropertySource的resources属性指定自定义YAML文件路径，再结合属性绑定注解将配置值注入到类字段中，以下是两种常见实现方式：

方式一：结合`@ConfigurationProperties`（推荐批量绑定）

import io.micronaut.context.annotation.ConfigurationProperties;
import io.micronaut.context.annotation.PropertySource;

@PropertySource(resources = "classpath:new.yaml")
@ConfigurationProperties("test") // 对应yaml文件中的属性前缀
public class TestConfig {
    private String first;

    // 必须提供Getter和Setter，Micronaut通过反射绑定属性
    public String getFirst() {
        return first;
    }

    public void setFirst(String first) {
        this.first = first;
    }
}

对应的new.yaml内容示例：

test:
  first: "自定义配置值"

方式二：结合`@Value`（适合单个属性注入）

import io.micronaut.context.annotation.PropertySource;
import jakarta.inject.Singleton;
import io.micronaut.core.value.annotation.Value;

@Singleton
@PropertySource(resources = "classpath:new.yaml")
public class TestConfig {
    @Value("${first}") // 直接引用yaml中的属性键
    private String first;

    public String getFirst() {
        return first;
    }
}

对应的new.yaml内容示例：