Java App Engine 11项目app.yaml变量替换及多环境配置咨询

问题根因 #

你之前配置的全局<resources>节点默认仅会将过滤后的资源输出到${project.build.directory}/classes目录，而App Engine Maven插件默认直接读取src/main/appengine下的原始app.yaml文件，不会读取classes目录下的文件，因此变量替换不会生效。

可行解决方案 #

方案1：单app.yaml+Maven显式变量替换（推荐，无重复配置） #

仅需维护一份app.yaml，通过Maven插件显式触发过滤后输出到App Engine插件读取的目标目录即可：

1. 保留src/main/appengine/app.yaml，需要动态替换的字段用Maven属性占位符写法，例如VPC连接器配置：

vpc_access_connector:
  name: ${vpc.connector.name}
  egress_setting: all-traffic

2. 在pom.xml中添加maven-resources-plugin配置，显式在构建阶段处理该目录的过滤：

<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-resources-plugin</artifactId>
      <version>3.3.1</version>
      <executions>
        <execution>
          <phase>process-resources</phase>
          <goals>
            <goal>copy-resources</goal>
          </goals>
          <configuration>
            <!-- 输出到App Engine插件的 staging 读取目录 -->
            <outputDirectory>${project.build.directory}/appengine-staging</outputDirectory>
            <resources>
              <resource>
                <directory>src/main/appengine</directory>
                <filtering>true</filtering>
              </resource>
            </resources>
          </configuration>
        </execution>
      </executions>
    </plugin>
    <!-- 原有App Engine Maven插件配置无需修改 -->
  </plugins>
</build>

3. 不同Maven Profile中的属性配置保持不变，打包/部署时指定对应Profile即可自动完成变量替换，例如mvn package appengine:deploy -Pprod。

方案2：直接引用环境变量（无需Maven配置，适合CI/CD场景） #

App Engine的app.yaml原生支持引用部署环境的系统环境变量，语法为$环境变量名，示例：

vpc_access_connector:
  name: "projects/你的项目ID/locations/你的区域/connectors/$VPC_CONNECTOR_NAME"

部署前提前设置对应环境变量即可生效，例如生产环境部署：

export VPC_CONNECTOR_NAME=prod-vpc-connector
gcloud app deploy

方案3：多环境对应多份app.yaml（次选） #

如果需要隔离各环境配置，可按环境命名配置文件，例如app-test.yaml、app-ea.yaml、app-prod.yaml，在不同Maven Profile中配置插件将对应环境的配置文件复制为最终生效的app.yaml即可。

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