Spring Boot 多环境配置隔离的核心是 Profile 机制配合文件命名规范与分阶段激活策略：application.yml 存共用配置，dev/test/prod 文件存环境独有配置；本地用 VM 参数或 Maven Profile 激活，打包时通过 Maven 资源过滤实现物理隔离，容器运行时用环境变量注入；启动时校验 profile 组合防误用。
Spring Boot 实现多环境配置隔离，核心是 Profile 机制配合规范的配置文件命名和明确的激活方式。关键不在“怎么写”，而在于“怎么隔离”——让 dev 配置进不了 prod 包，让 prod 配置在本地启动时根本不可见。
配置文件命名与结构要严格遵循约定
在 src/main/resources 下建立以下文件：
- application.yml：只放所有环境共用的基础配置（如应用名、日志格式、通用 Bean 参数）
- application-dev.yml：仅包含开发环境独有配置（本地数据库地址、H2 内存库、debug 日志级别、本地 Nacos 地址）
- application-test.yml：测试环境专用（独立测试库、Mock 外部服务开关）
- application-prod.yml：生产环境专属（云数据库连接池参数、生产 Redis 密码、关闭调试端点）
注意：不要在 application.yml 中直接写 spring.profiles.active=prod，这会埋下本地误启风险；默认可设为 dev，但更安全的做法是构建时才决定。
激活方式必须分场景选择，避免硬编码
不同阶段用不同激活手段，形成控制权分离：
sc-java-to-ts-interface
下载
将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。
立即学习“Java免费学习笔记（深入）”；
- 本地开发启动：IDE 运行配置里加 VM options：-Dspring.profiles.active=dev，或在 Maven 命令中加：-Pdev
- 打包部署时：用 Maven Profile 控制资源过滤，确保 JAR 包内只含目标环境配置（例如 prod 包不含 application-dev.yml）
- 容器运行时：通过环境变量注入，如 Docker 启动时加 -e SPRING_PROFILES_ACTIVE=prod
- 禁止在 application.yml 中静态写死 active：否则无法被外部覆盖，失去灵活性和安全性
构建阶段就要做物理隔离，不止逻辑切换
光靠运行时激活不够，必须从打包源头切断混用可能：
- 在 pom.xml 中定义 Maven Profile，例如
<id>prod</id>，并绑定resources:resources插件开启 filtering - 把 application.yml 中的 active 值写成占位符：
spring: profiles: active: '@environment@' - 构建时指定 profile：
mvn clean package -Pprod，Maven 自动将 @environment@ 替换为 prod，且只拷贝 application-prod.yml 相关内容 - 这样生成的 prod.jar 里根本没有 application-dev.yml，从物理上杜绝误连本地库的可能
启动时加一层守卫校验，防漏网之鱼
即使配置隔离了，仍需防止人为传错参数。可在启动类中加入环境校验逻辑：
- 读取当前激活的 profile 列表
- 若检测到同时激活了 dev 和 prod（比如误写成
--spring.profiles.active=dev,prod），直接抛异常终止启动 - 若在非本地环境（如服务器）检测到 dev profile，也拒绝启动
- 这类校验不依赖配置文件内容，而是基于运行时实际生效的 profile，真实可靠
