配置解析失败时应区分可预期错误与必须暴露的异常，如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”字符串才是更常见的“假值”：

• 用 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"）都会导致异常，工具方法要覆盖这些常见脏数据

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南