合理设计配置结构的核心是“可读、可查、可扩、可隔离”：按语义分组、环境物理隔离逻辑统一、敏感信息与运行时参数解耦、配置即契约并用类型安全约束输入。
合理设计配置结构，核心是让配置“可读、可查、可扩、可隔离”，而不是堆砌键值对。开发人员最怕的不是改配置，而是改错配置、找不到配置、不敢动配置。
按语义分组，避免扁平化键名
把相关配置聚合成逻辑单元，而不是用编号或模糊前缀硬凑。比如数据库连接，不要写成：
db1.url=db1.user=db1.password=...
db2.url=db2.user=db2.password=...
而应使用嵌套结构（YAML）或命名空间（Properties）表达归属关系：
- YAML 推荐写法：用层级明确归属，一眼看出哪组是哪个数据源
datasources:
primary:
url: jdbc:mysql://...
username: root
password: ****
backup:
url: jdbc:postgresql://...
username: app
password: ****- Properties 兼容写法：用点号分隔语义层级，比数字下标更易理解
datasource.primary.url=jdbc:mysql://... datasource.primary.username=root datasource.backup.url=jdbc:postgresql://... datasource.backup.username=app
这样新增一个数据源只需加几行，不用重编号、不破坏已有逻辑，也不需要翻文档猜含义。
环境配置物理隔离 + 逻辑统一
不同环境（dev/test/prod）的差异项必须分离，但共用部分要集中管理，避免重复和遗漏。
- 用
application.yml主文件定义通用配置（如日志级别、基础路径） - 用
application-dev.yml、application-prod.yml只覆盖变动项（如数据库地址、开关标志） - 启动时通过
spring.profiles.active=prod激活对应配置，无需改代码、不误触其他环境
禁止在 application.properties 中写死 db.url=localhost 再靠注释“上线时改这里”——那是埋雷，不是配置。
立即学习“Java免费学习笔记（深入）”；
敏感信息与运行时参数解耦
密码、密钥、令牌等不该出现在版本库中；动态参数（如定时任务间隔、限流阈值）应便于运维调整。
- 敏感字段用占位符 + 外部注入：
spring.datasource.password=${DB_PASSWORD:}，优先从环境变量或K8s Secret读取 - 可调参数单独归类，例如统一放在
app.features.*或app.schedule.*下，方便搜索和审计 - 为关键配置加注释说明用途、取值范围和影响，比如：
# 仅限0-100，值越大缓存命中率越高但内存占用上升
配置即契约：用类型安全约束输入
靠文档或约定不如靠代码约束。Spring Boot 的 @ConfigurationProperties 是关键工具。
- 定义 Java Bean 映射配置段，自动校验非空、范围、格式（如邮箱、URL）
- 配合
@Validated和自定义注解，启动时就报错，而不是运行时连不上数据库才暴露问题 - IDE 能自动提示字段，减少拼写错误；单元测试可直接 new 实例验证默认值是否合理
例如：AppConfig.java 绑定 app.logging.level，若配置写成 INFOX，启动失败并提示“不支持的日志级别”，比日志里静默降级更可靠。
