《Java 编程实战》10.3 异步边界:阻塞、上下文与可观测性
异步任务换线程之后,MDC 里的 requestId 会变成空,ThreadLocal 也读不到;InheritableThreadLocal 只在创建线程时复制一次,线程池复用后照样丢。本节用真实日志展示这三类丢失,给出 MdcExecutor 传递与清理方案,并讨论阻塞 JDBC、orTimeout 不取消上游、异常解包这几个边界。
category
异步任务换线程之后,MDC 里的 requestId 会变成空,ThreadLocal 也读不到;InheritableThreadLocal 只在创建线程时复制一次,线程池复用后照样丢。本节用真实日志展示这三类丢失,给出 MdcExecutor 传递与清理方案,并讨论阻塞 JDBC、orTimeout 不取消上游、异常解包这几个边界。
一次会员借阅详情要查借阅、会员和书目,串行是 600ms,并行是 210ms,但并行不等于无限扇出。本节用 thenCompose 表达两波依赖,用 allOf 合并独立查询,并把每本书一次查询的 N+1 改成一次 findByIsbns 批量查询,最后用信号量把数据库并发压回连接池能承受的范围。
CompletableFuture 不是把 Future 换个名字:thenApply、thenCompose、thenCombine 决定依赖关系,orTimeout 与 exceptionally 决定失败路径。本节用 500ms 任务配 200ms 超时、allOf 单任务失败等输出,说明超时不会取消上游、allOf 会等所有任务结束,再把并行查询接进 libraryd 搜索。
线程池满了之后,AbortPolicy 只会抛一个 RejectedExecutionException,调用方看到的却是 500。本节把队列深度、活跃线程数和拒绝计数变成可观测信号,用自定义拒绝处理器把过载映射成 503,并讨论 CallerRunsPolicy 为什么会把压力传回 Jetty 请求线程。
JDK 25 的虚拟线程早已不是预览特性。本节先在同一个 JVM 参数下对比 2000 个平台线程与 2000/100000 个虚拟线程的创建耗时和 RSS,再用 Javalin 7.2.4 的 concurrency.useVirtualThreads 打开虚拟线程,最后用 JFR 确认 synchronized 在 JDK 25 里不再 pin,并说明结构化并发为何仍不进入本卷。
libraryd 的阻塞查询不能直接跑在 Jetty 请求线程上。本节用 ThreadPoolExecutor 把核心线程数、最大线程数、有界队列和拒绝策略讲清楚,并用 2 个线程、3 个队列位的饱和实验展示第 5 个任务之后会发生什么,最后把线程池接进 AppMain 与优雅停机。
领域层抛 LibraryException,持久层抛 SQLException,web 层只认识 Problem Details。本节把三层翻译串起来:SQLState 怎么变成错误码,错误码怎么决定 HTTP 状态,异常处理器为什么按最具体类型匹配,以及 404、405 和处理器自己抛异常时会发生什么。
同样是 400,有的接口返回字符串,有的返回对象,客户端只能按状态码猜。本节按 RFC 9457 把 libraryd 的错误响应固定成 application/problem+json,讲清 type、title、status、detail 与扩展成员 code、requestId、errors,并用真实响应说明媒体类型被覆盖的坑。
libraryd 的 bodyAsClass 只负责解析,不负责判断字段是否为空、超长或越界。本节用 Jakarta Validation 3.1.1 与 Hibernate Validator 9.1.5 把约束写在 record 上,把 ConstraintViolation 收成字段错误 Map,并用真实输出说明 Expressly 缺失、null 与空白、消息语言和领域校验的分工。
进程收到 SIGTERM 时,libraryd 正在处理的借阅请求会不会被切断,连接池和定时任务会不会来不及收尾。本节用两次真实停机实验对比 stopTimeout=0 与 10 秒的差别,再给出 LibraryApplication 的关闭顺序、幂等关闭、启动失败回滚和 shutdown hook 的完整写法。
libraryd 的每个 handler 都在重复读请求头、拼日志、记耗时。本节用 Javalin 的 before/after 把请求 ID、MDC、访问日志和指标收进中间件,并用真实执行顺序说明异常处理器与 after 的先后关系,最后给出请求头信任、MDC 清理与指标基数的边界。
libraryd 的服务层已经能借书还书,却还没有 HTTP 入口。本节用 Javalin 7.2.4 把路由挂在配置对象上,接通路径参数、查询参数、分页默认值与 Jackson,并用真实请求验证 201、204、Location、日期序列化和内容类型检查,最后给出完整路由清单。
审计事件要按类型还原,领域对象互相引用又会让 Jackson 无限递归。本节真实复现多态类型丢失、嵌套深度 1002 的报错,并演示如何把事件安全写入 PostgreSQL 的 jsonb 列、再用宽松 mapper 读回,最后给出 libraryd 的 AuditEvent 与仓储写法。
领域 record 不是 API 契约:Loan 没有 status 和 overdueDays,请求直接绑定领域对象又会带来批量赋值。本节用 Jackson 真实输出设计 BookDto、LoanDto、PageResponse 与 ApiError,划清请求、响应和领域对象的边界。
HTTP 层不能靠字符串拼接生成 JSON。本节用 Jackson 2.22.4 真实演示 record 绑定、命名策略、JavaTimeModule 与 ISO-8601 日期,以及 FAIL_ON_UNKNOWN_PROPERTIES 的报错原文,最后把配置收进 libraryd 的单例 JsonSupport。
两个借阅请求同时通过「没有活动借阅」检查时,应用层的先查再插并不安全。本节用两个 JDBC 连接真实复现部分唯一索引冲突、条件更新幂等归还与死锁 40P01,并给出 libraryd 借阅、归还和批量写的最终写法,说明为什么 synchronized 在多实例下无效。
两个连接同时读写 loans 时,read committed 与 repeatable read 到底差在哪?本节用真实 PostgreSQL 输出拆开语句快照与事务快照,观察 xmin/xmax 与行锁等待,并给出 libraryd 报表查询与可重试事务的落地写法。
libraryd 的一次借阅要写会员和借阅两条 SQL,JDBC 默认的自动提交会让失败只回滚一半。本节用真实 PostgreSQL 演示 autoCommit=false、commit、rollback 与保存点,把事务边界收在服务方法上,并解释 25P02 与连接归还问题。
列表页、批量导入和借阅详情会把数据访问层的问题放大。本节实现 LIMIT/OFFSET 分页与总数统计,比较逐条插入、addBatch 和 reWriteBatchedInserts 的真实耗时,并用一次 JOIN 消灭活动借阅列表里的 N+1 查询。
小数据量下所有查询都很快,索引问题要等到十万行才暴露。本节用 EXPLAIN (ANALYZE, BUFFERS) 对比 Seq Scan、Index Scan 与 Bitmap Index Scan,给 libraryd 的模糊搜索和活动借阅补上 pg_trgm GIN 索引与部分索引。