Spring Boot项目部署至Google App Engine的配置属性设置

一、application.properties配置与GAE环境变量的关系 #

Spring Boot支持将环境变量直接映射为application.properties中的配置项，转换规则很简单：把配置项的点替换成下划线，同时转成大写即可。比如spring.datasource.url对应环境变量SPRING_DATASOURCE_URL，你示例里的所有配置项都可以用这种方式在GAE中配置。

二、在app.yaml中配置环境变量的示例 #

修改你的src/main/appengine/app.yaml，添加env_variables字段，将生产环境的配置转成环境变量：

runtime: java11
instance_class: B1
basic_scaling:
  max_instances: 4

env_variables:
  SPRING_DATASOURCE_URL: "jdbc:mysql://my_prod_db_host:my_prod_db_port/my_prod_db_name"
  SPRING_DATASOURCE_USERNAME: "my_prod_username"
  SPRING_DATASOURCE_PASSWORD: "my_prod_password"
  MYAPP_APP_JWT_EXPIRATION_MS: "3600000"
  MYAPP_APP_REFRESH_TOKEN_EXPIRATION_MS: "2419200000"
  SPRING_MAIL_USERNAME: "my_prod_email@gmail.com"

部署后，Spring Boot会自动读取这些环境变量，覆盖本地application.properties中的对应配置。

三、同一框架区分开发/生产环境的实现方案 #

完全可行，推荐两种实用方式：

方式1：使用Spring Profiles #

• 本地创建application-dev.properties，存放开发环境专属配置，原application.properties作为公共基础配置
• 在GAE的app.yaml中添加环境变量指定生产环境的profile：

  env_variables:
    SPRING_PROFILES_ACTIVE: "prod"
  

• 创建application-prod.properties（可放在src/main/resources目录），写入生产环境配置，部署时Spring Boot会自动加载对应profile的配置

方式2：环境变量直接覆盖 #

• 本地开发直接使用application.properties的配置
• GAE的app.yaml中设置生产环境的环境变量，Spring Boot会优先读取环境变量的值，自动覆盖本地配置，无需额外创建profile文件

注意事项 #

敏感信息（如数据库密码、邮箱密码）不建议直接明文写在app.yaml中，GAE推荐用Secret Manager存储，之后通过环境变量引用：

env_variables:
  SPRING_DATASOURCE_PASSWORD: "sm://my-secret-name"

部署前需要给GAE服务账号赋予Secret Manager的访问权限。

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