如何通过Maven POM传递属性至配置文件占位符？解决Spring启动报错

问题场景 #

将Spring应用部署到Kubernetes集群后，希望通过ConfigMap传递配置属性，但使用Maven构建时，应用启动报错无法解析占位符。使用@Value注解引用变量，在application.yaml中使用占位符并尝试通过Maven Profile传递属性，执行mvn clean install -Plocal后报错：

Caused by: java.lang.IllegalArgumentException: Could not resolve placeholder 'placeholderOne' in value "${placeholderOne}"

相关代码 #

application.yaml #

DATABASE_URL: ${placeholderOne}

pom.xml #

<profile>
    <id>local</id>
    <properties>
        <placeholderOne>url</placeholderOne>
    </properties>
</profile>

Controller.java #

@RestController
public class Controller {

    @Value("${DATABASE_URL}")
    private String dbUrl;

    @GetMapping("/endpointOne")
    public Greeting greeting() {
        return new Greeting(1, dbUrl);
    }

}

错误原因 #

你直接将Maven的占位符写入Spring配置文件，但Spring本身无法识别Maven的${placeholderOne}变量。Maven默认不会自动替换配置文件中的占位符，导致application.yaml中的${placeholderOne}原封不动保留，Spring启动时会尝试解析这个未定义的Spring占位符，从而抛出错误。

解决方案 #

方案一：让Maven构建时替换配置文件占位符（适合本地开发） #

修改pom.xml，添加资源过滤配置，让Maven处理application.yaml时替换其中的Maven属性：

<build>
    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <filtering>true</filtering>
            <includes>
                <include>application.yaml</include>
            </includes>
        </resource>
    </resources>
</build>

同时为避免与Spring占位符冲突，将application.yaml中的Maven占位符语法改为@变量名@：

DATABASE_URL: @placeholderOne@

执行mvn clean install -Plocal后，Maven会把@placeholderOne@替换为Profile中定义的url，生成的配置文件能被Spring正常解析。

方案二：适配Kubernetes ConfigMap的生产级方案（推荐） #

核心需求是部署到K8s后用ConfigMap传递配置，本地构建无需Maven替换占位符，而是让Spring支持从外部配置/环境变量取值：

1. 修改application.yaml，为占位符设置默认值（避免本地启动报错）：

DATABASE_URL: ${DATABASE_URL:default-local-db-url}

该语法表示：如果环境变量或外部配置存在DATABASE_URL则使用它，否则用默认值。

2. 本地开发时，创建application-local.yaml覆盖配置：

DATABASE_URL: local-dev-db-url

启动时激活local Profile（--spring.profiles.active=local），Spring会自动加载该文件。

3. K8s部署时，创建ConfigMap：

apiVersion: v1
kind: ConfigMap
metadata:
  name: app-config
data:
  DATABASE_URL: "k8s-cluster-db-url"

然后在Deployment中通过环境变量注入ConfigMap的值：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: app-deployment
spec:
  replicas: 1
  selector:
    matchLabels:
      app: my-app
  template:
    metadata:
      labels:
        app: my-app
    spec:
      containers:
      - name: my-app
        image: your-app-image:tag
        env:
        - name: DATABASE_URL
          valueFrom:
            configMapKeyRef:
              name: app-config
              key: DATABASE_URL

这种方式下，Maven构建无需处理占位符，Spring启动时会直接读取K8s注入的环境变量值。

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