Properties.load()不支持嵌套键，仅存储扁平字符串键值对；db.url是完整键名，db并非键；需手动前缀过滤提取子配置，不可直接解析层级；与@ConfigurationProperties无直接兼容性。
Properties.load() 读不到嵌套键？它根本不支持层级
Java 的 Properties 类本质是扁平的 String → String 映射，没有“多级配置”概念。所谓 db.url、cache.redis.host 这类带点的键名，只是字符串命名习惯，Properties 不会自动解析成树结构或嵌套对象。
常见错误现象：props.get("db") 返回 null，哪怕文件里写了 db.url=jdbc:h2:mem:test —— 因为 db 根本不是键，db.url 才是。
- 所有键都按字面量存入，
load()不做任何拆分或递归解析 - 如果你需要
getNested("db.url")或getSection("cache")，得自己实现或换库 - 用
stringPropertyNames()能看到全部原始键名，适合调试键是否加载成功
如何安全提取带点的键（比如 db.url）
手动按点分割容易出错：空值、越界、大小写不一致、前缀匹配误伤（db.url.test 被当成 db.url）。稳妥做法是先过滤再切分：
String prefix = "db.";
Set<String> keys = props.stringPropertyNames().stream()
.filter(k -> k.startsWith(prefix))
.collect(Collectors.toSet());
Map<String, String> dbConfig = new HashMap<>();
for (String key : keys) {
String subKey = key.substring(prefix.length()); // 得到 "url"、"user" 等
dbConfig.put(subKey, props.getProperty(key));
}
- 别用
getProperty("db.url")直接取——它只查完整键名，没问题；但想批量取db.*就必须遍历 - 注意前缀结尾的点号不能漏，否则会匹配到
dbx.url - 如果键名含转义点（如
file\.name=test.txt），Properties会自动处理，但你的前缀匹配逻辑得考虑反斜杠场景
Properties 和 Spring Boot 的 @ConfigurationProperties 冲突吗？
不冲突，但职责完全不同。Properties 是底层加载器，@ConfigurationProperties 是上层绑定机制。直接用 Properties 加载后传给 @ConfigurationProperties 会失败，因为后者依赖 Spring 的类型转换和元数据，不接受原始 Properties 实例。
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
- Spring Boot 默认用
ConfigDataLoader解析application.properties，内部也用Properties，但做了封装 - 如果你手写
new Properties().load(...)，然后想塞进@ConfigurationProperties类，行不通——得用BinderAPI 手动绑定 - 性能上无差异，但兼容性：原生
Properties支持 Java 6+，而@ConfigurationProperties要求 Spring Boot 2.2+
别在 properties 文件里写 JSON/YAML 风格值
有人把整个 Redis 配置写成一个键：redis.config={"host":"localhost","port":6379}，指望后续用 JSON 库解析。这看似省事，实则埋坑：
-
Properties会把花括号、冒号、引号当普通字符，但若值含换行或未转义等号，load()可能抛Invalid Unicode sequence - 中文、特殊符号需手动 Unicode 转义（
\u4f60\u597d），维护成本陡增 - 不如拆成独立键：
redis.host=localhost、redis.port=6379，清晰且无需额外解析
真要嵌套结构，就别硬撑 Properties，换 SnakeYAML 或 com.fasterxml.jackson.dataformat:jackson-dataformat-properties 更靠谱。
