-
Java sealed interface 扩展失败时，先检查 permits 中的类型是否可访问且确实直接 implements 或 extends 该接口，再核对 final、sealed、non-sealed 续封修饰符，最后区分 named module 与 unnamed module 的包边界。本文用最小编译矩阵逐项定位这些错误。
-
Java record 适合表达由多个字段组成的 Map key 值对象，因为它按组件生成 equals 和 hashCode；本文同时说明浅层不可变、集合组件和防御性拷贝的边界。
-
BigDecimal.divide 不指定舍入规则时，遇到 1/3 这类非终止小数会抛出 ArithmeticException。本文按金额小数位、有效数字和严格校验三种场景说明如何选择 scale、MathContext 与 RoundingMode。
-
Java HttpClient 没有直接的 multipart 表单构造器，需要自己处理 boundary、CRLF、文件段和长度。本文给出可计算长度的拼接方案，并说明大文件如何改用可重复创建的流式请求体。
-
CompletableFuture.allOf 只能告诉你一组并发任务的聚合结果失败，不能直接定位具体任务。本文用 handle 保存每个任务的标识、成功值和原始异常，再结合 allOf 生成可重试、可告警的失败清单。
-
Java Optional 的 empty 表示没有值，不等于异常。通过 map、filter 和 orElseThrow 的边界设计，可以保留真实故障并稳定处理缺省结果。
-
讲清 Java Stream 使用 groupingBy 搭配 maxBy 获取每组最大时间记录的方法，并比较 Optional 展平、toMap 合并、空值和并列时间的处理边界。
-
Java HttpClient 的 sendAsync 收到 404 时，future 通常会正常完成，因为 404 是合法 HTTP 响应而非传输异常。本文用代码区分状态码、超时、连接失败和响应体处理错误。
-
Java HttpClient 的 sendAsync 返回可取消的 CompletableFuture。本文区分请求级超时与业务主动取消，给出保留原始 future、定时 cancel、异常分类和响应体收尾的完整写法。
-
Java Stream 使用 groupingBy 分组后，可以把 mapping 放在下游收集器中提取每组指定字段；如果改用 toMap，还要明确重复键的合并策略，并检查并行收集的顺序与合并边界。
-
Java Stream 收集 Map 时，按键唯一性、重复键策略和并行语义选择 toUnmodifiableMap、带合并函数的 toMap 或 toConcurrentMap，再用 Map.copyOf 发布不可变快照。
-
多个 Java ModuleLayer 同时存在时，不要用父层、同名模块或类加载器是否相同来猜 reads 关系。本文用 Module.canRead、addReads、findModule 和 findLoader 建立可观察的判断方法。
-
Java 插件需要独立的类加载边界时，可以用 ModuleFinder 和 Configuration 解析模块图，再用 defineModulesWithManyLoaders 为不同插件模块建立独立 ClassLoader。本文说明父层、exports、可读性和常见加载失败的排查方法。
-
从异常中的模块与包名入手，区分 exports、opens 和读取关系，给出 Java 反射 setAccessible 失败的诊断代码与最小修复方案。
-
Java 模块反射报访问被拒绝时，先看调用是否需要深反射：exports 面向公开类型和成员，opens 面向运行时访问包内全部成员。本文用 module-info.java、--add-opens 和 Module API 给出排查与落地方法。
