在 Spring Boot 中，应通过 Spring Profiles + application-{profile}.yml 文件分离环境配置（如本地 8080、生产 5000），并使用 spring.profiles.active 指定生效配置，而非依赖 SERVER_PORT 环境变量覆盖，以确保配置可追溯、可复现、符合 Spring Boot 外部化配置优先级规范。

在 spring boot 中，应通过 spring profiles + `application-{profile}.yml` 文件分离环境配置（如本地 8080、生产 5000），并使用 `spring.profiles.active` 指定生效配置，而非依赖 `server_port` 环境变量覆盖，以确保配置可追溯、可复现、符合 spring boot 外部化配置优先级规范。

在 Spring Boot 应用中，端口配置不应硬编码在主配置文件中，也不应依赖操作系统级环境变量（如 SERVER_PORT=5000）进行临时覆盖——这会削弱配置的可维护性与环境一致性。推荐采用 Profile 驱动的外部化配置 方案，清晰划分开发、测试、生产等环境。

✅ 正确做法：基于 Profile 的 YAML 分离配置

1. 定义配置文件结构
   在 src/main/resources/ 下创建：

   • application.yml（主配置，设为默认生产行为）：

     spring:
       profiles:
         active: prod  # 默认启用 prod profile（可选，建议显式声明）

   • application-dev.yml（开发环境）：

     server:
       port: 8080
     logging:
       level:
         root: DEBUG

   • application-prod.yml（生产环境，如 AWS）：

     server:
       port: 5000
     logging:
       level:
         root: INFO

2. 启动时激活对应 Profile

   • 本地 IDEA 启动：在 Run Configuration → Environment variables 中添加
     SPRING_PROFILES_ACTIVE=dev
     或直接在 VM options 中写：
     -Dspring.profiles.active=dev
   • AWS 服务器运行 JAR：

     java -Dspring.profiles.active=prod -jar myapp.jar

     ✅ 此方式明确指定 profile，Spring Boot 会自动加载 application-prod.yml 并合并覆盖 application.yml 中同名属性。

     

     Spring Boot Actuator Analyzer

     分析Spring Boot Actuator端点的安全性、健康检查、指标暴露及生产配置——审计信息、健康状态和自定义端点。

     下载

⚠️ 注意事项与常见误区

• 不要混用 SERVER_PORT 和 Profile 配置：
  SERVER_PORT=5000 是 Spring Boot 的命令行参数级配置（优先级高于 YAML），虽能生效，但会绕过 profile 逻辑，导致配置意图不清晰、难以审计。应统一通过 profile 管理环境差异。

• 确保 profile 文件命名规范：
  必须为 application-{profile}.yml（或 .properties），且 {profile} 全小写（如 prod，非 PROD）。Spring Boot 对大小写敏感。

• Profile 激活方式优先级（由高到低）：
  命令行 --spring.profiles.active=xxx > JVM 系统属性 -Dspring.profiles.active=xxx > OS 环境变量 SPRING_PROFILES_ACTIVE=xxx > application.yml 中 spring.profiles.active 设置。

• 验证配置是否生效：
  启动日志中会明确打印：
  The following profiles are active: dev
  并显示最终绑定的端口：
  Tomcat started on port(s): 8080 (http)

? 总结

将端口等环境敏感配置交由 Spring Profiles 管理，是 Spring Boot 官方推荐的最佳实践。它使配置具备语义化（dev/prod）、可版本控制、可组合（支持多 profile 如 dev,mysql），并天然兼容 Maven Profile、CI/CD 变量注入。避免“一个 jar 多种行为靠运气”，而是“一个 jar 明确行为靠 profile”。

延伸阅读：Spring Boot 官方文档 - Externalized Configuration