配置解析失败时应区分可预期错误与必须暴露的异常，如FileNotFoundException走默认值，其他IOException仅warn；@Value默认值有盲区，推荐@ConfigurationProperties；用Optional过滤逻辑空值；统一封装数字解析避免散落try-catch。
配置解析失败时不做降级，应用就容易启动失败或运行异常。关键不是“捕获所有异常”，而是识别哪些错误可预期、可兜底，哪些必须暴露。
区分文件缺失和读取异常
用 Properties.load() 读取外部配置文件时，FileNotFoundException 是预期情况，应走默认值；而其他 IOException（如磁盘满、编码错）需记录 warn 日志但不中断流程：
- 别直接 new FileInputStream，改用 getResourceAsStream()，返回 null 表示资源未打包，直接设默认值
- 显式判断 instanceof FileNotFoundException，避免把严重 I/O 问题也当普通缺失处理
- 绝对不要 catch Exception —— 会吞掉 NullPointerException 等编程错误
@Value 默认值有盲区，慎用
@Value("${key:default}") 的冒号默认值只在 key 完全未配置时生效；一旦环境变量、命令行参数或配置中心把 key 设为空串或 "null" 字符串，它就会原样注入，不会触发 fallback。
Java注释规范Skills
下载
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- 推荐改用 @ConfigurationProperties，它的绑定逻辑会在类型转换后才应用默认值，对空字符串、"null" 字符串等更鲁棒
- 若必须用 @Value，建议配合 Objects.requireNonNullElse() 或三元判断二次校验
- 避免在 @Value 中写复杂表达式或嵌套占位符，默认值机制不支持这类 fallback
用 Optional 安全提取并过滤“逻辑空值”
从 Properties 或配置对象中取值时，null 只是表层风险，空字符串、空白字符、“null”字符串才是更常见的“假值”：
立即学习“Java免费学习笔记（深入）”；
- 用 Optional.ofNullable(config.getProperty("timeout")) 包装原始值
- 接 .filter(s -> !s.trim().isEmpty()) 排除语义上无效的字符串
- 再用 .map(Integer::parseInt).orElse(3000) 安全转数字；若 parse 失败，会抛 NumberFormatException，需在外层 try-catch 或改用工具类封装
- 需要动态降级逻辑（如查备用配置、打日志）时，用 orElseGet(() -> {...}) 延迟执行
统一数字解析，避免散落的 try-catch
Integer.parseInt()、Double.parseDouble() 遇到非法字符串直接抛 NumberFormatException，每个调用点都写 try-catch 易遗漏且难维护：
- 封装通用工具方法，如 NumberUtils.parseInt(str, 0)，内部判空 + trim + try-catch
- 对高频解析场景，可前置正则校验（如 str.matches("-?\d+")）减少异常开销，但非必需
- 注意：空字符串、null、纯空白、带单位的字符串（如 "100ms"）都会导致异常，工具方法要覆盖这些常见脏数据
