[{"data":1,"prerenderedAt":21954},["ShallowReactive",2],{"java:java-oom-troubleshooting\u002F":3,"java-wiki-navigation":1288},{"id":4,"title":5,"body":6,"commentId":1274,"description":1275,"difficulty":1276,"draft":1277,"extension":1278,"meta":1279,"navigation":1280,"order":1281,"path":1282,"section":1283,"seo":1284,"stem":1285,"updated":1286,"__hash__":1287},"java\u002Fjava\u002Fjava-oom-troubleshooting.md","如果系统出现 OOM，应该如何处理？",{"type":7,"value":8,"toc":1227},"minimark",[9,13,17,21,49,52,55,64,67,81,84,88,94,97,193,200,204,207,226,229,232,236,241,244,271,275,278,288,291,294,300,303,307,408,411,417,420,443,446,450,453,457,467,471,474,480,483,489,495,499,502,508,512,515,535,538,544,548,551,554,571,581,585,611,615,618,621,635,638,642,645,665,668,702,705,711,714,718,721,724,747,750,770,773,777,780,810,813,841,844,848,851,868,871,875,937,940,944,947,964,967,984,987,1004,1007,1011,1014,1037,1040,1044,1048,1062,1065,1088,1091,1108,1112,1116,1119,1123,1126,1130,1133,1137,1140,1144,1147,1151,1189,1192,1223],[10,11,5],"h1",{"id":12},"如果系统出现-oom应该如何处理",[14,15,16],"h2",{"id":16},"面试回答",[18,19,20],"p",{},"系统发生 OOM 后，我会先止损并保留现场，而不是立即反复重启。首先确认影响范围，通过摘除故障实例、切换流量、限流或关闭非核心功能保护系统；同时保存 OOM 错误、应用日志、GC 日志、Heap Dump、容器事件和监控数据。证据保存完成后，再由进程托管系统重启或扩容恢复服务。",[18,22,23,24,28,29,32,33,36,37,40,41,44,45,48],{},"然后根据错误类型确定排查方向。",[25,26,27],"code",{},"Java heap space"," 和 ",[25,30,31],{},"GC overhead limit exceeded"," 重点分析堆；",[25,34,35],{},"Metaspace"," 重点检查类数量和 ClassLoader；",[25,38,39],{},"Direct buffer memory"," 重点检查直接内存和 Netty\u002FNIO Buffer；",[25,42,43],{},"unable to create native thread"," 重点检查线程数量、线程栈、系统限制和进程原生内存；容器出现 ",[25,46,47],{},"OOMKilled"," 时，还要检查进程 RSS、容器内存限制以及堆外内存，因为它不一定会留下 Java OOM。",[18,50,51],{},"堆内存问题通常使用 Heap Dump、对象直方图和 GC 日志分析。重点查看占用最大的对象、Retained Size、Dominator Tree 和到 GC Roots 的引用链，并结合老年代在 Full GC 后是否持续增长，区分内存泄漏、正常容量不足和单次超大对象分配。修复后需要用相同流量模型验证内存能否回落、GC 是否恢复正常，同时补齐自动 Dump、GC 日志、内存分区监控和容量告警。",[18,53,54],{},"一句话总结：",[56,57,58],"blockquote",{},[18,59,60],{},[61,62,63],"strong",{},"OOM 处理的主线是先止损、再留证、按内存区域分类定位，最后区分泄漏、容量不足和异常大对象，并通过同等流量验证修复。",[14,65,66],{"id":66},"一张图看懂",[18,68,69],{},[70,71,77],"a",{"href":72,"target":73,"rel":74},"\u002Fimages\u002Fwiki\u002Fjava\u002Fjava-oom-troubleshooting.svg","_blank",[75,76],"noopener","noreferrer",[78,79],"img",{"src":72,"alt":80},"Java OOM 止损、留证、分类定位、修复验证与预防流程",[14,82,83],{"id":83},"详细讲解",[14,85,87],{"id":86},"一oom-不等于-java-堆内存泄漏","一、OOM 不等于 Java 堆内存泄漏",[18,89,90,93],{},[25,91,92],{},"OutOfMemoryError"," 表示 JVM 无法满足某次资源申请，但发生问题的资源不一定是 Java 堆，也不一定存在泄漏。",[18,95,96],{},"常见类型如下：",[98,99,100,113],"table",{},[101,102,103],"thead",{},[104,105,106,110],"tr",{},[107,108,109],"th",{},"错误信息",[107,111,112],{},"主要排查方向",[114,115,116,126,135,144,154,163,172,182],"tbody",{},[104,117,118,123],{},[119,120,121],"td",{},[25,122,27],{},[119,124,125],{},"堆容量不足、对象泄漏、瞬时大对象",[104,127,128,132],{},[119,129,130],{},[25,131,31],{},[119,133,134],{},"堆长期接近耗尽，GC 频繁但回收效果很差",[104,136,137,141],{},[119,138,139],{},[25,140,35],{},[119,142,143],{},"类元数据过多、ClassLoader 泄漏、动态生成类失控",[104,145,146,151],{},[119,147,148],{},[25,149,150],{},"Compressed class space",[119,152,153],{},"压缩类指针空间不足",[104,155,156,160],{},[119,157,158],{},[25,159,39],{},[119,161,162],{},"NIO、Netty 等直接内存申请过多或释放不及时",[104,164,165,169],{},[119,166,167],{},[25,168,43],{},[119,170,171],{},"线程过多、线程栈占用过大、系统线程限制或原生内存不足",[104,173,174,179],{},[119,175,176],{},[25,177,178],{},"Requested array size exceeds VM limit",[119,180,181],{},"代码尝试创建超过 JVM 限制的超大数组",[104,183,184,190],{},[119,185,186,187,189],{},"容器 ",[25,188,47],{},"、退出码 137",[119,191,192],{},"进程总内存超过容器限制，不一定出现 Java OOM",[18,194,195,196,199],{},"因此，第一步不是直接调大 ",[25,197,198],{},"-Xmx","，而是先确认错误类型和耗尽的内存区域。",[14,201,203],{"id":202},"二第一阶段先止损","二、第一阶段：先止损",[18,205,206],{},"线上故障首先要控制影响范围：",[208,209,210,214,217,220,223],"ol",{},[211,212,213],"li",{},"从负载均衡中摘除异常实例，避免继续接收新流量；",[211,215,216],{},"有健康副本时切换流量或临时扩容；",[211,218,219],{},"对非核心接口限流、熔断或降级；",[211,221,222],{},"暂停可能持续放大内存的批处理、消费任务或大查询；",[211,224,225],{},"确认现场信息已经保存后，再重启异常实例。",[18,227,228],{},"是否立即重启取决于可用性和取证条件。如果服务已经不可用，并且有自动生成的 Heap Dump、GC 日志和监控数据，可以尽快重启恢复；如果没有任何证据且仍能安全操作，应先保留必要现场。",[18,230,231],{},"不要让已经发生严重 OOM 的进程长期勉强提供服务。此时进程可能持续 Full GC、请求超时，甚至无法创建用于自救的新线程。",[14,233,235],{"id":234},"三第二阶段保留现场","三、第二阶段：保留现场",[237,238,240],"h3",{"id":239},"_1-记录基本信息","1. 记录基本信息",[18,242,243],{},"至少保存：",[245,246,247,250,253,256,259,262,265,268],"ul",{},[211,248,249],{},"完整 OOM 错误和调用栈；",[211,251,252],{},"故障时间、实例、版本和流量变化；",[211,254,255],{},"JVM 启动参数；",[211,257,258],{},"GC 日志；",[211,260,261],{},"Heap Dump；",[211,263,264],{},"堆、元空间、直接内存、线程数和进程 RSS 监控；",[211,266,267],{},"容器事件、退出原因和内存限制；",[211,269,270],{},"故障前后的发布、配置和任务变更。",[237,272,274],{"id":273},"_2-提前配置自动-heap-dump","2. 提前配置自动 Heap Dump",[18,276,277],{},"生产环境应在启动时配置：",[279,280,286],"pre",{"className":281,"code":283,"language":284,"meta":285},[282],"language-text","-XX:+HeapDumpOnOutOfMemoryError\n-XX:HeapDumpPath=\u002Fdata\u002Fdumps\n","text","",[25,287,283],{"__ignoreMap":285},[18,289,290],{},"Dump 目录必须有足够空间和写权限，并有清理策略。Heap Dump 可能包含用户数据、令牌或业务字段，下载和保存时要遵守数据安全要求。",[18,292,293],{},"对于由进程托管系统负责自动拉起的无状态服务，可以评估：",[279,295,298],{"className":296,"code":297,"language":284,"meta":285},[282],"-XX:+ExitOnOutOfMemoryError\n",[25,299,297],{"__ignoreMap":285},[18,301,302],{},"它让 JVM 在 OOM 后退出，由 Kubernetes、systemd 等外部系统重启。是否使用取决于服务容灾能力，不能替代现场保留和根因修复。",[237,304,306],{"id":305},"_3-常用诊断命令","3. 常用诊断命令",[279,308,312],{"className":309,"code":310,"language":311,"meta":285,"style":285},"language-bash shiki shiki-themes github-light github-dark","jcmd \u003Cpid> VM.flags\njcmd \u003Cpid> GC.heap_info\njcmd \u003Cpid> GC.class_histogram\njcmd \u003Cpid> Thread.print\njcmd \u003Cpid> GC.heap_dump \u002Fdata\u002Fdumps\u002Fapp.hprof\n","bash",[25,313,314,341,357,373,389],{"__ignoreMap":285},[315,316,319,323,327,331,335,338],"span",{"class":317,"line":318},"line",1,[315,320,322],{"class":321},"sScJk","jcmd",[315,324,326],{"class":325},"szBVR"," \u003C",[315,328,330],{"class":329},"sZZnC","pi",[315,332,334],{"class":333},"sVt8B","d",[315,336,337],{"class":325},">",[315,339,340],{"class":329}," VM.flags\n",[315,342,344,346,348,350,352,354],{"class":317,"line":343},2,[315,345,322],{"class":321},[315,347,326],{"class":325},[315,349,330],{"class":329},[315,351,334],{"class":333},[315,353,337],{"class":325},[315,355,356],{"class":329}," GC.heap_info\n",[315,358,360,362,364,366,368,370],{"class":317,"line":359},3,[315,361,322],{"class":321},[315,363,326],{"class":325},[315,365,330],{"class":329},[315,367,334],{"class":333},[315,369,337],{"class":325},[315,371,372],{"class":329}," GC.class_histogram\n",[315,374,376,378,380,382,384,386],{"class":317,"line":375},4,[315,377,322],{"class":321},[315,379,326],{"class":325},[315,381,330],{"class":329},[315,383,334],{"class":333},[315,385,337],{"class":325},[315,387,388],{"class":329}," Thread.print\n",[315,390,392,394,396,398,400,402,405],{"class":317,"line":391},5,[315,393,322],{"class":321},[315,395,326],{"class":325},[315,397,330],{"class":329},[315,399,334],{"class":333},[315,401,337],{"class":325},[315,403,404],{"class":329}," GC.heap_dump",[315,406,407],{"class":329}," \u002Fdata\u002Fdumps\u002Fapp.hprof\n",[18,409,410],{},"原生内存跟踪需要在 JVM 启动时开启：",[279,412,415],{"className":413,"code":414,"language":284,"meta":285},[282],"-XX:NativeMemoryTracking=summary\n",[25,416,414],{"__ignoreMap":285},[18,418,419],{},"开启后可以查看：",[279,421,423],{"className":309,"code":422,"language":311,"meta":285,"style":285},"jcmd \u003Cpid> VM.native_memory summary\n",[25,424,425],{"__ignoreMap":285},[315,426,427,429,431,433,435,437,440],{"class":317,"line":318},[315,428,322],{"class":321},[315,430,326],{"class":325},[315,432,330],{"class":329},[315,434,334],{"class":333},[315,436,337],{"class":325},[315,438,439],{"class":329}," VM.native_memory",[315,441,442],{"class":329}," summary\n",[18,444,445],{},"在线执行对象直方图或 Heap Dump 可能引起停顿和大量磁盘 I\u002FO。操作前要确认磁盘空间、实例影响和可用副本，优先使用 OOM 时自动生成的 Dump。",[14,447,449],{"id":448},"四先判断是-jvm-oom还是容器-oomkilled","四、先判断是 JVM OOM，还是容器 OOMKilled",[18,451,452],{},"这两类问题经常被混淆。",[237,454,456],{"id":455},"jvm-oom","JVM OOM",[18,458,459,460,462,463,466],{},"JVM 自己发现某个资源无法继续分配，通常会在日志中出现具体的 ",[25,461,92],{},"。如果配置了自动 Dump，可能生成 ",[25,464,465],{},".hprof"," 文件。",[237,468,470],{"id":469},"容器-oomkilled","容器 OOMKilled",[18,472,473],{},"当进程总内存超过容器的 cgroup 限制时，操作系统可能直接杀掉进程。Kubernetes 中常见现象是：",[279,475,478],{"className":476,"code":477,"language":284,"meta":285},[282],"Reason: OOMKilled\nExit Code: 137\n",[25,479,477],{"__ignoreMap":285},[18,481,482],{},"这时进程可能来不及抛出 Java OOM，也可能没有 Heap Dump。容器计算的是进程总内存，不只是 Java 堆：",[279,484,487],{"className":485,"code":486,"language":284,"meta":285},[282],"进程总内存\n≈ Java Heap\n+ Metaspace\n+ Direct Memory\n+ 线程栈\n+ Code Cache\n+ JVM 原生结构\n+ 共享库和其他映射\n",[25,488,486],{"__ignoreMap":285},[18,490,491,492,494],{},"如果 ",[25,493,198],{}," 几乎等于容器内存上限，即使堆没有耗尽，也可能因为堆外空间、线程栈或 JVM 自身开销触发 OOMKilled。",[14,496,498],{"id":497},"五java-heap-space-如何分析","五、Java Heap Space 如何分析",[18,500,501],{},"堆 OOM 通常要回答三个问题：",[279,503,506],{"className":504,"code":505,"language":284,"meta":285},[282],"谁占用了内存？\n为什么没有被回收？\n占用是持续增长，还是一次性突增？\n",[25,507,505],{"__ignoreMap":285},[237,509,511],{"id":510},"_1-先看-gc-趋势","1. 先看 GC 趋势",[18,513,514],{},"重点观察：",[245,516,517,520,523,526,529,532],{},[211,518,519],{},"老年代使用量是否持续增长；",[211,521,522],{},"Full GC 是否越来越频繁；",[211,524,525],{},"Full GC 后内存能否明显下降；",[211,527,528],{},"对象分配速率是否突然升高；",[211,530,531],{},"晋升速率和大对象分配是否异常；",[211,533,534],{},"GC 停顿是否已经影响业务。",[18,536,537],{},"典型判断：",[279,539,542],{"className":540,"code":541,"language":284,"meta":285},[282],"Full GC 后老年代基线持续上升\n→ 更像对象泄漏或无上限缓存\n\nFull GC 后能够回落，但高峰期仍然耗尽\n→ 更像容量不足或瞬时流量过大\n\n内存突然被单次请求快速打满\n→ 检查超大数组、文件、结果集或批次\n",[25,543,541],{"__ignoreMap":285},[237,545,547],{"id":546},"_2-分析-heap-dump","2. 分析 Heap Dump",[18,549,550],{},"常用工具包括 Eclipse MAT、JDK Mission Control 和 VisualVM。",[18,552,553],{},"重点关注：",[245,555,556,559,562,565,568],{},[211,557,558],{},"Histogram：各类对象的实例数和浅堆大小；",[211,560,561],{},"Dominator Tree：哪些对象支配了大量内存；",[211,563,564],{},"Retained Size：删除某对象后理论上能够释放多少内存；",[211,566,567],{},"Path to GC Roots：对象为什么仍然可达；",[211,569,570],{},"Leak Suspects：工具给出的泄漏候选，需要结合业务验证。",[18,572,573,576,577,580],{},[25,574,575],{},"Shallow Size"," 只表示对象自身大小；",[25,578,579],{},"Retained Size"," 还包括只能通过该对象访问的其他对象。排查泄漏时，Retained Size 通常更有价值。",[237,582,584],{"id":583},"_3-常见堆泄漏来源","3. 常见堆泄漏来源",[245,586,587,590,593,596,599,602,605,608],{},[211,588,589],{},"没有容量上限或过期机制的本地缓存；",[211,591,592],{},"静态集合持续保存业务对象；",[211,594,595],{},"ThreadLocal 使用后没有清理；",[211,597,598],{},"监听器、回调或订阅关系只注册不注销；",[211,600,601],{},"队列无界，生产速度长期高于消费速度；",[211,603,604],{},"一次性加载超大文件、结果集或消息批次；",[211,606,607],{},"ORM 上下文、会话对象长期持有实体；",[211,609,610],{},"重试任务、Future 或上下文对象长期积压。",[14,612,614],{"id":613},"六gc-overhead-limit-exceeded-是什么","六、GC Overhead Limit Exceeded 是什么",[18,616,617],{},"这个错误表示 JVM 花费大量时间执行 GC，但回收出的空间很少。它通常是堆即将耗尽的结果，而不是一种独立内存区域。",[18,619,620],{},"排查方法与堆 OOM 基本一致：",[208,622,623,626,629,632],{},[211,624,625],{},"查看 Full GC 频率和回收前后占用；",[211,627,628],{},"分析 Heap Dump 中的主要存活对象；",[211,630,631],{},"检查是否存在内存泄漏或缓存、队列无上限；",[211,633,634],{},"检查堆容量是否与真实负载匹配。",[18,636,637],{},"只关闭 GC overhead 检查通常没有解决根因，只会让进程以另一种方式继续恶化。",[14,639,641],{"id":640},"七metaspace-oom-如何分析","七、Metaspace OOM 如何分析",[18,643,644],{},"Metaspace 保存类元数据。发生 OOM 时重点检查：",[245,646,647,650,653,656,659],{},[211,648,649],{},"已加载类数量是否持续增长；",[211,651,652],{},"是否频繁动态生成代理类、脚本类或字节码增强类；",[211,654,655],{},"是否存在大量无法卸载的 ClassLoader；",[211,657,658],{},"热部署、插件化或脚本引擎是否反复创建类加载器；",[211,660,661,664],{},[25,662,663],{},"-XX:MaxMetaspaceSize"," 是否设置得过小。",[18,666,667],{},"可以使用：",[279,669,671],{"className":309,"code":670,"language":311,"meta":285,"style":285},"jcmd \u003Cpid> VM.classloader_stats\njcmd \u003Cpid> GC.class_histogram\n",[25,672,673,688],{"__ignoreMap":285},[315,674,675,677,679,681,683,685],{"class":317,"line":318},[315,676,322],{"class":321},[315,678,326],{"class":325},[315,680,330],{"class":329},[315,682,334],{"class":333},[315,684,337],{"class":325},[315,686,687],{"class":329}," VM.classloader_stats\n",[315,689,690,692,694,696,698,700],{"class":317,"line":343},[315,691,322],{"class":321},[315,693,326],{"class":325},[315,695,330],{"class":329},[315,697,334],{"class":333},[315,699,337],{"class":325},[315,701,372],{"class":329},[18,703,704],{},"典型泄漏链路是：",[279,706,709],{"className":707,"code":708,"language":284,"meta":285},[282],"业务线程、ThreadLocal、静态对象或第三方库\n→ 持有自定义 ClassLoader\n→ ClassLoader 持有其加载的全部 Class\n→ 类元数据无法卸载\n",[25,710,708],{"__ignoreMap":285},[18,712,713],{},"简单调大 Metaspace 只能延迟故障。类数量持续增长时，应定位是哪个 ClassLoader 和动态类生成逻辑没有释放。",[14,715,717],{"id":716},"八direct-buffer-memory-如何分析","八、Direct Buffer Memory 如何分析",[18,719,720],{},"直接内存位于 Java 堆之外，常见使用者包括 NIO、Netty、压缩库和网络框架。",[18,722,723],{},"重点检查：",[245,725,726,729,735,738,741,744],{},[211,727,728],{},"DirectByteBuffer 数量和容量；",[211,730,731,734],{},[25,732,733],{},"-XX:MaxDirectMemorySize","；",[211,736,737],{},"Netty 池化内存和引用计数是否正确释放；",[211,739,740],{},"是否缓存了大量直接缓冲区；",[211,742,743],{},"是否存在大文件或网络数据的堆外缓冲；",[211,745,746],{},"进程 RSS 是否增长，但 Java 堆保持稳定。",[18,748,749],{},"如果启用了 NMT，可以通过：",[279,751,752],{"className":309,"code":422,"language":311,"meta":285,"style":285},[25,753,754],{"__ignoreMap":285},[315,755,756,758,760,762,764,766,768],{"class":317,"line":318},[315,757,322],{"class":321},[315,759,326],{"class":325},[315,761,330],{"class":329},[315,763,334],{"class":333},[315,765,337],{"class":325},[315,767,439],{"class":329},[315,769,442],{"class":329},[18,771,772],{},"查看 JVM 能追踪到的原生内存分类。需要注意，NMT 不能解释所有第三方原生库分配，仍要结合框架指标、进程 RSS 和操作系统工具分析。",[14,774,776],{"id":775},"九unable-to-create-native-thread-如何分析","九、Unable to Create Native Thread 如何分析",[18,778,779],{},"创建线程不仅需要 Java 对象，还需要原生线程和线程栈。常见原因包括：",[245,781,782,785,792,795,798,804,807],{},[211,783,784],{},"线程池配置失控或不断创建新线程；",[211,786,787,788,791],{},"使用 ",[25,789,790],{},"newCachedThreadPool()"," 等高上限线程池承接阻塞任务；",[211,793,794],{},"每个请求或任务都手动创建线程；",[211,796,797],{},"线程阻塞、死锁或下游超时，旧线程迟迟不能释放；",[211,799,800,803],{},[25,801,802],{},"-Xss"," 设置过大；",[211,805,806],{},"容器原生内存不足；",[211,808,809],{},"操作系统或容器的 PID、用户线程数限制。",[18,811,812],{},"排查时可以结合：",[279,814,816],{"className":309,"code":815,"language":311,"meta":285,"style":285},"jcmd \u003Cpid> Thread.print\nps -eLf\n",[25,817,818,832],{"__ignoreMap":285},[315,819,820,822,824,826,828,830],{"class":317,"line":318},[315,821,322],{"class":321},[315,823,326],{"class":325},[315,825,330],{"class":329},[315,827,334],{"class":333},[315,829,337],{"class":325},[315,831,388],{"class":329},[315,833,834,837],{"class":317,"line":343},[315,835,836],{"class":321},"ps",[315,838,840],{"class":839},"sj4cs"," -eLf\n",[18,842,843],{},"重点统计线程总数、线程名称分布和线程状态，确认是哪一个线程池或业务模块持续增长。解决方向通常是限制线程数量、使用有界队列、修复阻塞和超时、释放线程资源，而不是只调整系统线程上限。",[14,845,847],{"id":846},"十requested-array-size-exceeds-vm-limit","十、Requested Array Size Exceeds VM Limit",[18,849,850],{},"该错误通常说明代码尝试创建一个超过 JVM 可表示或可管理范围的数组，例如：",[245,852,853,856,859,862,865],{},[211,854,855],{},"根据错误长度计算数组容量；",[211,857,858],{},"整数溢出后得到异常容量；",[211,860,861],{},"一次性把超大文件读入 byte 数组；",[211,863,864],{},"一次性拼接超大字符串；",[211,866,867],{},"查询结果或批处理缺少分页。",[18,869,870],{},"这类问题的重点是定位申请数组的调用栈并修改数据处理方式，例如分页、流式读取、分块处理或限制单次请求大小。单纯增加堆通常无效。",[14,872,874],{"id":873},"十一如何区分泄漏容量不足和异常大对象","十一、如何区分泄漏、容量不足和异常大对象",[98,876,877,887],{},[101,878,879],{},[104,880,881,884],{},[107,882,883],{},"现象",[107,885,886],{},"更可能的原因",[114,888,889,897,905,913,921,929],{},[104,890,891,894],{},[119,892,893],{},"Full GC 后老年代基线仍持续上升",[119,895,896],{},"对象泄漏、无上限缓存或队列",[104,898,899,902],{},[119,900,901],{},"内存随流量上升，流量下降后能够回落",[119,903,904],{},"正常业务占用或容量不足",[104,906,907,910],{},[119,908,909],{},"某次请求后内存瞬间大幅增长",[119,911,912],{},"超大对象、文件、结果集或批次",[104,914,915,918],{},[119,916,917],{},"Java 堆稳定，但进程 RSS 持续增长",[119,919,920],{},"直接内存、线程栈或原生库",[104,922,923,926],{},[119,924,925],{},"类数量和 Metaspace 持续增长",[119,927,928],{},"ClassLoader 或动态类泄漏",[104,930,931,934],{},[119,932,933],{},"线程数持续增长并最终创建失败",[119,935,936],{},"线程泄漏、阻塞或线程池失控",[18,938,939],{},"判断不能只靠故障时的一张截图。应把 Heap Dump、GC 日志、时间序列监控、流量和发布记录结合起来。",[14,941,943],{"id":942},"十二修复时应该做什么","十二、修复时应该做什么",[237,945,946],{"id":946},"内存泄漏",[245,948,949,952,955,958,961],{},[211,950,951],{},"删除无效引用；",[211,953,954],{},"给缓存和集合增加容量、过期和清理策略；",[211,956,957],{},"正确清理 ThreadLocal、监听器和回调；",[211,959,960],{},"修复 ClassLoader、Buffer 或原生资源释放；",[211,962,963],{},"为队列和重试任务设置上限。",[237,965,966],{"id":966},"容量不足",[245,968,969,972,975,978,981],{},[211,970,971],{},"根据峰值存活对象和分配速率重新评估堆容量；",[211,973,974],{},"优化对象生命周期和数据结构；",[211,976,977],{},"降低单次批量大小；",[211,979,980],{},"扩容实例并重新分配流量；",[211,982,983],{},"调整容器上限时为堆外内存保留空间。",[237,985,986],{"id":986},"异常大对象或突发流量",[245,988,989,992,995,998,1001],{},[211,990,991],{},"限制请求体、文件、分页和批次大小；",[211,993,994],{},"使用流式处理代替一次性加载；",[211,996,997],{},"对大查询增加保护；",[211,999,1000],{},"在入口处限流和拒绝异常请求；",[211,1002,1003],{},"避免把外部积压无限转移到 JVM 内存。",[18,1005,1006],{},"调大内存可以作为临时止损手段，但必须建立在容量评估之上。存在泄漏时，内存越大通常只是让故障更晚发生。",[14,1008,1010],{"id":1009},"十三如何验证修复有效","十三、如何验证修复有效",[18,1012,1013],{},"修复后不能只确认“暂时没有再 OOM”，还要在接近真实的流量模型下验证：",[245,1015,1016,1019,1022,1025,1028,1031,1034],{},[211,1017,1018],{},"老年代在 GC 后能够回落并保持稳定；",[211,1020,1021],{},"对象数量不再无界增长；",[211,1023,1024],{},"Metaspace、直接内存和线程数保持在合理范围；",[211,1026,1027],{},"GC 频率、停顿和吞吐符合目标；",[211,1029,1030],{},"进程 RSS 与容器限制之间有足够余量；",[211,1032,1033],{},"高峰、降峰和长时间运行都没有持续爬升；",[211,1035,1036],{},"限流、降级和自动重启策略能够正确触发。",[18,1038,1039],{},"内存泄漏往往需要时间积累，短时间功能测试不能代替持续稳定性验证。",[14,1041,1043],{"id":1042},"十四上线前应该建立哪些预防能力","十四、上线前应该建立哪些预防能力",[237,1045,1047],{"id":1046},"jvm-证据","JVM 证据",[245,1049,1050,1053,1056,1059],{},[211,1051,1052],{},"开启 OOM 自动 Heap Dump；",[211,1054,1055],{},"保存并轮转 GC 日志；",[211,1057,1058],{},"记录 JVM 参数和应用版本；",[211,1060,1061],{},"在需要分析原生内存的服务上评估开启 NMT。",[237,1063,1064],{"id":1064},"监控告警",[245,1066,1067,1070,1073,1076,1079,1082,1085],{},[211,1068,1069],{},"Heap 各代使用量及 GC 后基线；",[211,1071,1072],{},"GC 次数、停顿和回收量；",[211,1074,1075],{},"Metaspace 和已加载类数量；",[211,1077,1078],{},"Direct Buffer 使用量；",[211,1080,1081],{},"线程总数和各线程池状态；",[211,1083,1084],{},"进程 RSS、容器 Working Set 和 OOMKilled；",[211,1086,1087],{},"队列长度、缓存数量、请求体和批次大小。",[237,1089,1090],{"id":1090},"容量与保护",[245,1092,1093,1096,1099,1102,1105],{},[211,1094,1095],{},"为容器总内存预留堆外空间；",[211,1097,1098],{},"缓存、队列、线程池和批次必须有明确上限；",[211,1100,1101],{},"大请求、大文件和大查询需要入口保护；",[211,1103,1104],{},"关键服务具备摘流、限流、降级和快速重启能力；",[211,1106,1107],{},"定期进行内存压测和故障演练。",[14,1109,1111],{"id":1110},"十五常见错误做法","十五、常见错误做法",[237,1113,1115],{"id":1114},"_1-一出现-oom-就把-xmx-调大","1. 一出现 OOM 就把 Xmx 调大",[18,1117,1118],{},"这可能暂时缓解容量不足，但无法修复泄漏、线程失控、直接内存或 ClassLoader 问题。",[237,1120,1122],{"id":1121},"_2-重启后不保留任何证据","2. 重启后不保留任何证据",[18,1124,1125],{},"重启会清空最重要的现场。至少应提前配置自动 Dump、GC 日志和监控。",[237,1127,1129],{"id":1128},"_3-只看-heap-dump不看时间趋势","3. 只看 Heap Dump，不看时间趋势",[18,1131,1132],{},"单份 Dump 能说明“当时谁占内存”，但不一定能证明谁在持续增长。需要结合多个时间点、GC 后基线和业务流量。",[237,1134,1136],{"id":1135},"_4-把容器内存全部分给-xmx","4. 把容器内存全部分给 Xmx",[18,1138,1139],{},"JVM 还需要 Metaspace、直接内存、线程栈和原生结构，容器必须保留余量。",[237,1141,1143],{"id":1142},"_5-在线高峰期随意执行重型诊断","5. 在线高峰期随意执行重型诊断",[18,1145,1146],{},"Heap Dump、对象直方图等操作可能产生停顿和磁盘压力，应评估实例状态、可用副本和磁盘空间。",[14,1148,1150],{"id":1149},"十六排查检查清单","十六、排查检查清单",[245,1152,1153,1156,1159,1162,1165,1168,1171,1174,1177,1180,1183,1186],{},[211,1154,1155],{},"OOM 的完整错误信息是什么；",[211,1157,1158],{},"是 JVM 抛出的 OOM，还是容器 OOMKilled；",[211,1160,1161],{},"故障发生在哪个内存区域；",[211,1163,1164],{},"是否保存了 Heap Dump、GC 日志和监控；",[211,1166,1167],{},"Full GC 后老年代能否回落；",[211,1169,1170],{},"最大对象及其 Retained Size 是多少；",[211,1172,1173],{},"对象通过什么引用链连接到 GC Roots；",[211,1175,1176],{},"类数量、ClassLoader、直接内存或线程数是否持续增长；",[211,1178,1179],{},"最近是否有发布、配置、流量或批量任务变化；",[211,1181,1182],{},"问题属于泄漏、容量不足还是异常大对象；",[211,1184,1185],{},"修复后是否在真实负载和长时间运行下验证；",[211,1187,1188],{},"是否补齐自动留证、监控告警和容量保护。",[14,1190,1191],{"id":1191},"参考资料",[245,1193,1194,1202,1209,1216],{},[211,1195,1196],{},[70,1197,1201],{"href":1198,"rel":1199},"https:\u002F\u002Fdocs.oracle.com\u002Fen\u002Fjava\u002Fjavase\u002F21\u002Ftroubleshoot\u002Ftroubleshooting-memory-leaks.html",[1200],"nofollow","Oracle Java Troubleshooting Guide：Troubleshoot Memory Leaks",[211,1203,1204],{},[70,1205,1208],{"href":1206,"rel":1207},"https:\u002F\u002Fdocs.oracle.com\u002Fen\u002Fjava\u002Fjavase\u002F21\u002Fdocs\u002Fspecs\u002Fman\u002Fjcmd.html",[1200],"Oracle Java Tools Reference：jcmd",[211,1210,1211],{},[70,1212,1215],{"href":1213,"rel":1214},"https:\u002F\u002Fdocs.oracle.com\u002Fen\u002Fjava\u002Fjavase\u002F21\u002Fvm\u002Fnative-memory-tracking.html",[1200],"Oracle Java Troubleshooting Guide：Native Memory Tracking",[211,1217,1218],{},[70,1219,1222],{"href":1220,"rel":1221},"https:\u002F\u002Feclipse.dev\u002Fmat\u002F",[1200],"Eclipse Memory Analyzer",[1224,1225,1226],"style",{},"html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}",{"title":285,"searchDepth":343,"depth":343,"links":1228},[1229,1230,1231,1232,1233,1234,1239,1243,1248,1249,1250,1251,1252,1253,1254,1259,1260,1265,1272,1273],{"id":16,"depth":343,"text":16},{"id":66,"depth":343,"text":66},{"id":83,"depth":343,"text":83},{"id":86,"depth":343,"text":87},{"id":202,"depth":343,"text":203},{"id":234,"depth":343,"text":235,"children":1235},[1236,1237,1238],{"id":239,"depth":359,"text":240},{"id":273,"depth":359,"text":274},{"id":305,"depth":359,"text":306},{"id":448,"depth":343,"text":449,"children":1240},[1241,1242],{"id":455,"depth":359,"text":456},{"id":469,"depth":359,"text":470},{"id":497,"depth":343,"text":498,"children":1244},[1245,1246,1247],{"id":510,"depth":359,"text":511},{"id":546,"depth":359,"text":547},{"id":583,"depth":359,"text":584},{"id":613,"depth":343,"text":614},{"id":640,"depth":343,"text":641},{"id":716,"depth":343,"text":717},{"id":775,"depth":343,"text":776},{"id":846,"depth":343,"text":847},{"id":873,"depth":343,"text":874},{"id":942,"depth":343,"text":943,"children":1255},[1256,1257,1258],{"id":946,"depth":359,"text":946},{"id":966,"depth":359,"text":966},{"id":986,"depth":359,"text":986},{"id":1009,"depth":343,"text":1010},{"id":1042,"depth":343,"text":1043,"children":1261},[1262,1263,1264],{"id":1046,"depth":359,"text":1047},{"id":1064,"depth":359,"text":1064},{"id":1090,"depth":359,"text":1090},{"id":1110,"depth":343,"text":1111,"children":1266},[1267,1268,1269,1270,1271],{"id":1114,"depth":359,"text":1115},{"id":1121,"depth":359,"text":1122},{"id":1128,"depth":359,"text":1129},{"id":1135,"depth":359,"text":1136},{"id":1142,"depth":359,"text":1143},{"id":1149,"depth":343,"text":1150},{"id":1191,"depth":343,"text":1191},"wiki:java:java-oom-troubleshooting","从线上止损、现场保留、OOM 类型识别、Heap Dump 与 GC 日志分析，到堆、元空间、直接内存、线程和容器内存定位，系统讲解 Java OOM 的处理方法。","advanced",false,"md",{},true,81,"\u002Fjava\u002Fjava-oom-troubleshooting","面试专题",{"title":5,"description":1275},"java\u002Fjava-oom-troubleshooting","2026-07-27","NLfKUvMArra1aAnmFEOyj0HCI3SGlCca8zCYRDGw7qY",[1289,2814,3732,5046,6077,7424,9180,10328,15077,16274,18352,21053],{"id":1290,"title":1291,"body":1292,"commentId":2804,"description":2805,"difficulty":1276,"draft":1277,"extension":1278,"meta":2806,"navigation":1280,"order":2807,"path":2808,"section":2809,"seo":2810,"stem":2811,"updated":2812,"__hash__":2813},"java\u002Fjava\u002Fjdk8-synchronized-lock-states.md","JDK 8 synchronized 设计与锁状态转换",{"type":7,"value":1293,"toc":2747},[1294,1298,1304,1315,1318,1324,1327,1329,1338,1343,1346,1351,1357,1361,1364,1370,1377,1380,1386,1389,1392,1440,1444,1447,1453,1459,1462,1471,1476,1480,1487,1501,1615,1621,1627,1630,1633,1639,1642,1646,1652,1655,1661,1668,1671,1704,1708,1711,1714,1717,1721,1724,1727,1734,1737,1742,1746,1749,1755,1758,1761,1764,1770,1773,1776,1779,1785,1788,1794,1800,1804,1811,1814,1820,1823,1834,1837,1840,1843,1849,1852,1855,1858,1862,1865,1868,1872,1875,1879,1882,1886,1889,1892,1897,1901,1904,1906,1909,1912,1918,1921,1924,1927,1931,1945,1948,1954,1957,1963,1966,1972,1975,1979,1982,1986,1989,1992,1995,2001,2007,2011,2014,2020,2023,2029,2032,2035,2039,2042,2056,2059,2062,2068,2071,2077,2081,2088,2094,2097,2103,2106,2109,2123,2126,2130,2135,2141,2147,2156,2161,2165,2168,2171,2189,2192,2195,2198,2202,2378,2382,2386,2392,2396,2399,2405,2408,2412,2418,2422,2425,2496,2499,2606,2609,2635,2638,2644,2647,2653,2657,2661,2664,2668,2671,2675,2678,2682,2685,2689,2692,2696,2699,2703,2733,2736,2744],[14,1295,1297],{"id":1296},"一先给出整体结论","一、先给出整体结论",[18,1299,1300,1303],{},[25,1301,1302],{},"synchronized"," 是 Java 语言提供的内置同步机制。它在语义上负责三件事：",[245,1305,1306,1309,1312],{},[211,1307,1308],{},"同一时刻只允许满足条件的线程进入临界区；",[211,1310,1311],{},"支持同一线程重复获取同一把锁，也就是可重入；",[211,1313,1314],{},"解锁 happens-before 后续对同一 Monitor 的加锁，保证相关共享数据的可见性和有序性。",[18,1316,1317],{},"在 JDK 8 HotSpot 中，为了避免所有同步操作都直接阻塞线程，JVM 会根据竞争情况使用不同实现：",[279,1319,1322],{"className":1320,"code":1321,"language":284,"meta":285},[282],"偏向锁：同一个线程反复进入，尽量避免原子操作\n轻量级锁：线程交替执行或短暂竞争，使用栈上 Lock Record 和 CAS\n重量级锁：竞争较强或必须使用 Monitor 能力时，通过 ObjectMonitor 管理等待线程\n",[25,1323,1321],{"__ignoreMap":285},[18,1325,1326],{},"通常所说的“无锁、偏向锁、轻量级锁、重量级锁”，是对对象头及其关联同步结构的概括，不是 Java 语言规范定义的四种锁类型。",[14,1328,66],{"id":66},[18,1330,1331],{},[70,1332,1335],{"href":1333,"target":73,"rel":1334},"\u002Fimages\u002Fwiki\u002Fjava\u002Fjdk8-synchronized-state-transitions.svg",[75,76],[78,1336],{"src":1333,"alt":1337},"JDK 8 synchronized 锁状态转换总览",[56,1339,1340],{},[18,1341,1342],{},"图中信息较多，可点击图片查看原图。",[18,1344,1345],{},"需要先纠正一个常见说法：",[56,1347,1348],{},[18,1349,1350],{},"“锁只能升级，不能降级”适合帮助理解竞争路径，但并不严谨。",[18,1352,1353,1354],{},"轻量级锁正常释放后会通过 CAS 恢复对象原来的 Mark Word；已经膨胀的 ObjectMonitor 也可能在后续安全点被 JVM 回收。更准确的说法是：",[61,1355,1356],{},"持锁竞争过程中通常不会为了当前请求立即从重量级锁退回轻量级锁，但对象状态并非终身只能单向变化。",[14,1358,1360],{"id":1359},"二synchronized-在字节码中的入口","二、synchronized 在字节码中的入口",[18,1362,1363],{},"同步代码块通常编译为：",[279,1365,1368],{"className":1366,"code":1367,"language":284,"meta":285},[282],"monitorenter\n 临界区代码\nmonitorexit\n",[25,1369,1367],{"__ignoreMap":285},[18,1371,1372,1373,1376],{},"编译器会为正常返回和异常退出路径生成对应的 ",[25,1374,1375],{},"monitorexit","，保证退出同步块时释放锁。",[18,1378,1379],{},"同步方法不会在方法体中出现这两个指令，而是在方法访问标志中使用：",[279,1381,1384],{"className":1382,"code":1383,"language":284,"meta":285},[282],"ACC_SYNCHRONIZED\n",[25,1385,1383],{"__ignoreMap":285},[18,1387,1388],{},"JVM 在调用和返回同步方法时完成 Monitor 的进入与退出。",[18,1390,1391],{},"无论入口是哪一种，最终都围绕同一个锁对象工作：",[98,1393,1394,1404],{},[101,1395,1396],{},[104,1397,1398,1401],{},[107,1399,1400],{},"写法",[107,1402,1403],{},"实际锁对象",[114,1405,1406,1417,1429],{},[104,1407,1408,1411],{},[119,1409,1410],{},"实例同步方法",[119,1412,1413,1414],{},"当前实例 ",[25,1415,1416],{},"this",[104,1418,1419,1422],{},[119,1420,1421],{},"静态同步方法",[119,1423,1424,1425,1428],{},"当前类对应的 ",[25,1426,1427],{},"Class"," 对象",[104,1430,1431,1434],{},[119,1432,1433],{},"同步代码块",[119,1435,1436,1439],{},[25,1437,1438],{},"synchronized (...)"," 中指定的对象",[14,1441,1443],{"id":1442},"三对象头与-mark-word","三、对象头与 Mark Word",[18,1445,1446],{},"普通 Java 对象的对象头主要包含：",[279,1448,1451],{"className":1449,"code":1450,"language":284,"meta":285},[282],"Mark Word\nKlass Pointer\n",[25,1452,1450],{"__ignoreMap":285},[18,1454,1455,1456,1458],{},"数组对象还会额外保存数组长度。",[25,1457,1302],{}," 的关键状态主要编码在 Mark Word 中。",[18,1460,1461],{},"以 JDK 8、64 位 HotSpot 为例，Mark Word 会复用同一段空间：",[18,1463,1464],{},[70,1465,1468],{"href":1466,"target":73,"rel":1467},"\u002Fimages\u002Fwiki\u002Fjava\u002Fjdk8-synchronized-mark-word.svg",[75,76],[78,1469],{"src":1466,"alt":1470},"JDK 8 HotSpot Mark Word 与同步结构",[56,1472,1473],{},[18,1474,1475],{},"可点击图片查看完整尺寸。",[237,1477,1479],{"id":1478},"统一按最低-3-位阅读","统一按最低 3 位阅读",[18,1481,1482,1483,1486],{},"为了避免一会儿看 2 位、一会儿看 3 位，本文后续统一展示 Mark Word 的最低 ",[61,1484,1485],{},"3 位","。但要先区分“展示宽度”和“字段含义”：",[245,1488,1489,1495,1498],{},[211,1490,1491,1492,734],{},"真正的锁标志始终是最低 ",[61,1493,1494],{},"2 位",[211,1496,1497],{},"只有普通未锁定和偏向布局会把倒数第 3 位解释成“偏向位”；",[211,1499,1500],{},"轻量级锁、重量级锁保存的是对齐后的指针，本文把其最低 3 位也完整写出，但倒数第 3 位不再表示偏向。",[98,1502,1503,1519],{},[101,1504,1505],{},[104,1506,1507,1510,1513,1516],{},[107,1508,1509],{},"最低 3 位",[107,1511,1512],{},"最低 2 位锁标志",[107,1514,1515],{},"状态",[107,1517,1518],{},"倒数第 3 位如何解释",[114,1520,1521,1542,1561,1579,1597],{},[104,1522,1523,1528,1533,1536],{},[119,1524,1525],{},[25,1526,1527],{},"001",[119,1529,1530],{},[25,1531,1532],{},"01",[119,1534,1535],{},"普通未锁定",[119,1537,1538,1539],{},"偏向位为 ",[25,1540,1541],{},"0",[104,1543,1544,1549,1553,1556],{},[119,1545,1546],{},[25,1547,1548],{},"101",[119,1550,1551],{},[25,1552,1532],{},[119,1554,1555],{},"可偏向或已偏向",[119,1557,1538,1558],{},[25,1559,1560],{},"1",[104,1562,1563,1568,1573,1576],{},[119,1564,1565],{},[25,1566,1567],{},"000",[119,1569,1570],{},[25,1571,1572],{},"00",[119,1574,1575],{},"轻量级锁",[119,1577,1578],{},"对齐后的 Lock Record 指针低位，不是偏向位",[104,1580,1581,1586,1591,1594],{},[119,1582,1583],{},[25,1584,1585],{},"010",[119,1587,1588],{},[25,1589,1590],{},"10",[119,1592,1593],{},"重量级锁",[119,1595,1596],{},"对齐后的 ObjectMonitor 指针低位，不是偏向位",[104,1598,1599,1604,1609,1612],{},[119,1600,1601],{},[25,1602,1603],{},"011",[119,1605,1606],{},[25,1607,1608],{},"11",[119,1610,1611],{},"GC 标记",[119,1613,1614],{},"标记状态的一部分，不是偏向位",[18,1616,1617,1618,1620],{},"因此 ",[25,1619,1548],{}," 应当拆开读成：",[279,1622,1625],{"className":1623,"code":1624,"language":284,"meta":285},[282],"偏向位 1 ｜ 锁标志 01\n",[25,1626,1624],{"__ignoreMap":285},[18,1628,1629],{},"它不是一个三位的“锁标志”。本文使用三位只是为了让所有状态在图表中对齐、便于比较。",[18,1631,1632],{},"其中偏向状态可以继续区分：",[279,1634,1637],{"className":1635,"code":1636,"language":284,"meta":285},[282],"匿名偏向：线程指针为空，允许第一个线程认领\n已偏向：线程指针指向获得偏向的 JavaThread\n",[25,1638,1636],{"__ignoreMap":285},[18,1640,1641],{},"Mark Word 是一块被复用的空间。例如普通未锁定对象可以直接保存 identity hash；偏向对象需要保存线程指针，因此二者不能同时使用同一布局。",[237,1643,1645],{"id":1644},"epoch-到底是什么","epoch 到底是什么",[18,1647,1648,1651],{},[25,1649,1650],{},"epoch"," 可以理解为某个类的“偏向版本号”，它不是时间戳，也不是对象年龄。",[18,1653,1654],{},"偏向锁不只依赖对象自身。支持偏向的类会在类的 prototype header 中保存一个当前 epoch；每个偏向对象的 Mark Word 中也会记录对象认领时使用的 epoch。线程进入偏向对象时，会比较两者：",[279,1656,1659],{"className":1657,"code":1658,"language":284,"meta":285},[282],"对象 epoch == 类当前 epoch\n → 这份偏向记录仍属于当前版本，继续检查偏向线程\n\n对象 epoch != 类当前 epoch\n → 这份偏向记录已经过期，可以进入重偏向或撤销流程\n",[25,1660,1658],{"__ignoreMap":285},[18,1662,1663,1664,1667],{},"它主要服务于",[61,1665,1666],{},"批量重偏向","。当一批对象从线程 A 整体转交给线程 B 使用时，JVM 不必立即逐个改写所有对象头，而是先提升类的 epoch。旧对象之后被访问时，会因为 epoch 不匹配而按新版本重新处理。",[18,1669,1670],{},"所以需要把两个容易混淆的字段分开：",[98,1672,1673,1683],{},[101,1674,1675],{},[104,1676,1677,1680],{},[107,1678,1679],{},"字段",[107,1681,1682],{},"含义",[114,1684,1685,1695],{},[104,1686,1687,1692],{},[119,1688,1689],{},[25,1690,1691],{},"age",[119,1693,1694],{},"对象的 GC 年龄，用于分代回收",[104,1696,1697,1701],{},[119,1698,1699],{},[25,1700,1650],{},[119,1702,1703],{},"类的偏向版本，用于判断对象上的偏向记录是否过期",[14,1705,1707],{"id":1706},"四jdk-8-为什么需要三种锁实现","四、JDK 8 为什么需要三种锁实现",[18,1709,1710],{},"不同竞争场景适合不同成本的同步方式。",[237,1712,1713],{"id":1713},"只有一个线程反复进入",[18,1715,1716],{},"如果一个对象长期只被同一个线程加锁，每次都执行 CAS 仍然是额外成本。偏向锁把对象与线程关联起来，后续同一线程进入时主要检查对象头是否仍偏向自己。",[237,1718,1720],{"id":1719},"多线程交替执行但没有同时竞争","多线程交替执行，但没有同时竞争",[18,1722,1723],{},"例如线程 A 使用完后线程 B 才进入。此时没有必要挂起线程，可以通过栈上 Lock Record 和 CAS 完成加锁、解锁。",[237,1725,1726],{"id":1726},"多线程同时争抢或需要等待队列",[18,1728,1729,1730,1733],{},"当 CAS 快速路径无法解决竞争，或者调用 ",[25,1731,1732],{},"wait()"," 需要条件等待集合时，JVM 使用 ObjectMonitor 管理 Owner、竞争线程和等待线程。",[18,1735,1736],{},"所以这三种实现的目标不是简单比较“谁更高级”，而是：",[56,1738,1739],{},[18,1740,1741],{},"根据实际竞争强度，在原子操作、CPU 自旋、线程阻塞和唤醒成本之间做权衡。",[14,1743,1745],{"id":1744},"五对象初始状态普通未锁定还是匿名偏向","五、对象初始状态：普通未锁定还是匿名偏向",[18,1747,1748],{},"JDK 8 默认启用偏向锁，但默认存在启动延迟：",[279,1750,1753],{"className":1751,"code":1752,"language":284,"meta":285},[282],"-XX:+UseBiasedLocking\n-XX:BiasedLockingStartupDelay=4000\n",[25,1754,1752],{"__ignoreMap":285},[18,1756,1757],{},"因此需要区分对象创建时机：",[237,1759,1760],{"id":1760},"偏向锁尚未启用或被关闭",[18,1762,1763],{},"新对象通常使用普通未锁定布局：",[279,1765,1768],{"className":1766,"code":1767,"language":284,"meta":285},[282],"[identity hash | age | 0 | 01]\n",[25,1769,1767],{"__ignoreMap":285},[18,1771,1772],{},"线程第一次进入同步块时，直接尝试建立轻量级锁。",[237,1774,1775],{"id":1775},"偏向锁已经启用",[18,1777,1778],{},"支持偏向的类创建新对象时，对象通常处于匿名偏向状态：",[279,1780,1783],{"className":1781,"code":1782,"language":284,"meta":285},[282],"[0 | epoch | age | 1 | 01]\n",[25,1784,1782],{"__ignoreMap":285},[18,1786,1787],{},"因此严格来说，不应把这条路径描述为：",[279,1789,1792],{"className":1790,"code":1791,"language":284,"meta":285},[282],"新对象先是无锁，然后第一次进入才“升级”为可偏向状态\n",[25,1793,1791],{"__ignoreMap":285},[18,1795,1796,1797],{},"更准确的说法是：",[61,1798,1799],{},"对象创建时便根据类的 prototype header 获得普通未锁定或匿名偏向的 Mark Word。",[14,1801,1803],{"id":1802},"六偏向锁的获取与重入","六、偏向锁的获取与重入",[18,1805,1806,1807,1810],{},"线程进入一个匿名偏向对象时，会尝试通过 CAS 把自己的 ",[25,1808,1809],{},"JavaThread*","、类当前的 epoch 等信息写入 Mark Word。",[18,1812,1813],{},"成功后，对象变成：",[279,1815,1818],{"className":1816,"code":1817,"language":284,"meta":285},[282],"[当前 JavaThread* | epoch | age | 1 | 01]\n",[25,1819,1817],{"__ignoreMap":285},[18,1821,1822],{},"同一个线程以后再次进入时，主要检查：",[208,1824,1825,1828,1831],{},[211,1826,1827],{},"Mark Word 是否仍是偏向模式；",[211,1829,1830],{},"偏向线程是否是当前线程；",[211,1832,1833],{},"对象 epoch 是否仍与类的 prototype header 匹配。",[18,1835,1836],{},"全部满足时可直接进入，不需要再次通过 CAS 抢占锁。",[237,1838,1839],{"id":1839},"偏向锁退出为什么不清除线程信息",[18,1841,1842],{},"偏向锁针对的就是“同一个线程还会再次进入”这一场景。同步块结束后，Mark Word 通常仍保留对原线程的偏向：",[279,1844,1847],{"className":1845,"code":1846,"language":284,"meta":285},[282],"进入前：偏向线程 A\n执行中：偏向线程 A\n退出后：仍偏向线程 A\n",[25,1848,1846],{"__ignoreMap":285},[18,1850,1851],{},"它不是表示线程 A 永远占用临界区，而是表示下一次线程 A 再进入时可以走低成本路径。",[237,1853,1854],{"id":1854},"偏向锁如何实现可重入",[18,1856,1857],{},"对象头记录了偏向线程，但不通过一个公共计数器记录每次进入。JVM 可以结合当前线程栈上的锁记录识别同步嵌套。对同一偏向线程而言，重复进入不需要竞争性地修改对象头。",[14,1859,1861],{"id":1860},"七其他线程访问偏向对象时发生什么","七、其他线程访问偏向对象时发生什么",[18,1863,1864],{},"线程 B 遇到偏向线程 A 的对象时，不能简单地直接覆盖线程指针。JVM 需要先判断原偏向是否仍然有效。",[18,1866,1867],{},"可能出现以下路径。",[237,1869,1871],{"id":1870},"_1-epoch-已过期","1. epoch 已过期",[18,1873,1874],{},"类发生批量重偏向后，旧对象的 epoch 可能落后于类的 epoch。线程 B 可以尝试通过 CAS 将对象重新偏向自己。",[237,1876,1878],{"id":1877},"_2-原线程已经不再持有这把锁","2. 原线程已经不再持有这把锁",[18,1880,1881],{},"JVM 可以撤销原偏向，使对象恢复为普通未锁定状态，或者在允许的情况下重新偏向新线程。",[237,1883,1885],{"id":1884},"_3-原线程仍在同步块中","3. 原线程仍在同步块中",[18,1887,1888],{},"JVM 需要检查原线程栈，撤销偏向并重建合法的锁状态。如果此时存在实际竞争，后续会进入轻量级竞争或直接膨胀为 ObjectMonitor。",[18,1890,1891],{},"因此：",[56,1893,1894],{},[18,1895,1896],{},"另一个线程访问偏向对象，不等于必然直接升级为重量级锁。是否重偏向、撤销为普通状态、转换为轻量级锁或膨胀，需要结合 epoch、类级启发式统计和原线程是否仍持锁判断。",[14,1898,1900],{"id":1899},"八批量重偏向与批量撤销","八、批量重偏向与批量撤销",[18,1902,1903],{},"如果某个类的大量对象不断被不同线程使用，逐个在安全点撤销偏向的成本会很高。HotSpot 会对同一类的偏向撤销次数做启发式统计。",[237,1905,1666],{"id":1666},[18,1907,1908],{},"当撤销达到一定阈值时，JVM 可以提升类 prototype header 中的 epoch。旧对象不需要立刻逐个修改；之后线程发现对象 epoch 过期时，再尝试将它偏向当前线程。",[18,1910,1911],{},"适合这种模式：",[279,1913,1916],{"className":1914,"code":1915,"language":284,"meta":285},[282],"一批对象先由线程 A 使用\n之后整体交给线程 B 使用\n但同一时刻竞争并不强\n",[25,1917,1915],{"__ignoreMap":285},[237,1919,1920],{"id":1920},"批量撤销",[18,1922,1923],{},"如果该类持续表现出多线程竞争，偏向锁已经不再适合，JVM 可以撤销该类的偏向能力。之后新对象不再默认可偏向，已有对象也会按正常锁路径处理。",[18,1925,1926],{},"这也是为什么偏向锁不能只按“对象自身的四级升级”理解：它还存在以类为粒度的 prototype header、epoch 和批量启发式机制。",[14,1928,1930],{"id":1929},"九普通未锁定到轻量级锁","九、普通未锁定到轻量级锁",[18,1932,1933,1934,1937,1938,1941,1942,1944],{},"当对象处于普通未锁定状态，线程进入同步块时会在当前栈帧创建锁记录，HotSpot 源码中对应 ",[25,1935,1936],{},"BasicLock","，解释器栈中通常由 ",[25,1939,1940],{},"BasicObjectLock"," 将对象引用和 ",[25,1943,1936],{}," 组织在一起。",[18,1946,1947],{},"概念流程如下：",[279,1949,1952],{"className":1950,"code":1951,"language":284,"meta":285},[282],"1. 在线程栈创建 Lock Record\n2. 将对象原 Mark Word 保存到 displaced header\n3. CAS 修改对象 Mark Word\n4. 让 Mark Word 指向当前 Lock Record\n",[25,1953,1951],{"__ignoreMap":285},[18,1955,1956],{},"CAS 成功后：",[279,1958,1961],{"className":1959,"code":1960,"language":284,"meta":285},[282],"对象 Mark Word → 线程栈 Lock Record\nLock Record → 保存原 Mark Word\n",[25,1962,1960],{"__ignoreMap":285},[18,1964,1965],{},"对象头低两位为：",[279,1967,1970],{"className":1968,"code":1969,"language":284,"meta":285},[282],"00\n",[25,1971,1969],{"__ignoreMap":285},[18,1973,1974],{},"这就是通常所说的轻量级锁或栈锁。",[237,1976,1978],{"id":1977},"为什么要保存-displaced-header","为什么要保存 displaced header",[18,1980,1981],{},"轻量级锁占用了对象原来的 Mark Word。解锁时需要把原 Mark Word 恢复回对象头，因此先把它保存到 Lock Record。",[14,1983,1985],{"id":1984},"十轻量级锁的可重入","十、轻量级锁的可重入",[18,1987,1988],{},"同一个线程再次获取已经由自己栈锁定的对象时，JVM 会识别对象头中的 Lock Record 指针属于当前线程栈。",[18,1990,1991],{},"此时新的 Lock Record 会使用特殊值表示递归进入，例如 displaced header 置空，而不是再次覆盖对象头。",[18,1993,1994],{},"退出时：",[279,1996,1999],{"className":1997,"code":1998,"language":284,"meta":285},[282],"递归层 Lock Record：只退出当前递归层\n最外层 Lock Record：负责真正恢复对象头\n",[25,2000,1998],{"__ignoreMap":285},[18,2002,2003,2004,2006],{},"这解释了为什么 ",[25,2005,1302],{}," 天然支持可重入。",[14,2008,2010],{"id":2009},"十一轻量级锁如何释放","十一、轻量级锁如何释放",[18,2012,2013],{},"最外层同步块退出时，线程使用 CAS 尝试把 Lock Record 中保存的 displaced header 恢复到对象 Mark Word：",[279,2015,2018],{"className":2016,"code":2017,"language":284,"meta":285},[282],"期望值：对象头仍指向当前 Lock Record\n新值：进入同步块前保存的原 Mark Word\n",[25,2019,2017],{"__ignoreMap":285},[18,2021,2022],{},"CAS 成功：",[279,2024,2027],{"className":2025,"code":2026,"language":284,"meta":285},[282],"轻量级锁正常释放\n对象恢复普通未锁定状态\n",[25,2028,2026],{"__ignoreMap":285},[18,2030,2031],{},"CAS 失败通常意味着对象已在竞争过程中膨胀，不能再直接把原对象头覆盖回去，需要走 ObjectMonitor 的退出逻辑。",[18,2033,2034],{},"这就是“锁只能升级不能降级”表述不够准确的直接例子：没有发生膨胀的轻量级锁，退出后会恢复原 Mark Word。",[14,2036,2038],{"id":2037},"十二轻量级锁何时膨胀","十二、轻量级锁何时膨胀",[18,2040,2041],{},"线程尝试用 CAS 建立轻量级锁失败，说明对象头已经发生变化。可能原因包括：",[245,2043,2044,2047,2050,2053],{},[211,2045,2046],{},"另一个线程持有轻量级锁；",[211,2048,2049],{},"对象已经膨胀为 ObjectMonitor；",[211,2051,2052],{},"竞争期间其他线程正在处理锁状态；",[211,2054,2055],{},"必须执行依赖 ObjectMonitor 的操作。",[18,2057,2058],{},"JVM 可以先进行短暂自旋，希望持锁线程很快退出。自旋避免了线程立即挂起和恢复，但会消耗 CPU，因此只适合临界区较短的情况。",[18,2060,2061],{},"当快速路径不能解决问题时，JVM 会执行 Monitor inflation：",[279,2063,2066],{"className":2064,"code":2065,"language":284,"meta":285},[282],"创建或取得 ObjectMonitor\n复制并保存原 Mark Word\n将对象头改为指向 ObjectMonitor\n由 ObjectMonitor 负责后续竞争\n",[25,2067,2065],{"__ignoreMap":285},[18,2069,2070],{},"对象头低两位变成：",[279,2072,2075],{"className":2073,"code":2074,"language":284,"meta":285},[282],"10\n",[25,2076,2074],{"__ignoreMap":285},[14,2078,2080],{"id":2079},"十三重量级锁与-objectmonitor","十三、重量级锁与 ObjectMonitor",[18,2082,2083,2084,2087],{},"重量级状态下，对象 Mark Word 指向一个 ",[25,2085,2086],{},"ObjectMonitor","。理解它时重点关注以下字段或逻辑角色：",[279,2089,2092],{"className":2090,"code":2091,"language":284,"meta":285},[282],"_owner 当前持有 Monitor 的线程或相关锁记录\n_recursions 重入次数\n_cxq 新到达竞争线程形成的竞争队列\n_EntryList 等待重新竞争 Owner 的线程\n_WaitSet 调用 wait 后等待通知的线程\n_header 膨胀前保存的对象 Mark Word\n",[25,2093,2091],{"__ignoreMap":285},[18,2095,2096],{},"概念结构：",[279,2098,2101],{"className":2099,"code":2100,"language":284,"meta":285},[282],"对象 Mark Word\n │\n ▼\nObjectMonitor\n ├─ Owner\n ├─ Recursions\n ├─ cxq \u002F EntryList\n ├─ WaitSet\n └─ displaced header\n",[25,2102,2100],{"__ignoreMap":285},[18,2104,2105],{},"竞争线程可能先自旋尝试获得 Owner。仍然失败时，线程会进入等待结构并被挂起；持有线程退出后，Monitor 选择或唤醒后继线程继续竞争。",[18,2107,2108],{},"“重量级”的成本主要来自：",[245,2110,2111,2114,2117,2120],{},[211,2112,2113],{},"维护竞争和等待队列；",[211,2115,2116],{},"线程阻塞、唤醒与调度；",[211,2118,2119],{},"高竞争下的上下文切换；",[211,2121,2122],{},"对 Monitor 状态的原子协调。",[18,2124,2125],{},"它并不意味着每次操作都必然立刻执行一次昂贵的系统调用，HotSpot 仍包含快速路径和自适应自旋等优化。",[14,2127,2129],{"id":2128},"十四waitnotify-为什么会涉及重量级-monitor","十四、wait、notify 为什么会涉及重量级 Monitor",[18,2131,2132,2134],{},[25,2133,1732],{}," 的语义不是普通锁竞争：",[279,2136,2139],{"className":2137,"code":2138,"language":284,"meta":285},[282],"确认当前线程持有 Monitor\n完整释放锁及其重入层数\n进入 WaitSet\n等待 notify、notifyAll、中断或超时\n重新参与锁竞争\n恢复原重入状态后返回\n",[25,2140,2138],{"__ignoreMap":285},[18,2142,2143,2144,2146],{},"这需要 Owner、WaitSet、EntryList、重入次数等完整 Monitor 能力，因此 JDK 8 HotSpot 执行 ",[25,2145,1732],{}," 时会确保对象已经膨胀为 ObjectMonitor。",[18,2148,2149,28,2152,2155],{},[25,2150,2151],{},"notify()",[25,2153,2154],{},"notifyAll()"," 存在一个细节：如果对象当前只是由调用线程栈锁定，那么它不可能已经拥有 WaitSet，HotSpot 可以直接返回而不做无意义的膨胀；否则会取得或膨胀 ObjectMonitor，再处理等待线程。",[18,2157,2158,2160],{},[25,2159,2151],{}," 只是把等待线程从“等待条件”推进到“可以重新竞争锁”的阶段，并不会让它绕过当前 Owner 立即执行。",[14,2162,2164],{"id":2163},"十五identityhashcode-对锁状态的影响","十五、identityHashCode 对锁状态的影响",[18,2166,2167],{},"普通未锁定对象可以把 identity hash 保存在 Mark Word 中，但偏向锁的 Mark Word 需要保存 JavaThread 指针。",[18,2169,2170],{},"因此，对偏向对象计算：",[279,2172,2176],{"className":2173,"code":2174,"language":2175,"meta":285,"style":285},"language-java shiki shiki-themes github-light github-dark","System.identityHashCode(obj);\n","java",[25,2177,2178],{"__ignoreMap":285},[315,2179,2180,2183,2186],{"class":317,"line":318},[315,2181,2182],{"class":333},"System.",[315,2184,2185],{"class":321},"identityHashCode",[315,2187,2188],{"class":333},"(obj);\n",[18,2190,2191],{},"通常会导致偏向撤销，使对象头能够保存 hash。",[18,2193,2194],{},"如果对象正在使用轻量级锁，原 Mark Word 已经保存在当前线程栈的 Lock Record 中。为了稳定保存 identity hash，并让其他线程可靠读取，HotSpot 的相关路径可能把对象膨胀为 ObjectMonitor，再把 hash 保存在 Monitor 保存的 header 中。",[18,2196,2197],{},"所以观察锁升级实验时，不要在不知情的情况下调用可能计算 identity hash 的方法，否则实验本身会改变对象头。",[14,2199,2201],{"id":2200},"十六完整状态转换表","十六、完整状态转换表",[98,2203,2204,2217],{},[101,2205,2206],{},[104,2207,2208,2211,2214],{},[107,2209,2210],{},"当前状态",[107,2212,2213],{},"触发条件",[107,2215,2216],{},"可能结果",[114,2218,2219,2232,2245,2258,2270,2282,2294,2307,2319,2331,2343,2354,2367],{},[104,2220,2221,2226,2229],{},[119,2222,2223,2224],{},"普通未锁定 ",[25,2225,1527],{},[119,2227,2228],{},"首次进入同步块",[119,2230,2231],{},"CAS 成功后成为轻量级锁",[104,2233,2234,2239,2242],{},[119,2235,2236,2237],{},"匿名偏向 ",[25,2238,1548],{},[119,2240,2241],{},"第一个线程进入",[119,2243,2244],{},"CAS 写入线程指针，成为已偏向状态",[104,2246,2247,2252,2255],{},[119,2248,2249,2250],{},"已偏向 ",[25,2251,1548],{},[119,2253,2254],{},"原线程再次进入",[119,2256,2257],{},"保持偏向，低成本重入",[104,2259,2260,2264,2267],{},[119,2261,2249,2262],{},[25,2263,1548],{},[119,2265,2266],{},"新线程访问且 epoch 过期",[119,2268,2269],{},"尝试重偏向或撤销",[104,2271,2272,2276,2279],{},[119,2273,2249,2274],{},[25,2275,1548],{},[119,2277,2278],{},"新线程访问，原线程未持锁",[119,2280,2281],{},"撤销为普通状态，或按策略重偏向",[104,2283,2284,2288,2291],{},[119,2285,2249,2286],{},[25,2287,1548],{},[119,2289,2290],{},"新线程访问，原线程仍持锁",[119,2292,2293],{},"撤销偏向，转轻量级或膨胀",[104,2295,2296,2301,2304],{},[119,2297,2298,2299],{},"轻量级 ",[25,2300,1572],{},[119,2302,2303],{},"当前线程重入",[119,2305,2306],{},"新增递归 Lock Record，保持轻量级",[104,2308,2309,2313,2316],{},[119,2310,2298,2311],{},[25,2312,1572],{},[119,2314,2315],{},"无竞争退出",[119,2317,2318],{},"CAS 恢复原 Mark Word",[104,2320,2321,2325,2328],{},[119,2322,2298,2323],{},[25,2324,1572],{},[119,2326,2327],{},"竞争持续或恢复对象头失败",[119,2329,2330],{},"膨胀为 ObjectMonitor",[104,2332,2333,2336,2341],{},[119,2334,2335],{},"任意适用状态",[119,2337,2338,2340],{},[25,2339,1732],{}," 等需要完整 Monitor 语义",[119,2342,2330],{},[104,2344,2345,2348,2351],{},[119,2346,2347],{},"偏向\u002F轻量级",[119,2349,2350],{},"计算 identity hash 等特殊场景",[119,2352,2353],{},"撤销偏向或膨胀",[104,2355,2356,2361,2364],{},[119,2357,2358,2359],{},"重量级 ",[25,2360,1590],{},[119,2362,2363],{},"Owner 退出",[119,2365,2366],{},"唤醒\u002F选择后继；对象仍可保持膨胀",[104,2368,2369,2372,2375],{},[119,2370,2371],{},"空闲 ObjectMonitor",[119,2373,2374],{},"后续安全点清理",[119,2376,2377],{},"JVM 可能执行 Monitor deflation",[14,2379,2381],{"id":2380},"十七三条典型执行路径","十七、三条典型执行路径",[237,2383,2385],{"id":2384},"路径一同一个线程反复进入","路径一：同一个线程反复进入",[279,2387,2390],{"className":2388,"code":2389,"language":284,"meta":285},[282],"匿名偏向\n → CAS 偏向线程 A\n → A 执行同步块\n → A 退出但保留偏向\n → A 再次进入，快速命中\n",[25,2391,2389],{"__ignoreMap":285},[237,2393,2395],{"id":2394},"路径二线程交替使用没有重叠竞争","路径二：线程交替使用，没有重叠竞争",[18,2397,2398],{},"偏向关闭或偏向已撤销时：",[279,2400,2403],{"className":2401,"code":2402,"language":284,"meta":285},[282],"普通未锁定\n → A 建立轻量级锁\n → A CAS 恢复对象头\n → B 建立轻量级锁\n → B CAS 恢复对象头\n",[25,2404,2402],{"__ignoreMap":285},[18,2406,2407],{},"这种场景没有必要让线程进入阻塞等待。",[237,2409,2411],{"id":2410},"路径三多线程同时竞争","路径三：多线程同时竞争",[279,2413,2416],{"className":2414,"code":2415,"language":284,"meta":285},[282],"A 持有轻量级锁\n → B CAS 失败并短暂自旋\n → A 未及时释放\n → 对象膨胀为 ObjectMonitor\n → B 进入竞争\u002F等待结构\n → A 退出并推进后继竞争\n",[25,2417,2415],{"__ignoreMap":285},[14,2419,2421],{"id":2420},"十八jol-验证时要注意什么","十八、JOL 验证时要注意什么",[18,2423,2424],{},"可以使用 JOL 查看对象布局：",[279,2426,2430],{"className":2427,"code":2428,"language":2429,"meta":285,"style":285},"language-xml shiki shiki-themes github-light github-dark","\u003Cdependency>\n \u003CgroupId>org.openjdk.jol\u003C\u002FgroupId>\n \u003CartifactId>jol-core\u003C\u002FartifactId>\n \u003Cversion>0.17\u003C\u002Fversion>\n\u003C\u002Fdependency>\n","xml",[25,2431,2432,2444,2459,2473,2487],{"__ignoreMap":285},[315,2433,2434,2437,2441],{"class":317,"line":318},[315,2435,2436],{"class":333},"\u003C",[315,2438,2440],{"class":2439},"s9eBZ","dependency",[315,2442,2443],{"class":333},">\n",[315,2445,2446,2449,2452,2455,2457],{"class":317,"line":343},[315,2447,2448],{"class":333}," \u003C",[315,2450,2451],{"class":2439},"groupId",[315,2453,2454],{"class":333},">org.openjdk.jol\u003C\u002F",[315,2456,2451],{"class":2439},[315,2458,2443],{"class":333},[315,2460,2461,2463,2466,2469,2471],{"class":317,"line":359},[315,2462,2448],{"class":333},[315,2464,2465],{"class":2439},"artifactId",[315,2467,2468],{"class":333},">jol-core\u003C\u002F",[315,2470,2465],{"class":2439},[315,2472,2443],{"class":333},[315,2474,2475,2477,2480,2483,2485],{"class":317,"line":375},[315,2476,2448],{"class":333},[315,2478,2479],{"class":2439},"version",[315,2481,2482],{"class":333},">0.17\u003C\u002F",[315,2484,2479],{"class":2439},[315,2486,2443],{"class":333},[315,2488,2489,2492,2494],{"class":317,"line":391},[315,2490,2491],{"class":333},"\u003C\u002F",[315,2493,2440],{"class":2439},[315,2495,2443],{"class":333},[18,2497,2498],{},"示例：",[279,2500,2502],{"className":2173,"code":2501,"language":2175,"meta":285,"style":285},"Object lock = new Object();\n\nSystem.out.println(ClassLayout.parseInstance(lock).toPrintable());\n\nsynchronized (lock) {\n System.out.println(ClassLayout.parseInstance(lock).toPrintable());\n}\n\nSystem.out.println(ClassLayout.parseInstance(lock).toPrintable());\n",[25,2503,2504,2521,2526,2549,2553,2560,2578,2584,2589],{"__ignoreMap":285},[315,2505,2506,2509,2512,2515,2518],{"class":317,"line":318},[315,2507,2508],{"class":333},"Object lock ",[315,2510,2511],{"class":325},"=",[315,2513,2514],{"class":325}," new",[315,2516,2517],{"class":321}," Object",[315,2519,2520],{"class":333},"();\n",[315,2522,2523],{"class":317,"line":343},[315,2524,2525],{"emptyLinePlaceholder":1280},"\n",[315,2527,2528,2531,2534,2537,2540,2543,2546],{"class":317,"line":359},[315,2529,2530],{"class":333},"System.out.",[315,2532,2533],{"class":321},"println",[315,2535,2536],{"class":333},"(ClassLayout.",[315,2538,2539],{"class":321},"parseInstance",[315,2541,2542],{"class":333},"(lock).",[315,2544,2545],{"class":321},"toPrintable",[315,2547,2548],{"class":333},"());\n",[315,2550,2551],{"class":317,"line":375},[315,2552,2525],{"emptyLinePlaceholder":1280},[315,2554,2555,2557],{"class":317,"line":391},[315,2556,1302],{"class":325},[315,2558,2559],{"class":333}," (lock) {\n",[315,2561,2563,2566,2568,2570,2572,2574,2576],{"class":317,"line":2562},6,[315,2564,2565],{"class":333}," System.out.",[315,2567,2533],{"class":321},[315,2569,2536],{"class":333},[315,2571,2539],{"class":321},[315,2573,2542],{"class":333},[315,2575,2545],{"class":321},[315,2577,2548],{"class":333},[315,2579,2581],{"class":317,"line":2580},7,[315,2582,2583],{"class":333},"}\n",[315,2585,2587],{"class":317,"line":2586},8,[315,2588,2525],{"emptyLinePlaceholder":1280},[315,2590,2592,2594,2596,2598,2600,2602,2604],{"class":317,"line":2591},9,[315,2593,2530],{"class":333},[315,2595,2533],{"class":321},[315,2597,2536],{"class":333},[315,2599,2539],{"class":321},[315,2601,2542],{"class":333},[315,2603,2545],{"class":321},[315,2605,2548],{"class":333},[18,2607,2608],{},"实验时要控制以下变量：",[245,2610,2611,2614,2620,2626,2629,2632],{},[211,2612,2613],{},"明确使用 JDK 8 HotSpot；",[211,2615,2616,2617,734],{},"记录是否开启 ",[25,2618,2619],{},"UseBiasedLocking",[211,2621,2622,2623,734],{},"记录 ",[25,2624,2625],{},"BiasedLockingStartupDelay",[211,2627,2628],{},"避免日志、调试器或工具意外计算 identity hash；",[211,2630,2631],{},"JOL 输出会受 32\u002F64 位、压缩指针和 GC 配置影响；",[211,2633,2634],{},"线程已经终止不代表任何场景都一定重偏向，仍要看 epoch 和撤销策略。",[18,2636,2637],{},"为了避免默认 4 秒延迟影响实验，可以显式设置：",[279,2639,2642],{"className":2640,"code":2641,"language":284,"meta":285},[282],"-XX:+UseBiasedLocking\n-XX:BiasedLockingStartupDelay=0\n",[25,2643,2641],{"__ignoreMap":285},[18,2645,2646],{},"关闭偏向锁、直接观察轻量级路径：",[279,2648,2651],{"className":2649,"code":2650,"language":284,"meta":285},[282],"-XX:-UseBiasedLocking\n",[25,2652,2650],{"__ignoreMap":285},[14,2654,2656],{"id":2655},"十九常见误区","十九、常见误区",[237,2658,2660],{"id":2659},"误区一新对象一定先是无锁再升级为偏向锁","误区一：新对象一定先是无锁，再升级为偏向锁",[18,2662,2663],{},"不准确。偏向能力启用后，支持偏向的类可以让新对象直接使用匿名偏向的 prototype header。",[237,2665,2667],{"id":2666},"误区二第二个线程出现就一定升级为重量级锁","误区二：第二个线程出现就一定升级为重量级锁",[18,2669,2670],{},"不准确。它可能触发重偏向、偏向撤销、轻量级锁，也可能在存在实际竞争时膨胀。",[237,2672,2674],{"id":2673},"误区三轻量级锁就是一直自旋","误区三：轻量级锁就是一直自旋",[18,2676,2677],{},"不准确。轻量级锁的核心是栈上 Lock Record 与对象头 CAS；自旋是竞争时可能采用的等待优化，不是轻量级锁的完整定义。",[237,2679,2681],{"id":2680},"误区四重量级锁完全由操作系统-mutex-等同实现","误区四：重量级锁完全由操作系统 Mutex 等同实现",[18,2683,2684],{},"过度简化。ObjectMonitor 是 HotSpot 的 JVM 级同步结构，内部会使用 CAS、自旋、队列、park\u002Funpark 等机制；线程最终阻塞和唤醒会依赖操作系统能力，但两者不能直接画等号。",[237,2686,2688],{"id":2687},"误区五锁一旦膨胀这个对象终身都是重量级锁","误区五：锁一旦膨胀，这个对象终身都是重量级锁",[18,2690,2691],{},"不准确。当前竞争阶段通常不会立即降级，但空闲 Monitor 后续可能由 JVM 在安全点执行 deflation。",[237,2693,2695],{"id":2694},"误区六这套流程适用于所有-jdk","误区六：这套流程适用于所有 JDK",[18,2697,2698],{},"不准确。本文讨论的是 JDK 8 HotSpot。偏向锁后来被默认禁用，现代 HotSpot 的锁实现也持续演进，因此理解具体机制时必须先限定版本。",[14,2700,2702],{"id":2701},"二十参考资料","二十、参考资料",[245,2704,2705,2712,2719,2726],{},[211,2706,2707],{},[70,2708,2711],{"href":2709,"rel":2710},"https:\u002F\u002Fgithub.com\u002Fopenjdk\u002Fjdk8u\u002Fblob\u002Fmaster\u002Fhotspot\u002Fsrc\u002Fshare\u002Fvm\u002Foops\u002FmarkOop.hpp",[1200],"JDK 8 HotSpot：markOop.hpp",[211,2713,2714],{},[70,2715,2718],{"href":2716,"rel":2717},"https:\u002F\u002Fgithub.com\u002Fopenjdk\u002Fjdk8u\u002Fblob\u002Fmaster\u002Fhotspot\u002Fsrc\u002Fshare\u002Fvm\u002Fruntime\u002Fsynchronizer.cpp",[1200],"JDK 8 HotSpot：synchronizer.cpp",[211,2720,2721],{},[70,2722,2725],{"href":2723,"rel":2724},"https:\u002F\u002Fgithub.com\u002Fopenjdk\u002Fjdk8u\u002Fblob\u002Fmaster\u002Fhotspot\u002Fsrc\u002Fshare\u002Fvm\u002Fruntime\u002FbiasedLocking.cpp",[1200],"JDK 8 HotSpot：biasedLocking.cpp",[211,2727,2728],{},[70,2729,2732],{"href":2730,"rel":2731},"https:\u002F\u002Fgithub.com\u002Fopenjdk\u002Fjdk8u\u002Fblob\u002Fmaster\u002Fhotspot\u002Fsrc\u002Fshare\u002Fvm\u002Fruntime\u002FobjectMonitor.hpp",[1200],"JDK 8 HotSpot：objectMonitor.hpp",[14,2734,2735],{"id":2735},"相关内容",[245,2737,2738],{},[211,2739,2740],{},[70,2741,2743],{"href":2742},"\u002Fwiki\u002Fjava\u002Fsynchronized-vs-reentrantlock\u002F","synchronized 和 ReentrantLock 的区别",[1224,2745,2746],{},"html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .s9eBZ, html code.shiki .s9eBZ{--shiki-default:#22863A;--shiki-dark:#85E89D}html pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}",{"title":285,"searchDepth":343,"depth":343,"links":2748},[2749,2750,2751,2752,2756,2761,2765,2769,2774,2778,2781,2782,2783,2784,2785,2786,2787,2788,2793,2794,2802,2803],{"id":1296,"depth":343,"text":1297},{"id":66,"depth":343,"text":66},{"id":1359,"depth":343,"text":1360},{"id":1442,"depth":343,"text":1443,"children":2753},[2754,2755],{"id":1478,"depth":359,"text":1479},{"id":1644,"depth":359,"text":1645},{"id":1706,"depth":343,"text":1707,"children":2757},[2758,2759,2760],{"id":1713,"depth":359,"text":1713},{"id":1719,"depth":359,"text":1720},{"id":1726,"depth":359,"text":1726},{"id":1744,"depth":343,"text":1745,"children":2762},[2763,2764],{"id":1760,"depth":359,"text":1760},{"id":1775,"depth":359,"text":1775},{"id":1802,"depth":343,"text":1803,"children":2766},[2767,2768],{"id":1839,"depth":359,"text":1839},{"id":1854,"depth":359,"text":1854},{"id":1860,"depth":343,"text":1861,"children":2770},[2771,2772,2773],{"id":1870,"depth":359,"text":1871},{"id":1877,"depth":359,"text":1878},{"id":1884,"depth":359,"text":1885},{"id":1899,"depth":343,"text":1900,"children":2775},[2776,2777],{"id":1666,"depth":359,"text":1666},{"id":1920,"depth":359,"text":1920},{"id":1929,"depth":343,"text":1930,"children":2779},[2780],{"id":1977,"depth":359,"text":1978},{"id":1984,"depth":343,"text":1985},{"id":2009,"depth":343,"text":2010},{"id":2037,"depth":343,"text":2038},{"id":2079,"depth":343,"text":2080},{"id":2128,"depth":343,"text":2129},{"id":2163,"depth":343,"text":2164},{"id":2200,"depth":343,"text":2201},{"id":2380,"depth":343,"text":2381,"children":2789},[2790,2791,2792],{"id":2384,"depth":359,"text":2385},{"id":2394,"depth":359,"text":2395},{"id":2410,"depth":359,"text":2411},{"id":2420,"depth":343,"text":2421},{"id":2655,"depth":343,"text":2656,"children":2795},[2796,2797,2798,2799,2800,2801],{"id":2659,"depth":359,"text":2660},{"id":2666,"depth":359,"text":2667},{"id":2673,"depth":359,"text":2674},{"id":2680,"depth":359,"text":2681},{"id":2687,"depth":359,"text":2688},{"id":2694,"depth":359,"text":2695},{"id":2701,"depth":343,"text":2702},{"id":2735,"depth":343,"text":2735},"wiki:java:jdk8-synchronized-lock-states","从 Mark Word、Lock Record 与 ObjectMonitor 出发，系统理解 JDK 8 HotSpot 中偏向锁、轻量级锁、重量级锁的获取、撤销、膨胀和释放过程。",{},35,"\u002Fjava\u002Fjdk8-synchronized-lock-states","并发编程",{"title":1291,"description":2805},"java\u002Fjdk8-synchronized-lock-states","2026-07-23","pzK2g0rnXBsTfHk45mk4P4Dlca-bkRaWaNMeJy8yZRA",{"id":2815,"title":2743,"body":2816,"commentId":3722,"description":3723,"difficulty":3724,"draft":1277,"extension":1278,"meta":3725,"navigation":1280,"order":3726,"path":3727,"section":1283,"seo":3728,"stem":3729,"updated":3730,"__hash__":3731},"java\u002Fjava\u002Fsynchronized-vs-reentrantlock.md",{"type":7,"value":2817,"toc":3700},[2818,2821,2824,2829,2832,2839,2841,2850,2852,2860,2870,2874,2876,2882,2885,2891,2894,2897,2903,2910,2913,2917,3070,3072,3076,3079,3084,3087,3093,3096,3099,3105,3108,3110,3114,3120,3123,3126,3132,3135,3140,3142,3146,3149,3152,3158,3161,3164,3170,3173,3179,3182,3188,3191,3193,3197,3200,3206,3209,3215,3220,3223,3225,3229,3234,3237,3243,3248,3254,3257,3263,3266,3272,3275,3281,3284,3290,3293,3299,3302,3304,3308,3311,3314,3320,3323,3329,3332,3335,3338,3344,3347,3350,3356,3359,3365,3372,3374,3378,3383,3389,3392,3395,3401,3407,3413,3416,3422,3425,3427,3431,3434,3437,3453,3456,3461,3464,3466,3470,3473,3493,3495,3501,3504,3509,3511,3515,3517,3543,3546,3552,3555,3557,3561,3606,3609,3614,3621,3627,3630,3632,3636,3640,3643,3647,3650,3654,3657,3665,3669,3672,3676,3679,3682,3688,3690,3693],[18,2819,2820],{},"synchronized和reentrantLock的区别？",[10,2822,2823],{"id":2823},"面试标准回答",[56,2825,2826],{},[18,2827,2828],{},"synchronized 是 JVM 层面的内置锁，语法简单，进入同步块后自动加锁，退出时自动释放，支持可重入和内存可见性。ReentrantLock 是基于 AQS 实现的显式锁，同样支持可重入，但提供了公平锁、可响应中断获取锁、tryLock、超时获取以及多个 Condition 等高级能力。两者在现代 JDK 中性能差距通常不是主要选型依据；功能简单时优先 synchronized，需要精细控制时使用 ReentrantLock，并且必须在 finally 中释放锁。",[18,2830,2831],{},"一句话记忆：",[56,2833,2834],{},[18,2835,2836],{},[61,2837,2838],{},"synchronized 简单自动，ReentrantLock 灵活可控。",[14,2840,66],{"id":66},[18,2842,2843],{},[70,2844,2847],{"href":2845,"target":73,"rel":2846},"\u002Fimages\u002Fwiki\u002Fjava\u002Fsynchronized-vs-reentrantlock.svg",[75,76],[78,2848],{"src":2845,"alt":2849},"synchronized 与 ReentrantLock 核心差异和选型建议",[10,2851,83],{"id":83},[18,2853,2854,28,2856,2859],{},[25,2855,1302],{},[25,2857,2858],{},"ReentrantLock"," 都能实现互斥和可见性，但定位不同：",[56,2861,2862],{},[18,2863,2864,2866,2867,2869],{},[25,2865,1302],{}," 是 JVM 原生关键字，语法简单；",[25,2868,2858],{}," 是 JUC 提供的显式锁，功能更丰富、控制能力更强。",[14,2871,2873],{"id":2872},"一基本用法","一、基本用法",[237,2875,1302],{"id":1302},[279,2877,2880],{"className":2878,"code":2879,"language":284},[282],"synchronized (lock) {\n \u002F\u002F 临界区\n}\n",[25,2881,2879],{"__ignoreMap":285},[18,2883,2884],{},"或者：",[279,2886,2889],{"className":2887,"code":2888,"language":284},[282],"public synchronized void method() {\n}\n",[25,2890,2888],{"__ignoreMap":285},[18,2892,2893],{},"锁会自动释放。",[237,2895,2858],{"id":2896},"reentrantlock",[279,2898,2901],{"className":2899,"code":2900,"language":284},[282],"ReentrantLock lock = new ReentrantLock();\n\nlock.lock();\ntry {\n \u002F\u002F 临界区\n} finally {\n lock.unlock();\n}\n",[25,2902,2900],{"__ignoreMap":285},[18,2904,2905,2906,2909],{},"必须手动释放，所以通常必须写在 ",[25,2907,2908],{},"finally"," 中。",[2911,2912],"hr",{},[14,2914,2916],{"id":2915},"二核心区别","二、核心区别",[98,2918,2919,2930],{},[101,2920,2921],{},[104,2922,2923,2926,2928],{},[107,2924,2925],{},"对比项",[107,2927,1302],{},[107,2929,2858],{},[114,2931,2932,2943,2954,2964,2974,2987,2999,3011,3022,3037,3048,3059],{},[104,2933,2934,2937,2940],{},[119,2935,2936],{},"实现层次",[119,2938,2939],{},"JVM 关键字、Monitor",[119,2941,2942],{},"Java 类，基于 AQS",[104,2944,2945,2948,2951],{},[119,2946,2947],{},"加锁释放",[119,2949,2950],{},"自动",[119,2952,2953],{},"手动",[104,2955,2956,2959,2962],{},[119,2957,2958],{},"可重入",[119,2960,2961],{},"支持",[119,2963,2961],{},[104,2965,2966,2969,2972],{},[119,2967,2968],{},"公平锁",[119,2970,2971],{},"不支持显式配置",[119,2973,2961],{},[104,2975,2976,2979,2982],{},[119,2977,2978],{},"可中断获取锁",[119,2980,2981],{},"不支持",[119,2983,2984],{},[25,2985,2986],{},"lockInterruptibly()",[104,2988,2989,2992,2994],{},[119,2990,2991],{},"尝试获取锁",[119,2993,2981],{},[119,2995,2996],{},[25,2997,2998],{},"tryLock()",[104,3000,3001,3004,3006],{},[119,3002,3003],{},"超时获取锁",[119,3005,2981],{},[119,3007,3008],{},[25,3009,3010],{},"tryLock(timeout, unit)",[104,3012,3013,3016,3019],{},[119,3014,3015],{},"条件队列",[119,3017,3018],{},"一个 Monitor WaitSet",[119,3020,3021],{},"可创建多个 Condition",[104,3023,3024,3027,3032],{},[119,3025,3026],{},"等待通知",[119,3028,3029],{},[25,3030,3031],{},"wait\u002Fnotify\u002FnotifyAll",[119,3033,3034],{},[25,3035,3036],{},"await\u002Fsignal\u002FsignalAll",[104,3038,3039,3042,3045],{},[119,3040,3041],{},"锁状态查询",[119,3043,3044],{},"能力有限",[119,3046,3047],{},"提供较多查询方法",[104,3049,3050,3053,3056],{},[119,3051,3052],{},"编码复杂度",[119,3054,3055],{},"低",[119,3057,3058],{},"较高",[104,3060,3061,3064,3067],{},[119,3062,3063],{},"异常释放",[119,3065,3066],{},"自动释放",[119,3068,3069],{},"必须 finally unlock",[2911,3071],{},[10,3073,3075],{"id":3074},"三两者都支持可重入","三、两者都支持可重入",[18,3077,3078],{},"可重入指：",[56,3080,3081],{},[18,3082,3083],{},"同一个线程已经持有锁时，可以再次获取同一把锁。",[237,3085,1302],{"id":3086},"synchronized-1",[279,3088,3091],{"className":3089,"code":3090,"language":284},[282],"public synchronized void methodA() {\n methodB();\n}\n\npublic synchronized void methodB() {\n}\n",[25,3092,3090],{"__ignoreMap":285},[18,3094,3095],{},"同一个对象上的两个同步方法，线程可以重入。",[237,3097,2858],{"id":3098},"reentrantlock-1",[279,3100,3103],{"className":3101,"code":3102,"language":284},[282],"lock.lock();\ntry {\n lock.lock();\n try {\n \u002F\u002F 重入\n } finally {\n lock.unlock();\n }\n} finally {\n lock.unlock();\n}\n",[25,3104,3102],{"__ignoreMap":285},[18,3106,3107],{},"获取几次，就必须释放几次。",[2911,3109],{},[10,3111,3113],{"id":3112},"四reentrantlock-支持公平锁","四、ReentrantLock 支持公平锁",[279,3115,3118],{"className":3116,"code":3117,"language":284},[282],"ReentrantLock fairLock = new ReentrantLock(true);\n",[25,3119,3117],{"__ignoreMap":285},[18,3121,3122],{},"公平锁会尽量按 AQS 队列顺序获取锁。",[18,3124,3125],{},"默认是非公平锁：",[279,3127,3130],{"className":3128,"code":3129,"language":284},[282],"ReentrantLock lock = new ReentrantLock();\n",[25,3131,3129],{"__ignoreMap":285},[18,3133,3134],{},"非公平锁允许新线程插队，吞吐量通常更高。",[18,3136,3137,3139],{},[25,3138,1302],{}," 没有 API 让你指定公平性，通常按非公平竞争理解。",[2911,3141],{},[10,3143,3145],{"id":3144},"五reentrantlock-支持可响应中断等待","五、ReentrantLock 支持可响应中断等待",[18,3147,3148],{},"假设线程正在等待锁。",[18,3150,3151],{},"使用：",[279,3153,3156],{"className":3154,"code":3155,"language":284},[282],"lock.lock();\n",[25,3157,3155],{"__ignoreMap":285},[18,3159,3160],{},"即使线程被中断，也不会因为中断立即退出获取锁过程。",[18,3162,3163],{},"而：",[279,3165,3168],{"className":3166,"code":3167,"language":284},[282],"lock.lockInterruptibly();\n",[25,3169,3167],{"__ignoreMap":285},[18,3171,3172],{},"等待期间如果收到中断，会抛出：",[279,3174,3177],{"className":3175,"code":3176,"language":284},[282],"InterruptedException\n",[25,3178,3176],{"__ignoreMap":285},[18,3180,3181],{},"例如：",[279,3183,3186],{"className":3184,"code":3185,"language":284},[282],"try {\n lock.lockInterruptibly();\n try {\n doWork();\n } finally {\n lock.unlock();\n }\n} catch (InterruptedException e) {\n Thread.currentThread().interrupt();\n}\n",[25,3187,3185],{"__ignoreMap":285},[18,3189,3190],{},"这对于避免线程长时间死等、响应取消请求很有价值。",[2911,3192],{},[10,3194,3196],{"id":3195},"六reentrantlock-支持尝试获取和超时","六、ReentrantLock 支持尝试获取和超时",[237,3198,3199],{"id":3199},"立即尝试",[279,3201,3204],{"className":3202,"code":3203,"language":284},[282],"if (lock.tryLock()) {\n try {\n doWork();\n } finally {\n lock.unlock();\n }\n} else {\n \u002F\u002F 获取失败，走降级逻辑\n}\n",[25,3205,3203],{"__ignoreMap":285},[237,3207,3208],{"id":3208},"超时尝试",[279,3210,3213],{"className":3211,"code":3212,"language":284},[282],"if (lock.tryLock(2, TimeUnit.SECONDS)) {\n try {\n doWork();\n } finally {\n lock.unlock();\n }\n} else {\n \u002F\u002F 两秒内未拿到锁\n}\n",[25,3214,3212],{"__ignoreMap":285},[18,3216,3217,3219],{},[25,3218,1302],{}," 一旦进入竞争，只能等待，无法直接设置超时。",[18,3221,3222],{},"这也是 ReentrantLock 在需要降级、超时控制时的重要优势。",[2911,3224],{},[10,3226,3228],{"id":3227},"七condition-比-waitnotify-更灵活","七、Condition 比 wait\u002Fnotify 更灵活",[18,3230,3231,3233],{},[25,3232,1302],{}," 的一个 Monitor 只有一个 WaitSet。",[18,3235,3236],{},"例如阻塞队列里：",[279,3238,3241],{"className":3239,"code":3240,"language":284},[282],"生产者等待 notFull\n消费者等待 notEmpty\n",[25,3242,3240],{"__ignoreMap":285},[18,3244,787,3245,3247],{},[25,3246,1302],{}," 时，生产者和消费者都在同一个 WaitSet 中，通常要：",[279,3249,3252],{"className":3250,"code":3251,"language":284},[282],"notifyAll();\n",[25,3253,3251],{"__ignoreMap":285},[18,3255,3256],{},"而 ReentrantLock 可以创建多个 Condition：",[279,3258,3261],{"className":3259,"code":3260,"language":284},[282],"Condition notFull = lock.newCondition();\nCondition notEmpty = lock.newCondition();\n",[25,3262,3260],{"__ignoreMap":285},[18,3264,3265],{},"生产者等待：",[279,3267,3270],{"className":3268,"code":3269,"language":284},[282],"while (queue.size() == capacity) {\n notFull.await();\n}\n",[25,3271,3269],{"__ignoreMap":285},[18,3273,3274],{},"消费者等待：",[279,3276,3279],{"className":3277,"code":3278,"language":284},[282],"while (queue.isEmpty()) {\n notEmpty.await();\n}\n",[25,3280,3278],{"__ignoreMap":285},[18,3282,3283],{},"生产完成：",[279,3285,3288],{"className":3286,"code":3287,"language":284},[282],"notEmpty.signal();\n",[25,3289,3287],{"__ignoreMap":285},[18,3291,3292],{},"消费完成：",[279,3294,3297],{"className":3295,"code":3296,"language":284},[282],"notFull.signal();\n",[25,3298,3296],{"__ignoreMap":285},[18,3300,3301],{},"这样可以精确唤醒，减少无效唤醒。",[2911,3303],{},[10,3305,3307],{"id":3306},"八底层实现不同","八、底层实现不同",[14,3309,1302],{"id":3310},"synchronized-2",[18,3312,3313],{},"经典理解：",[279,3315,3318],{"className":3316,"code":3317,"language":284},[282],"对象头 Mark Word\n+\nMonitor\n+\nJVM 锁优化\n",[25,3319,3317],{"__ignoreMap":285},[18,3321,3322],{},"JDK 8 中可能经历：",[279,3324,3327],{"className":3325,"code":3326,"language":284},[282],"偏向锁\n→ 轻量级锁\n→ 重量级锁\n",[25,3328,3326],{"__ignoreMap":285},[18,3330,3331],{},"这是 HotSpot 的 JVM 实现优化。",[14,3333,2858],{"id":3334},"reentrantlock-2",[18,3336,3337],{},"主要基于：",[279,3339,3342],{"className":3340,"code":3341,"language":284},[282],"AbstractQueuedSynchronizer\n",[25,3343,3341],{"__ignoreMap":285},[18,3345,3346],{},"也就是 AQS。",[18,3348,3349],{},"核心状态：",[279,3351,3354],{"className":3352,"code":3353,"language":284},[282],"volatile int state;\n",[25,3355,3353],{"__ignoreMap":285},[18,3357,3358],{},"独占锁时：",[279,3360,3363],{"className":3361,"code":3362,"language":284},[282],"state = 0 未加锁\nstate = 1 第一次获取\nstate > 1 重入次数\n",[25,3364,3362],{"__ignoreMap":285},[18,3366,3367,3368,3371],{},"竞争失败的线程进入 CLH 变体同步队列，并通过 ",[25,3369,3370],{},"park\u002Funpark"," 等待和唤醒。",[2911,3373],{},[10,3375,3377],{"id":3376},"九异常情况下的差异","九、异常情况下的差异",[18,3379,3380,3382],{},[25,3381,1302],{},"：",[279,3384,3387],{"className":3385,"code":3386,"language":284},[282],"synchronized (lock) {\n throw new RuntimeException();\n}\n",[25,3388,3386],{"__ignoreMap":285},[18,3390,3391],{},"离开同步块时，JVM 自动释放锁。",[18,3393,3394],{},"ReentrantLock：",[279,3396,3399],{"className":3397,"code":3398,"language":284},[282],"lock.lock();\ndoWork();\nlock.unlock();\n",[25,3400,3398],{"__ignoreMap":285},[18,3402,491,3403,3406],{},[25,3404,3405],{},"doWork()"," 抛异常：",[279,3408,3411],{"className":3409,"code":3410,"language":284},[282],"unlock 没执行\n→ 锁永久未释放\n",[25,3412,3410],{"__ignoreMap":285},[18,3414,3415],{},"所以必须写：",[279,3417,3420],{"className":3418,"code":3419,"language":284},[282],"lock.lock();\ntry {\n doWork();\n} finally {\n lock.unlock();\n}\n",[25,3421,3419],{"__ignoreMap":285},[18,3423,3424],{},"这是 ReentrantLock 最常见的编码风险。",[2911,3426],{},[10,3428,3430],{"id":3429},"十性能区别","十、性能区别",[18,3432,3433],{},"早期 JDK 中，ReentrantLock 性能常常明显优于 synchronized。",[18,3435,3436],{},"但 JDK 6 以后，JVM 对 synchronized 做了大量优化：",[245,3438,3439,3442,3444,3447,3450],{},[211,3440,3441],{},"偏向锁",[211,3443,1575],{},[211,3445,3446],{},"自旋",[211,3448,3449],{},"锁消除",[211,3451,3452],{},"锁粗化",[18,3454,3455],{},"现代 JDK 中：",[56,3457,3458],{},[18,3459,3460],{},"两者性能差异通常不是选型的首要依据。",[18,3462,3463],{},"应该根据功能需求选择，而不是简单认为 ReentrantLock 一定更快。",[2911,3465],{},[10,3467,3469],{"id":3468},"十一什么时候使用-synchronized","十一、什么时候使用 synchronized",[18,3471,3472],{},"适合：",[245,3474,3475,3478,3481,3484,3487,3490],{},[211,3476,3477],{},"临界区简单",[211,3479,3480],{},"不需要公平锁",[211,3482,3483],{},"不需要超时获取",[211,3485,3486],{},"不需要中断锁等待",[211,3488,3489],{},"只有一个等待条件",[211,3491,3492],{},"希望代码简单、自动释放锁",[18,3494,3181],{},[279,3496,3499],{"className":3497,"code":3498,"language":284},[282],"public synchronized void increment() {\n count++;\n}\n",[25,3500,3498],{"__ignoreMap":285},[18,3502,3503],{},"一般优先原则：",[56,3505,3506],{},[18,3507,3508],{},"能用 synchronized 清晰表达时，优先用 synchronized。",[2911,3510],{},[10,3512,3514],{"id":3513},"十二什么时候使用-reentrantlock","十二、什么时候使用 ReentrantLock",[18,3516,3472],{},[245,3518,3519,3522,3528,3531,3534,3537,3540],{},[211,3520,3521],{},"需要公平锁",[211,3523,3524,3525],{},"需要 ",[25,3526,3527],{},"tryLock",[211,3529,3530],{},"需要超时获取锁",[211,3532,3533],{},"需要可中断等待",[211,3535,3536],{},"需要多个 Condition",[211,3538,3539],{},"需要查询等待队列、持锁状态",[211,3541,3542],{},"需要更精细的锁控制",[18,3544,3545],{},"例如转账时避免死锁：",[279,3547,3550],{"className":3548,"code":3549,"language":284},[282],"if (accountA.lock.tryLock(100, TimeUnit.MILLISECONDS)) {\n try {\n if (accountB.lock.tryLock(100, TimeUnit.MILLISECONDS)) {\n try {\n transfer();\n } finally {\n accountB.lock.unlock();\n }\n }\n } finally {\n accountA.lock.unlock();\n }\n}\n",[25,3551,3549],{"__ignoreMap":285},[18,3553,3554],{},"使用 synchronized 很难实现这种超时退避。",[2911,3556],{},[10,3558,3560],{"id":3559},"十三waitnotify-和-awaitsignal-对应关系","十三、wait\u002Fnotify 和 await\u002Fsignal 对应关系",[98,3562,3563,3571],{},[101,3564,3565],{},[104,3566,3567,3569],{},[107,3568,1302],{},[107,3570,2858],{},[114,3572,3573,3584,3595],{},[104,3574,3575,3579],{},[119,3576,3577],{},[25,3578,1732],{},[119,3580,3581],{},[25,3582,3583],{},"Condition.await()",[104,3585,3586,3590],{},[119,3587,3588],{},[25,3589,2151],{},[119,3591,3592],{},[25,3593,3594],{},"Condition.signal()",[104,3596,3597,3601],{},[119,3598,3599],{},[25,3600,2154],{},[119,3602,3603],{},[25,3604,3605],{},"Condition.signalAll()",[18,3607,3608],{},"两者都要求：",[56,3610,3611],{},[18,3612,3613],{},"调用等待或通知方法前，必须先持有对应的锁。",[18,3615,3616,3617,3620],{},"并且等待都应该放在 ",[25,3618,3619],{},"while"," 中：",[279,3622,3625],{"className":3623,"code":3624,"language":284},[282],"while (!conditionSatisfied()) {\n condition.await();\n}\n",[25,3626,3624],{"__ignoreMap":285},[18,3628,3629],{},"防止虚假唤醒和竞争后条件失效。",[2911,3631],{},[10,3633,3635],{"id":3634},"十四常见误区","十四、常见误区",[237,3637,3639],{"id":3638},"误区一reentrantlock-才支持可重入","误区一：ReentrantLock 才支持可重入",[18,3641,3642],{},"不对。两者都可重入。",[237,3644,3646],{"id":3645},"误区二reentrantlock-一定比-synchronized-快","误区二：ReentrantLock 一定比 synchronized 快",[18,3648,3649],{},"不对。现代 JVM 下要看场景，功能差异比纯性能更重要。",[237,3651,3653],{"id":3652},"误区三synchronized-会自动释放reentrantlock-不会","误区三：synchronized 会自动释放，ReentrantLock 不会",[18,3655,3656],{},"更准确地说：",[245,3658,3659,3662],{},[211,3660,3661],{},"synchronized 离开同步块时自动释放",[211,3663,3664],{},"ReentrantLock 必须显式 unlock",[237,3666,3668],{"id":3667},"误区四公平锁一定更好","误区四：公平锁一定更好",[18,3670,3671],{},"公平锁吞吐量通常更低，只在有明确公平性需求时使用。",[237,3673,3675],{"id":3674},"误区五trylock-失败后可以直接-unlock","误区五：tryLock 失败后可以直接 unlock",[18,3677,3678],{},"不可以。只有成功获取锁后才能释放。",[18,3680,3681],{},"正确写法：",[279,3683,3686],{"className":3684,"code":3685,"language":284},[282],"boolean locked = false;\ntry {\n locked = lock.tryLock();\n if (!locked) {\n return;\n }\n\n doWork();\n} finally {\n if (locked) {\n lock.unlock();\n }\n}\n",[25,3687,3685],{"__ignoreMap":285},[2911,3689],{},[14,3691,3692],{"id":3692},"相关主题",[245,3694,3695],{},[211,3696,3697],{},[70,3698,1291],{"href":3699},"\u002Fwiki\u002Fjava\u002Fjdk8-synchronized-lock-states\u002F",{"title":285,"searchDepth":343,"depth":343,"links":3701},[3702,3703,3707,3713,3714,3721],{"id":66,"depth":343,"text":66},{"id":2872,"depth":343,"text":2873,"children":3704},[3705,3706],{"id":1302,"depth":359,"text":1302},{"id":2896,"depth":359,"text":2858},{"id":2915,"depth":343,"text":2916,"children":3708},[3709,3710,3711,3712],{"id":3086,"depth":359,"text":1302},{"id":3098,"depth":359,"text":2858},{"id":3199,"depth":359,"text":3199},{"id":3208,"depth":359,"text":3208},{"id":3310,"depth":343,"text":1302},{"id":3334,"depth":343,"text":2858,"children":3715},[3716,3717,3718,3719,3720],{"id":3638,"depth":359,"text":3639},{"id":3645,"depth":359,"text":3646},{"id":3652,"depth":359,"text":3653},{"id":3667,"depth":359,"text":3668},{"id":3674,"depth":359,"text":3675},{"id":3692,"depth":343,"text":3692},"wiki:java:synchronized-vs-reentrantlock","对比 synchronized 与 ReentrantLock 的实现、可重入、公平锁、中断、超时、Condition 和适用场景。","intermediate",{},71,"\u002Fjava\u002Fsynchronized-vs-reentrantlock",{"title":2743,"description":3723},"java\u002Fsynchronized-vs-reentrantlock","2026-07-21","HvwBdM7dDk9OpIeOwtk34xX3bS9W_vivGkHtOntEom0",{"id":3733,"title":3734,"body":3735,"commentId":5037,"description":5038,"difficulty":1276,"draft":1277,"extension":1278,"meta":5039,"navigation":1280,"order":5040,"path":5041,"section":1283,"seo":5042,"stem":5043,"updated":5044,"__hash__":5045},"java\u002Fjava\u002Fkafka-message-loss-prevention.md","Kafka 如何保证消息不丢失",{"type":7,"value":3736,"toc":4992},[3737,3740,3742,3759,3761,3768,3770,3779,3781,3784,3791,3794,3798,3801,3815,3818,3822,3828,3835,3890,3893,3907,3916,3920,3923,3966,3969,3972,3985,3989,3992,4008,4015,4076,4082,4086,4089,4095,4098,4101,4107,4110,4114,4118,4121,4127,4130,4133,4137,4140,4143,4149,4152,4158,4163,4169,4172,4178,4181,4186,4189,4193,4206,4212,4215,4225,4228,4234,4244,4249,4252,4256,4260,4272,4275,4281,4284,4288,4291,4297,4300,4411,4414,4418,4421,4427,4430,4447,4454,4458,4461,4467,4470,4483,4486,4489,4493,4496,4502,4506,4509,4512,4518,4521,4524,4544,4551,4554,4560,4566,4570,4573,4575,4581,4587,4590,4604,4608,4679,4682,4689,4693,4743,4746,4753,4756,4760,4870,4874,4881,4889,4893,4899,4903,4906,4910,4913,4917,4920,4924,4927,4947,4950,4952,4989],[10,3738,3734],{"id":3739},"kafka-如何保证消息不丢失",[14,3741,16],{"id":16},[56,3743,3744],{},[18,3745,3746,3747,3750,3751,3754,3755,3758],{},"Kafka 保证消息不丢失需要覆盖生产者、Broker 和消费者三段链路。生产者侧使用 ",[25,3748,3749],{},"acks=all","、开启重试和幂等生产，并检查发送回调，对最终失败进行落库、告警或补偿；Broker 侧通常设置三副本、",[25,3752,3753],{},"min.insync.replicas=2","，并关闭非同步副本选举，即配置 ",[25,3756,3757],{},"unclean.leader.election.enable=false","，保证消息在足够多的同步副本写入后才确认成功；消费者侧关闭自动提交，在业务处理成功后再提交 Offset，失败时不提交以便重新消费。这样通常实现至少一次投递，所以消费端还必须通过事件 ID、唯一索引或状态机保证幂等。涉及数据库与 Kafka 的一致性时，可以使用 Transactional Outbox；消费端需要应对重复消息时，可以使用 Inbox。Kafka 的消息不丢失是端到端保障，不是只配置一个参数。",[18,3760,54],{},[56,3762,3763],{},[18,3764,3765],{},[61,3766,3767],{},"生产者确认成功，Broker 多副本可靠保存，消费者处理成功后提交，业务端用幂等和补偿兜底。",[14,3769,66],{"id":66},[18,3771,3772],{},[70,3773,3776],{"href":3774,"target":73,"rel":3775},"\u002Fimages\u002Fwiki\u002Fjava\u002Fkafka-message-loss-prevention.svg",[75,76],[78,3777],{"src":3774,"alt":3778},"Kafka 消息不丢失的端到端保障链路",[14,3780,83],{"id":83},[18,3782,3783],{},"Kafka 消息不丢失不是靠某一个参数实现的，而是一个端到端问题：",[56,3785,3786],{},[18,3787,3788],{},[61,3789,3790],{},"生产者必须确认消息发送成功，Broker 必须把消息可靠地保存在足够多的副本中，消费者必须在业务处理成功后再提交 Offset。",[18,3792,3793],{},"其中任何一个环节处理不当，都可能出现“业务上看起来消息丢了”的情况。",[14,3795,3797],{"id":3796},"一先明确什么叫消息丢失","一、先明确什么叫“消息丢失”",[18,3799,3800],{},"常见的丢失场景主要有四类：",[208,3802,3803,3806,3809,3812],{},[211,3804,3805],{},"生产者调用发送方法后没有检查结果，实际发送失败却被业务忽略。",[211,3807,3808],{},"Leader 收到消息后就返回成功，消息还未复制到 Follower，Leader 随后故障。",[211,3810,3811],{},"消费者先提交 Offset，再执行业务；业务处理失败后，消息不会再次投递。",[211,3813,3814],{},"Kafka 中的消息没有丢，但写数据库、调用下游等业务操作失败，又没有补偿机制。",[18,3816,3817],{},"因此，Kafka 中仍能查到消息，不代表业务一定处理成功；反过来，业务没有结果，也不一定是 Broker 丢了消息。",[14,3819,3821],{"id":3820},"二生产者如何避免丢消息","二、生产者如何避免丢消息",[237,3823,3825,3826],{"id":3824},"_1-使用-acksall","1. 使用 ",[25,3827,3749],{},[18,3829,3830,3831,3834],{},"生产者的 ",[25,3832,3833],{},"acks"," 决定 Broker 在什么条件下确认发送成功：",[98,3836,3837,3850],{},[101,3838,3839],{},[104,3840,3841,3844,3847],{},[107,3842,3843],{},"配置",[107,3845,3846],{},"确认时机",[107,3848,3849],{},"风险",[114,3851,3852,3865,3878],{},[104,3853,3854,3859,3862],{},[119,3855,3856],{},[25,3857,3858],{},"acks=0",[119,3860,3861],{},"不等待 Broker 响应",[119,3863,3864],{},"发送失败也无法感知，风险最高",[104,3866,3867,3872,3875],{},[119,3868,3869],{},[25,3870,3871],{},"acks=1",[119,3873,3874],{},"Leader 写入本地日志后返回",[119,3876,3877],{},"Leader 故障且副本尚未同步时可能丢失",[104,3879,3880,3884,3887],{},[119,3881,3882],{},[25,3883,3749],{},[119,3885,3886],{},"当前 ISR 中的副本都确认后返回",[119,3888,3889],{},"Kafka 能提供的最强生产者确认保证",[18,3891,3892],{},"关键配置：",[279,3894,3898],{"className":3895,"code":3896,"language":3897,"meta":285,"style":285},"language-properties shiki shiki-themes github-light github-dark","acks=all\n","properties",[25,3899,3900],{"__ignoreMap":285},[315,3901,3902,3904],{"class":317,"line":318},[315,3903,3833],{"class":325},[315,3905,3906],{"class":333},"=all\n",[18,3908,3909,3911,3912,3915],{},[25,3910,3749],{}," 并不等于绝对不丢。它还需要与副本数和 ",[25,3913,3914],{},"min.insync.replicas"," 配合，否则 ISR 中只剩 Leader 一个副本时，依然可能成功写入。",[237,3917,3919],{"id":3918},"_2-开启重试和幂等生产","2. 开启重试和幂等生产",[18,3921,3922],{},"网络抖动、Leader 切换等临时故障可能导致发送失败，生产者需要允许重试：",[279,3924,3926],{"className":3895,"code":3925,"language":3897,"meta":285,"style":285},"enable.idempotence=true\nacks=all\nretries=2147483647\nmax.in.flight.requests.per.connection=5\ndelivery.timeout.ms=120000\n",[25,3927,3928,3936,3942,3950,3958],{"__ignoreMap":285},[315,3929,3930,3933],{"class":317,"line":318},[315,3931,3932],{"class":325},"enable.idempotence",[315,3934,3935],{"class":333},"=true\n",[315,3937,3938,3940],{"class":317,"line":343},[315,3939,3833],{"class":325},[315,3941,3906],{"class":333},[315,3943,3944,3947],{"class":317,"line":359},[315,3945,3946],{"class":325},"retries",[315,3948,3949],{"class":333},"=2147483647\n",[315,3951,3952,3955],{"class":317,"line":375},[315,3953,3954],{"class":325},"max.in.flight.requests.per.connection",[315,3956,3957],{"class":333},"=5\n",[315,3959,3960,3963],{"class":317,"line":391},[315,3961,3962],{"class":325},"delivery.timeout.ms",[315,3964,3965],{"class":333},"=120000\n",[18,3967,3968],{},"幂等生产者会给消息附加 Producer ID 和序列号，使 Broker 能识别同一生产会话内的重复写入，避免因重试产生重复消息。",[18,3970,3971],{},"需要注意：",[245,3973,3974,3977,3982],{},[211,3975,3976],{},"幂等生产解决的是重试导致的重复写入，不是发送失败后的业务补偿。",[211,3978,3979,3981],{},[25,3980,3962],{}," 到期后，生产者仍可能最终失败。",[211,3983,3984],{},"业务不能无限依赖客户端重试，最终失败必须记录、告警或进入补偿流程。",[237,3986,3988],{"id":3987},"_3-必须检查发送结果","3. 必须检查发送结果",[18,3990,3991],{},"下面这种“只发送、不处理结果”的写法存在风险：",[279,3993,3995],{"className":2173,"code":3994,"language":2175,"meta":285,"style":285},"producer.send(record);\n",[25,3996,3997],{"__ignoreMap":285},[315,3998,3999,4002,4005],{"class":317,"line":318},[315,4000,4001],{"class":333},"producer.",[315,4003,4004],{"class":321},"send",[315,4006,4007],{"class":333},"(record);\n",[18,4009,4010,4011,4014],{},"应该检查回调或 ",[25,4012,4013],{},"Future"," 的执行结果：",[279,4016,4018],{"className":2173,"code":4017,"language":2175,"meta":285,"style":285},"producer.send(record, (metadata, exception) -> {\n if (exception != null) {\n \u002F\u002F 记录原始消息、告警并进入补偿流程\n handleSendFailure(record, exception);\n }\n});\n",[25,4019,4020,4035,4052,4058,4066,4071],{"__ignoreMap":285},[315,4021,4022,4024,4026,4029,4032],{"class":317,"line":318},[315,4023,4001],{"class":333},[315,4025,4004],{"class":321},[315,4027,4028],{"class":333},"(record, (metadata, exception) ",[315,4030,4031],{"class":325},"->",[315,4033,4034],{"class":333}," {\n",[315,4036,4037,4040,4043,4046,4049],{"class":317,"line":343},[315,4038,4039],{"class":325}," if",[315,4041,4042],{"class":333}," (exception ",[315,4044,4045],{"class":325},"!=",[315,4047,4048],{"class":839}," null",[315,4050,4051],{"class":333},") {\n",[315,4053,4054],{"class":317,"line":359},[315,4055,4057],{"class":4056},"sJ8bj"," \u002F\u002F 记录原始消息、告警并进入补偿流程\n",[315,4059,4060,4063],{"class":317,"line":375},[315,4061,4062],{"class":321}," handleSendFailure",[315,4064,4065],{"class":333},"(record, exception);\n",[315,4067,4068],{"class":317,"line":391},[315,4069,4070],{"class":333}," }\n",[315,4072,4073],{"class":317,"line":2562},[315,4074,4075],{"class":333},"});\n",[18,4077,4078,4079,4081],{},"序列化失败、鉴权失败、消息过大和超时等错误，最终都需要业务明确处理。不能把“调用过 ",[25,4080,4004],{},"”当成“消息已经可靠进入 Kafka”。",[237,4083,4085],{"id":4084},"_4-数据库与-kafka-的一致性","4. 数据库与 Kafka 的一致性",[18,4087,4088],{},"如果业务流程是：",[279,4090,4093],{"className":4091,"code":4092,"language":284,"meta":285},[282],"更新数据库\n→\n发送 Kafka 消息\n",[25,4094,4092],{"__ignoreMap":285},[18,4096,4097],{},"数据库更新成功、消息发送失败时，仍然会造成业务事件丢失。",[18,4099,4100],{},"常见解决方式是本地消息表，也叫 Transactional Outbox：",[279,4102,4105],{"className":4103,"code":4104,"language":284,"meta":285},[282],"同一个数据库事务\n├── 更新业务数据\n└── 写入待发送事件表\n\n事务提交后\n→ 后台任务投递 Kafka\n→ 成功后标记事件已发送\n",[25,4106,4104],{"__ignoreMap":285},[18,4108,4109],{},"这样即使 Kafka 暂时不可用，消息也可以从本地消息表继续重试。Kafka 事务可以保证 Kafka 内部多条记录及消费 Offset 的原子性，但不会自动把外部数据库事务包含进来。",[14,4111,4113],{"id":4112},"三broker-如何保证消息可靠保存","三、Broker 如何保证消息可靠保存",[237,4115,4117],{"id":4116},"_1-合理设置副本数","1. 合理设置副本数",[18,4119,4120],{},"生产环境通常使用：",[279,4122,4125],{"className":4123,"code":4124,"language":284,"meta":285},[282],"replication.factor = 3\n",[25,4126,4124],{"__ignoreMap":285},[18,4128,4129],{},"一个分区包含一个 Leader 和多个 Follower。生产者与 Leader 交互，Follower 从 Leader 复制日志。某个 Broker 故障后，可以从仍然同步的副本中选举新 Leader。",[18,4131,4132],{},"副本数提高的是容错能力，但副本只有真正保持同步才有意义。",[237,4134,4136],{"id":4135},"_2-理解-isr","2. 理解 ISR",[18,4138,4139],{},"ISR 是 In-Sync Replicas，即当前与 Leader 保持同步的副本集合。",[18,4141,4142],{},"例如一个三副本分区：",[279,4144,4147],{"className":4145,"code":4146,"language":284,"meta":285},[282],"Leader A\nFollower B\nFollower C\n\nISR = [A, B, C]\n",[25,4148,4146],{"__ignoreMap":285},[18,4150,4151],{},"如果 C 长时间跟不上 Leader，它会被移出 ISR：",[279,4153,4156],{"className":4154,"code":4155,"language":284,"meta":285},[282],"ISR = [A, B]\n",[25,4157,4155],{"__ignoreMap":285},[18,4159,4160,4162],{},[25,4161,3749],{}," 等待的是当前 ISR 的确认，而不是永远等待所有配置副本。",[237,4164,4166,4167],{"id":4165},"_3-配置-mininsyncreplicas","3. 配置 ",[25,4168,3914],{},[18,4170,4171],{},"推荐组合：",[279,4173,4176],{"className":4174,"code":4175,"language":284,"meta":285},[282],"replication.factor = 3\nmin.insync.replicas = 2\nacks = all\n",[25,4177,4175],{"__ignoreMap":285},[18,4179,4180],{},"它表达的含义是：",[56,4182,4183],{},[18,4184,4185],{},"至少要有两个同步副本可用，写入才允许成功。",[18,4187,4188],{},"如果 ISR 只剩一个副本，Broker 会拒绝写入。此时系统牺牲部分可用性，避免在单副本状态下继续写入并承担更高的数据丢失风险。",[237,4190,4192],{"id":4191},"_4-关闭非同步副本选举","4. 关闭非同步副本选举",[279,4194,4196],{"className":3895,"code":4195,"language":3897,"meta":285,"style":285},"unclean.leader.election.enable=false\n",[25,4197,4198],{"__ignoreMap":285},[315,4199,4200,4203],{"class":317,"line":318},[315,4201,4202],{"class":325},"unclean.leader.election.enable",[315,4204,4205],{"class":333},"=false\n",[18,4207,4208,4211],{},[25,4209,4210],{},"unclean leader election"," 指允许不在 ISR 中的副本被选举为 Leader。如果所有同步副本都不可用，非 ISR 副本可能缺少最新消息；将它选为 Leader 虽然能更快恢复分区服务，却可能造成日志回退和数据丢失。",[18,4213,4214],{},"因此，对数据可靠性要求较高的场景应明确配置：",[56,4216,4217],{},[18,4218,4219],{},[61,4220,4221,4222,4224],{},"关闭非同步副本选举：",[25,4223,3757],{},"。",[18,4226,4227],{},"这是一个典型的取舍：",[279,4229,4232],{"className":4230,"code":4231,"language":284,"meta":285},[282],"开启非同步副本选举：可用性更高，但可能丢失消息\n关闭非同步副本选举：数据可靠性更强，但分区可能暂时不可用\n",[25,4233,4231],{"__ignoreMap":285},[237,4235,4237,4238,4240,4241],{"id":4236},"_5-acksall-不等于每条消息都立即-fsync","5. ",[25,4239,3749],{}," 不等于每条消息都立即 ",[25,4242,4243],{},"fsync",[18,4245,4246,4247,4224],{},"Kafka 的持久性主要依赖顺序写日志、操作系统页缓存和多副本机制。Broker 返回成功，并不表示每个副本都对该消息单独执行了一次物理磁盘 ",[25,4248,4243],{},[18,4250,4251],{},"实际生产中，通常通过跨 Broker 副本降低单机和单盘故障风险，而不是强制每条消息同步刷盘。若多个副本同时发生不可恢复故障，仍不存在数学意义上的绝对零丢失。",[14,4253,4255],{"id":4254},"四消费者如何避免消费丢失","四、消费者如何避免“消费丢失”",[237,4257,4259],{"id":4258},"_1-关闭自动提交-offset","1. 关闭自动提交 Offset",[279,4261,4263],{"className":3895,"code":4262,"language":3897,"meta":285,"style":285},"enable.auto.commit=false\n",[25,4264,4265],{"__ignoreMap":285},[315,4266,4267,4270],{"class":317,"line":318},[315,4268,4269],{"class":325},"enable.auto.commit",[315,4271,4205],{"class":333},[18,4273,4274],{},"自动提交可能出现以下顺序：",[279,4276,4279],{"className":4277,"code":4278,"language":284,"meta":285},[282],"拉取消息\n→ 自动提交 Offset\n→ 执行业务\n→ 进程崩溃\n",[25,4280,4278],{"__ignoreMap":285},[18,4282,4283],{},"重启后，消费者会从已提交的下一个 Offset 继续消费，刚才尚未处理成功的消息就被跳过了。",[237,4285,4287],{"id":4286},"_2-业务成功后再提交-offset","2. 业务成功后再提交 Offset",[18,4289,4290],{},"更可靠的顺序是：",[279,4292,4295],{"className":4293,"code":4294,"language":284,"meta":285},[282],"拉取消息\n→ 执行业务\n→ 业务成功\n→ 提交 Offset\n",[25,4296,4294],{"__ignoreMap":285},[18,4298,4299],{},"如果业务处理失败，就不提交 Offset，让消息后续重新消费：",[279,4301,4303],{"className":2173,"code":4302,"language":2175,"meta":285,"style":285},"while (true) {\n ConsumerRecords\u003CString, String> records = consumer.poll(Duration.ofSeconds(1));\n\n for (ConsumerRecord\u003CString, String> record : records) {\n process(record);\n }\n\n consumer.commitSync();\n}\n",[25,4304,4305,4317,4355,4359,4382,4389,4393,4397,4407],{"__ignoreMap":285},[315,4306,4307,4309,4312,4315],{"class":317,"line":318},[315,4308,3619],{"class":325},[315,4310,4311],{"class":333}," (",[315,4313,4314],{"class":839},"true",[315,4316,4051],{"class":333},[315,4318,4319,4322,4325,4328,4330,4333,4335,4338,4341,4344,4347,4350,4352],{"class":317,"line":343},[315,4320,4321],{"class":333}," ConsumerRecords\u003C",[315,4323,4324],{"class":325},"String",[315,4326,4327],{"class":333},", ",[315,4329,4324],{"class":325},[315,4331,4332],{"class":333},"> records ",[315,4334,2511],{"class":325},[315,4336,4337],{"class":333}," consumer.",[315,4339,4340],{"class":321},"poll",[315,4342,4343],{"class":333},"(Duration.",[315,4345,4346],{"class":321},"ofSeconds",[315,4348,4349],{"class":333},"(",[315,4351,1560],{"class":839},[315,4353,4354],{"class":333},"));\n",[315,4356,4357],{"class":317,"line":359},[315,4358,2525],{"emptyLinePlaceholder":1280},[315,4360,4361,4364,4367,4369,4371,4373,4376,4379],{"class":317,"line":375},[315,4362,4363],{"class":325}," for",[315,4365,4366],{"class":333}," (ConsumerRecord\u003C",[315,4368,4324],{"class":325},[315,4370,4327],{"class":333},[315,4372,4324],{"class":325},[315,4374,4375],{"class":333},"> record ",[315,4377,4378],{"class":325},":",[315,4380,4381],{"class":333}," records) {\n",[315,4383,4384,4387],{"class":317,"line":391},[315,4385,4386],{"class":321}," process",[315,4388,4007],{"class":333},[315,4390,4391],{"class":317,"line":2562},[315,4392,4070],{"class":333},[315,4394,4395],{"class":317,"line":2580},[315,4396,2525],{"emptyLinePlaceholder":1280},[315,4398,4399,4402,4405],{"class":317,"line":2586},[315,4400,4401],{"class":333}," consumer.",[315,4403,4404],{"class":321},"commitSync",[315,4406,2520],{"class":333},[315,4408,4409],{"class":317,"line":2591},[315,4410,2583],{"class":333},[18,4412,4413],{},"示例表达的是基本原则。实际批量消费时，如果一批消息中只有部分成功，需要准确管理各分区可提交的 Offset，不能直接把失败消息之后的位置一起提交。",[237,4415,4417],{"id":4416},"_3-为什么还需要业务幂等","3. 为什么还需要业务幂等",[18,4419,4420],{},"“处理成功后提交”可以避免消息被跳过，但会引入重复：",[279,4422,4425],{"className":4423,"code":4424,"language":284,"meta":285},[282],"业务处理成功\n→ 提交 Offset 前进程崩溃\n→ 重启后再次消费同一条消息\n",[25,4426,4424],{"__ignoreMap":285},[18,4428,4429],{},"因此，可靠消费通常采用至少一次投递，并在业务层保证幂等。常见方式包括：",[245,4431,4432,4435,4438,4441,4444],{},[211,4433,4434],{},"使用事件 ID 建立数据库唯一索引。",[211,4436,4437],{},"建立消费去重表或 Inbox 表。",[211,4439,4440],{},"使用业务状态机，只允许合法状态转换。",[211,4442,4443],{},"更新时带版本号或业务条件。",[211,4445,4446],{},"对扣款、发券等操作使用唯一业务流水号。",[56,4448,4449],{},[18,4450,4451],{},[61,4452,4453],{},"不丢消息通常意味着允许重复，再通过幂等消除重复影响。",[237,4455,4457],{"id":4456},"_4-kafka-内部链路的-exactly-once","4. Kafka 内部链路的 Exactly Once",[18,4459,4460],{},"如果消费 Kafka 后仍然写回 Kafka，可以使用 Kafka 事务，把输出记录和消费 Offset 放进同一个事务：",[279,4462,4465],{"className":4463,"code":4464,"language":284,"meta":285},[282],"消费消息\n→ 处理\n→ 写入下游 Topic\n→ sendOffsetsToTransaction\n→ 提交事务\n",[25,4466,4464],{"__ignoreMap":285},[18,4468,4469],{},"下游消费者设置：",[279,4471,4473],{"className":3895,"code":4472,"language":3897,"meta":285,"style":285},"isolation.level=read_committed\n",[25,4474,4475],{"__ignoreMap":285},[315,4476,4477,4480],{"class":317,"line":318},[315,4478,4479],{"class":325},"isolation.level",[315,4481,4482],{"class":333},"=read_committed\n",[18,4484,4485],{},"这样只读取已提交事务的数据。",[18,4487,4488],{},"但如果最终写入的是 MySQL 等外部系统，Kafka 事务并不能自动保证 Kafka 与数据库的原子性。生产方可以用 Outbox 保证事件可靠发出，消费方可以用 Inbox 应对重复消费，具体区别见下一节。",[14,4490,4492],{"id":4491},"五outbox-与-inbox-分别是什么","五、Outbox 与 Inbox 分别是什么",[18,4494,4495],{},"Outbox 和 Inbox 都借助数据库本地事务解决消息链路中的一致性问题，但它们位于不同位置：",[279,4497,4500],{"className":4498,"code":4499,"language":284,"meta":285},[282],"业务生产方 → Outbox → Kafka → Inbox → 业务消费方\n",[25,4501,4499],{"__ignoreMap":285},[237,4503,4505],{"id":4504},"_1-outbox保证业务事件可靠发出","1. Outbox：保证业务事件可靠发出",[18,4507,4508],{},"Outbox 位于消息生产方，用来解决“数据库更新成功，但 Kafka 消息发送失败”的双写不一致问题。",[18,4510,4511],{},"核心流程：",[279,4513,4516],{"className":4514,"code":4515,"language":284,"meta":285},[282],"同一个数据库事务\n├── 更新业务数据\n└── 写入 Outbox 事件表\n\n事务提交\n→ 后台投递程序扫描 Outbox\n→ 发送 Kafka\n→ 收到成功确认后标记已发送\n",[25,4517,4515],{"__ignoreMap":285},[18,4519,4520],{},"例如创建订单时，不直接把“订单创建事件”的可靠性寄托在一次 Kafka 调用上，而是在创建订单的同一个数据库事务中写入一条 Outbox 记录。即使 Kafka 暂时不可用，后台任务仍可继续重试。",[18,4522,4523],{},"Outbox 的关键点：",[245,4525,4526,4529,4535,4538,4541],{},[211,4527,4528],{},"业务数据和事件记录必须写入同一个数据库事务。",[211,4530,4531,4532,4224],{},"每条事件应有全局唯一的 ",[25,4533,4534],{},"eventId",[211,4536,4537],{},"投递程序可以轮询事件表，也可以通过 CDC 捕获新增事件。",[211,4539,4540],{},"“发送成功但标记失败”可能导致再次投递，因此消费者仍需幂等。",[211,4542,4543],{},"Outbox 解决的是事件可靠发出，不保证消费者一定处理成功。",[18,4545,4546,4547,4550],{},"这里的 CDC 是 ",[61,4548,4549],{},"Change Data Capture（变更数据捕获）","。它会读取数据库的变更日志，例如 MySQL Binlog，捕获数据的新增、修改和删除，再把变更发送到 Kafka。常用工具有 Debezium、Canal。",[18,4552,4553],{},"在 Outbox 场景中，它的工作链路是：",[279,4555,4558],{"className":4556,"code":4557,"language":284,"meta":285},[282],"业务事务写入业务表和 Outbox 表\n→ CDC 监听 Binlog\n→ 捕获新增的 Outbox 记录\n→ 发送到 Kafka\n",[25,4559,4557],{"__ignoreMap":285},[18,4561,4562,4563,4565],{},"相比定时扫描 Outbox 表，CDC 延迟更低，也能减少频繁查询数据库的压力。但消息链路仍可能产生重复，因此必须保留 ",[25,4564,4534],{},"，并由消费端保证幂等。",[237,4567,4569],{"id":4568},"_2-inbox保证重复消息只产生一次业务效果","2. Inbox：保证重复消息只产生一次业务效果",[18,4571,4572],{},"Inbox 位于消息消费方，用来记录已经处理过的事件，主要解决至少一次投递带来的重复消费问题。",[18,4574,4511],{},[279,4576,4579],{"className":4577,"code":4578,"language":284,"meta":285},[282],"收到 Kafka 消息\n→ 开启数据库事务\n→ 根据 eventId 写入 Inbox 记录\n→ 执行业务更新\n→ 提交数据库事务\n→ 提交 Kafka Offset\n",[25,4580,4578],{"__ignoreMap":285},[18,4582,4583,4584,4586],{},"Inbox 表通常对 ",[25,4585,4534],{}," 建立唯一索引。重复消息到达时，如果发现该事件已经存在，就不再重复执行业务逻辑。",[18,4588,4589],{},"Inbox 的关键点：",[245,4591,4592,4595,4598,4601],{},[211,4593,4594],{},"Inbox 记录和业务更新必须处于同一个数据库事务。",[211,4596,4597],{},"唯一索引负责防止同一事件被并发重复处理。",[211,4599,4600],{},"数据库事务提交后、Offset 提交前发生故障，消息仍会重投，但 Inbox 可以识别重复。",[211,4602,4603],{},"如果消费逻辑还会调用外部 HTTP 接口，Inbox 无法自动让数据库和外部接口形成原子事务；仍需下游幂等、重试或补偿。",[237,4605,4607],{"id":4606},"_3-两者的区别","3. 两者的区别",[98,4609,4610,4622],{},[101,4611,4612],{},[104,4613,4614,4616,4619],{},[107,4615,2925],{},[107,4617,4618],{},"Outbox",[107,4620,4621],{},"Inbox",[114,4623,4624,4635,4646,4657,4668],{},[104,4625,4626,4629,4632],{},[119,4627,4628],{},"所在位置",[119,4630,4631],{},"消息生产方",[119,4633,4634],{},"消息消费方",[104,4636,4637,4640,4643],{},[119,4638,4639],{},"主要目标",[119,4641,4642],{},"防止业务成功但事件未发出",[119,4644,4645],{},"防止重复消息重复产生业务效果",[104,4647,4648,4651,4654],{},[119,4649,4650],{},"本地事务内容",[119,4652,4653],{},"业务更新 + 写事件表",[119,4655,4656],{},"写消费记录 + 业务更新",[104,4658,4659,4662,4665],{},[119,4660,4661],{},"后台动作",[119,4663,4664],{},"把待发送事件投递到 Kafka",[119,4666,4667],{},"通常不需要再次投递",[104,4669,4670,4673,4676],{},[119,4671,4672],{},"仍需注意",[119,4674,4675],{},"投递过程可能产生重复消息",[119,4677,4678],{},"外部调用仍需幂等或补偿",[18,4680,4681],{},"一句话区分：",[56,4683,4684],{},[18,4685,4686],{},[61,4687,4688],{},"Outbox 保证“该发的消息最终发出去”，Inbox 保证“重复收到的消息不会重复生效”。",[14,4690,4692],{"id":4691},"六三种投递语义","六、三种投递语义",[98,4694,4695,4708],{},[101,4696,4697],{},[104,4698,4699,4702,4705],{},[107,4700,4701],{},"语义",[107,4703,4704],{},"Offset 与业务处理顺序",[107,4706,4707],{},"结果",[114,4709,4710,4721,4732],{},[104,4711,4712,4715,4718],{},[119,4713,4714],{},"At Most Once",[119,4716,4717],{},"先提交，再处理",[119,4719,4720],{},"可能丢失，通常不重复",[104,4722,4723,4726,4729],{},[119,4724,4725],{},"At Least Once",[119,4727,4728],{},"先处理，再提交",[119,4730,4731],{},"不轻易丢失，可能重复",[104,4733,4734,4737,4740],{},[119,4735,4736],{},"Exactly Once",[119,4738,4739],{},"事务或幂等机制协调",[119,4741,4742],{},"业务效果恰好一次",[18,4744,4745],{},"绝大多数业务系统采用：",[56,4747,4748],{},[18,4749,4750],{},[61,4751,4752],{},"Kafka 至少一次投递 + 消费端业务幂等。",[18,4754,4755],{},"这通常比追求所有环节的强事务更容易实现，也更便于扩展。",[14,4757,4759],{"id":4758},"七常见故障与保障措施","七、常见故障与保障措施",[98,4761,4762,4775],{},[101,4763,4764],{},[104,4765,4766,4769,4772],{},[107,4767,4768],{},"故障场景",[107,4770,4771],{},"可能后果",[107,4773,4774],{},"主要保障",[114,4776,4777,4788,4801,4814,4826,4837,4848,4859],{},[104,4778,4779,4782,4785],{},[119,4780,4781],{},"生产者网络抖动",[119,4783,4784],{},"发送失败或结果未知",[119,4786,4787],{},"重试、幂等生产、回调处理",[104,4789,4790,4793,4796],{},[119,4791,4792],{},"Leader 写入后立即故障",[119,4794,4795],{},"未同步消息丢失",[119,4797,4798,4800],{},[25,4799,3749],{},"、副本、ISR",[104,4802,4803,4806,4809],{},[119,4804,4805],{},"ISR 只剩一个副本",[119,4807,4808],{},"单点故障风险升高",[119,4810,4811,4813],{},[25,4812,3914],{}," 拒绝写入",[104,4815,4816,4819,4822],{},[119,4817,4818],{},"同步副本全部不可用",[119,4820,4821],{},"非同步副本选主后日志回退",[119,4823,4221,4824],{},[25,4825,3757],{},[104,4827,4828,4831,4834],{},[119,4829,4830],{},"消费者先提交后处理",[119,4832,4833],{},"业务消息被跳过",[119,4835,4836],{},"关闭自动提交，成功后提交",[104,4838,4839,4842,4845],{},[119,4840,4841],{},"处理成功但提交前崩溃",[119,4843,4844],{},"重复消费",[119,4846,4847],{},"业务幂等、唯一流水号",[104,4849,4850,4853,4856],{},[119,4851,4852],{},"数据库成功、Kafka 失败",[119,4854,4855],{},"业务事件未发出",[119,4857,4858],{},"Transactional Outbox",[104,4860,4861,4864,4867],{},[119,4862,4863],{},"Kafka 成功、下游失败",[119,4865,4866],{},"业务结果缺失",[119,4868,4869],{},"重试、死信、补偿、告警",[14,4871,4873],{"id":4872},"八常见误区","八、常见误区",[237,4875,4877,4878,4880],{"id":4876},"误区一配置-acksall-就绝对不会丢","误区一：配置 ",[25,4879,3749],{}," 就绝对不会丢",[18,4882,4883,4885,4886,4888],{},[25,4884,3749],{}," 只解决生产者到 Broker 的确认强度，还要配合副本数、",[25,4887,3914],{},"、正确选主和消费者提交策略。",[237,4890,4892],{"id":4891},"误区二配置无限重试就不会丢","误区二：配置无限重试就不会丢",[18,4894,4895,4896,4898],{},"重试仍然受 ",[25,4897,3962],{}," 等条件限制，而且权限错误、序列化错误等问题无法靠盲目重试解决。最终失败必须被业务感知和补偿。",[237,4900,4902],{"id":4901},"误区三手动提交-offset-就是-exactly-once","误区三：手动提交 Offset 就是 Exactly Once",[18,4904,4905],{},"手动提交只能帮助建立“处理成功后提交”的顺序，崩溃窗口仍可能造成重复消费，因此还需要业务幂等。",[237,4907,4909],{"id":4908},"误区四kafka-事务可以自动覆盖数据库","误区四：Kafka 事务可以自动覆盖数据库",[18,4911,4912],{},"Kafka 事务主要协调 Kafka 内部的消息与 Offset，不会自动与 MySQL 等外部数据库形成同一个原子事务。",[237,4914,4916],{"id":4915},"误区五broker-返回成功就等于所有副本已经物理刷盘","误区五：Broker 返回成功就等于所有副本已经物理刷盘",[18,4918,4919],{},"Kafka 的确认、副本复制和磁盘刷盘是不同概念。高可靠主要依靠多副本和同步副本约束，而不是把每条消息都单独同步刷盘。",[14,4921,4923],{"id":4922},"九监控和运维同样重要","九、监控和运维同样重要",[18,4925,4926],{},"配置正确后，还应持续监控：",[245,4928,4929,4932,4935,4938,4941,4944],{},[211,4930,4931],{},"发送失败率、重试次数和发送延迟。",[211,4933,4934],{},"ISR 收缩、未充分复制分区和离线分区。",[211,4936,4937],{},"Broker 磁盘空间、磁盘延迟和网络异常。",[211,4939,4940],{},"消费积压、消费失败、重平衡次数。",[211,4942,4943],{},"死信消息和补偿任务堆积。",[211,4945,4946],{},"业务事件与最终结果的对账差异。",[18,4948,4949],{},"没有监控和对账，即使消息已经丢失，系统也可能长期无法发现。",[14,4951,1191],{"id":1191},[245,4953,4954,4961,4968,4975,4982],{},[211,4955,4956],{},[70,4957,4960],{"href":4958,"rel":4959},"https:\u002F\u002Fkafka.apache.org\u002F41\u002Fconfiguration\u002Fproducer-configs\u002F",[1200],"Apache Kafka Producer Configs",[211,4962,4963],{},[70,4964,4967],{"href":4965,"rel":4966},"https:\u002F\u002Fkafka.apache.org\u002F41\u002Fconfiguration\u002Fbroker-configs\u002F",[1200],"Apache Kafka Broker Configs",[211,4969,4970],{},[70,4971,4974],{"href":4972,"rel":4973},"https:\u002F\u002Fkafka.apache.org\u002F41\u002Fconfiguration\u002Fconsumer-configs\u002F",[1200],"Apache Kafka Consumer Configs",[211,4976,4977],{},[70,4978,4981],{"href":4979,"rel":4980},"https:\u002F\u002Fkafka.apache.org\u002F41\u002Fdesign\u002Fdesign\u002F",[1200],"Apache Kafka Design：Message Delivery Semantics",[211,4983,4984],{},[70,4985,4988],{"href":4986,"rel":4987},"https:\u002F\u002Fkafka.apache.org\u002F41\u002Fjavadoc\u002Forg\u002Fapache\u002Fkafka\u002Fclients\u002Fconsumer\u002FKafkaConsumer.html",[1200],"Apache KafkaConsumer JavaDoc",[1224,4990,4991],{},"html pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sJ8bj, html code.shiki .sJ8bj{--shiki-default:#6A737D;--shiki-dark:#6A737D}",{"title":285,"searchDepth":343,"depth":343,"links":4993},[4994,4995,4996,4997,4998,5005,5014,5020,5025,5026,5027,5035,5036],{"id":16,"depth":343,"text":16},{"id":66,"depth":343,"text":66},{"id":83,"depth":343,"text":83},{"id":3796,"depth":343,"text":3797},{"id":3820,"depth":343,"text":3821,"children":4999},[5000,5002,5003,5004],{"id":3824,"depth":359,"text":5001},"1. 使用 acks=all",{"id":3918,"depth":359,"text":3919},{"id":3987,"depth":359,"text":3988},{"id":4084,"depth":359,"text":4085},{"id":4112,"depth":343,"text":4113,"children":5006},[5007,5008,5009,5011,5012],{"id":4116,"depth":359,"text":4117},{"id":4135,"depth":359,"text":4136},{"id":4165,"depth":359,"text":5010},"3. 配置 min.insync.replicas",{"id":4191,"depth":359,"text":4192},{"id":4236,"depth":359,"text":5013},"5. acks=all 不等于每条消息都立即 fsync",{"id":4254,"depth":343,"text":4255,"children":5015},[5016,5017,5018,5019],{"id":4258,"depth":359,"text":4259},{"id":4286,"depth":359,"text":4287},{"id":4416,"depth":359,"text":4417},{"id":4456,"depth":359,"text":4457},{"id":4491,"depth":343,"text":4492,"children":5021},[5022,5023,5024],{"id":4504,"depth":359,"text":4505},{"id":4568,"depth":359,"text":4569},{"id":4606,"depth":359,"text":4607},{"id":4691,"depth":343,"text":4692},{"id":4758,"depth":343,"text":4759},{"id":4872,"depth":343,"text":4873,"children":5028},[5029,5031,5032,5033,5034],{"id":4876,"depth":359,"text":5030},"误区一：配置 acks=all 就绝对不会丢",{"id":4891,"depth":359,"text":4892},{"id":4901,"depth":359,"text":4902},{"id":4908,"depth":359,"text":4909},{"id":4915,"depth":359,"text":4916},{"id":4922,"depth":343,"text":4923},{"id":1191,"depth":343,"text":1191},"wiki:java:kafka-message-loss-prevention","从生产者、Broker 和消费者三段链路分析 Kafka 消息丢失的原因，以及 acks、ISR、副本、手动提交 Offset 和业务幂等的完整保障方案。",{},72,"\u002Fjava\u002Fkafka-message-loss-prevention",{"title":3734,"description":5038},"java\u002Fkafka-message-loss-prevention","2026-07-24","7RYCOV4a1N5fgUG67sSi5WAq6gaBz5gHS16sBwuy4yk",{"id":5047,"title":5048,"body":5049,"commentId":6069,"description":6070,"difficulty":1276,"draft":1277,"extension":1278,"meta":6071,"navigation":1280,"order":6072,"path":6073,"section":1283,"seo":6074,"stem":6075,"updated":5044,"__hash__":6076},"java\u002Fjava\u002Fkafka-high-concurrency-performance-availability.md","Kafka 是如何实现高并发、高性能、高可用的",{"type":7,"value":5050,"toc":6025},[5051,5054,5056,5071,5073,5080,5082,5091,5093,5096,5110,5114,5118,5121,5127,5130,5137,5141,5144,5147,5158,5161,5165,5168,5170,5176,5179,5183,5186,5189,5193,5197,5200,5206,5209,5213,5216,5222,5242,5245,5249,5252,5258,5261,5275,5281,5285,5288,5294,5297,5314,5321,5327,5330,5333,5340,5343,5371,5378,5382,5385,5388,5402,5419,5423,5426,5432,5438,5444,5447,5456,5462,5465,5472,5478,5482,5485,5488,5494,5496,5502,5505,5511,5514,5517,5520,5541,5544,5548,5552,5555,5561,5564,5567,5571,5574,5580,5583,5592,5595,5600,5603,5606,5610,5615,5626,5629,5643,5646,5649,5655,5658,5662,5669,5675,5678,5681,5729,5732,5738,5741,5745,5748,5751,5757,5760,5764,5826,5829,5835,5839,5842,5862,5865,5868,5874,5877,5881,5885,5888,5892,5898,5902,5905,5909,5912,5919,5926,5930,5933,5944,5948,5961,5964,5978,5980,6022],[10,5052,5048],{"id":5053},"kafka-是如何实现高并发高性能高可用的",[14,5055,16],{"id":16},[56,5057,5058],{},[18,5059,5060,5061,5064,5065,5067,5068,5070],{},"Kafka 的高并发主要依靠分区实现横向扩展：一个 Topic 被拆成多个 Partition，分区 Leader 分散在不同 Broker 上，生产者可以并行写入，消费者组也可以按分区并行消费。高性能主要来自追加写和顺序 I\u002FO、操作系统 Page Cache、生产与消费两端的批处理、批量压缩，以及通过 ",[25,5062,5063],{},"sendfile"," 实现的零拷贝传输。高可用则依靠多副本、Leader\u002FFollower、ISR、故障选主和 KRaft Controller Quorum；生产端再配合 ",[25,5066,3749],{},"、",[25,5069,3914],{}," 和幂等生产，消费端通过 Consumer Group、Offset 与重新分配实现故障恢复。Kafka 的核心设计是在分区粒度上并行，在单分区内部维持有序日志，再用副本机制保障故障后的连续服务。",[18,5072,54],{},[56,5074,5075],{},[18,5076,5077],{},[61,5078,5079],{},"分区提供并行度，顺序日志、批处理和零拷贝提供吞吐量，副本、ISR 与故障选主提供可用性。",[14,5081,66],{"id":66},[18,5083,5084],{},[70,5085,5088],{"href":5086,"target":73,"rel":5087},"\u002Fimages\u002Fwiki\u002Fjava\u002Fkafka-high-concurrency-performance-availability.svg",[75,76],[78,5089],{"src":5086,"alt":5090},"Kafka 高并发、高性能和高可用实现机制总览",[14,5092,83],{"id":83},[18,5094,5095],{},"Kafka 的三个能力不是彼此孤立的：",[245,5097,5098,5101,5104,5107],{},[211,5099,5100],{},"分区既是并发执行和横向扩展的单位，也是副本复制与故障恢复的单位。",[211,5102,5103],{},"批处理既减少网络请求，也把大量小写入转化为更高效的顺序写。",[211,5105,5106],{},"Page Cache 既提升读写性能，也能配合副本机制避免为了可靠性而对每条消息执行同步刷盘。",[211,5108,5109],{},"副本增强了可靠性，但同时会增加网络、磁盘与确认延迟，因此需要在吞吐、延迟和可靠性之间取舍。",[14,5111,5113],{"id":5112},"一高并发通过分区横向扩展","一、高并发：通过分区横向扩展",[237,5115,5117],{"id":5116},"_1-partition-是-kafka-的并行单元","1. Partition 是 Kafka 的并行单元",[18,5119,5120],{},"一个 Topic 可以拆成多个 Partition：",[279,5122,5125],{"className":5123,"code":5124,"language":284,"meta":285},[282],"Topic: order-events\n├── Partition 0 → Leader 在 Broker A\n├── Partition 1 → Leader 在 Broker B\n└── Partition 2 → Leader 在 Broker C\n",[25,5126,5124],{"__ignoreMap":285},[18,5128,5129],{},"不同分区可以由不同 Broker 同时处理，因此整体吞吐不再受限于单台机器。增加 Broker 并合理增加分区后，存储容量、网络带宽和读写能力都可以横向扩展。",[18,5131,5132,5133,5136],{},"Kafka 只保证",[61,5134,5135],{},"单分区内有序","，不保证一个 Topic 的所有分区之间全局有序。这是它获得并行能力的重要前提。",[237,5138,5140],{"id":5139},"_2-生产者直接找到分区-leader","2. 生产者直接找到分区 Leader",[18,5142,5143],{},"生产者会缓存集群元数据，根据消息 Key、显式分区或默认分区策略选择 Partition，然后直接向该分区的 Leader 发送数据，中间不需要额外的统一路由节点。",[18,5145,5146],{},"常见分区方式：",[245,5148,5149,5152,5155],{},[211,5150,5151],{},"指定 Key：相同 Key 通常进入同一分区，适合保证同一订单、用户或账户内的消息顺序。",[211,5153,5154],{},"不指定 Key：默认分区策略会在适当时机选择分区，并尽量形成较大的批次。",[211,5156,5157],{},"自定义分区器：按租户、地区或业务规则路由。",[18,5159,5160],{},"如果 Key 分布不均，大量消息集中到少数分区，就会出现热点分区。此时即使 Broker 很多，整体吞吐仍会被热点 Leader 限制。",[237,5162,5164],{"id":5163},"_3-consumer-group-按分区并行消费","3. Consumer Group 按分区并行消费",[18,5166,5167],{},"同一个 Consumer Group 中，一个 Partition 在同一时刻只分配给一个 Consumer；一个 Consumer 可以负责多个 Partition。",[18,5169,3181],{},[279,5171,5174],{"className":5172,"code":5173,"language":284,"meta":285},[282],"4 个 Partition + 2 个 Consumer\n→ 每个 Consumer 负责约 2 个 Partition\n\n4 个 Partition + 4 个 Consumer\n→ 每个 Consumer 负责约 1 个 Partition\n\n4 个 Partition + 6 个 Consumer\n→ 最多只有 4 个 Consumer 能获得 Partition\n",[25,5175,5173],{"__ignoreMap":285},[18,5177,5178],{},"因此，一个消费组的有效并行度上限通常受 Partition 数量约束。简单增加 Consumer，而不增加 Partition，不一定能提高吞吐量。",[237,5180,5182],{"id":5181},"_4-broker-内部通过线程分工处理请求","4. Broker 内部通过线程分工处理请求",[18,5184,5185],{},"Broker 不会用一个线程串行完成所有网络和磁盘工作。网络线程负责接收请求、解析协议和返回响应，请求处理线程负责执行 Produce、Fetch 等具体逻辑，后台线程负责日志清理、副本同步等任务。",[18,5187,5188],{},"这种职责分离让网络连接管理、业务请求处理和后台维护能够并行执行，避免某类工作完全阻塞其他工作。",[14,5190,5192],{"id":5191},"二高性能把随机小操作变成顺序批量操作","二、高性能：把随机小操作变成顺序批量操作",[237,5194,5196],{"id":5195},"_1-顺序追加写","1. 顺序追加写",[18,5198,5199],{},"Kafka 的 Partition 本质上是一条只追加的日志。新消息写到日志末尾，不需要像通用数据库那样频繁进行随机位置更新。",[279,5201,5204],{"className":5202,"code":5203,"language":284,"meta":285},[282],"旧数据 ────────────────→ 日志末尾追加新批次\noffset 0 1 2 3 4 5 6 ...\n",[25,5205,5203],{"__ignoreMap":285},[18,5207,5208],{},"顺序 I\u002FO 能充分利用磁盘和操作系统的预读、合并写能力。日志达到一定大小或时间后会切分为新的 Segment，旧 Segment 可以按保留策略清理或压缩，不影响当前日志继续追加。",[237,5210,5212],{"id":5211},"_2-分段日志与稀疏索引","2. 分段日志与稀疏索引",[18,5214,5215],{},"每个 Partition 由多个日志 Segment 组成，常见文件包括：",[279,5217,5220],{"className":5218,"code":5219,"language":284,"meta":285},[282],"00000000000000000000.log\n00000000000000000000.index\n00000000000000000000.timeindex\n",[25,5221,5219],{"__ignoreMap":285},[245,5223,5224,5230,5236],{},[211,5225,5226,5229],{},[25,5227,5228],{},".log"," 保存消息批次。",[211,5231,5232,5235],{},[25,5233,5234],{},".index"," 保存相对 Offset 到日志物理位置的稀疏映射。",[211,5237,5238,5241],{},[25,5239,5240],{},".timeindex"," 保存时间戳到相对 Offset 的稀疏映射。",[18,5243,5244],{},"查找消息时，Kafka 先定位 Segment，再通过稀疏索引找到接近目标的位置，最后在日志中继续顺序查找。索引不需要记录每一条消息，因此能控制索引体积和内存占用。",[237,5246,5248],{"id":5247},"_3-充分利用-page-cache","3. 充分利用 Page Cache",[18,5250,5251],{},"Kafka 不把全部消息封装成大量 Java 堆对象长期缓存，而是依赖操作系统 Page Cache：",[279,5253,5256],{"className":5254,"code":5255,"language":284,"meta":285},[282],"Producer\n→ Broker 写日志文件\n→ 数据先进入 Page Cache\n→ 操作系统异步回写磁盘\n",[25,5257,5255],{"__ignoreMap":285},[18,5259,5260],{},"这样做有几个好处：",[245,5262,5263,5266,5269,5272],{},[211,5264,5265],{},"利用操作系统成熟的预读和回写机制。",[211,5267,5268],{},"减少 JVM 堆内存占用和 GC 压力。",[211,5270,5271],{},"热数据可以直接从 Page Cache 读取。",[211,5273,5274],{},"Broker 重启后，操作系统缓存仍可能保留部分热数据，不必完全重新构建 JVM 内缓存。",[18,5276,5277,5278,5280],{},"Kafka 的可靠性主要依赖多副本，而不是对每条消息都执行一次同步 ",[25,5279,4243],{},"。如果强制每条消息同步刷盘，吞吐和延迟都会明显恶化。",[237,5282,5284],{"id":5283},"_4-端到端批处理","4. 端到端批处理",[18,5286,5287],{},"批处理贯穿生产、Broker 存储和消费三段链路：",[279,5289,5292],{"className":5290,"code":5291,"language":284,"meta":285},[282],"多条消息\n→ Producer 聚合成 Record Batch\n→ 一次网络请求发送\n→ Broker 将 Record Batch 连续追加到分区日志\n→ Consumer 一次 Fetch 多条消息\n",[25,5293,5291],{"__ignoreMap":285},[18,5295,5296],{},"它可以摊薄：",[245,5298,5299,5302,5305,5308,5311],{},[211,5300,5301],{},"网络往返成本。",[211,5303,5304],{},"系统调用成本。",[211,5306,5307],{},"协议头和请求头开销。",[211,5309,5310],{},"磁盘写入次数。",[211,5312,5313],{},"消息压缩成本。",[18,5315,5316,5317,5320],{},"这里的“Broker 追加批次”不是把多条消息合并成一条业务消息，也不承诺底层一定只发生一次系统调用。它表示 Kafka 的生产者和存储格式都以 ",[61,5318,5319],{},"Record Batch"," 为基本单位：",[279,5322,5325],{"className":5323,"code":5324,"language":284,"meta":285},[282],"Record Batch\n├── 批次头：baseOffset、长度、时间戳、压缩类型、CRC 等\n├── Record 1\n├── Record 2\n└── Record 3\n",[25,5326,5324],{"__ignoreMap":285},[18,5328,5329],{},"Producer 会先按 Partition 在内存中积累消息，形成 Record Batch。Broker 收到后，对批次进行校验，为其中的消息确定 Offset，然后把整段连续数据追加到对应 Partition 的当前日志 Segment 末尾。相比每条消息都单独发请求、单独写日志，批次追加可以用更少的请求和更大的连续 I\u002FO 摊薄固定开销。",[18,5331,5332],{},"一个 ProduceRequest 还可以携带多个 Partition 的 Record Batch，但 Broker 最终仍然分别追加到各个 Partition 的日志中。因此：",[56,5334,5335],{},[18,5336,5337],{},[61,5338,5339],{},"批次是网络传输和日志写入的基本单位，Partition 才是日志组织、顺序保证和副本复制的基本单位。",[18,5341,5342],{},"生产者常见相关参数：",[279,5344,5346],{"className":3895,"code":5345,"language":3897,"meta":285,"style":285},"batch.size=16384\nlinger.ms=5\ncompression.type=lz4\n",[25,5347,5348,5356,5363],{"__ignoreMap":285},[315,5349,5350,5353],{"class":317,"line":318},[315,5351,5352],{"class":325},"batch.size",[315,5354,5355],{"class":333},"=16384\n",[315,5357,5358,5361],{"class":317,"line":343},[315,5359,5360],{"class":325},"linger.ms",[315,5362,3957],{"class":333},[315,5364,5365,5368],{"class":317,"line":359},[315,5366,5367],{"class":325},"compression.type",[315,5369,5370],{"class":333},"=lz4\n",[18,5372,5373,28,5375,5377],{},[25,5374,5352],{},[25,5376,5360],{}," 体现的是吞吐与延迟之间的取舍：适度等待可以积累更大的批次，但等待过长会增加低流量场景的发送延迟。参数值应根据消息大小、流量和延迟目标压测确定，不能机械照搬示例。",[237,5379,5381],{"id":5380},"_5-批量压缩","5. 批量压缩",[18,5383,5384],{},"Kafka 对一个 Record Batch 进行整体压缩，而不是分别压缩每条消息。相似消息中的字段名和公共内容可以获得更好的压缩率。",[18,5386,5387],{},"压缩后的批次会以压缩形式写入日志并传输给消费者，从而降低：",[245,5389,5390,5393,5396,5399],{},[211,5391,5392],{},"Broker 磁盘占用。",[211,5394,5395],{},"生产者到 Broker 的网络流量。",[211,5397,5398],{},"副本复制流量。",[211,5400,5401],{},"Broker 到消费者的网络流量。",[18,5403,5404,5405,5067,5408,5067,5411,5414,5415,5418],{},"压缩会消耗 CPU，因此需要根据资源瓶颈选择 ",[25,5406,5407],{},"lz4",[25,5409,5410],{},"zstd",[25,5412,5413],{},"snappy"," 或 ",[25,5416,5417],{},"gzip"," 等算法。网络或磁盘是瓶颈时，压缩往往能换取更高吞吐。",[237,5420,5422],{"id":5421},"_6-零拷贝","6. 零拷贝",[18,5424,5425],{},"消费者拉取日志数据时，普通路径可能需要：",[279,5427,5430],{"className":5428,"code":5429,"language":284,"meta":285},[282],"磁盘 → Page Cache → 用户空间 → Socket Buffer → 网卡\n",[25,5431,5429],{"__ignoreMap":285},[18,5433,5434,5435,5437],{},"Kafka 在适用条件下利用 Linux ",[25,5436,5063],{},"，让数据从 Page Cache 直接进入网络发送路径，减少用户态和内核态之间的复制与上下文切换：",[279,5439,5442],{"className":5440,"code":5441,"language":284,"meta":285},[282],"Page Cache → Socket \u002F 网卡\n",[25,5443,5441],{"__ignoreMap":285},[18,5445,5446],{},"这就是常说的零拷贝。它主要优化 Broker 向消费者传输已有日志数据的过程。",[18,5448,5449],{},[70,5450,5453],{"href":5451,"target":73,"rel":5452},"\u002Fimages\u002Fwiki\u002Fjava\u002Fkafka-sendfile-vs-traditional-io.svg",[75,76],[78,5454],{"src":5451,"alt":5455},"Kafka sendfile 零拷贝与传统文件传输路径对比",[18,5457,5458,5459,5461],{},"传统路径需要先把数据从内核 Page Cache 复制到 Broker 的用户空间，再从用户空间写回内核 Socket Buffer；",[25,5460,5063],{}," 让内核直接组织 Page Cache 到网络 Socket 的传输，Broker 不再把消息内容完整搬入 JVM 用户空间。",[18,5463,5464],{},"所以“零拷贝”更准确的含义是：",[56,5466,5467],{},[18,5468,5469],{},[61,5470,5471],{},"减少或绕过 Page Cache 与用户空间之间不必要的数据复制，而不是数据在磁盘、内存和网卡之间一次都不移动。",[18,5473,5474,5475,5477],{},"需要注意，Kafka 官方文档明确说明，启用 SSL 时数据要经过用户态 TLS 处理，当前不会使用这条 ",[25,5476,5063],{}," 路径。因此不能笼统地说所有 Kafka 网络传输都一定是零拷贝。",[237,5479,5481],{"id":5480},"_7-consumer-pull-与长轮询","7. Consumer Pull 与长轮询",[18,5483,5484],{},"Kafka 由消费者主动 Pull 数据。消费者可以根据自己的处理能力决定拉取速度，处理不过来时，未消费消息会暂时保留在 Kafka 中，并表现为 Consumer Lag 增长，而不是由 Broker 持续 Push 直至压垮消费者。",[18,5486,5487],{},"Consumer Lag 表示消费者的消费进度落后于 Partition 最新位置的程度。监控消费组时，通常可以近似理解为：",[279,5489,5492],{"className":5490,"code":5491,"language":284,"meta":285},[282],"Consumer Lag\n= Partition Log End Offset\n- Consumer Group 已提交 Offset\n",[25,5493,5491],{"__ignoreMap":285},[18,5495,3181],{},[279,5497,5500],{"className":5498,"code":5499,"language":284,"meta":285},[282],"Partition 下一条待写位置：10000\n消费组下一条待消费位置：9400\n\nLag = 10000 - 9400 = 600\n",[25,5501,5499],{"__ignoreMap":285},[18,5503,5504],{},"这表示当前大约还有 600 个 Offset 的数据尚未被该消费组处理。Lag 不是消息丢失，而是消费积压：",[279,5506,5509],{"className":5507,"code":5508,"language":284,"meta":285},[282],"生产速度 > 消费速度\n→ Lag 持续增大\n\n消费速度 > 生产速度\n→ Consumer 逐步追赶\n→ Lag 逐步减小\n",[25,5510,5508],{"__ignoreMap":285},[18,5512,5513],{},"Lag 不能只看某一时刻的绝对值，还要观察增长趋势、积压持续时间和业务允许的最大延迟。同样数量的 Lag，在每秒几条和每秒几十万条的 Topic 中代表的时间延迟完全不同。",[18,5515,5516],{},"如果 Lag 长期增长，可能是消费者处理变慢、下游故障、分区热点、Consumer 数量不足或频繁重平衡。若积压时间超过 Topic 的数据保留期限，旧消息可能已经被清理，消费者就不能再依靠 Kafka 把这部分数据完整追回。",[18,5518,5519],{},"Fetch 请求支持批量拉取和长轮询：",[279,5521,5523],{"className":3895,"code":5522,"language":3897,"meta":285,"style":285},"fetch.min.bytes=1\nfetch.max.wait.ms=500\n",[25,5524,5525,5533],{"__ignoreMap":285},[315,5526,5527,5530],{"class":317,"line":318},[315,5528,5529],{"class":325},"fetch.min.bytes",[315,5531,5532],{"class":333},"=1\n",[315,5534,5535,5538],{"class":317,"line":343},[315,5536,5537],{"class":325},"fetch.max.wait.ms",[315,5539,5540],{"class":333},"=500\n",[18,5542,5543],{},"Broker 暂时没有足够数据时，可以等待一段时间再响应，避免消费者无数据时频繁空轮询；流量较高时，又可以一次返回较大的批次。",[14,5545,5547],{"id":5546},"三高可用副本isr-与故障转移","三、高可用：副本、ISR 与故障转移",[237,5549,5551],{"id":5550},"_1-每个-partition-可以有多个副本","1. 每个 Partition 可以有多个副本",[18,5553,5554],{},"假设副本因子为 3：",[279,5556,5559],{"className":5557,"code":5558,"language":284,"meta":285},[282],"Partition 0\n├── Leader：Broker A\n├── Follower：Broker B\n└── Follower：Broker C\n",[25,5560,5558],{"__ignoreMap":285},[18,5562,5563],{},"生产和普通消费请求由 Leader 处理，Follower 分别从 Leader 拉取并复制日志。多个 Follower 的同步是彼此独立的，不存在先同步 B、再由 B 同步 C 的固定顺序。",[18,5565,5566],{},"副本应尽量分散在不同 Broker；具备机架感知配置时，还可以跨机架放置，降低单机或单机架故障带来的影响。",[237,5568,5570],{"id":5569},"_2-isr-维护可安全选主的副本集合","2. ISR 维护可安全选主的副本集合",[18,5572,5573],{},"ISR 是 In-Sync Replicas，即当前与 Leader 保持同步的副本集合。Follower 故障或长时间落后时会被移出 ISR，重新追上后可以再次加入。",[279,5575,5578],{"className":5576,"code":5577,"language":284,"meta":285},[282],"正常：ISR = [A, B, C]\nC 落后：ISR = [A, B]\n",[25,5579,5577],{"__ignoreMap":285},[18,5581,5582],{},"Leader 故障后，Controller 会从符合条件的副本中选择新的 Leader。以 ISR 为基础进行选主，可以避免把明显缺少最新日志的副本直接作为新的数据源。",[237,5584,5586,5587,5589,5590],{"id":5585},"_3-acks-与-mininsyncreplicas","3. ",[25,5588,3833],{}," 与 ",[25,5591,3914],{},[18,5593,5594],{},"常见的高可靠组合是：",[279,5596,5598],{"className":5597,"code":4175,"language":284,"meta":285},[282],[25,5599,4175],{"__ignoreMap":285},[18,5601,5602],{},"含义是生产者等待当前 ISR 的确认，并且 ISR 至少要有两个副本，否则 Broker 拒绝写入。",[18,5604,5605],{},"这个配置体现了 CAP 取舍：副本不足时拒绝写入，会降低部分可用性，但可以避免在只剩单副本时继续写入并承担更高的数据丢失风险。",[237,5607,5609],{"id":5608},"_4-kraft-controller-quorum-保证控制面可用","4. KRaft Controller Quorum 保证控制面可用",[5611,5612,5614],"h4",{"id":5613},"kraft-controller-quorum-是什么","KRaft Controller Quorum 是什么",[18,5616,5617,5618,5621,5622,5625],{},"KRaft 是 Kafka 自己实现的元数据管理机制，用来替代早期依赖的 ZooKeeper。集群中会有若干个承担 ",[25,5619,5620],{},"controller"," 角色的节点，这些 Controller 组成一个基于 Raft 共识协议的 ",[61,5623,5624],{},"Controller Quorum","，即控制器仲裁组。",[18,5627,5628],{},"它们维护的是集群元数据，而不是普通 Topic 的业务消息：",[245,5630,5631,5634,5637,5640],{},[211,5632,5633],{},"Broker 注册、存活状态和节点信息。",[211,5635,5636],{},"Topic 与 Partition 的定义。",[211,5638,5639],{},"每个 Partition 的副本分配、Leader 和 ISR。",[211,5641,5642],{},"配置、配额以及其他集群级元数据。",[18,5644,5645],{},"这些变化会写入 KRaft 的集群元数据日志，并复制给 Quorum 中的其他 Controller。一次元数据变更获得多数 Controller 确认后才算提交，因此单个 Controller 故障不会导致已提交元数据丢失。",[18,5647,5648],{},"常见部署是 3 个或 5 个 Controller：",[279,5650,5653],{"className":5651,"code":5652,"language":284,"meta":285},[282],"3 个 Controller → 多数派为 2，可容忍 1 个故障\n5 个 Controller → 多数派为 3，可容忍 2 个故障\n",[25,5654,5652],{"__ignoreMap":285},[18,5656,5657],{},"如果存活 Controller 失去多数派，集群不能安全提交新的元数据变更。此时已有数据读写是否还能短暂继续，取决于具体操作和现有元数据状态，但创建 Topic、Partition Leader 调度等控制面操作会受到影响。",[5611,5659,5661],{"id":5660},"active-controller-是什么","Active Controller 是什么",[18,5663,5664,5665,5668],{},"Controller Quorum 在同一时刻会选出一个 Leader，Kafka 的文档和运行语境中通常称它为 ",[61,5666,5667],{},"Active Controller","。其他 Controller 作为 Follower 复制元数据日志，随时准备接管。",[279,5670,5673],{"className":5671,"code":5672,"language":284,"meta":285},[282],"Controller A：Active Controller\n├── 接收和处理元数据变更\n├── 管理 Broker 注册与故障\n├── 触发 Partition Leader 选举\n└── 把变更写入元数据日志\n\nController B、C：Follower Controllers\n├── 复制元数据日志\n└── Active Controller 故障后参与重新选举\n",[25,5674,5672],{"__ignoreMap":285},[18,5676,5677],{},"Active Controller 不是所有业务消息的入口，也不负责替 Broker 保存普通 Topic 数据。生产者和消费者仍然直接与 Partition Leader 所在的 Broker 通信。",[18,5679,5680],{},"需要明确区分两个层面：",[98,5682,5683,5699],{},[101,5684,5685],{},[104,5686,5687,5690,5693,5696],{},[107,5688,5689],{},"层面",[107,5691,5692],{},"主要角色",[107,5694,5695],{},"保存什么",[107,5697,5698],{},"负责什么",[114,5700,5701,5715],{},[104,5702,5703,5706,5709,5712],{},[119,5704,5705],{},"数据面",[119,5707,5708],{},"Broker、Partition Leader\u002FFollower",[119,5710,5711],{},"普通 Topic 的业务消息",[119,5713,5714],{},"生产、消费、副本复制",[104,5716,5717,5720,5723,5726],{},[119,5718,5719],{},"控制面",[119,5721,5722],{},"KRaft Controller Quorum",[119,5724,5725],{},"集群元数据日志",[119,5727,5728],{},"节点管理、元数据变更、Leader 调度",[18,5730,5731],{},"例如 Broker A 突然故障：",[279,5733,5736],{"className":5734,"code":5735,"language":284,"meta":285},[282],"Active Controller 感知 Broker A 失联\n→ 找出受影响的 Partition\n→ 从符合条件的副本中选择新 Leader\n→ 将选举结果写入元数据日志\n→ 多数 Controller 确认提交\n→ 向相关 Broker 发布新元数据\n→ 客户端刷新元数据并访问新 Leader\n",[25,5737,5735],{"__ignoreMap":285},[18,5739,5740],{},"如果 Active Controller 自身故障，剩余 Controller 会通过 Raft 重新选出新的 Active Controller。新节点已经复制了已提交的元数据日志，因此可以继续管理集群。",[237,5742,5744],{"id":5743},"_5-consumer-group-自动接管故障消费者的分区","5. Consumer Group 自动接管故障消费者的分区",[18,5746,5747],{},"消费者通过心跳维持组成员身份。如果某个 Consumer 崩溃或超时，Consumer Group 会重新分配它原来负责的 Partition，让其他 Consumer 接管。",[18,5749,5750],{},"消费进度保存在已提交的 Offset 中，因此新 Consumer 可以从相应位置继续处理：",[279,5752,5755],{"className":5753,"code":5754,"language":284,"meta":285},[282],"Consumer A 故障\n→ 触发重新分配\n→ Partition 交给 Consumer B\n→ B 从已提交 Offset 继续消费\n",[25,5756,5754],{"__ignoreMap":285},[18,5758,5759],{},"重平衡期间可能产生短暂停顿，所以高可用不等于无感切换。合理设置会话、心跳、处理时长，并避免频繁扩缩容，有助于减少重平衡影响。",[14,5761,5763],{"id":5762},"四三种能力如何协同","四、三种能力如何协同",[98,5765,5766,5782],{},[101,5767,5768],{},[104,5769,5770,5773,5776,5779],{},[107,5771,5772],{},"目标",[107,5774,5775],{},"核心机制",[107,5777,5778],{},"解决的问题",[107,5780,5781],{},"主要代价",[114,5783,5784,5798,5812],{},[104,5785,5786,5789,5792,5795],{},[119,5787,5788],{},"高并发",[119,5790,5791],{},"多 Partition、多 Broker、Consumer Group",[119,5793,5794],{},"并行生产、存储和消费",[119,5796,5797],{},"分区与元数据管理成本",[104,5799,5800,5803,5806,5809],{},[119,5801,5802],{},"高性能",[119,5804,5805],{},"顺序写、Page Cache、批处理、压缩、零拷贝",[119,5807,5808],{},"降低 I\u002FO、复制和网络开销",[119,5810,5811],{},"批处理延迟与 CPU 消耗",[104,5813,5814,5817,5820,5823],{},[119,5815,5816],{},"高可用",[119,5818,5819],{},"多副本、ISR、Controller Quorum、故障转移",[119,5821,5822],{},"节点故障后继续提供服务",[119,5824,5825],{},"副本存储、网络与确认延迟",[18,5827,5828],{},"可以把整个链路理解为：",[279,5830,5833],{"className":5831,"code":5832,"language":284,"meta":285},[282],"消息按 Partition 分流\n→ Producer 批量发送\n→ Leader 顺序追加到日志\n→ Follower 并行复制\n→ 满足确认条件后返回\n→ Consumer Group 按 Partition 批量拉取\n",[25,5834,5832],{"__ignoreMap":285},[14,5836,5838],{"id":5837},"五为什么不能只靠增加分区提升性能","五、为什么不能只靠增加分区提升性能",[18,5840,5841],{},"分区是扩展能力的基础，但分区不是越多越好。分区数量增加会同时带来：",[245,5843,5844,5847,5850,5853,5856,5859],{},[211,5845,5846],{},"更多日志目录、Segment 和文件句柄。",[211,5848,5849],{},"更多副本复制任务。",[211,5851,5852],{},"更大的集群元数据。",[211,5854,5855],{},"更高的 Leader 选举和故障恢复成本。",[211,5857,5858],{},"Consumer Group 重平衡开销。",[211,5860,5861],{},"单 Key 顺序范围更难调整。",[18,5863,5864],{},"合理做法是根据目标吞吐量、单分区压测能力、消费者并行度、副本数和未来增长空间估算，而不是一次创建大量分区。",[18,5866,5867],{},"一个简化估算思路：",[279,5869,5872],{"className":5870,"code":5871,"language":284,"meta":285},[282],"分区数 ≥ max(\n 目标生产吞吐 \u002F 单分区生产吞吐,\n 目标消费吞吐 \u002F 单消费者单分区吞吐,\n 期望消费并行度\n)\n",[25,5873,5871],{"__ignoreMap":285},[18,5875,5876],{},"最终仍需要在接近生产环境的机器、网络、副本配置和消息大小下进行压测。",[14,5878,5880],{"id":5879},"六常见误区","六、常见误区",[237,5882,5884],{"id":5883},"误区一kafka-使用磁盘所以一定比内存消息队列慢","误区一：Kafka 使用磁盘，所以一定比内存消息队列慢",[18,5886,5887],{},"Kafka 采用顺序追加、Page Cache 和批处理，大量读写实际在操作系统缓存中完成。性能取决于访问模式，而不是简单由“使用磁盘”决定。",[237,5889,5891],{"id":5890},"误区二零拷贝让数据完全不发生复制","误区二：零拷贝让数据完全不发生复制",[18,5893,5894,5895,5897],{},"零拷贝是减少不必要的用户态复制，并非物理意义上的一次复制都没有；而且启用 SSL 时不会走 Kafka 文档描述的 ",[25,5896,5063],{}," 路径。",[237,5899,5901],{"id":5900},"误区三消费者越多消费速度一定越快","误区三：消费者越多，消费速度一定越快",[18,5903,5904],{},"同一消费组内，一个 Partition 同时只能交给一个 Consumer。Consumer 数超过 Partition 数后，多出的 Consumer 不会获得分区。",[237,5906,5908],{"id":5907},"误区四副本越多高可用越高且没有代价","误区四：副本越多，高可用越高且没有代价",[18,5910,5911],{},"更多副本会增加存储、网络复制和写确认成本。副本数应根据故障域和可靠性目标确定，常见三副本不代表所有场景都必须相同。",[237,5913,5915,5916,5918],{"id":5914},"误区五acksall-就代表所有配置副本都已写入","误区五：",[25,5917,3749],{}," 就代表所有配置副本都已写入",[18,5920,5921,5923,5924,4224],{},[25,5922,3749],{}," 等待的是当前 ISR，而不是所有配置副本。要避免 ISR 只剩一个副本时仍然成功写入，需要配合 ",[25,5925,3914],{},[14,5927,5929],{"id":5928},"七排查性能和可用性问题时看什么","七、排查性能和可用性问题时看什么",[237,5931,5932],{"id":5932},"生产端",[245,5934,5935,5938,5941],{},[211,5936,5937],{},"发送吞吐、请求延迟、错误率和重试次数。",[211,5939,5940],{},"批次大小、压缩率和缓冲区等待。",[211,5942,5943],{},"消息 Key 是否造成分区流量倾斜。",[237,5945,5947],{"id":5946},"broker","Broker",[245,5949,5950,5953,5956,5958],{},[211,5951,5952],{},"各 Broker、Partition 和 Leader 的流量是否均衡。",[211,5954,5955],{},"磁盘利用率、磁盘延迟、网络带宽和请求队列。",[211,5957,4934],{},[211,5959,5960],{},"Page Cache 命中效果和系统是否发生 Swap。",[237,5962,5963],{"id":5963},"消费端",[245,5965,5966,5969,5972,5975],{},[211,5967,5968],{},"Consumer Lag 及其增长速度。",[211,5970,5971],{},"单条消息处理耗时和批次处理耗时。",[211,5973,5974],{},"Consumer 数量与 Partition 数量是否匹配。",[211,5976,5977],{},"重平衡次数、心跳超时和 Offset 提交失败。",[14,5979,1191],{"id":1191},[245,5981,5982,5988,5995,6002,6007,6012,6017],{},[211,5983,5984],{},[70,5985,5987],{"href":4979,"rel":5986},[1200],"Apache Kafka Design",[211,5989,5990],{},[70,5991,5994],{"href":5992,"rel":5993},"https:\u002F\u002Fkafka.apache.org\u002F41\u002Foperations\u002Fkraft\u002F",[1200],"Apache Kafka KRaft",[211,5996,5997],{},[70,5998,6001],{"href":5999,"rel":6000},"https:\u002F\u002Fkafka.apache.org\u002F41\u002Fimplementation\u002Fmessage-format\u002F",[1200],"Apache Kafka Message Format",[211,6003,6004],{},[70,6005,4960],{"href":4958,"rel":6006},[1200],[211,6008,6009],{},[70,6010,4974],{"href":4972,"rel":6011},[1200],[211,6013,6014],{},[70,6015,4967],{"href":4965,"rel":6016},[1200],[211,6018,6019],{},[70,6020,4988],{"href":4986,"rel":6021},[1200],[1224,6023,6024],{},"html pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":285,"searchDepth":343,"depth":343,"links":6026},[6027,6028,6029,6030,6036,6045,6053,6054,6055,6063,6068],{"id":16,"depth":343,"text":16},{"id":66,"depth":343,"text":66},{"id":83,"depth":343,"text":83},{"id":5112,"depth":343,"text":5113,"children":6031},[6032,6033,6034,6035],{"id":5116,"depth":359,"text":5117},{"id":5139,"depth":359,"text":5140},{"id":5163,"depth":359,"text":5164},{"id":5181,"depth":359,"text":5182},{"id":5191,"depth":343,"text":5192,"children":6037},[6038,6039,6040,6041,6042,6043,6044],{"id":5195,"depth":359,"text":5196},{"id":5211,"depth":359,"text":5212},{"id":5247,"depth":359,"text":5248},{"id":5283,"depth":359,"text":5284},{"id":5380,"depth":359,"text":5381},{"id":5421,"depth":359,"text":5422},{"id":5480,"depth":359,"text":5481},{"id":5546,"depth":343,"text":5547,"children":6046},[6047,6048,6049,6051,6052],{"id":5550,"depth":359,"text":5551},{"id":5569,"depth":359,"text":5570},{"id":5585,"depth":359,"text":6050},"3. acks 与 min.insync.replicas",{"id":5608,"depth":359,"text":5609},{"id":5743,"depth":359,"text":5744},{"id":5762,"depth":343,"text":5763},{"id":5837,"depth":343,"text":5838},{"id":5879,"depth":343,"text":5880,"children":6056},[6057,6058,6059,6060,6061],{"id":5883,"depth":359,"text":5884},{"id":5890,"depth":359,"text":5891},{"id":5900,"depth":359,"text":5901},{"id":5907,"depth":359,"text":5908},{"id":5914,"depth":359,"text":6062},"误区五：acks=all 就代表所有配置副本都已写入",{"id":5928,"depth":343,"text":5929,"children":6064},[6065,6066,6067],{"id":5932,"depth":359,"text":5932},{"id":5946,"depth":359,"text":5947},{"id":5963,"depth":359,"text":5963},{"id":1191,"depth":343,"text":1191},"wiki:java:kafka-high-concurrency-performance-availability","从分区并行、顺序写、Page Cache、批处理、零拷贝、副本与 ISR 等机制，系统理解 Kafka 高吞吐与高可用架构。",{},73,"\u002Fjava\u002Fkafka-high-concurrency-performance-availability",{"title":5048,"description":6070},"java\u002Fkafka-high-concurrency-performance-availability","_IH9pA0NFXAB3GxWc8Sjqpayx4kx_Keb34bXEq0Chc0",{"id":6078,"title":6079,"body":6080,"commentId":7416,"description":7417,"difficulty":1276,"draft":1277,"extension":1278,"meta":7418,"navigation":1280,"order":7419,"path":7420,"section":1283,"seo":7421,"stem":7422,"updated":5044,"__hash__":7423},"java\u002Fjava\u002Fkafka-message-backlog-handling.md","Kafka 消息积压如何处理",{"type":7,"value":6081,"toc":7370},[6082,6085,6087,6092,6094,6101,6103,6112,6114,6117,6123,6126,6130,6133,6136,6141,6143,6149,6152,6155,6226,6229,6232,6238,6241,6247,6250,6253,6257,6261,6267,6270,6274,6277,6300,6307,6311,6314,6334,6337,6343,6346,6350,6353,6356,6362,6365,6369,6372,6389,6392,6396,6400,6403,6409,6412,6416,6419,6433,6436,6439,6445,6448,6452,6455,6458,6461,6465,6469,6472,6475,6481,6484,6488,6491,6514,6516,6522,6527,6530,6536,6539,6542,6559,6562,6566,6569,6608,6611,6636,6640,6643,6649,6652,6658,6661,6671,6674,6680,6683,6691,6705,6714,6718,6731,6734,6740,6744,6747,6753,6756,6762,6765,6768,6771,6774,6777,6808,6811,6815,6819,6822,6825,6832,6835,6839,6842,6845,6851,6854,6860,6863,6866,6871,6874,6877,6881,6887,6890,6894,6900,6906,6909,6912,6926,6930,6933,6939,6942,6946,6949,6952,6958,6961,6981,6984,6988,6991,6997,7000,7014,7017,7021,7024,7030,7033,7039,7042,7048,7050,7056,7059,7065,7069,7072,7079,7082,7099,7102,7106,7109,7112,7167,7174,7227,7230,7233,7239,7245,7248,7251,7257,7260,7264,7267,7290,7294,7298,7301,7308,7311,7315,7318,7322,7329,7332,7336,7339,7341,7367],[10,6083,6079],{"id":6084},"kafka-消息积压如何处理",[14,6086,16],{"id":16},[56,6088,6089],{},[18,6090,6091],{},"Kafka 消息积压不能一上来就盲目增加消费者，首先要确认积压范围和原因：观察各 Partition 的 Consumer Lag、生产速率、消费速率、消费者存活状态、重平衡、处理耗时和下游依赖。如果消费实例异常或下游故障，应先恢复服务；如果生产速度持续大于消费速度，需要对非核心生产流量限流，同时扩容消费者，但同一消费组的有效并行度不会超过 Partition 数量。如果单条处理过慢，应通过批量写库、减少同步 RPC、优化慢 SQL 或使用受控的异步处理提高单实例吞吐；如果只有个别 Partition 积压，要检查消息 Key 是否造成热点；如果被异常消息反复阻塞，需要有限重试后进入死信或人工补偿。恢复时间可以用“积压量 ÷（消费速率－生产速率）”估算，只有消费能力大于生产速度，积压才会真正下降。Offset 跳到最新只能在业务明确同意丢弃旧消息时使用，不能作为常规解决方案。",[18,6093,54],{},[56,6095,6096],{},[18,6097,6098],{},[61,6099,6100],{},"先判断为什么消费速度落后，再从减少流入、恢复异常、提升单实例吞吐和增加有效并行度四个方向处理。",[14,6102,66],{"id":66},[18,6104,6105],{},[70,6106,6109],{"href":6107,"target":73,"rel":6108},"\u002Fimages\u002Fwiki\u002Fjava\u002Fkafka-message-backlog-handling.svg",[75,76],[78,6110],{"src":6107,"alt":6111},"Kafka 消息积压排查与处理流程",[14,6113,83],{"id":83},[18,6115,6116],{},"Kafka 消息积压的本质是：",[279,6118,6121],{"className":6119,"code":6120,"language":284,"meta":285},[282],"一段时间内的生产速度\n>\n一段时间内的有效消费速度\n",[25,6122,6120],{"__ignoreMap":285},[18,6124,6125],{},"积压不是单一故障类型，它可能由突发流量、消费者异常、下游变慢、分区热点或异常消息阻塞引起。不同原因的处理方式完全不同。",[14,6127,6129],{"id":6128},"一什么是-kafka-消息积压","一、什么是 Kafka 消息积压",[18,6131,6132],{},"每个 Partition 中的消息都有 Offset。生产者持续向日志末尾写入，消费组通过已提交 Offset 记录自己的处理进度。",[18,6134,6135],{},"监控消费组时，Consumer Lag 通常可以近似理解为：",[279,6137,6139],{"className":6138,"code":5491,"language":284,"meta":285},[282],[25,6140,5491],{"__ignoreMap":285},[18,6142,3181],{},[279,6144,6147],{"className":6145,"code":6146,"language":284,"meta":285},[282],"Partition Log End Offset：120000\n消费组已提交 Offset：95000\n\nLag = 120000 - 95000 = 25000\n",[25,6148,6146],{"__ignoreMap":285},[18,6150,6151],{},"表示这个消费组在该 Partition 上大约落后 25000 个 Offset。",[18,6153,6154],{},"需要同时观察三类指标：",[98,6156,6157,6169],{},[101,6158,6159],{},[104,6160,6161,6164,6166],{},[107,6162,6163],{},"指标",[107,6165,1682],{},[107,6167,6168],{},"判断价值",[114,6170,6171,6182,6193,6204,6215],{},[104,6172,6173,6176,6179],{},[119,6174,6175],{},"当前 Lag",[119,6177,6178],{},"还落后多少 Offset",[119,6180,6181],{},"反映积压规模",[104,6183,6184,6187,6190],{},[119,6185,6186],{},"Lag 增长速度",[119,6188,6189],{},"单位时间新增多少积压",[119,6191,6192],{},"判断问题是否正在恶化",[104,6194,6195,6198,6201],{},[119,6196,6197],{},"最老未处理消息年龄",[119,6199,6200],{},"最老待处理消息的时间戳距现在多久",[119,6202,6203],{},"反映业务已经延迟多久",[104,6205,6206,6209,6212],{},[119,6207,6208],{},"积压字节量",[119,6210,6211],{},"待处理消息占用的总字节数",[119,6213,6214],{},"反映网络、磁盘和反序列化压力",[104,6216,6217,6220,6223],{},[119,6218,6219],{},"单条处理耗时",[119,6221,6222],{},"处理一条或一批消息实际需要多久",[119,6224,6225],{},"用于估算积压清空速度",[18,6227,6228],{},"只看 Lag 绝对值容易误判。例如同样积压 10 万条，在每秒消费 20 万条的系统里可能很快恢复，在每秒只消费 100 条的系统里则非常严重。",[18,6230,6231],{},"Lag 是 Offset 数量差，本身只表示“落后多少条记录”，不能直接等同于时间延迟。对于相同的 10 万 Lag，消费者处理速度越快，处理完现有积压所需的时间越短：",[279,6233,6236],{"className":6234,"code":6235,"language":284,"meta":285},[282],"处理现有积压所需时间\n≈ Lag ÷ 消费速度\n",[25,6237,6235],{"__ignoreMap":285},[18,6239,6240],{},"如果生产者仍在持续写入，要估算 Lag 整体降为 0 的时间，则应扣除生产速度：",[279,6242,6245],{"className":6243,"code":6244,"language":284,"meta":285},[282],"Lag 归零时间\n≈ Lag ÷（消费速度－生产速度）\n",[25,6246,6244],{"__ignoreMap":285},[18,6248,6249],{},"只有消费速度大于生产速度，Lag 才会持续下降。至于当前业务已经延迟多久，应直接查看最老未处理消息的时间戳，而不是只根据 Lag 推算。",[18,6251,6252],{},"消息大小影响的是积压字节量、网络传输和反序列化成本；单条处理复杂度影响的是消费速度。它们都很重要，但不能与 Lag 条数或消息年龄混为同一个指标。",[14,6254,6256],{"id":6255},"二先判断积压发生在哪里","二、先判断积压发生在哪里",[237,6258,6260],{"id":6259},"_1-是所有-partition-积压还是少数-partition-积压","1. 是所有 Partition 积压，还是少数 Partition 积压",[279,6262,6265],{"className":6263,"code":6264,"language":284,"meta":285},[282],"所有 Partition 的 Lag 都增长\n→ 更可能是整体消费能力不足、消费者异常或下游故障\n\n只有少数 Partition 的 Lag 很高\n→ 更可能是 Key 倾斜、热点业务或个别异常消息\n",[25,6266,6264],{"__ignoreMap":285},[18,6268,6269],{},"不能只看 Topic 的总 Lag。总数会掩盖单个热点 Partition，应同时查看每个 Partition 的 Lag、生产速率和消费速率。",[237,6271,6273],{"id":6272},"_2-消费者是否正常工作","2. 消费者是否正常工作",[18,6275,6276],{},"先检查：",[245,6278,6279,6282,6285,6288,6294,6297],{},[211,6280,6281],{},"消费实例是否存活，是否频繁重启。",[211,6283,6284],{},"Consumer Group 中是否存在空闲或反复加入、退出的成员。",[211,6286,6287],{},"是否频繁发生重平衡。",[211,6289,6290,6293],{},[25,6291,6292],{},"poll()"," 是否长时间没有被调用。",[211,6295,6296],{},"Offset 是否持续推进。",[211,6298,6299],{},"消费日志中是否存在反序列化、鉴权、提交 Offset 或业务异常。",[18,6301,6302,6303,6306],{},"如果业务处理时间超过 ",[25,6304,6305],{},"max.poll.interval.ms","，消费者会被认为没有正常推进消费，Partition 可能被重新分配。消费者不断处理、超时、重平衡，又可能造成更严重的积压。",[237,6308,6310],{"id":6309},"_3-单条消息处理是否变慢","3. 单条消息处理是否变慢",[18,6312,6313],{},"Kafka 消费本身往往不是最慢的部分，真正瓶颈通常在业务逻辑：",[245,6315,6316,6319,6322,6325,6328,6331],{},[211,6317,6318],{},"数据库慢 SQL、锁等待或连接池耗尽。",[211,6320,6321],{},"调用外部 RPC 超时。",[211,6323,6324],{},"每条消息单独写库，缺少批处理。",[211,6326,6327],{},"序列化、解压或大对象处理消耗 CPU。",[211,6329,6330],{},"消费逻辑加了粒度过大的锁。",[211,6332,6333],{},"下游 Elasticsearch、Redis 或第三方接口限流。",[18,6335,6336],{},"应把消费耗时拆分为：",[279,6338,6341],{"className":6339,"code":6340,"language":284,"meta":285},[282],"拉取耗时\n+ 反序列化耗时\n+ 业务计算耗时\n+ 数据库 \u002F RPC \u002F 下游写入耗时\n+ Offset 提交耗时\n",[25,6342,6340],{"__ignoreMap":285},[18,6344,6345],{},"只有找到主要耗时，优化才有方向。",[237,6347,6349],{"id":6348},"_4-是否被毒消息阻塞","4. 是否被“毒消息”阻塞",[18,6351,6352],{},"毒消息是指某条数据因为格式错误、业务状态异常或下游约束问题，每次消费都会失败。",[18,6354,6355],{},"如果代码采用无限重试：",[279,6357,6360],{"className":6358,"code":6359,"language":284,"meta":285},[282],"消费失败\n→ 立即重试\n→ 再次失败\n→ 一直占住当前 Partition\n",[25,6361,6359],{"__ignoreMap":285},[18,6363,6364],{},"该 Partition 后续所有消息都可能无法继续处理，表现为单分区 Lag 持续增大。",[237,6366,6368],{"id":6367},"_5-broker-或基础设施是否成为瓶颈","5. Broker 或基础设施是否成为瓶颈",[18,6370,6371],{},"还要检查：",[245,6373,6374,6377,6380,6383,6386],{},[211,6375,6376],{},"Broker 磁盘延迟、网络带宽和 CPU。",[211,6378,6379],{},"Fetch 请求延迟和错误率。",[211,6381,6382],{},"ISR 收缩、离线分区和副本同步异常。",[211,6384,6385],{},"消费者所在机器的 CPU、内存、GC 和网络。",[211,6387,6388],{},"是否发生跨机房访问或网络抖动。",[18,6390,6391],{},"如果 Broker 或网络已经饱和，单纯增加 Consumer 可能只会制造更多请求和竞争。",[14,6393,6395],{"id":6394},"三紧急处理先止住-lag-增长","三、紧急处理：先止住 Lag 增长",[237,6397,6399],{"id":6398},"_1-恢复异常消费者和下游","1. 恢复异常消费者和下游",[18,6401,6402],{},"如果积压源于实例宕机、数据库故障或下游超时，应优先恢复根因：",[279,6404,6407],{"className":6405,"code":6406,"language":284,"meta":285},[282],"恢复消费实例\n→ 恢复数据库 \u002F RPC \u002F 下游\n→ 确认 Offset 开始推进\n→ 再评估是否需要扩容\n",[25,6408,6406],{"__ignoreMap":285},[18,6410,6411],{},"下游仍不可用时强行增加消费者，只会放大连接数、重试和超时流量。",[237,6413,6415],{"id":6414},"_2-对非核心生产流量限流或降级","2. 对非核心生产流量限流或降级",[18,6417,6418],{},"如果生产速度仍在持续上升，而消费端已经满负荷，可以在业务允许时：",[245,6420,6421,6424,6427,6430],{},[211,6422,6423],{},"限制非核心事件的生产速率。",[211,6425,6426],{},"暂停可延迟的定时任务和批量导入。",[211,6428,6429],{},"合并低价值事件。",[211,6431,6432],{},"对非核心功能降级。",[18,6434,6435],{},"这不是最终解决方案，但能降低流入速度，给消费端争取恢复窗口。",[18,6437,6438],{},"这里的“合并低价值事件”，不是随意删除消息，而是对业务允许只保留最终状态或聚合结果的事件进行压缩。例如：",[279,6440,6443],{"className":6441,"code":6442,"language":284,"meta":285},[282],"同一个商品在 1 秒内连续产生 20 次缓存刷新通知\n→ 只保留一次刷新通知\n\n同一设备连续上报多次进度：10%、20%、30%\n→ 如果业务只关心最新进度，可以只发送 30%\n\n大量指标增量事件\n→ 在生产端按时间窗口汇总后，发送一条聚合结果\n",[25,6444,6442],{"__ignoreMap":285},[18,6446,6447],{},"合并前必须先定义清楚业务语义，包括按什么 Key 合并、合并时间窗口多长、保留最新值还是累计值，以及异常时如何补偿。订单状态流转、支付、账户流水、库存扣减、审计日志等每条事件都具有独立业务意义，不能使用这种方式合并。",[237,6449,6451],{"id":6450},"_3-确认消息保留时间是否足够","3. 确认消息保留时间是否足够",[18,6453,6454],{},"积压消息依赖 Kafka 的日志保留策略。如果预计追赶需要数小时或数天，应确认 Topic 的保留时间和磁盘空间是否足够。",[18,6456,6457],{},"如果最老未消费消息超过保留期限，旧日志可能被清理。此时即使消费者恢复，也无法从 Kafka 读取已经删除的数据。",[18,6459,6460],{},"紧急情况下可以评估临时延长保留时间，但必须同步评估 Broker 磁盘容量，避免积压尚未解决又触发磁盘告警。",[14,6462,6464],{"id":6463},"四提升消费能力","四、提升消费能力",[237,6466,6468],{"id":6467},"_1-增加-consumer-实例","1. 增加 Consumer 实例",[18,6470,6471],{},"增加同一 Consumer Group 中的实例，可以让更多 Partition 并行消费。",[18,6473,6474],{},"但有效并行度受 Partition 数量限制：",[279,6476,6479],{"className":6477,"code":6478,"language":284,"meta":285},[282],"8 个 Partition + 4 个 Consumer\n→ 可以继续扩容\n\n8 个 Partition + 8 个 Consumer\n→ 已接近分区级并行上限\n\n8 个 Partition + 12 个 Consumer\n→ 约 4 个 Consumer 无 Partition 可处理\n",[25,6480,6478],{"__ignoreMap":285},[18,6482,6483],{},"因此扩容前要同时查看当前 Partition 数量、消费者数量和分配情况。",[237,6485,6487],{"id":6486},"_2-优化单实例处理吞吐","2. 优化单实例处理吞吐",[18,6489,6490],{},"常见优化方式：",[245,6492,6493,6496,6499,6502,6505,6508,6511],{},[211,6494,6495],{},"把逐条写数据库改为批量写入。",[211,6497,6498],{},"合并相同业务 Key 的重复更新。",[211,6500,6501],{},"优化 SQL、索引和事务范围。",[211,6503,6504],{},"减少消费线程中的同步远程调用。",[211,6506,6507],{},"对可并行步骤使用有界线程池。",[211,6509,6510],{},"复用连接和客户端，避免每条消息重复创建。",[211,6512,6513],{},"降低无必要的日志和对象序列化开销。",[18,6515,3181],{},[279,6517,6520],{"className":6518,"code":6519,"language":284,"meta":285},[282],"原方案：\n每条消息 → 一次数据库事务\n\n优化后：\n一批消息 → 分组校验 → 批量写入 → 提交对应 Offset\n",[25,6521,6519],{"__ignoreMap":285},[18,6523,6524,6525,4224],{},"批量越大不一定越好。批次过大会增加内存占用、事务时间和失败重试成本，还可能让一次处理时间超过 ",[25,6526,6305],{},[18,6528,6529],{},"这里的“同步远程调用”，是指消费线程发送 RPC 或 HTTP 请求后，必须等待对方返回才能继续处理下一条消息：",[279,6531,6534],{"className":6532,"code":6533,"language":284,"meta":285},[282],"消费一条消息\n→ 调用远程库存服务\n→ 阻塞等待 50 ms\n→ 收到结果\n→ 再处理下一条消息\n",[25,6535,6533],{"__ignoreMap":285},[18,6537,6538],{},"即使本地计算只需要 1 ms，线程的大部分时间也消耗在网络等待上。如果每条消息都串行调用一次远程服务，单线程理论吞吐很容易被远程调用耗时限制。",[18,6540,6541],{},"“减少同步 RPC”可以从以下方向处理：",[245,6543,6544,6547,6550,6553,6556],{},[211,6545,6546],{},"把逐条调用改为批量接口，例如一次查询或提交 100 条。",[211,6548,6549],{},"对可复用且允许短时间不一致的数据使用本地缓存，减少重复查询。",[211,6551,6552],{},"把互不依赖的调用改成受控并发，但必须限制并发数，避免压垮下游。",[211,6554,6555],{},"将通知、埋点等非核心副作用发送到下游 Topic，由独立消费者异步执行。",[211,6557,6558],{},"合理设置超时、熔断和连接池，避免故障调用长期占住消费线程。",[18,6560,6561],{},"如果必须拿到远程结果才能保证当前消息处理正确，就不能为了吞吐简单删除该 RPC。此时更重要的是批量化、限制并发、幂等和下游容量治理。",[237,6563,6565],{"id":6564},"_3-谨慎调整消费参数","3. 谨慎调整消费参数",[18,6567,6568],{},"常见参数包括：",[279,6570,6572],{"className":3895,"code":6571,"language":3897,"meta":285,"style":285},"max.poll.records=500\nmax.poll.interval.ms=300000\nfetch.min.bytes=1\nfetch.max.wait.ms=500\nmax.partition.fetch.bytes=1048576\n",[25,6573,6574,6581,6588,6594,6600],{"__ignoreMap":285},[315,6575,6576,6579],{"class":317,"line":318},[315,6577,6578],{"class":325},"max.poll.records",[315,6580,5540],{"class":333},[315,6582,6583,6585],{"class":317,"line":343},[315,6584,6305],{"class":325},[315,6586,6587],{"class":333},"=300000\n",[315,6589,6590,6592],{"class":317,"line":359},[315,6591,5529],{"class":325},[315,6593,5532],{"class":333},[315,6595,6596,6598],{"class":317,"line":375},[315,6597,5537],{"class":325},[315,6599,5540],{"class":333},[315,6601,6602,6605],{"class":317,"line":391},[315,6603,6604],{"class":325},"max.partition.fetch.bytes",[315,6606,6607],{"class":333},"=1048576\n",[18,6609,6610],{},"调整原则：",[245,6612,6613,6622,6628,6633],{},[211,6614,6615,6616,6618,6619,6621],{},"如果一批消息处理不完，应适当减小 ",[25,6617,6578],{},"，或优化处理速度，而不是只把 ",[25,6620,6305],{}," 调得无限大。",[211,6623,6624,6625,6627],{},"增大 ",[25,6626,5529],{}," 可以提高批量拉取效率，但会增加低流量时的等待延迟。",[211,6629,6630,6632],{},[25,6631,6604],{}," 过小可能限制大批次拉取，但调大后要评估客户端内存。",[211,6634,6635],{},"参数优化只能降低 Kafka 拉取开销，无法解决数据库或 RPC 本身处理缓慢。",[237,6637,6639],{"id":6638},"_4-异步处理必须有边界","4. 异步处理必须有边界",[18,6641,6642],{},"一种常见设计是由 Poll 线程负责拉取，再把消息交给工作线程池处理：",[279,6644,6647],{"className":6645,"code":6646,"language":284,"meta":285},[282],"Poll 线程\n→ 有界队列\n→ 工作线程池\n→ 处理完成\n→ 按 Partition 推进可安全提交的 Offset\n",[25,6648,6646],{"__ignoreMap":285},[18,6650,6651],{},"为什么必须使用有界队列？假设 Kafka 已经积压 100 万条，Poll 线程仍然高速拉取并塞入无界队列，而工作线程每秒只能处理 100 条，那么积压只是从 Kafka 的磁盘日志转移到了 JVM 堆内存。结果可能是：",[279,6653,6656],{"className":6654,"code":6655,"language":284,"meta":285},[282],"队列持续增长\n→ 堆内存占用上升\n→ Full GC 频繁\n→ 消费进程响应变慢甚至 OOM\n→ 未提交的内存任务随进程退出而丢失并被重新投递\n",[25,6657,6655],{"__ignoreMap":285},[18,6659,6660],{},"Kafka 本身就是持久化队列，没有必要把尚未具备处理能力的消息提前搬进易失的 JVM 内存。",[5611,6662,6664,6665,28,6668],{"id":6663},"使用高低水位控制-pause-和-resume","使用高、低水位控制 ",[25,6666,6667],{},"pause()",[25,6669,6670],{},"resume()",[18,6672,6673],{},"可以为队列设置容量和两个阈值。例如队列容量为 10000：",[279,6675,6678],{"className":6676,"code":6677,"language":284,"meta":285},[282],"高水位：8000\n队列达到高水位\n→ Poll 线程对相关 Partition 调用 pause()\n→ 后续 poll() 暂停返回这些 Partition 的新消息\n\n低水位：3000\n工作线程处理后，队列下降到低水位\n→ Poll 线程调用 resume()\n→ 后续 poll() 重新拉取这些 Partition\n",[25,6679,6677],{"__ignoreMap":285},[18,6681,6682],{},"使用两个不同阈值是为了避免队列在一个临界值附近反复暂停、恢复。阈值不能照搬固定数字，应根据单条消息大小、堆内存、工作线程数和峰值处理耗时进行容量评估。",[18,6684,6685,6687,6688,6690],{},[25,6686,6667],{}," 的含义是暂停指定 Partition 在后续 ",[25,6689,6292],{}," 中返回新记录，它不会：",[245,6692,6693,6696,6699,6702],{},[211,6694,6695],{},"取消当前 Partition 的分配。",[211,6697,6698],{},"自动提交 Offset。",[211,6700,6701],{},"主动触发 Consumer Group 重平衡。",[211,6703,6704],{},"清除已经拉取并放入本地队列的消息。",[18,6706,6707,6708,6710,6711,6713],{},"暂停期间仍然必须持续调用 ",[25,6709,6292],{},"，让 Consumer 处理心跳、协调和重平衡事件。不能因为所有分区都已暂停，就让 Poll 线程长时间睡眠或等待队列清空，否则仍可能超过 ",[25,6712,6305],{}," 并失去分区。",[5611,6715,6717],{"id":6716},"只能由-consumer-所在线程控制拉取","只能由 Consumer 所在线程控制拉取",[18,6719,6720,6723,6724,5067,6726,5067,6728,6730],{},[25,6721,6722],{},"KafkaConsumer"," 不是线程安全的。通常由唯一的 Poll 线程持有并调用 ",[25,6725,6292],{},[25,6727,6667],{},[25,6729,6670],{}," 和提交 Offset；工作线程只处理业务，并把“完成结果”写回一个线程安全的完成队列。工作线程不能直接操作同一个 Consumer。",[18,6732,6733],{},"伪代码可以理解为：",[279,6735,6738],{"className":6736,"code":6737,"language":284,"meta":285},[282],"Poll 线程循环：\n 读取工作线程上报的完成结果\n 推进每个 Partition 的连续成功 Offset\n 根据队列水位执行 pause \u002F resume\n poll() 拉取允许继续消费的 Partition\n 把记录投递到对应的有界工作队列\n\n工作线程：\n 处理业务\n 成功或失败结果写回完成队列\n 不直接调用 KafkaConsumer\n",[25,6739,6737],{"__ignoreMap":285},[5611,6741,6743],{"id":6742},"为什么要按-partition-提交连续成功区间","为什么要按 Partition 提交“连续成功区间”",[18,6745,6746],{},"假设同一 Partition 拉取到：",[279,6748,6751],{"className":6749,"code":6750,"language":284,"meta":285},[282],"Offset 100、101、102\n",[25,6752,6750],{"__ignoreMap":285},[18,6754,6755],{},"并发处理结果是：",[279,6757,6760],{"className":6758,"code":6759,"language":284,"meta":285},[282],"100 成功\n101 仍在处理\n102 成功\n",[25,6761,6759],{"__ignoreMap":285},[18,6763,6764],{},"此时最多只能提交 101，也就是声明 100 已处理完成；不能提交 103。否则进程在 101 完成前崩溃，重启后会从 103 开始，101 就可能被永久跳过。",[18,6766,6767],{},"只有 101 也成功后，100～102 形成连续成功区间，才能提交 103。若业务要求同一 Partition 严格有序，最简单的方式是同一 Partition 串行处理，不要并发执行。",[5611,6769,6770],{"id":6770},"重平衡时还要处理本地未完成任务",[18,6772,6773],{},"发生 Partition 撤销时，应停止向被撤销 Partition 的队列继续投递，并在回调允许的时间内提交已经连续处理成功的 Offset。尚未完成或来不及安全提交的任务，应允许新 Consumer 从旧 Offset 重新消费，因此业务处理必须具备幂等性。",[18,6775,6776],{},"需要共同遵守的约束包括：",[245,6778,6779,6784,6787,6794,6799,6802,6805],{},[211,6780,6781,6783],{},[25,6782,6722],{}," 本身不是线程安全的，不能让多个工作线程同时操作同一个 Consumer。",[211,6785,6786],{},"队列必须有界，不能把 Kafka 的积压无上限转移到 JVM 内存。",[211,6788,6789,5589,6791,6793],{},[25,6790,6667],{},[25,6792,6670],{}," 应由 Poll 线程执行，工作线程通过控制信号提出请求。",[211,6795,6796,6797,4224],{},"即使 Partition 已暂停，Poll 线程也要持续执行 ",[25,6798,6292],{},[211,6800,6801],{},"Offset 必须在消息真正处理成功后提交。",[211,6803,6804],{},"同一 Partition 如果要求严格顺序，不能让后面的消息先于前面的消息产生业务效果。",[211,6806,6807],{},"并发完成后只能提交“连续成功区间”的下一个 Offset，不能跨过尚未完成或失败的消息。",[18,6809,6810],{},"异步化能提高吞吐，但会显著增加 Offset、顺序和失败处理的复杂度。",[14,6812,6814],{"id":6813},"五partition-不够时怎么办","五、Partition 不够时怎么办",[237,6816,6818],{"id":6817},"_1-增加-partition-主要提升未来并行度","1. 增加 Partition 主要提升未来并行度",[18,6820,6821],{},"如果 Consumer 数量已经等于 Partition 数量，且单分区处理能力也接近上限，可以评估增加 Partition。",[18,6823,6824],{},"但要明确：",[56,6826,6827],{},[18,6828,6829],{},[61,6830,6831],{},"给 Topic 新增 Partition，不会把旧 Partition 中已经积压的消息自动重新分布到新 Partition。",[18,6833,6834],{},"新 Partition 主要承接之后产生的新消息。旧积压仍然留在原来的 Partition 中，仍需由对应消费者追赶。",[237,6836,6838],{"id":6837},"_2-增加-partition-可能改变-key-路由","2. 增加 Partition 可能改变 Key 路由",[18,6840,6841],{},"默认的 Key 哈希结果通常与 Partition 数量有关。增加 Partition 后，同一个 Key 的新消息可能进入不同于历史消息的 Partition，从而影响跨扩容时点的顺序假设。",[18,6843,6844],{},"例如为了便于理解，假设某个分区规则可以简化为：",[279,6846,6849],{"className":6847,"code":6848,"language":284,"meta":285},[282],"目标分区 = hash(key) % Partition 数量\n",[25,6850,6848],{"__ignoreMap":285},[18,6852,6853],{},"同一个 Key 的哈希值为 13：",[279,6855,6858],{"className":6856,"code":6857,"language":284,"meta":285},[282],"原来 4 个 Partition：13 % 4 = 1，写入 P1\n扩容到 8 个 Partition：13 % 8 = 5，新消息写入 P5\n",[25,6859,6857],{"__ignoreMap":285},[18,6861,6862],{},"扩容前已经写入 P1 的旧消息不会被搬到 P5。P1 和 P5 又可能由不同 Consumer 并行处理，因此 P5 中的新消息可能先于 P1 中的旧消息完成。这个风险不只是“扩容瞬间”存在，而是会持续到旧分区中的相关历史消息全部处理完毕。",[18,6864,6865],{},"所谓“消费端能否接受跨分区处理”，实际是在问：",[56,6867,6868],{},[18,6869,6870],{},"同一个业务 Key 的旧消息和新消息同时位于不同 Partition，并可能并行、乱序完成时，业务是否仍然正确？",[18,6872,6873],{},"如果事件是独立日志或幂等的最终状态覆盖，业务可能可以接受；如果事件依赖严格顺序，例如“创建订单 → 支付成功 → 关闭订单”，就不能直接接受。",[18,6875,6876],{},"如果业务依赖同一 Key 的严格顺序，常见选择有：",[5611,6878,6880],{"id":6879},"方案一排空旧消息后再扩分区","方案一：排空旧消息后再扩分区",[279,6882,6885],{"className":6883,"code":6884,"language":284,"meta":285},[282],"限制或暂停生产\n→ 等待旧 Topic 的相关消息处理完成\n→ 增加 Partition\n→ 恢复生产\n",[25,6886,6884],{"__ignoreMap":285},[18,6888,6889],{},"这种方式逻辑最清楚，但需要维护窗口，而且在高流量系统中可能很难完全停写。",[5611,6891,6893],{"id":6892},"方案二新建-topic-并进行受控切换","方案二：新建 Topic 并进行受控切换",[18,6895,6896,6897,3382],{},"例如创建具有目标分区数和新路由规则的 ",[25,6898,6899],{},"order-events-v2",[279,6901,6904],{"className":6902,"code":6903,"language":284,"meta":285},[282],"1. 创建并验证新 Topic\n2. 定义明确的切换时间、版本号或业务水位\n3. 新消息从切换点开始写入 v2\n4. v1 消费者继续处理切换点以前的旧消息\n5. 确认某个 Key 或全部旧消息越过安全水位后，再允许 v2 对应消息生效\n6. 完成核对后停止 v1，并保留回滚方案\n",[25,6905,6903],{"__ignoreMap":285},[18,6907,6908],{},"新建 Topic 的价值是把新旧路由、配置和消费组隔离开，便于验证与回滚；代价是必须设计双 Topic 切换、重复消息、遗漏检查和新旧 Offset 衔接。它不是 Kafka 自动迁移，而是业务自己完成的版本化切换。",[18,6910,6911],{},"因此扩分区前应明确回答：",[245,6913,6914,6917,6920,6923],{},[211,6915,6916],{},"分区器如何计算目标 Partition。",[211,6918,6919],{},"旧消息是否已经处理完成。",[211,6921,6922],{},"同一 Key 跨新旧 Partition 并行处理是否会破坏业务顺序。",[211,6924,6925],{},"是选择维护窗口排空旧消息，还是新建 Topic 做受控切换。",[237,6927,6929],{"id":6928},"_3-极端情况下建立临时加速链路","3. 极端情况下建立临时加速链路",[18,6931,6932],{},"当原 Topic 分区数严重不足、积压量巨大时，可以设计经过评审的临时方案：",[279,6934,6937],{"className":6935,"code":6936,"language":284,"meta":285},[282],"原 Topic\n→ 临时搬运程序\n→ 更高分区数的中转 Topic\n→ 临时扩容后的消费组\n→ 业务处理\n",[25,6938,6936],{"__ignoreMap":285},[18,6940,6941],{},"这会引入顺序、重复、Offset 衔接和回切问题，只适合经过完整设计和演练的场景，不能在生产事故中临时拍脑袋执行。",[14,6943,6945],{"id":6944},"六热点-partition-如何处理","六、热点 Partition 如何处理",[18,6947,6948],{},"如果只有少数 Partition 积压，需要检查消息 Key 分布。",[18,6950,6951],{},"例如所有消息都使用同一个固定 Key：",[279,6953,6956],{"className":6954,"code":6955,"language":284,"meta":285},[282],"key = \"default\"\n→ 所有消息进入同一 Partition\n→ 其他 Partition 空闲\n→ 单分区成为瓶颈\n",[25,6957,6955],{"__ignoreMap":285},[18,6959,6960],{},"解决方向包括：",[245,6962,6963,6966,6969,6975,6978],{},[211,6964,6965],{},"选择分布更均匀的业务 Key。",[211,6967,6968],{},"对非顺序场景取消固定 Key。",[211,6970,6971,6972,4224],{},"对热点业务 Key 做可控分片，例如 ",[25,6973,6974],{},"userId + shardNo",[211,6976,6977],{},"单独拆分热点租户或热点业务到独立 Topic。",[211,6979,6980],{},"优化该 Partition 对应消费者的单条处理耗时。",[18,6982,6983],{},"Key 拆分会改变顺序语义。原来同一 Key 的全局顺序，拆分后通常只能保证每个子 Key 内部有序。",[14,6985,6987],{"id":6986},"七毒消息和重试如何处理","七、毒消息和重试如何处理",[18,6989,6990],{},"不要让一条永远失败的消息无限阻塞 Partition。常见处理策略是：",[279,6992,6995],{"className":6993,"code":6994,"language":284,"meta":285},[282],"第一次失败\n→ 记录错误并有限重试\n→ 仍然失败\n→ 进入重试 Topic \u002F 死信 Topic\n→ 主消费链路继续\n→ 告警和人工补偿\n",[25,6996,6994],{"__ignoreMap":285},[18,6998,6999],{},"需要保留：",[245,7001,7002,7005,7008,7011],{},[211,7003,7004],{},"原始 Topic、Partition 和 Offset。",[211,7006,7007],{},"消息 Key、事件 ID 和原始内容。",[211,7009,7010],{},"异常原因和重试次数。",[211,7012,7013],{},"首次失败和最后失败时间。",[18,7015,7016],{},"如果业务要求同一 Key 严格顺序，就不能简单跳过失败消息继续处理后续消息。此时应暂停对应 Partition，优先修复或补偿该消息；这是吞吐与顺序之间的业务取舍。",[14,7018,7020],{"id":7019},"八如何估算多久能消化完积压","八、如何估算多久能消化完积压",[18,7022,7023],{},"设：",[279,7025,7028],{"className":7026,"code":7027,"language":284,"meta":285},[282],"B = 当前积压消息数\nP = 当前生产速度（条\u002F秒）\nC = 扩容后的稳定消费速度（条\u002F秒）\n",[25,7029,7027],{"__ignoreMap":285},[18,7031,7032],{},"只有：",[279,7034,7037],{"className":7035,"code":7036,"language":284,"meta":285},[282],"C > P\n",[25,7038,7036],{"__ignoreMap":285},[18,7040,7041],{},"积压才会下降。理论恢复时间约为：",[279,7043,7046],{"className":7044,"code":7045,"language":284,"meta":285},[282],"恢复时间 T = B \u002F (C - P)\n",[25,7047,7045],{"__ignoreMap":285},[18,7049,3181],{},[279,7051,7054],{"className":7052,"code":7053,"language":284,"meta":285},[282],"当前积压 B = 360 万条\n生产速度 P = 2000 条\u002F秒\n消费速度 C = 5000 条\u002F秒\n\n净消化速度 = 5000 - 2000 = 3000 条\u002F秒\n理论恢复时间 = 3600000 \u002F 3000 = 1200 秒\n≈ 20 分钟\n",[25,7055,7053],{"__ignoreMap":285},[18,7057,7058],{},"实际还要为重平衡、失败重试、下游波动和流量峰值预留余量。",[18,7060,491,7061,7064],{},[25,7062,7063],{},"C \u003C= P","，无论运行多久都追不上，必须降低生产速率或提高有效消费能力。",[14,7066,7068],{"id":7067},"九offset-跳到最新为什么不是常规方案","九、Offset 跳到最新为什么不是常规方案",[18,7070,7071],{},"把消费组 Offset 重置到最新位置，确实可以让 Lag 迅速变成 0，但其本质是：",[56,7073,7074],{},[18,7075,7076],{},[61,7077,7078],{},"主动放弃尚未消费的历史消息。",[18,7080,7081],{},"只有同时满足以下条件才可以考虑：",[245,7083,7084,7087,7090,7093,7096],{},[211,7085,7086],{},"业务明确确认旧消息可以丢弃。",[211,7088,7089],{},"已评估对账、状态和下游影响。",[211,7091,7092],{},"已保留必要的审计或补偿数据。",[211,7094,7095],{},"操作前进行了 Dry Run，并确认 Topic、Consumer Group 和目标 Offset。",[211,7097,7098],{},"操作期间停止相关消费者，避免 Offset 并发变化。",[18,7100,7101],{},"资金、订单、库存等关键链路不能把重置 Offset 当作普通清积压手段。",[237,7103,7105],{"id":7104},"什么是-dry-run","什么是 Dry Run",[18,7107,7108],{},"Dry Run 就是“只预演，不执行”。它先计算并展示每个 Partition 将从哪个 Offset 调整到哪个 Offset，供操作人员核对 Topic、消费组、分区范围和目标位置，但不真正修改已提交 Offset。",[18,7110,7111],{},"例如将消费组预演重置到最新位置：",[279,7113,7115],{"className":309,"code":7114,"language":311,"meta":285,"style":285},"bin\u002Fkafka-consumer-groups.sh \\\n --bootstrap-server kafka.example.com:9092 \\\n --group order-consumer-group \\\n --topic order-events \\\n --reset-offsets \\\n --to-latest\n",[25,7116,7117,7125,7135,7145,7155,7162],{"__ignoreMap":285},[315,7118,7119,7122],{"class":317,"line":318},[315,7120,7121],{"class":321},"bin\u002Fkafka-consumer-groups.sh",[315,7123,7124],{"class":839}," \\\n",[315,7126,7127,7130,7133],{"class":317,"line":343},[315,7128,7129],{"class":839}," --bootstrap-server",[315,7131,7132],{"class":329}," kafka.example.com:9092",[315,7134,7124],{"class":839},[315,7136,7137,7140,7143],{"class":317,"line":359},[315,7138,7139],{"class":839}," --group",[315,7141,7142],{"class":329}," order-consumer-group",[315,7144,7124],{"class":839},[315,7146,7147,7150,7153],{"class":317,"line":375},[315,7148,7149],{"class":839}," --topic",[315,7151,7152],{"class":329}," order-events",[315,7154,7124],{"class":839},[315,7156,7157,7160],{"class":317,"line":391},[315,7158,7159],{"class":839}," --reset-offsets",[315,7161,7124],{"class":839},[315,7163,7164],{"class":317,"line":2562},[315,7165,7166],{"class":839}," --to-latest\n",[18,7168,7169,7170,7173],{},"Kafka 4.1 的消费组工具默认只展示重置计划；确认结果无误后，显式增加 ",[25,7171,7172],{},"--execute"," 才会真正执行：",[279,7175,7177],{"className":309,"code":7176,"language":311,"meta":285,"style":285},"bin\u002Fkafka-consumer-groups.sh \\\n --bootstrap-server kafka.example.com:9092 \\\n --group order-consumer-group \\\n --topic order-events \\\n --reset-offsets \\\n --to-latest \\\n --execute\n",[25,7178,7179,7185,7193,7201,7209,7215,7222],{"__ignoreMap":285},[315,7180,7181,7183],{"class":317,"line":318},[315,7182,7121],{"class":321},[315,7184,7124],{"class":839},[315,7186,7187,7189,7191],{"class":317,"line":343},[315,7188,7129],{"class":839},[315,7190,7132],{"class":329},[315,7192,7124],{"class":839},[315,7194,7195,7197,7199],{"class":317,"line":359},[315,7196,7139],{"class":839},[315,7198,7142],{"class":329},[315,7200,7124],{"class":839},[315,7202,7203,7205,7207],{"class":317,"line":375},[315,7204,7149],{"class":839},[315,7206,7152],{"class":329},[315,7208,7124],{"class":839},[315,7210,7211,7213],{"class":317,"line":391},[315,7212,7159],{"class":839},[315,7214,7124],{"class":839},[315,7216,7217,7220],{"class":317,"line":2562},[315,7218,7219],{"class":839}," --to-latest",[315,7221,7124],{"class":839},[315,7223,7224],{"class":317,"line":2580},[315,7225,7226],{"class":839}," --execute\n",[18,7228,7229],{},"不同 Kafka 版本的工具参数可能略有差异，生产操作前应以实际部署版本的命令帮助和官方文档为准。",[237,7231,7232],{"id":7232},"为什么操作期间要停止消费者",[18,7234,7235,7236,7238],{},"活动消费者会继续执行 ",[25,7237,6292],{},"、处理消息并提交 Offset。如果管理人员同时重置 Offset，就可能发生竞态：",[279,7240,7243],{"className":7241,"code":7242,"language":284,"meta":285},[282],"管理员把 Offset 从 1000 重置到 5000\n→ 仍在运行的消费者随后提交自己内存中的旧进度 1200\n→ 重置结果被旧提交覆盖\n",[25,7244,7242],{"__ignoreMap":285},[18,7246,7247],{},"反过来也可能是消费者刚处理到 1300，管理员基于稍早看到的状态执行重置，导致已处理消息重复消费或尚未处理消息被跳过。活动成员还可能触发重平衡，使操作时看到的分区归属和 Offset 继续变化。",[18,7249,7250],{},"因此安全流程应是：",[279,7252,7255],{"className":7253,"code":7254,"language":284,"meta":285},[282],"停止该消费组的所有消费者\n→ 确认消费组已无活动成员\n→ 记录操作前 Offset\n→ 执行 Dry Run 并双人核对\n→ 使用 --execute 修改 Offset\n→ 再次查询并确认结果\n→ 启动消费者并观察消费位置\n",[25,7256,7254],{"__ignoreMap":285},[18,7258,7259],{},"这不仅是避免并发覆盖。Kafka 官方的消费组 Offset 重置说明也明确要求先确保消费实例处于非活动状态。",[14,7261,7263],{"id":7262},"十恢复后要做什么","十、恢复后要做什么",[18,7265,7266],{},"积压恢复不代表问题结束，还应完成：",[208,7268,7269,7272,7275,7278,7281,7284,7287],{},[211,7270,7271],{},"复盘根因和时间线。",[211,7273,7274],{},"补充总 Lag、最大分区 Lag、时间 Lag 和增长率告警。",[211,7276,7277],{},"建立生产速度、消费速度和预计恢复时间看板。",[211,7279,7280],{},"对热点 Partition、毒消息和下游耗时建立专项监控。",[211,7282,7283],{},"按峰值流量进行容量压测，保留消费冗余。",[211,7285,7286],{},"演练消费者扩容、下游故障、重平衡和死信补偿。",[211,7288,7289],{},"核对积压期间是否发生消息过期、重复处理或业务遗漏。",[14,7291,7293],{"id":7292},"十一常见误区","十一、常见误区",[237,7295,7297],{"id":7296},"误区一积压就直接增加-consumer","误区一：积压就直接增加 Consumer",[18,7299,7300],{},"如果 Partition 数量不足、多数 Consumer 已空闲，或者瓶颈实际在数据库，增加 Consumer 不会解决问题，反而可能加剧下游压力。",[237,7302,7304,7305,7307],{"id":7303},"误区二把-maxpollrecords-调大就能提升吞吐","误区二：把 ",[25,7306,6578],{}," 调大就能提升吞吐",[18,7309,7310],{},"拉取更多消息不等于处理更快。批次过大还可能导致处理超时、重平衡和更高的失败重试成本。",[237,7312,7314],{"id":7313},"误区三增加-partition-会重新分配旧积压","误区三：增加 Partition 会重新分配旧积压",[18,7316,7317],{},"新增 Partition 不会迁移旧 Partition 中已有的消息，只能为后续消息提供更多并行空间。",[237,7319,7321],{"id":7320},"误区四lag-等于业务延迟","误区四：Lag 等于业务延迟",[18,7323,7324,7325,7328],{},"Lag 是 Offset 数量差，只表示还落后多少条记录，不等于时间延迟。相同 Lag 下，消费者处理速度越快，处理完现有积压所需的时间越短；如果生产仍在继续，则应使用 ",[25,7326,7327],{},"Lag ÷（消费速度－生产速度）"," 估算 Lag 归零时间。",[18,7330,7331],{},"当前业务已经延迟多久，应通过最老未处理消息的时间戳判断。消息大小影响积压字节量、网络与反序列化成本，单条处理耗时影响消费速度。因此排查时应把 Lag 条数、最老消息年龄、积压字节量和实际处理吞吐分开观察，不能混成一个指标。",[237,7333,7335],{"id":7334},"误区五把-offset-跳到最新就是清理积压","误区五：把 Offset 跳到最新就是清理积压",[18,7337,7338],{},"这不是“处理了积压”，而是“丢弃了积压”。必须经过明确的业务授权和风险评估。",[14,7340,1191],{"id":1191},[245,7342,7343,7348,7353,7360],{},[211,7344,7345],{},[70,7346,4974],{"href":4972,"rel":7347},[1200],[211,7349,7350],{},[70,7351,4988],{"href":4986,"rel":7352},[1200],[211,7354,7355],{},[70,7356,7359],{"href":7357,"rel":7358},"https:\u002F\u002Fkafka.apache.org\u002F41\u002Foperations\u002Fconsumer-rebalance-protocol\u002F",[1200],"Apache Kafka Consumer Rebalance Protocol",[211,7361,7362],{},[70,7363,7366],{"href":7364,"rel":7365},"https:\u002F\u002Fkafka.apache.org\u002F41\u002Foperations\u002Fbasic-kafka-operations\u002F",[1200],"Apache Kafka Basic Operations",[1224,7368,7369],{},"html pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}",{"title":285,"searchDepth":343,"depth":343,"links":7371},[7372,7373,7374,7375,7376,7383,7388,7394,7399,7400,7401,7402,7406,7407,7415],{"id":16,"depth":343,"text":16},{"id":66,"depth":343,"text":66},{"id":83,"depth":343,"text":83},{"id":6128,"depth":343,"text":6129},{"id":6255,"depth":343,"text":6256,"children":7377},[7378,7379,7380,7381,7382],{"id":6259,"depth":359,"text":6260},{"id":6272,"depth":359,"text":6273},{"id":6309,"depth":359,"text":6310},{"id":6348,"depth":359,"text":6349},{"id":6367,"depth":359,"text":6368},{"id":6394,"depth":343,"text":6395,"children":7384},[7385,7386,7387],{"id":6398,"depth":359,"text":6399},{"id":6414,"depth":359,"text":6415},{"id":6450,"depth":359,"text":6451},{"id":6463,"depth":343,"text":6464,"children":7389},[7390,7391,7392,7393],{"id":6467,"depth":359,"text":6468},{"id":6486,"depth":359,"text":6487},{"id":6564,"depth":359,"text":6565},{"id":6638,"depth":359,"text":6639},{"id":6813,"depth":343,"text":6814,"children":7395},[7396,7397,7398],{"id":6817,"depth":359,"text":6818},{"id":6837,"depth":359,"text":6838},{"id":6928,"depth":359,"text":6929},{"id":6944,"depth":343,"text":6945},{"id":6986,"depth":343,"text":6987},{"id":7019,"depth":343,"text":7020},{"id":7067,"depth":343,"text":7068,"children":7403},[7404,7405],{"id":7104,"depth":359,"text":7105},{"id":7232,"depth":359,"text":7232},{"id":7262,"depth":343,"text":7263},{"id":7292,"depth":343,"text":7293,"children":7408},[7409,7410,7412,7413,7414],{"id":7296,"depth":359,"text":7297},{"id":7303,"depth":359,"text":7411},"误区二：把 max.poll.records 调大就能提升吞吐",{"id":7313,"depth":359,"text":7314},{"id":7320,"depth":359,"text":7321},{"id":7334,"depth":359,"text":7335},{"id":1191,"depth":343,"text":1191},"wiki:java:kafka-message-backlog-handling","从 Consumer Lag 识别、瓶颈定位、限流止血、消费者扩容、批量处理、热点分区和毒消息治理等方面，系统讲解 Kafka 消息积压处理方案。",{},74,"\u002Fjava\u002Fkafka-message-backlog-handling",{"title":6079,"description":7417},"java\u002Fkafka-message-backlog-handling","j141MMc6Jxe-rO6ryPb9AobOsARduthfBsD8j-HG0p8",{"id":7425,"title":7426,"body":7427,"commentId":9172,"description":9173,"difficulty":1276,"draft":1277,"extension":1278,"meta":9174,"navigation":1280,"order":9175,"path":9176,"section":1283,"seo":9177,"stem":9178,"updated":5044,"__hash__":9179},"java\u002Fjava\u002Fmysql-transaction-isolation-and-phantom-read.md","MySQL 的隔离级别都有哪些？如何避免幻读？",{"type":7,"value":7428,"toc":9123},[7429,7431,7434,7473,7476,7490,7493,7496,7501,7503,7512,7514,7518,7521,7526,7529,7532,7613,7615,7620,7624,7628,7631,7637,7643,7647,7650,7656,7659,7664,7668,7671,7677,7680,7683,7688,7691,7699,7703,7707,7710,7721,7724,7728,7731,7734,7740,7743,7749,7757,7761,7764,7770,7776,7779,7782,7786,7789,7795,7815,7818,7821,7825,7828,7832,7838,7877,7880,7891,7894,7898,7901,7942,7945,7948,7952,7955,7998,8005,8046,8049,8080,8083,8086,8091,8094,8098,8101,8149,8156,8178,8181,8184,8209,8215,8218,8223,8227,8231,8234,8236,8271,8277,8281,8284,8287,8293,8296,8302,8305,8309,8312,8318,8321,8327,8330,8336,8356,8359,8364,8367,8401,8414,8420,8423,8429,8432,8435,8459,8465,8468,8501,8505,8508,8511,8548,8551,8554,8557,8562,8564,8569,8572,8589,8593,8596,8639,8642,8645,8648,8662,8665,8688,8691,8695,8701,8704,8710,8713,8725,8728,8731,8735,8738,8746,8749,8757,8760,8774,8778,8782,8784,8798,8802,8804,8818,8822,8824,8838,8841,8861,8865,8868,8891,8894,8914,8917,8947,8950,8972,8975,8986,8989,9004,9015,9018,9026,9029,9031,9035,9038,9042,9045,9053,9057,9060,9064,9067,9071,9074,9078,9081,9083,9120],[14,7430,16],{"id":16},[18,7432,7433],{},"MySQL InnoDB 支持四种事务隔离级别：读未提交、读已提交、可重复读和串行化。",[245,7435,7436,7442,7448,7467],{},[211,7437,7438,7441],{},[61,7439,7440],{},"读未提交（READ UNCOMMITTED）","：可能发生脏读、不可重复读和幻读。",[211,7443,7444,7447],{},[61,7445,7446],{},"读已提交（READ COMMITTED）","：只能读取已经提交的数据，但每次普通查询都会创建新的 Read View，因此可能发生不可重复读和幻读。",[211,7449,7450,7453,7454,5067,7457,5067,7460,28,7463,7466],{},[61,7451,7452],{},"可重复读（REPEATABLE READ）","：MySQL InnoDB 的默认隔离级别。同一事务中的普通快照读复用第一次查询建立的 Read View，避免不可重复读，并通过一致性快照避免看到后来插入的幻影行；对于 ",[25,7455,7456],{},"SELECT ... FOR UPDATE",[25,7458,7459],{},"SELECT ... FOR SHARE",[25,7461,7462],{},"UPDATE",[25,7464,7465],{},"DELETE"," 等当前读，则通过 Next-Key Lock 锁住索引记录及其前面的间隙，阻止其他事务在查询范围内插入新记录。",[211,7468,7469,7472],{},[61,7470,7471],{},"串行化（SERIALIZABLE）","：隔离性最强，事务近似串行执行，可以避免脏读、不可重复读和幻读，但并发能力最低。",[18,7474,7475],{},"因此，回答“InnoDB 如何避免幻读”时，需要区分两类读取：",[208,7477,7478,7485],{},[211,7479,7480,7481,7484],{},"普通 ",[25,7482,7483],{},"SELECT"," 属于快照读，REPEATABLE READ 通过 MVCC 和同一个 Read View，让事务始终读取同一份一致性快照。",[211,7486,7487,7489],{},[25,7488,7456],{}," 等属于当前读，REPEATABLE READ 通过 Gap Lock 和 Next-Key Lock 阻止其他事务向锁定范围插入新记录。",[18,7491,7492],{},"如果业务逻辑是“先查询是否存在，再决定是否插入或更新”，仅依赖快照读通常不够，应在 REPEATABLE READ 下使用合适索引和锁定读，并通过唯一索引等数据库约束作为最终兜底。",[237,7494,7495],{"id":7495},"一句话总结",[56,7497,7498],{},[18,7499,7500],{},"InnoDB 默认使用 REPEATABLE READ：普通查询靠 MVCC 的一致性快照避免看见幻影行，当前读靠 Next-Key Lock 锁住记录和间隙，阻止幻影行被插入。",[14,7502,66],{"id":66},[18,7504,7505],{},[70,7506,7509],{"href":7507,"target":73,"rel":7508},"\u002Fimages\u002Fwiki\u002Fjava\u002Fmysql-transaction-isolation-and-phantom-read.svg",[75,76],[78,7510],{"src":7507,"alt":7511},"MySQL 四种事务隔离级别与 InnoDB 避免幻读的机制",[14,7513,83],{"id":83},[14,7515,7517],{"id":7516},"一事务隔离级别解决什么问题","一、事务隔离级别解决什么问题",[18,7519,7520],{},"多个事务并发执行时，一个事务的写入可能影响另一个事务的读取。隔离级别用于规定：",[56,7522,7523],{},[18,7524,7525],{},"一个事务能够看到其他事务的哪些修改，以及什么时候能够看到这些修改。",[18,7527,7528],{},"隔离级别越高，事务之间的影响越小，但加锁和等待通常越多，并发能力也可能越低。",[18,7530,7531],{},"MySQL InnoDB 支持 SQL 标准定义的四种隔离级别：",[98,7533,7534,7554],{},[101,7535,7536],{},[104,7537,7538,7541,7545,7548,7551],{},[107,7539,7540],{},"隔离级别",[107,7542,7544],{"align":7543},"right","脏读",[107,7546,7547],{"align":7543},"不可重复读",[107,7549,7550],{"align":7543},"幻读",[107,7552,7553],{"align":7543},"并发能力",[114,7555,7556,7571,7585,7599],{},[104,7557,7558,7561,7564,7566,7568],{},[119,7559,7560],{},"READ UNCOMMITTED",[119,7562,7563],{"align":7543},"可能",[119,7565,7563],{"align":7543},[119,7567,7563],{"align":7543},[119,7569,7570],{"align":7543},"最高",[104,7572,7573,7576,7579,7581,7583],{},[119,7574,7575],{},"READ COMMITTED",[119,7577,7578],{"align":7543},"避免",[119,7580,7563],{"align":7543},[119,7582,7563],{"align":7543},[119,7584,3058],{"align":7543},[104,7586,7587,7590,7592,7594,7597],{},[119,7588,7589],{},"REPEATABLE READ",[119,7591,7578],{"align":7543},[119,7593,7578],{"align":7543},[119,7595,7596],{"align":7543},"InnoDB 通过 MVCC 和 Next-Key Lock 处理",[119,7598,3058],{"align":7543},[104,7600,7601,7604,7606,7608,7610],{},[119,7602,7603],{},"SERIALIZABLE",[119,7605,7578],{"align":7543},[119,7607,7578],{"align":7543},[119,7609,7578],{"align":7543},[119,7611,7612],{"align":7543},"最低",[18,7614,3971],{},[56,7616,7617],{},[18,7618,7619],{},"“REPEATABLE READ 可能发生幻读”是 SQL 标准层面的常见结论；MySQL InnoDB 在该级别上又实现了 MVCC 和 Next-Key Lock，对快照读和当前读分别处理幻读问题。",[14,7621,7623],{"id":7622},"二三种并发读取问题","二、三种并发读取问题",[237,7625,7627],{"id":7626},"_1-脏读","1. 脏读",[18,7629,7630],{},"事务 A 读取了事务 B 尚未提交的数据。如果事务 B 最后回滚，事务 A 读到的就是从未真正生效的数据。",[279,7632,7635],{"className":7633,"code":7634,"language":284,"meta":285},[282],"事务 A 事务 B\n 修改余额 100 → 0\n读取余额，得到 0\n ROLLBACK\n",[25,7636,7634],{"__ignoreMap":285},[18,7638,7639,7640,7642],{},"这里的 ",[25,7641,1541],{}," 就是脏数据。",[237,7644,7646],{"id":7645},"_2-不可重复读","2. 不可重复读",[18,7648,7649],{},"同一事务两次读取同一行，得到的字段值不同。",[279,7651,7654],{"className":7652,"code":7653,"language":284,"meta":285},[282],"事务 A 事务 B\n读取 id=1，余额为 100\n 修改余额为 80\n COMMIT\n再次读取 id=1，余额为 80\n",[25,7655,7653],{"__ignoreMap":285},[18,7657,7658],{},"不可重复读关注的是：",[56,7660,7661],{},[18,7662,7663],{},"同一行记录的内容发生了变化。",[237,7665,7667],{"id":7666},"_3-幻读","3. 幻读",[18,7669,7670],{},"同一事务使用相同查询条件执行两次查询，第二次返回的结果集合中出现了第一次不存在的记录，或者原有记录消失。",[279,7672,7675],{"className":7673,"code":7674,"language":284,"meta":285},[282],"事务 A 事务 B\n查询 amount > 100，返回 3 行\n 插入一条 amount=150 的记录\n COMMIT\n再次查询 amount > 100，返回 4 行\n",[25,7676,7674],{"__ignoreMap":285},[18,7678,7679],{},"新增的第 4 行就是幻影行。",[18,7681,7682],{},"幻读关注的是：",[56,7684,7685],{},[18,7686,7687],{},"满足查询条件的记录集合发生了变化。",[18,7689,7690],{},"所以，不可重复读和幻读的区别可以记为：",[245,7692,7693,7696],{},[211,7694,7695],{},"不可重复读：同一行的值变了。",[211,7697,7698],{},"幻读：符合条件的行数或记录集合变了。",[14,7700,7702],{"id":7701},"三四种隔离级别","三、四种隔离级别",[237,7704,7706],{"id":7705},"_1-read-uncommitted读未提交","1. READ UNCOMMITTED：读未提交",[18,7708,7709],{},"事务可以读取其他事务尚未提交的修改，因此可能发生：",[245,7711,7712,7715,7718],{},[211,7713,7714],{},"脏读；",[211,7716,7717],{},"不可重复读；",[211,7719,7720],{},"幻读。",[18,7722,7723],{},"它的隔离性最低，实际业务系统很少使用。",[237,7725,7727],{"id":7726},"_2-read-committed读已提交","2. READ COMMITTED：读已提交",[18,7729,7730],{},"事务只能读取已经提交的数据，因此不会发生脏读。",[18,7732,7733],{},"但在 InnoDB 中，每一次普通一致性读都会创建一个新的 Read View：",[279,7735,7738],{"className":7736,"code":7737,"language":284,"meta":285},[282],"第一次 SELECT → Read View 1\n第二次 SELECT → Read View 2\n第三次 SELECT → Read View 3\n",[25,7739,7737],{"__ignoreMap":285},[18,7741,7742],{},"如果其他事务在两次查询之间提交了修改，后一次查询就可能看到新数据，因此可能发生：",[245,7744,7745,7747],{},[211,7746,7717],{},[211,7748,7720],{},[18,7750,7751,7752,28,7754,7756],{},"另外，在 READ COMMITTED 下，锁定读、",[25,7753,7462],{},[25,7755,7465],{}," 通常只锁索引记录，不锁记录前面的间隙。除了外键约束检查和重复键检查等情况外，Gap Lock 被禁用，因此其他事务仍可能向间隙插入新记录。",[237,7758,7760],{"id":7759},"_3-repeatable-read可重复读","3. REPEATABLE READ：可重复读",[18,7762,7763],{},"这是 InnoDB 的默认隔离级别。",[18,7765,7766,7767,7769],{},"对于普通 ",[25,7768,7483],{},"，事务中的第一次一致性读会建立 Read View，之后的普通一致性读继续使用该快照：",[279,7771,7774],{"className":7772,"code":7773,"language":284,"meta":285},[282],"第一次普通 SELECT → 创建 Read View\n第二次普通 SELECT → 复用同一个 Read View\n第三次普通 SELECT → 复用同一个 Read View\n",[25,7775,7773],{"__ignoreMap":285},[18,7777,7778],{},"因此，其他事务之后提交的更新、删除或插入不会出现在当前事务的旧快照中。",[18,7780,7781],{},"对于锁定读和数据修改语句，InnoDB 会读取最新可用数据，并根据查询使用的索引范围加锁。范围条件通常会使用 Gap Lock 或 Next-Key Lock，阻止其他事务向被锁定的范围插入新记录。",[237,7783,7785],{"id":7784},"_4-serializable串行化","4. SERIALIZABLE：串行化",[18,7787,7788],{},"SERIALIZABLE 是隔离性最强的级别。",[18,7790,7791,7792,7794],{},"在关闭自动提交的情况下，InnoDB 会把普通 ",[25,7793,7483],{}," 隐式转换为共享锁定读，效果类似：",[279,7796,7800],{"className":7797,"code":7798,"language":7799,"meta":285,"style":285},"language-sql shiki shiki-themes github-light github-dark","SELECT ... FOR SHARE;\n","sql",[25,7801,7802],{"__ignoreMap":285},[315,7803,7804,7806,7809,7812],{"class":317,"line":318},[315,7805,7483],{"class":325},[315,7807,7808],{"class":333}," ... ",[315,7810,7811],{"class":325},"FOR",[315,7813,7814],{"class":333}," SHARE;\n",[18,7816,7817],{},"这样事务之间会产生更多锁等待，能够避免脏读、不可重复读和幻读，但吞吐量通常明显下降。",[18,7819,7820],{},"它适合一致性要求极高、并发量较低，或者确实需要事务串行执行的场景。",[14,7822,7824],{"id":7823},"四快照读与当前读","四、快照读与当前读",[18,7826,7827],{},"理解 InnoDB 如何处理幻读，必须先区分快照读和当前读。",[237,7829,7831],{"id":7830},"_1-快照读","1. 快照读",[18,7833,7834,7835,7837],{},"在 READ COMMITTED 和 REPEATABLE READ 下，普通 ",[25,7836,7483],{}," 通常属于快照读：",[279,7839,7841],{"className":7797,"code":7840,"language":7799,"meta":285,"style":285},"SELECT * FROM orders WHERE amount BETWEEN 100 AND 200;\n",[25,7842,7843],{"__ignoreMap":285},[315,7844,7845,7847,7850,7853,7856,7859,7862,7865,7868,7871,7874],{"class":317,"line":318},[315,7846,7483],{"class":325},[315,7848,7849],{"class":325}," *",[315,7851,7852],{"class":325}," FROM",[315,7854,7855],{"class":333}," orders ",[315,7857,7858],{"class":325},"WHERE",[315,7860,7861],{"class":333}," amount ",[315,7863,7864],{"class":325},"BETWEEN",[315,7866,7867],{"class":839}," 100",[315,7869,7870],{"class":325}," AND",[315,7872,7873],{"class":839}," 200",[315,7875,7876],{"class":333},";\n",[18,7878,7879],{},"快照读：",[245,7881,7882,7885,7888],{},[211,7883,7884],{},"不对查询记录加行锁；",[211,7886,7887],{},"通过 MVCC 读取某个时间点的一致性数据；",[211,7889,7890],{},"其他事务可以继续修改、删除或插入数据。",[18,7892,7893],{},"REPEATABLE READ 下，同一事务中的普通快照读复用同一个 Read View，所以后来提交的记录对当前快照不可见。",[237,7895,7897],{"id":7896},"_2-当前读","2. 当前读",[18,7899,7900],{},"下面这些操作需要读取最新可用的数据，并对数据加锁：",[279,7902,7904],{"className":7797,"code":7903,"language":7799,"meta":285,"style":285},"SELECT ... FOR UPDATE;\nSELECT ... FOR SHARE;\nUPDATE ...;\nDELETE ...;\n",[25,7905,7906,7919,7929,7936],{"__ignoreMap":285},[315,7907,7908,7910,7912,7914,7917],{"class":317,"line":318},[315,7909,7483],{"class":325},[315,7911,7808],{"class":333},[315,7913,7811],{"class":325},[315,7915,7916],{"class":325}," UPDATE",[315,7918,7876],{"class":333},[315,7920,7921,7923,7925,7927],{"class":317,"line":343},[315,7922,7483],{"class":325},[315,7924,7808],{"class":333},[315,7926,7811],{"class":325},[315,7928,7814],{"class":333},[315,7930,7931,7933],{"class":317,"line":359},[315,7932,7462],{"class":325},[315,7934,7935],{"class":333}," ...;\n",[315,7937,7938,7940],{"class":317,"line":375},[315,7939,7465],{"class":325},[315,7941,7935],{"class":333},[18,7943,7944],{},"它们通常被称为当前读或锁定读。",[18,7946,7947],{},"当前读不能只依靠旧快照，因为业务接下来可能要修改数据。它必须在最新数据状态上进行判断，并锁住相关记录或范围，避免判断完成后数据立即被并发事务改变。",[14,7949,7951],{"id":7950},"五快照读如何避免幻读","五、快照读如何避免幻读",[18,7953,7954],{},"假设当前使用 REPEATABLE READ：",[279,7956,7958],{"className":7797,"code":7957,"language":7799,"meta":285,"style":285},"START TRANSACTION;\n\nSELECT * FROM orders\nWHERE amount BETWEEN 100 AND 200;\n",[25,7959,7960,7967,7971,7982],{"__ignoreMap":285},[315,7961,7962,7965],{"class":317,"line":318},[315,7963,7964],{"class":325},"START TRANSACTION",[315,7966,7876],{"class":333},[315,7968,7969],{"class":317,"line":343},[315,7970,2525],{"emptyLinePlaceholder":1280},[315,7972,7973,7975,7977,7979],{"class":317,"line":359},[315,7974,7483],{"class":325},[315,7976,7849],{"class":325},[315,7978,7852],{"class":325},[315,7980,7981],{"class":333}," orders\n",[315,7983,7984,7986,7988,7990,7992,7994,7996],{"class":317,"line":375},[315,7985,7858],{"class":325},[315,7987,7861],{"class":333},[315,7989,7864],{"class":325},[315,7991,7867],{"class":839},[315,7993,7870],{"class":325},[315,7995,7873],{"class":839},[315,7997,7876],{"class":333},[18,7999,8000,8001,8004],{},"第一次普通查询建立 Read View。此后事务 B 插入一条 ",[25,8002,8003],{},"amount=150"," 的记录并提交：",[279,8006,8008],{"className":7797,"code":8007,"language":7799,"meta":285,"style":285},"INSERT INTO orders(user_id, amount)\nVALUES (10, 150);\n\nCOMMIT;\n",[25,8009,8010,8018,8035,8039],{"__ignoreMap":285},[315,8011,8012,8015],{"class":317,"line":318},[315,8013,8014],{"class":325},"INSERT INTO",[315,8016,8017],{"class":333}," orders(user_id, amount)\n",[315,8019,8020,8023,8025,8027,8029,8032],{"class":317,"line":343},[315,8021,8022],{"class":325},"VALUES",[315,8024,4311],{"class":333},[315,8026,1590],{"class":839},[315,8028,4327],{"class":333},[315,8030,8031],{"class":839},"150",[315,8033,8034],{"class":333},");\n",[315,8036,8037],{"class":317,"line":359},[315,8038,2525],{"emptyLinePlaceholder":1280},[315,8040,8041,8044],{"class":317,"line":375},[315,8042,8043],{"class":325},"COMMIT",[315,8045,7876],{"class":333},[18,8047,8048],{},"事务 A 再次执行相同的普通查询：",[279,8050,8052],{"className":7797,"code":8051,"language":7799,"meta":285,"style":285},"SELECT * FROM orders\nWHERE amount BETWEEN 100 AND 200;\n",[25,8053,8054,8064],{"__ignoreMap":285},[315,8055,8056,8058,8060,8062],{"class":317,"line":318},[315,8057,7483],{"class":325},[315,8059,7849],{"class":325},[315,8061,7852],{"class":325},[315,8063,7981],{"class":333},[315,8065,8066,8068,8070,8072,8074,8076,8078],{"class":317,"line":343},[315,8067,7858],{"class":325},[315,8069,7861],{"class":333},[315,8071,7864],{"class":325},[315,8073,7867],{"class":839},[315,8075,7870],{"class":325},[315,8077,7873],{"class":839},[315,8079,7876],{"class":333},[18,8081,8082],{},"由于事务 A 仍然使用原来的 Read View，新插入的记录不在该快照的可见范围内，因此第二次查询不会看到它。",[18,8084,8085],{},"这里需要准确理解：",[56,8087,8088],{},[18,8089,8090],{},"MVCC 没有阻止事务 B 插入记录，只是让这条后来提交的记录对事务 A 的旧快照不可见。",[18,8092,8093],{},"因此，快照读解决的是“当前事务看到什么”，而不是“其他事务能不能写入”。",[14,8095,8097],{"id":8096},"六当前读如何避免幻读","六、当前读如何避免幻读",[18,8099,8100],{},"如果业务需要先锁定一个范围，再根据查询结果修改数据，可以使用：",[279,8102,8104],{"className":7797,"code":8103,"language":7799,"meta":285,"style":285},"START TRANSACTION;\n\nSELECT * FROM orders\nWHERE amount BETWEEN 100 AND 200\nFOR UPDATE;\n",[25,8105,8106,8112,8116,8126,8141],{"__ignoreMap":285},[315,8107,8108,8110],{"class":317,"line":318},[315,8109,7964],{"class":325},[315,8111,7876],{"class":333},[315,8113,8114],{"class":317,"line":343},[315,8115,2525],{"emptyLinePlaceholder":1280},[315,8117,8118,8120,8122,8124],{"class":317,"line":359},[315,8119,7483],{"class":325},[315,8121,7849],{"class":325},[315,8123,7852],{"class":325},[315,8125,7981],{"class":333},[315,8127,8128,8130,8132,8134,8136,8138],{"class":317,"line":375},[315,8129,7858],{"class":325},[315,8131,7861],{"class":333},[315,8133,7864],{"class":325},[315,8135,7867],{"class":839},[315,8137,7870],{"class":325},[315,8139,8140],{"class":839}," 200\n",[315,8142,8143,8145,8147],{"class":317,"line":391},[315,8144,7811],{"class":325},[315,8146,7916],{"class":325},[315,8148,7876],{"class":333},[18,8150,8151,8152,8155],{},"假设 ",[25,8153,8154],{},"amount"," 上存在普通索引：",[279,8157,8159],{"className":7797,"code":8158,"language":7799,"meta":285,"style":285},"CREATE INDEX idx_orders_amount ON orders(amount);\n",[25,8160,8161],{"__ignoreMap":285},[315,8162,8163,8166,8169,8172,8175],{"class":317,"line":318},[315,8164,8165],{"class":325},"CREATE",[315,8167,8168],{"class":325}," INDEX",[315,8170,8171],{"class":321}," idx_orders_amount",[315,8173,8174],{"class":325}," ON",[315,8176,8177],{"class":333}," orders(amount);\n",[18,8179,8180],{},"在 REPEATABLE READ 下，InnoDB 扫描这个索引范围时，通常会对索引记录及其间隙加 Next-Key Lock。",[18,8182,8183],{},"此时另一个事务尝试插入：",[279,8185,8187],{"className":7797,"code":8186,"language":7799,"meta":285,"style":285},"INSERT INTO orders(user_id, amount)\nVALUES (10, 150);\n",[25,8188,8189,8195],{"__ignoreMap":285},[315,8190,8191,8193],{"class":317,"line":318},[315,8192,8014],{"class":325},[315,8194,8017],{"class":333},[315,8196,8197,8199,8201,8203,8205,8207],{"class":317,"line":343},[315,8198,8022],{"class":325},[315,8200,4311],{"class":333},[315,8202,1590],{"class":839},[315,8204,4327],{"class":333},[315,8206,8031],{"class":839},[315,8208,8034],{"class":333},[18,8210,8211,8212,8214],{},"由于 ",[25,8213,8031],{}," 落在已经锁定的索引范围内，该插入通常会被阻塞，直到前一个事务提交或回滚。",[18,8216,8217],{},"这次不是“让新记录不可见”，而是：",[56,8219,8220],{},[18,8221,8222],{},"阻止新记录进入已经锁定的查询范围。",[14,8224,8226],{"id":8225},"七record-lockgap-lock-与-next-key-lock","七、Record Lock、Gap Lock 与 Next-Key Lock",[237,8228,8230],{"id":8229},"_1-record-lock","1. Record Lock",[18,8232,8233],{},"Record Lock 锁住的是索引记录。",[18,8235,3181],{},[279,8237,8239],{"className":7797,"code":8238,"language":7799,"meta":285,"style":285},"SELECT * FROM orders\nWHERE id = 100\nFOR UPDATE;\n",[25,8240,8241,8251,8263],{"__ignoreMap":285},[315,8242,8243,8245,8247,8249],{"class":317,"line":318},[315,8244,7483],{"class":325},[315,8246,7849],{"class":325},[315,8248,7852],{"class":325},[315,8250,7981],{"class":333},[315,8252,8253,8255,8258,8260],{"class":317,"line":343},[315,8254,7858],{"class":325},[315,8256,8257],{"class":333}," id ",[315,8259,2511],{"class":325},[315,8261,8262],{"class":839}," 100\n",[315,8264,8265,8267,8269],{"class":317,"line":359},[315,8266,7811],{"class":325},[315,8268,7916],{"class":325},[315,8270,7876],{"class":333},[18,8272,491,8273,8276],{},[25,8274,8275],{},"id"," 是唯一索引，并且使用唯一等值条件准确定位一条记录，InnoDB 通常只锁找到的索引记录，不需要锁前面的间隙。",[237,8278,8280],{"id":8279},"_2-gap-lock","2. Gap Lock",[18,8282,8283],{},"Gap Lock 锁住的是两个索引记录之间的间隙，而不是某一条已经存在的记录。",[18,8285,8286],{},"假设索引中已有：",[279,8288,8291],{"className":8289,"code":8290,"language":284,"meta":285},[282],"100\n200\n300\n",[25,8292,8290],{"__ignoreMap":285},[18,8294,8295],{},"那么其中存在：",[279,8297,8300],{"className":8298,"code":8299,"language":284,"meta":285},[282],"(-∞, 100)\n(100, 200)\n(200, 300)\n(300, +∞)\n",[25,8301,8299],{"__ignoreMap":285},[18,8303,8304],{},"Gap Lock 的主要作用是限制其他事务在对应间隙插入新索引记录。",[237,8306,8308],{"id":8307},"_3-next-key-lock","3. Next-Key Lock",[18,8310,8311],{},"Next-Key Lock 的准确定义是：",[279,8313,8316],{"className":8314,"code":8315,"language":284,"meta":285},[282],"Next-Key Lock = Record Lock + 该记录前面的 Gap Lock\n",[25,8317,8315],{"__ignoreMap":285},[18,8319,8320],{},"这里的“前面”是指索引排序中的前一个间隙。假设索引值为：",[279,8322,8325],{"className":8323,"code":8324,"language":284,"meta":285},[282],"3\n5\n8\n",[25,8326,8324],{"__ignoreMap":285},[18,8328,8329],{},"可能形成的 Next-Key Lock 区间是：",[279,8331,8334],{"className":8332,"code":8333,"language":284,"meta":285},[282],"(-∞, 3]\n(3, 5]\n(5, 8]\n(8, +∞)\n",[25,8335,8333],{"__ignoreMap":285},[18,8337,8338,8339,8342,8343,8346,8347,8349,8350,5589,8353,8355],{},"例如，对索引记录 ",[25,8340,8341],{},"5"," 加 Next-Key Lock，可以概念性地理解为锁住 ",[25,8344,8345],{},"(3, 5]","：既保护记录 ",[25,8348,8341],{},"，又阻止其他事务向 ",[25,8351,8352],{},"3",[25,8354,8341],{}," 之间插入新索引记录。",[18,8357,8358],{},"这里需要区分单个 Next-Key Lock 和一条 SQL 最终获得的整组锁：",[56,8360,8361],{},[18,8362,8363],{},"一个 Next-Key Lock 只包含当前记录和它前面的间隙，但一条 SQL 可能同时获得多个 Record Lock、Gap Lock 和 Next-Key Lock，最终覆盖查询记录前后的整个范围。",[18,8365,8366],{},"例如，在 REPEATABLE READ 下执行：",[279,8368,8370],{"className":7797,"code":8369,"language":7799,"meta":285,"style":285},"SELECT * FROM orders\nWHERE amount = 5\nFOR UPDATE;\n",[25,8371,8372,8382,8393],{"__ignoreMap":285},[315,8373,8374,8376,8378,8380],{"class":317,"line":318},[315,8375,7483],{"class":325},[315,8377,7849],{"class":325},[315,8379,7852],{"class":325},[315,8381,7981],{"class":333},[315,8383,8384,8386,8388,8390],{"class":317,"line":343},[315,8385,7858],{"class":325},[315,8387,7861],{"class":333},[315,8389,2511],{"class":325},[315,8391,8392],{"class":839}," 5\n",[315,8394,8395,8397,8399],{"class":317,"line":359},[315,8396,7811],{"class":325},[315,8398,7916],{"class":325},[315,8400,7876],{"class":333},[18,8402,491,8403,8405,8406,8409,8410,8413],{},[25,8404,8154],{}," 是普通非唯一索引，并且相邻索引值为 ",[25,8407,8408],{},"3、5、8","，为了防止其他事务再次插入 ",[25,8411,8412],{},"amount=5"," 的记录，最终需要保护：",[279,8415,8418],{"className":8416,"code":8417,"language":284,"meta":285},[282],"记录 5\n记录 5 前面的间隙：(3, 5)\n记录 5 后面的间隙：(5, 8)\n",[25,8419,8417],{"__ignoreMap":285},[18,8421,8422],{},"可以概念性地理解为：",[279,8424,8427],{"className":8425,"code":8426,"language":284,"meta":285},[282],"(3, 5] → 记录 5 的 Next-Key Lock\n(5, 8) → 查询范围结束位置的 Gap Lock\n",[25,8428,8426],{"__ignoreMap":285},[18,8430,8431],{},"所以，“等值查询可能锁住匹配记录及其前后间隙”是对一条 SQL 最终锁定范围的描述；它不代表单个 Next-Key Lock 同时包含记录前后两个间隙。",[18,8433,8434],{},"还要区分以下情况：",[245,8436,8437,8442,8453,8456],{},[211,8438,7480,8439,8441],{},[25,8440,7483],{}," 是快照读，不会因为这个查询条件加 Next-Key Lock。",[211,8443,8444,5067,8446,5067,8448,28,8450,8452],{},[25,8445,7456],{},[25,8447,7459],{},[25,8449,7462],{},[25,8451,7465],{}," 才属于锁定读或当前读。",[211,8454,8455],{},"如果使用唯一索引和唯一等值条件，并且准确找到已有记录，InnoDB 通常只加 Record Lock，不需要锁前后间隙。",[211,8457,8458],{},"如果查询条件没有命中唯一记录，或者使用普通非唯一索引，InnoDB 会根据实际扫描范围使用 Gap Lock 或 Next-Key Lock。",[18,8460,8461,8462,8464],{},"具体获得哪些锁，最终还取决于隔离级别、索引类型、查询条件和实际执行计划，不能只根据 ",[25,8463,7858],{}," 条件判断。",[18,8466,8467],{},"InnoDB 还可以锁住最后一条记录之后的间隙，从而保护开放区间查询：",[279,8469,8471],{"className":7797,"code":8470,"language":7799,"meta":285,"style":285},"SELECT * FROM orders\nWHERE amount > 200\nFOR UPDATE;\n",[25,8472,8473,8483,8493],{"__ignoreMap":285},[315,8474,8475,8477,8479,8481],{"class":317,"line":318},[315,8476,7483],{"class":325},[315,8478,7849],{"class":325},[315,8480,7852],{"class":325},[315,8482,7981],{"class":333},[315,8484,8485,8487,8489,8491],{"class":317,"line":343},[315,8486,7858],{"class":325},[315,8488,7861],{"class":333},[315,8490,337],{"class":325},[315,8492,8140],{"class":839},[315,8494,8495,8497,8499],{"class":317,"line":359},[315,8496,7811],{"class":325},[315,8498,7916],{"class":325},[315,8500,7876],{"class":333},[14,8502,8504],{"id":8503},"八索引为什么很重要","八、索引为什么很重要",[18,8506,8507],{},"InnoDB 的行锁本质上是索引记录锁，Next-Key Lock 也是围绕索引扫描范围建立的。",[18,8509,8510],{},"如果查询能够使用合适索引：",[279,8512,8514],{"className":7797,"code":8513,"language":7799,"meta":285,"style":285},"SELECT * FROM orders\nWHERE amount BETWEEN 100 AND 200\nFOR UPDATE;\n",[25,8515,8516,8526,8540],{"__ignoreMap":285},[315,8517,8518,8520,8522,8524],{"class":317,"line":318},[315,8519,7483],{"class":325},[315,8521,7849],{"class":325},[315,8523,7852],{"class":325},[315,8525,7981],{"class":333},[315,8527,8528,8530,8532,8534,8536,8538],{"class":317,"line":343},[315,8529,7858],{"class":325},[315,8531,7861],{"class":333},[315,8533,7864],{"class":325},[315,8535,7867],{"class":839},[315,8537,7870],{"class":325},[315,8539,8140],{"class":839},[315,8541,8542,8544,8546],{"class":317,"line":359},[315,8543,7811],{"class":325},[315,8545,7916],{"class":325},[315,8547,7876],{"class":333},[18,8549,8550],{},"InnoDB 可以更准确地锁定相关索引范围。",[18,8552,8553],{},"如果缺少合适索引，InnoDB 可能需要扫描并锁定大量索引记录，锁的范围会变大，并发能力明显下降。",[18,8555,8556],{},"这里不要简单表述为：",[56,8558,8559],{},[18,8560,8561],{},"没有索引就一定加表锁。",[18,8563,1796],{},[56,8565,8566],{},[18,8567,8568],{},"InnoDB 仍然基于索引记录加锁；缺少可用业务索引时，可能扫描并锁住大量记录，使效果接近大范围锁定。",[18,8570,8571],{},"因此，使用锁定读避免幻读时，需要同时关注：",[245,8573,8574,8577,8580,8583,8586],{},[211,8575,8576],{},"查询条件是否命中索引；",[211,8578,8579],{},"实际执行计划选择了哪个索引；",[211,8581,8582],{},"锁定范围是否超出预期；",[211,8584,8585],{},"事务是否足够短；",[211,8587,8588],{},"是否可能形成死锁。",[14,8590,8592],{"id":8591},"九为什么不能只依赖快照读完成先查后写","九、为什么不能只依赖快照读完成“先查后写”",[18,8594,8595],{},"假设业务要求同一用户只能存在一条有效申请：",[279,8597,8599],{"className":7797,"code":8598,"language":7799,"meta":285,"style":285},"SELECT * FROM applications\nWHERE user_id = 100\n AND status = 'ACTIVE';\n",[25,8600,8601,8612,8623],{"__ignoreMap":285},[315,8602,8603,8605,8607,8609],{"class":317,"line":318},[315,8604,7483],{"class":325},[315,8606,7849],{"class":325},[315,8608,7852],{"class":325},[315,8610,8611],{"class":333}," applications\n",[315,8613,8614,8616,8619,8621],{"class":317,"line":343},[315,8615,7858],{"class":325},[315,8617,8618],{"class":333}," user_id ",[315,8620,2511],{"class":325},[315,8622,8262],{"class":839},[315,8624,8625,8628,8631,8634,8637],{"class":317,"line":359},[315,8626,8627],{"class":325}," AND",[315,8629,8630],{"class":325}," status",[315,8632,8633],{"class":325}," =",[315,8635,8636],{"class":329}," 'ACTIVE'",[315,8638,7876],{"class":333},[18,8640,8641],{},"两个事务可能同时通过快照读发现“记录不存在”，然后各自插入一条有效申请。",[18,8643,8644],{},"REPEATABLE READ 虽然让两个事务各自的查询结果保持一致，但没有阻止另一个事务执行插入。",[18,8646,8647],{},"因此，业务不变量不能只依赖普通快照读。常见方案是：",[208,8649,8650,8653,8656,8659],{},[211,8651,8652],{},"建立能够表达业务规则的唯一索引；",[211,8654,8655],{},"在 REPEATABLE READ 下使用合适的锁定读；",[211,8657,8658],{},"捕获重复键或死锁异常，并进行有限重试；",[211,8660,8661],{},"缩短事务时间，避免锁范围长期占用。",[18,8663,8664],{},"例如业务规则能够转换为唯一键时，优先让数据库约束兜底：",[279,8666,8668],{"className":7797,"code":8667,"language":7799,"meta":285,"style":285},"CREATE UNIQUE INDEX uk_user_active\nON applications(user_id, active_flag);\n",[25,8669,8670,8680],{"__ignoreMap":285},[315,8671,8672,8674,8677],{"class":317,"line":318},[315,8673,8165],{"class":325},[315,8675,8676],{"class":325}," UNIQUE INDEX",[315,8678,8679],{"class":321}," uk_user_active\n",[315,8681,8682,8685],{"class":317,"line":343},[315,8683,8684],{"class":325},"ON",[315,8686,8687],{"class":333}," applications(user_id, active_flag);\n",[18,8689,8690],{},"具体索引设计仍要根据数据模型确定，不能为了唯一约束直接照搬示例。",[14,8692,8694],{"id":8693},"十混用快照读和当前读为什么容易困惑","十、混用快照读和当前读为什么容易困惑",[18,8696,8697,8698,8700],{},"在 REPEATABLE READ 事务中，普通 ",[25,8699,7483],{}," 使用旧快照，而锁定读读取最新可用的数据。",[18,8702,8703],{},"可能出现：",[279,8705,8708],{"className":8706,"code":8707,"language":284,"meta":285},[282],"1. 普通 SELECT 没看到某条新记录\n2. 另一个事务插入该记录并提交\n3. SELECT ... FOR UPDATE 却看到了这条记录\n",[25,8709,8707],{"__ignoreMap":285},[18,8711,8712],{},"原因不是隔离级别突然失效，而是两条语句使用了不同的读取机制：",[245,8714,8715,8720],{},[211,8716,7480,8717,8719],{},[25,8718,7483],{},"：读取 Read View 中的一致性快照；",[211,8721,8722,8724],{},[25,8723,7456],{},"：读取最新可用数据并加锁。",[18,8726,8727],{},"MySQL 官方文档也不建议在同一个 REPEATABLE READ 事务中随意混用锁定语句和非锁定查询，因为它们可能呈现两个不同时间状态的数据。",[18,8729,8730],{},"如果业务必须基于最新结果做写入判断，应统一使用锁定读；如果必须获得更严格、容易理解的串行语义，可以评估 SERIALIZABLE，但要接受更高的锁竞争。",[14,8732,8734],{"id":8733},"十一read-committed-下加-for-update-能否避免幻读","十一、READ COMMITTED 下加 FOR UPDATE 能否避免幻读",[18,8736,8737],{},"不能笼统地说可以。",[18,8739,8740,8741,28,8743,8745],{},"在 READ COMMITTED 下，InnoDB 对锁定读、",[25,8742,7462],{},[25,8744,7465],{}," 通常只锁索引记录，不锁前面的间隙。其他事务仍可以向记录间隙插入新行，因此范围查询仍可能出现幻读。",[18,8747,8748],{},"Gap Lock 在该级别主要保留给：",[245,8750,8751,8754],{},[211,8752,8753],{},"外键约束检查；",[211,8755,8756],{},"重复键检查。",[18,8758,8759],{},"如果业务需要锁住一个尚不存在的范围，应评估：",[245,8761,8762,8765,8768,8771],{},[211,8763,8764],{},"使用 REPEATABLE READ，并通过合适索引和 Next-Key Lock 锁定范围；",[211,8766,8767],{},"使用 SERIALIZABLE；",[211,8769,8770],{},"把业务不变量转换为唯一约束；",[211,8772,8773],{},"调整数据模型，避免依赖无法锁定的“空结果”。",[14,8775,8777],{"id":8776},"十二如何选择隔离级别","十二、如何选择隔离级别",[237,8779,8781],{"id":8780},"选择-read-committed","选择 READ COMMITTED",[18,8783,3472],{},[245,8785,8786,8789,8792,8795],{},[211,8787,8788],{},"希望每次查询都看到最新已提交数据；",[211,8790,8791],{},"可以接受同一事务内两次读取结果不同；",[211,8793,8794],{},"希望减少 Gap Lock 和锁冲突；",[211,8796,8797],{},"业务通过版本号、唯一约束或其他机制保证并发正确性。",[237,8799,8801],{"id":8800},"选择-repeatable-read","选择 REPEATABLE READ",[18,8803,3472],{},[245,8805,8806,8809,8812,8815],{},[211,8807,8808],{},"希望事务中的普通查询保持一致视图；",[211,8810,8811],{},"需要使用 Next-Key Lock 保护范围；",[211,8813,8814],{},"能够控制索引、锁顺序和事务时长；",[211,8816,8817],{},"接受 InnoDB 默认隔离级别。",[237,8819,8821],{"id":8820},"选择-serializable","选择 SERIALIZABLE",[18,8823,3472],{},[245,8825,8826,8829,8832,8835],{},[211,8827,8828],{},"并发量较低；",[211,8830,8831],{},"一致性要求极高；",[211,8833,8834],{},"业务逻辑难以通过更细粒度约束实现；",[211,8836,8837],{},"能够接受更多阻塞、超时和死锁重试。",[18,8839,8840],{},"隔离级别不是越高越好。选择时需要综合评估：",[245,8842,8843,8846,8849,8852,8855,8858],{},[211,8844,8845],{},"一致性要求；",[211,8847,8848],{},"读写比例；",[211,8850,8851],{},"热点数据；",[211,8853,8854],{},"事务持续时间；",[211,8856,8857],{},"可接受的锁等待；",[211,8859,8860],{},"数据库吞吐量。",[14,8862,8864],{"id":8863},"十三查看和设置隔离级别","十三、查看和设置隔离级别",[18,8866,8867],{},"查看当前会话隔离级别：",[279,8869,8871],{"className":7797,"code":8870,"language":7799,"meta":285,"style":285},"SELECT @@SESSION.transaction_isolation;\n",[25,8872,8873],{"__ignoreMap":285},[315,8874,8875,8877,8880,8883,8886,8889],{"class":317,"line":318},[315,8876,7483],{"class":325},[315,8878,8879],{"class":333}," @@",[315,8881,8882],{"class":839},"SESSION",[315,8884,8885],{"class":333},".",[315,8887,8888],{"class":839},"transaction_isolation",[315,8890,7876],{"class":333},[18,8892,8893],{},"查看全局默认隔离级别：",[279,8895,8897],{"className":7797,"code":8896,"language":7799,"meta":285,"style":285},"SELECT @@GLOBAL.transaction_isolation;\n",[25,8898,8899],{"__ignoreMap":285},[315,8900,8901,8903,8905,8908,8910,8912],{"class":317,"line":318},[315,8902,7483],{"class":325},[315,8904,8879],{"class":333},[315,8906,8907],{"class":839},"GLOBAL",[315,8909,8885],{"class":333},[315,8911,8888],{"class":839},[315,8913,7876],{"class":333},[18,8915,8916],{},"修改当前会话后续事务的隔离级别：",[279,8918,8920],{"className":7797,"code":8919,"language":7799,"meta":285,"style":285},"SET SESSION TRANSACTION ISOLATION LEVEL READ COMMITTED;\n",[25,8921,8922],{"__ignoreMap":285},[315,8923,8924,8927,8930,8933,8936,8939,8942,8945],{"class":317,"line":318},[315,8925,8926],{"class":325},"SET",[315,8928,8929],{"class":325}," SESSION",[315,8931,8932],{"class":325}," TRANSACTION",[315,8934,8935],{"class":325}," ISOLATION",[315,8937,8938],{"class":325}," LEVEL",[315,8940,8941],{"class":325}," READ",[315,8943,8944],{"class":325}," COMMITTED",[315,8946,7876],{"class":333},[18,8948,8949],{},"设置下一个事务的隔离级别：",[279,8951,8953],{"className":7797,"code":8952,"language":7799,"meta":285,"style":285},"SET TRANSACTION ISOLATION LEVEL REPEATABLE READ;\n",[25,8954,8955],{"__ignoreMap":285},[315,8956,8957,8959,8961,8963,8965,8968,8970],{"class":317,"line":318},[315,8958,8926],{"class":325},[315,8960,8932],{"class":325},[315,8962,8935],{"class":325},[315,8964,8938],{"class":325},[315,8966,8967],{"class":325}," REPEATABLE",[315,8969,8941],{"class":325},[315,8971,7876],{"class":333},[18,8973,8974],{},"开始事务：",[279,8976,8978],{"className":7797,"code":8977,"language":7799,"meta":285,"style":285},"START TRANSACTION;\n",[25,8979,8980],{"__ignoreMap":285},[315,8981,8982,8984],{"class":317,"line":318},[315,8983,7964],{"class":325},[315,8985,7876],{"class":333},[18,8987,8988],{},"线上修改隔离级别前，需要：",[245,8990,8991,8994,9001],{},[211,8992,8993],{},"验证依赖一致性快照、锁定范围和“先查后写”的业务逻辑；",[211,8995,8996,8997,9000],{},"确认 ",[25,8998,8999],{},"binlog_format"," 与目标隔离级别兼容；",[211,9002,9003],{},"观察切换前后的锁等待、死锁率、事务时延和数据库吞吐量。",[18,9005,9006,9007,9010,9011,9014],{},"这里需要确认的不是笼统的“复制方式”，而是二进制日志格式的兼容性。例如 MySQL 的 READ COMMITTED 只支持 Row-Based Logging；如果配置为 ",[25,9008,9009],{},"MIXED","，MySQL 会自动使用行格式记录。系统原本已经使用 ",[25,9012,9013],{},"ROW"," 时，通常不需要为此额外调整。",[18,9016,9017],{},"监控指标也不是选择隔离级别的前置条件，而是用于验证切换产生的实际影响：",[245,9019,9020,9023],{},[211,9021,9022],{},"从 REPEATABLE READ 切换到 READ COMMITTED，Gap Lock 通常减少，锁等待和死锁概率可能下降，但业务会失去事务级固定快照；",[211,9024,9025],{},"切换到更高隔离级别时，锁范围和等待时间可能增加，事务耗时及吞吐量可能受到影响。",[18,9027,9028],{},"因此，不能只根据理论吞吐量直接切换隔离级别。",[14,9030,3635],{"id":3634},[237,9032,9034],{"id":9033},"误区-1mvcc-会阻止其他事务插入","误区 1：MVCC 会阻止其他事务插入",[18,9036,9037],{},"不会。MVCC 主要决定一条记录对当前 Read View 是否可见，不会因为快照读而阻塞其他事务写入。",[237,9039,9041],{"id":9040},"误区-2repeatable-read-只靠-mvcc-避免所有幻读","误区 2：REPEATABLE READ 只靠 MVCC 避免所有幻读",[18,9043,9044],{},"不完整。",[245,9046,9047,9050],{},[211,9048,9049],{},"快照读靠 MVCC 和固定 Read View；",[211,9051,9052],{},"当前读靠 Gap Lock 和 Next-Key Lock。",[237,9054,9056],{"id":9055},"误区-3只要加-for-update-就一定不会幻读","误区 3：只要加 FOR UPDATE 就一定不会幻读",[18,9058,9059],{},"不一定。是否锁住间隙与隔离级别、查询条件、索引类型和实际扫描范围有关。READ COMMITTED 下通常不会为普通范围查询使用 Gap Lock。",[237,9061,9063],{"id":9062},"误区-4next-key-lock-锁的是数据页","误区 4：Next-Key Lock 锁的是数据页",[18,9065,9066],{},"不是。它围绕索引记录和索引记录之间的间隙建立。",[237,9068,9070],{"id":9069},"误区-5没有索引就一定升级为表锁","误区 5：没有索引就一定升级为表锁",[18,9072,9073],{},"这个表述不准确。InnoDB 仍然基于索引进行记录锁定，但缺少合适索引可能导致扫描和锁定大量记录，使并发效果接近大范围锁定。",[237,9075,9077],{"id":9076},"误区-6serializable-一定是最好的选择","误区 6：SERIALIZABLE 一定是最好的选择",[18,9079,9080],{},"它的隔离性最强，但会显著增加锁等待，降低并发能力。多数业务更适合通过合理隔离级别、索引、锁定读和数据库约束共同保证正确性。",[14,9082,1191],{"id":1191},[245,9084,9085,9092,9099,9106,9113],{},[211,9086,9087],{},[70,9088,9091],{"href":9089,"rel":9090},"https:\u002F\u002Fdev.mysql.com\u002Fdoc\u002Frefman\u002F8.4\u002Fen\u002Finnodb-transaction-isolation-levels.html",[1200],"MySQL 8.4 Reference Manual：Transaction Isolation Levels",[211,9093,9094],{},[70,9095,9098],{"href":9096,"rel":9097},"https:\u002F\u002Fdev.mysql.com\u002Fdoc\u002Frefman\u002F8.4\u002Fen\u002Finnodb-consistent-read.html",[1200],"MySQL 8.4 Reference Manual：Consistent Nonlocking Reads",[211,9100,9101],{},[70,9102,9105],{"href":9103,"rel":9104},"https:\u002F\u002Fdev.mysql.com\u002Fdoc\u002Frefman\u002F8.4\u002Fen\u002Finnodb-next-key-locking.html",[1200],"MySQL 8.4 Reference Manual：Phantom Rows",[211,9107,9108],{},[70,9109,9112],{"href":9110,"rel":9111},"https:\u002F\u002Fdev.mysql.com\u002Fdoc\u002Frefman\u002F8.4\u002Fen\u002Finnodb-locking-reads.html",[1200],"MySQL 8.4 Reference Manual：Locking Reads",[211,9114,9115],{},[70,9116,9119],{"href":9117,"rel":9118},"https:\u002F\u002Fdev.mysql.com\u002Fdoc\u002Frefman\u002F8.4\u002Fen\u002Fset-transaction.html",[1200],"MySQL 8.4 Reference Manual：SET TRANSACTION Statement",[1224,9121,9122],{},"html pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}",{"title":285,"searchDepth":343,"depth":343,"links":9124},[9125,9128,9129,9130,9131,9136,9142,9146,9147,9148,9153,9154,9155,9156,9157,9162,9163,9171],{"id":16,"depth":343,"text":16,"children":9126},[9127],{"id":7495,"depth":359,"text":7495},{"id":66,"depth":343,"text":66},{"id":83,"depth":343,"text":83},{"id":7516,"depth":343,"text":7517},{"id":7622,"depth":343,"text":7623,"children":9132},[9133,9134,9135],{"id":7626,"depth":359,"text":7627},{"id":7645,"depth":359,"text":7646},{"id":7666,"depth":359,"text":7667},{"id":7701,"depth":343,"text":7702,"children":9137},[9138,9139,9140,9141],{"id":7705,"depth":359,"text":7706},{"id":7726,"depth":359,"text":7727},{"id":7759,"depth":359,"text":7760},{"id":7784,"depth":359,"text":7785},{"id":7823,"depth":343,"text":7824,"children":9143},[9144,9145],{"id":7830,"depth":359,"text":7831},{"id":7896,"depth":359,"text":7897},{"id":7950,"depth":343,"text":7951},{"id":8096,"depth":343,"text":8097},{"id":8225,"depth":343,"text":8226,"children":9149},[9150,9151,9152],{"id":8229,"depth":359,"text":8230},{"id":8279,"depth":359,"text":8280},{"id":8307,"depth":359,"text":8308},{"id":8503,"depth":343,"text":8504},{"id":8591,"depth":343,"text":8592},{"id":8693,"depth":343,"text":8694},{"id":8733,"depth":343,"text":8734},{"id":8776,"depth":343,"text":8777,"children":9158},[9159,9160,9161],{"id":8780,"depth":359,"text":8781},{"id":8800,"depth":359,"text":8801},{"id":8820,"depth":359,"text":8821},{"id":8863,"depth":343,"text":8864},{"id":3634,"depth":343,"text":3635,"children":9164},[9165,9166,9167,9168,9169,9170],{"id":9033,"depth":359,"text":9034},{"id":9040,"depth":359,"text":9041},{"id":9055,"depth":359,"text":9056},{"id":9062,"depth":359,"text":9063},{"id":9069,"depth":359,"text":9070},{"id":9076,"depth":359,"text":9077},{"id":1191,"depth":343,"text":1191},"wiki:java:mysql-transaction-isolation-and-phantom-read","梳理 MySQL InnoDB 的四种事务隔离级别，解释脏读、不可重复读和幻读，并说明 MVCC、Read View、Gap Lock 与 Next-Key Lock 如何共同避免幻读。",{},75,"\u002Fjava\u002Fmysql-transaction-isolation-and-phantom-read",{"title":7426,"description":9173},"java\u002Fmysql-transaction-isolation-and-phantom-read","fQEdrnJPxztc16zbaEZBXfxB2OYyLN5Gdv5shRJ6FbQ",{"id":9181,"title":9182,"body":9183,"commentId":10319,"description":10320,"difficulty":1276,"draft":1277,"extension":1278,"meta":10321,"navigation":1280,"order":10322,"path":10323,"section":1283,"seo":10324,"stem":10325,"updated":10326,"__hash__":10327},"java\u002Fjava\u002Fmysql-bplus-tree-vs-btree.md","MySQL 为何采用 B+ 树？B+ 树与 B 树的区别是什么？",{"type":7,"value":9184,"toc":10288},[9185,9187,9190,9193,9207,9210,9213,9215,9220,9222,9231,9233,9237,9244,9264,9267,9269,9283,9287,9290,9293,9296,9302,9305,9322,9329,9333,9336,9339,9345,9348,9364,9367,9381,9385,9489,9492,9495,9499,9502,9505,9508,9514,9517,9524,9529,9533,9538,9541,9546,9549,9555,9558,9564,9567,9573,9576,9580,9583,9586,9592,9595,9598,9601,9607,9610,9616,9619,9624,9633,9637,9640,9677,9684,9690,9693,9699,9702,9705,9747,9750,9754,9757,9760,9766,9769,9776,9780,9783,9798,9801,9804,9854,9857,9860,9877,9880,9883,9887,9890,9893,9908,9911,9917,9920,9946,9949,9952,9956,9959,9965,9968,9992,9995,10028,10033,10039,10042,10045,10075,10078,10087,10091,10094,10097,10103,10106,10109,10113,10116,10133,10136,10140,10143,10146,10152,10155,10158,10172,10175,10179,10183,10186,10190,10193,10197,10200,10204,10207,10211,10222,10226,10229,10235,10241,10246,10248,10285],[14,9186,16],{"id":16},[18,9188,9189],{},"MySQL InnoDB 的普通索引采用通常所说的 B+ 树结构，核心原因是数据库索引需要同时兼顾磁盘或页访问次数、等值查询、范围查询和顺序遍历。",[18,9191,9192],{},"B+ 树与 B 树的主要区别是：",[245,9194,9195,9198,9201,9204],{},[211,9196,9197],{},"B 树的非叶子节点和叶子节点都可以保存数据记录；",[211,9199,9200],{},"B+ 树的非叶子节点主要保存索引键和子页面指针，完整索引记录集中在叶子节点；",[211,9202,9203],{},"B+ 树的叶子节点按照键值顺序连接，适合范围扫描；",[211,9205,9206],{},"由于非叶子节点不保存完整数据，同样大小的页面能够容纳更多目录项，树的扇出更大、高度更低。",[18,9208,9209],{},"InnoDB 默认索引页大小为 16KB。一次读取通常以页为单位，而不是只读取一个键。B+ 树通过较大的扇出，把大量数据组织在较少的层级中，查询通常只需要访问少量页面；定位到范围起点后，还可以沿叶子页顺序扫描，不必反复从根节点查找。",[18,9211,9212],{},"InnoDB 的聚簇索引叶子节点保存完整行数据，二级索引叶子节点保存二级索引键和主键值。通过二级索引查询非覆盖列时，需要先取得主键，再回到聚簇索引查找完整行，这就是常说的回表。",[237,9214,7495],{"id":7495},[56,9216,9217],{},[18,9218,9219],{},"B+ 树让非叶子节点专注于导航，以更大的扇出降低树高，并把有序数据集中在相连的叶子节点中，因此既能减少页面访问，又适合范围查询和顺序扫描。",[14,9221,66],{"id":66},[18,9223,9224],{},[70,9225,9228],{"href":9226,"target":73,"rel":9227},"\u002Fimages\u002Fwiki\u002Fjava\u002Fmysql-btree-vs-bplus-tree.svg",[75,76],[78,9229],{"src":9226,"alt":9230},"B 树与 B+ 树结构对比",[14,9232,83],{"id":83},[14,9234,9236],{"id":9235},"一先明确mysql-文档中的-b-tree-与-b-树","一、先明确：MySQL 文档中的 B-tree 与 B+ 树",[18,9238,9239,9240,9243],{},"MySQL 官方文档通常把 InnoDB 的普通索引统称为 ",[25,9241,9242],{},"B-tree"," 索引。在数据库实现和面试语境中，InnoDB 的这种索引组织通常被称为 B+ 树：",[245,9245,9246,9249,9252,9255,9258,9261],{},[211,9247,9248],{},"索引记录存放在叶子页；",[211,9250,9251],{},"非叶子页负责索引导航；",[211,9253,9254],{},"聚簇索引的叶子页保存行数据；",[211,9256,9257],{},"二级索引的叶子记录保存索引列和主键；",[211,9259,9260],{},"InnoDB 同一层的索引页通过前后页指针双向连接；",[211,9262,9263],{},"叶子页中的索引记录有序，能够进行范围扫描。",[18,9265,9266],{},"因此，“MySQL 使用 B+ 树”通常是在描述 InnoDB 普通索引的具体组织特征；它不代表 MySQL 中所有索引都使用 B+ 树。",[18,9268,3181],{},[245,9270,9271,9274,9277,9280],{},[211,9272,9273],{},"InnoDB 普通索引使用 B-tree 类结构；",[211,9275,9276],{},"空间索引使用 R-tree；",[211,9278,9279],{},"全文索引有独立的倒排索引设计；",[211,9281,9282],{},"InnoDB 还可能使用自适应哈希索引加速部分热点等值访问。",[14,9284,9286],{"id":9285},"二b-树是什么","二、B 树是什么",[18,9288,9289],{},"B 树是一种多路平衡查找树。",[18,9291,9292],{},"“多路”表示一个节点可以拥有多个子节点，而不是像二叉查找树那样最多只有两个子节点。",[18,9294,9295],{},"一个简化的 B 树可以表示为：",[279,9297,9300],{"className":9298,"code":9299,"language":284,"meta":285},[282]," [20 | 50]\n \u002F | \\\n [5 | 10] [30 | 40] [60 | 80]\n",[25,9301,9299],{"__ignoreMap":285},[18,9303,9304],{},"B 树具有以下特点：",[245,9306,9307,9310,9313,9316,9319],{},[211,9308,9309],{},"节点中的键有序；",[211,9311,9312],{},"一个节点可以保存多个键和数据记录；",[211,9314,9315],{},"非叶子节点也可以直接保存数据；",[211,9317,9318],{},"所有叶子节点通常处于同一层；",[211,9320,9321],{},"插入和删除后通过分裂、合并或旋转维持平衡。",[18,9323,9324,9325,9328],{},"查询 ",[25,9326,9327],{},"20"," 时，可能在根节点直接找到数据，不一定需要访问叶子节点。",[14,9330,9332],{"id":9331},"三b-树是什么","三、B+ 树是什么",[18,9334,9335],{},"B+ 树也是多路平衡查找树，但它把导航结构和数据记录进一步分离。",[18,9337,9338],{},"一个简化的 B+ 树可以表示为：",[279,9340,9343],{"className":9341,"code":9342,"language":284,"meta":285},[282]," [20 | 50]\n \u002F | \\\n \u002F | \\\n [5 | 10 | 20] [30 | 40 | 50] [60 | 80]\n ↔ ↔\n 叶子页通过前后页指针双向连接\n",[25,9344,9342],{"__ignoreMap":285},[18,9346,9347],{},"B+ 树具有以下典型特点：",[245,9349,9350,9353,9356,9359,9361],{},[211,9351,9352],{},"非叶子节点主要保存键和子节点指针；",[211,9354,9355],{},"完整的数据记录集中在叶子节点；",[211,9357,9358],{},"所有查询最终都会到达叶子节点；",[211,9360,9260],{},[211,9362,9363],{},"适合从某个键开始连续读取一段数据。",[18,9365,9366],{},"需要注意，示意图中的分隔键可能同时出现在非叶子节点和叶子节点中。非叶子节点中的键用于导航，叶子节点中的索引记录才承载最终数据定位信息。",[18,9368,9369,9370,9373,9374,5067,9377,9380],{},"这里的双向链表连接的是",[61,9371,9372],{},"索引页","，并不是说整棵 B+ 树本身就是双向链表。整体结构仍然是一棵多路平衡树：树结构负责快速定位目标页；页面头中的 ",[25,9375,9376],{},"FIL_PAGE_PREV",[25,9378,9379],{},"FIL_PAGE_NEXT"," 字段保存前后页的页号，这些页号相当于逻辑指针，用于前后遍历。单个索引页内部的记录则主要按键值顺序组成单向链表，并由页目录辅助查找。",[14,9382,9384],{"id":9383},"四b-树与-b-树的核心区别","四、B 树与 B+ 树的核心区别",[98,9386,9387,9399],{},[101,9388,9389],{},[104,9390,9391,9393,9396],{},[107,9392,2925],{},[107,9394,9395],{},"B 树",[107,9397,9398],{},"B+ 树",[114,9400,9401,9412,9423,9434,9445,9456,9467,9478],{},[104,9402,9403,9406,9409],{},[119,9404,9405],{},"数据记录位置",[119,9407,9408],{},"非叶子节点和叶子节点都可以保存",[119,9410,9411],{},"完整索引记录集中在叶子节点",[104,9413,9414,9417,9420],{},[119,9415,9416],{},"非叶子节点职责",[119,9418,9419],{},"导航，同时可能保存数据",[119,9421,9422],{},"主要负责导航",[104,9424,9425,9428,9431],{},[119,9426,9427],{},"单个节点可容纳的键",[119,9429,9430],{},"相对较少",[119,9432,9433],{},"通常更多",[104,9435,9436,9439,9442],{},[119,9437,9438],{},"树的扇出",[119,9440,9441],{},"相对较小",[119,9443,9444],{},"通常更大",[104,9446,9447,9450,9453],{},[119,9448,9449],{},"树高",[119,9451,9452],{},"相同数据量下可能更高",[119,9454,9455],{},"相同数据量下通常更低",[104,9457,9458,9461,9464],{},[119,9459,9460],{},"等值查询",[119,9462,9463],{},"可能在非叶子节点提前结束",[119,9465,9466],{},"通常需要走到叶子节点",[104,9468,9469,9472,9475],{},[119,9470,9471],{},"范围查询",[119,9473,9474],{},"可能需要在树中多次定位",[119,9476,9477],{},"定位起点后可顺序扫描叶子节点",[104,9479,9480,9483,9486],{},[119,9481,9482],{},"查询路径",[119,9484,9485],{},"不同记录的结束层级可能不同",[119,9487,9488],{},"通常都到叶子层，路径更稳定",[18,9490,9491],{},"不能简单得出“B+ 树在所有场景都比 B 树快”的结论。",[18,9493,9494],{},"如果整个数据结构都在内存中，而且只做等值查询，B 树可能在非叶子节点提前命中。但数据库索引更关心页面访问、范围扫描和批量读取，B+ 树的整体特性更适合这类负载。",[14,9496,9498],{"id":9497},"五为什么数据库关心页面访问次数","五、为什么数据库关心页面访问次数",[18,9500,9501],{},"InnoDB 管理数据的基本单位是页，默认页面大小为 16KB。",[18,9503,9504],{},"查询一个索引键时，底层不是只从磁盘读取这个键对应的几个字节，而是把相关页面读入 Buffer Pool，再在页内查找。",[18,9506,9507],{},"因此，索引设计要尽量做到：",[279,9509,9512],{"className":9510,"code":9511,"language":284,"meta":285},[282],"更少的树层级\n ↓\n更少的页面访问\n ↓\n更低的 I\u002FO 和缓存查找成本\n",[25,9513,9511],{"__ignoreMap":285},[18,9515,9516],{},"即使相关页面已经在 Buffer Pool 中，查询仍然需要逐层定位索引页、在页内比较目录项，并在必要时获取页面 Latch。树高较低通常意味着遍历的页面更少，但此时节省的主要是内存中的索引导航成本，而不是磁盘 I\u002FO。",[18,9518,9519,9520,9523],{},"所以分析 B+ 树时，不应只背诵时间复杂度 ",[25,9521,9522],{},"O(log N)","，还要关注：",[56,9525,9526],{},[18,9527,9528],{},"这个对数以多大的扇出为底，以及一次查询需要访问多少个页面。",[14,9530,9532],{"id":9531},"六扇出是什么","六、扇出是什么",[18,9534,9535],{},[61,9536,9537],{},"扇出（Fan-out）是一个非叶子节点能够直接指向的子节点数量。",[18,9539,9540],{},"在 InnoDB 中，可以把它理解为：",[56,9542,9543],{},[18,9544,9545],{},"一个非叶子索引页能够直接导航到多少个下层索引页。",[18,9547,9548],{},"例如，某个非叶子页保存了大量“索引值 + 子页面指针”目录项，并能够据此导航到约 1,000 个子页面，那么可以近似地说这个节点的扇出约为 1,000。",[18,9550,9551,9552,4224],{},"扇出不是整棵树的记录总数，也不是一个叶子页能够保存的行数。它描述的是",[61,9553,9554],{},"单个非叶子节点向下一层分出的分支数量",[18,9556,9557],{},"对于相同数量的数据，树高可以粗略理解为：",[279,9559,9562],{"className":9560,"code":9561,"language":284,"meta":285},[282],"树高 ≈ log(扇出)(需要管理的页面数)\n",[25,9563,9561],{"__ignoreMap":285},[18,9565,9566],{},"扇出越大，每增加一层能够覆盖的页面数增长得越快，因此管理相同数据量所需的层级通常越少：",[279,9568,9571],{"className":9569,"code":9570,"language":284,"meta":285},[282],"扇出为 2： 2 → 4 → 8 → 16\n扇出为 1,000： 1,000 → 1,000,000 → 1,000,000,000\n",[25,9572,9570],{"__ignoreMap":285},[18,9574,9575],{},"这里的数字只用于说明增长速度。真实扇出会受到索引键长度、页面格式、记录头、页面填充率等因素影响。",[14,9577,9579],{"id":9578},"七b-树如何通过更大的扇出降低树高","七、B+ 树如何通过更大的扇出降低树高",[18,9581,9582],{},"假设一个非叶子页既保存键，又保存完整行数据，那么每个目录项会比较大，一个页面能够容纳的目录项就比较少。",[18,9584,9585],{},"如果非叶子页只保存：",[279,9587,9590],{"className":9588,"code":9589,"language":284,"meta":285},[282],"索引键 + 子页面指针\n",[25,9591,9589],{"__ignoreMap":285},[18,9593,9594],{},"每个目录项更小，同一个 16KB 页面就能容纳更多目录项，一个节点可以指向更多子页面。",[18,9596,9597],{},"由于单个目录项更紧凑，同一个页面可以保存更多目录项、指向更多子页面，这就是 B+ 树扇出更大的原因。",[18,9599,9600],{},"例如，仅用于理解数量级，假设一个非叶子目录项平均占用 16 字节，忽略页头、槽目录、填充率和其他开销：",[279,9602,9605],{"className":9603,"code":9604,"language":284,"meta":285},[282],"16KB ÷ 16B ≈ 1024\n",[25,9606,9604],{"__ignoreMap":285},[18,9608,9609],{},"一个非叶子页理论上可以导航约一千个子页面：",[279,9611,9614],{"className":9612,"code":9613,"language":284,"meta":285},[282],"根节点：约 1,000 个分支\n第二层：约 1,000 × 1,000 个分支\n第三层：继续扩大\n",[25,9615,9613],{"__ignoreMap":285},[18,9617,9618],{},"真实容量会受到键长度、页格式、记录头、填充率等因素影响，不能直接按这个示例计算生产容量。但它能说明：",[56,9620,9621],{},[18,9622,9623],{},"多路树的扇出很大，少量层级就可以管理大量记录。",[18,9625,9626],{},[70,9627,9630],{"href":9628,"target":73,"rel":9629},"\u002Fimages\u002Fwiki\u002Fjava\u002Fmysql-bplus-tree-fanout.svg",[75,76],[78,9631],{"src":9628,"alt":9632},"B+ 树通过大扇出降低树高",[14,9634,9636],{"id":9635},"八为什么-b-树适合范围查询","八、为什么 B+ 树适合范围查询",[18,9638,9639],{},"假设执行：",[279,9641,9643],{"className":7797,"code":9642,"language":7799,"meta":285,"style":285},"SELECT *\nFROM orders\nWHERE id BETWEEN 1000 AND 2000;\n",[25,9644,9645,9652,9659],{"__ignoreMap":285},[315,9646,9647,9649],{"class":317,"line":318},[315,9648,7483],{"class":325},[315,9650,9651],{"class":325}," *\n",[315,9653,9654,9657],{"class":317,"line":343},[315,9655,9656],{"class":325},"FROM",[315,9658,7981],{"class":333},[315,9660,9661,9663,9665,9667,9670,9672,9675],{"class":317,"line":359},[315,9662,7858],{"class":325},[315,9664,8257],{"class":333},[315,9666,7864],{"class":325},[315,9668,9669],{"class":839}," 1000",[315,9671,7870],{"class":325},[315,9673,9674],{"class":839}," 2000",[315,9676,7876],{"class":333},[18,9678,9679,9680,9683],{},"B+ 树可以先从根节点定位到 ",[25,9681,9682],{},"id=1000"," 附近的叶子页：",[279,9685,9688],{"className":9686,"code":9687,"language":284,"meta":285},[282],"根页\n ↓\n非叶子页\n ↓\n包含 1000 的叶子页\n",[25,9689,9687],{"__ignoreMap":285},[18,9691,9692],{},"定位范围起点以后，可以沿叶子页顺序扫描：",[279,9694,9697],{"className":9695,"code":9696,"language":284,"meta":285},[282],"[1000 ... 1200] ↔ [1201 ... 1500] ↔ [1501 ... 1800] ↔ [1801 ... 2000]\n",[25,9698,9696],{"__ignoreMap":285},[18,9700,9701],{},"不需要为范围中的每一条记录重新从根节点查找。",[18,9703,9704],{},"因此，B+ 树天然适合：",[245,9706,9707,9719,9723,9729,9735,9744],{},[211,9708,9709,5067,9711,5067,9714,5067,9716,734],{},[25,9710,337],{},[25,9712,9713],{},">=",[25,9715,2436],{},[25,9717,9718],{},"\u003C=",[211,9720,9721,734],{},[25,9722,7864],{},[211,9724,9725,9726,734],{},"有效前缀的 ",[25,9727,9728],{},"LIKE 'abc%'",[211,9730,9731,9732,734],{},"按索引顺序执行的 ",[25,9733,9734],{},"ORDER BY",[211,9736,9737,9738,5067,9741,734],{},"部分 ",[25,9739,9740],{},"MIN",[25,9742,9743],{},"MAX",[211,9745,9746],{},"范围扫描和顺序分页。",[18,9748,9749],{},"能否真正使用索引顺序，还取决于联合索引结构、最左前缀、排序方向和执行计划，不能因为底层是 B+ 树就认为所有范围条件都会高效。",[14,9751,9753],{"id":9752},"九为什么不用二叉查找树或红黑树","九、为什么不用二叉查找树或红黑树",[18,9755,9756],{},"二叉查找树和红黑树的扇出通常是 2。",[18,9758,9759],{},"即使红黑树能够保持近似平衡，管理大量数据时树高仍然明显高于多路树：",[279,9761,9764],{"className":9762,"code":9763,"language":284,"meta":285},[282],"二叉树：\n每个节点最多 2 个分支\n\nB+ 树：\n每个页面可以拥有数百甚至更多分支\n",[25,9765,9763],{"__ignoreMap":285},[18,9767,9768],{},"如果每层节点可能位于不同页面，树越高，查询可能需要访问的页面越多。",[18,9770,9771,9772,9775],{},"红黑树很适合内存中的集合和映射，例如 Java 的 ",[25,9773,9774],{},"TreeMap","；数据库索引需要尽量减少页面 I\u002FO，并支持大范围顺序扫描，因此多路 B+ 树更加合适。",[14,9777,9779],{"id":9778},"十为什么不直接使用哈希索引","十、为什么不直接使用哈希索引",[18,9781,9782],{},"哈希结构擅长等值查询：",[279,9784,9786],{"className":7797,"code":9785,"language":7799,"meta":285,"style":285},"WHERE id = 100\n",[25,9787,9788],{"__ignoreMap":285},[315,9789,9790,9792,9794,9796],{"class":317,"line":318},[315,9791,7858],{"class":325},[315,9793,8257],{"class":333},[315,9795,2511],{"class":325},[315,9797,8262],{"class":839},[18,9799,9800],{},"理想情况下可以根据哈希值直接定位桶。",[18,9802,9803],{},"但哈希值不保留原始键的顺序，因此不适合：",[279,9805,9807],{"className":7797,"code":9806,"language":7799,"meta":285,"style":285},"WHERE id > 100;\nWHERE id BETWEEN 100 AND 200;\nORDER BY id;\nLIKE 'abc%';\n",[25,9808,9809,9821,9837,9844],{"__ignoreMap":285},[315,9810,9811,9813,9815,9817,9819],{"class":317,"line":318},[315,9812,7858],{"class":325},[315,9814,8257],{"class":333},[315,9816,337],{"class":325},[315,9818,7867],{"class":839},[315,9820,7876],{"class":333},[315,9822,9823,9825,9827,9829,9831,9833,9835],{"class":317,"line":343},[315,9824,7858],{"class":325},[315,9826,8257],{"class":333},[315,9828,7864],{"class":325},[315,9830,7867],{"class":839},[315,9832,7870],{"class":325},[315,9834,7873],{"class":839},[315,9836,7876],{"class":333},[315,9838,9839,9841],{"class":317,"line":359},[315,9840,9734],{"class":325},[315,9842,9843],{"class":333}," id;\n",[315,9845,9846,9849,9852],{"class":317,"line":375},[315,9847,9848],{"class":325},"LIKE",[315,9850,9851],{"class":329}," 'abc%'",[315,9853,7876],{"class":333},[18,9855,9856],{},"哈希索引还需要处理哈希冲突，也无法自然支持联合索引的有序最左前缀扫描。",[18,9858,9859],{},"B+ 树虽然等值查找通常需要沿树下降，但同时支持：",[245,9861,9862,9865,9868,9871,9874],{},[211,9863,9864],{},"等值查询；",[211,9866,9867],{},"范围查询；",[211,9869,9870],{},"顺序扫描；",[211,9872,9873],{},"排序；",[211,9875,9876],{},"联合索引前缀匹配。",[18,9878,9879],{},"因此它的通用性更强。",[18,9881,9882],{},"InnoDB 的自适应哈希索引可以为部分热点 B-tree 页面建立哈希访问路径，但它属于内部优化，不会替代原有 B+ 树索引。",[14,9884,9886],{"id":9885},"十一innodb-聚簇索引如何组织数据","十一、InnoDB 聚簇索引如何组织数据",[18,9888,9889],{},"每张 InnoDB 表都有一个聚簇索引。",[18,9891,9892],{},"聚簇索引的选择顺序通常是：",[208,9894,9895,9898,9905],{},[211,9896,9897],{},"显式定义的主键；",[211,9899,9900,9901,9904],{},"第一个所有列均为 ",[25,9902,9903],{},"NOT NULL"," 的唯一索引；",[211,9906,9907],{},"InnoDB 自动生成的隐藏行 ID。",[18,9909,9910],{},"聚簇索引可以简化为：",[279,9912,9915],{"className":9913,"code":9914,"language":284,"meta":285},[282],"非叶子节点：\n主键 + 子页面指针\n\n叶子节点：\n主键 + 完整行数据\n",[25,9916,9914],{"__ignoreMap":285},[18,9918,9919],{},"因此，通过主键查询：",[279,9921,9923],{"className":7797,"code":9922,"language":7799,"meta":285,"style":285},"SELECT * FROM users WHERE id = 100;\n",[25,9924,9925],{"__ignoreMap":285},[315,9926,9927,9929,9931,9933,9936,9938,9940,9942,9944],{"class":317,"line":318},[315,9928,7483],{"class":325},[315,9930,7849],{"class":325},[315,9932,7852],{"class":325},[315,9934,9935],{"class":333}," users ",[315,9937,7858],{"class":325},[315,9939,8257],{"class":333},[315,9941,2511],{"class":325},[315,9943,7867],{"class":839},[315,9945,7876],{"class":333},[18,9947,9948],{},"沿聚簇索引找到叶子记录时，通常已经取得了完整行数据。",[18,9950,9951],{},"这也是为什么官方文档把 InnoDB 表称为按聚簇索引组织的数据结构。",[14,9953,9955],{"id":9954},"十二innodb-二级索引如何组织数据","十二、InnoDB 二级索引如何组织数据",[18,9957,9958],{},"二级索引的叶子记录不直接保存完整行，而是保存：",[279,9960,9963],{"className":9961,"code":9962,"language":284,"meta":285},[282],"二级索引列 + 主键值\n",[25,9964,9962],{"__ignoreMap":285},[18,9966,9967],{},"假设存在：",[279,9969,9971],{"className":7797,"code":9970,"language":7799,"meta":285,"style":285},"CREATE INDEX idx_users_name ON users(name);\n",[25,9972,9973],{"__ignoreMap":285},[315,9974,9975,9977,9979,9982,9984,9987,9990],{"class":317,"line":318},[315,9976,8165],{"class":325},[315,9978,8168],{"class":325},[315,9980,9981],{"class":321}," idx_users_name",[315,9983,8174],{"class":325},[315,9985,9986],{"class":333}," users(",[315,9988,9989],{"class":325},"name",[315,9991,8034],{"class":333},[18,9993,9994],{},"执行：",[279,9996,9998],{"className":7797,"code":9997,"language":7799,"meta":285,"style":285},"SELECT age\nFROM users\nWHERE name = 'Tom';\n",[25,9999,10000,10007,10014],{"__ignoreMap":285},[315,10001,10002,10004],{"class":317,"line":318},[315,10003,7483],{"class":325},[315,10005,10006],{"class":333}," age\n",[315,10008,10009,10011],{"class":317,"line":343},[315,10010,9656],{"class":325},[315,10012,10013],{"class":333}," users\n",[315,10015,10016,10018,10021,10023,10026],{"class":317,"line":359},[315,10017,7858],{"class":325},[315,10019,10020],{"class":325}," name",[315,10022,8633],{"class":325},[315,10024,10025],{"class":329}," 'Tom'",[315,10027,7876],{"class":333},[18,10029,491,10030,10032],{},[25,10031,1691],{}," 不在二级索引中，查询过程通常是：",[279,10034,10037],{"className":10035,"code":10036,"language":284,"meta":285},[282],"idx_users_name B+ 树\n ↓\n找到 name='Tom' 对应的主键\n ↓\n回到聚簇索引 B+ 树\n ↓\n根据主键取得完整行和 age\n",[25,10038,10036],{"__ignoreMap":285},[18,10040,10041],{},"这就是回表。",[18,10043,10044],{},"如果查询所需列都能从二级索引叶子记录中取得：",[279,10046,10048],{"className":7797,"code":10047,"language":7799,"meta":285,"style":285},"SELECT id\nFROM users\nWHERE name = 'Tom';\n",[25,10049,10050,10057,10063],{"__ignoreMap":285},[315,10051,10052,10054],{"class":317,"line":318},[315,10053,7483],{"class":325},[315,10055,10056],{"class":333}," id\n",[315,10058,10059,10061],{"class":317,"line":343},[315,10060,9656],{"class":325},[315,10062,10013],{"class":333},[315,10064,10065,10067,10069,10071,10073],{"class":317,"line":359},[315,10066,7858],{"class":325},[315,10068,10020],{"class":325},[315,10070,8633],{"class":325},[315,10072,10025],{"class":329},[315,10074,7876],{"class":333},[18,10076,10077],{},"那么可能直接通过二级索引完成查询，不需要回到聚簇索引，这就是覆盖索引。",[18,10079,10080],{},[70,10081,10084],{"href":10082,"target":73,"rel":10083},"\u002Fimages\u002Fwiki\u002Fjava\u002Fmysql-innodb-index-lookup.svg",[75,76],[78,10085],{"src":10082,"alt":10086},"InnoDB 聚簇索引、二级索引与回表",[14,10088,10090],{"id":10089},"十三为什么主键不宜过长","十三、为什么主键不宜过长",[18,10092,10093],{},"InnoDB 的每条二级索引记录都包含主键值。",[18,10095,10096],{},"如果主键很长：",[279,10098,10101],{"className":10099,"code":10100,"language":284,"meta":285},[282],"每条二级索引记录更大\n ↓\n一个索引页容纳的记录更少\n ↓\n索引占用空间增加\n ↓\n缓存命中率和扇出可能下降\n",[25,10102,10100],{"__ignoreMap":285},[18,10104,10105],{},"因此，在满足业务要求的前提下，较短且稳定的主键通常更有利于 InnoDB 索引组织。",[18,10107,10108],{},"这并不意味着所有表都必须使用自增整数主键。是否采用自增 ID、分布式 ID 或业务主键，还要考虑写入热点、分库分表、数据合并和业务语义。",[14,10110,10112],{"id":10111},"十四叶子节点有序带来的其他收益","十四、叶子节点有序带来的其他收益",[18,10114,10115],{},"除了范围查询，叶子节点按键值有序还可以帮助：",[245,10117,10118,10121,10124,10127,10130],{},[211,10119,10120],{},"按索引顺序输出数据，减少额外排序；",[211,10122,10123],{},"快速定位最小值和最大值；",[211,10125,10126],{},"连续读取相邻索引记录；",[211,10128,10129],{},"对联合索引执行最左前缀扫描；",[211,10131,10132],{},"利用页预读和 Buffer Pool 提高连续访问效率。",[18,10134,10135],{},"但“逻辑有序”不等于“所有叶子页在磁盘上永远物理连续”。页面分裂、删除、合并和长期更新都会产生碎片，同层索引页主要依靠页面头中保存的前后页页号维持逻辑顺序。这些页号发挥逻辑指针的作用，并不是进程内存地址意义上的裸指针。",[14,10137,10139],{"id":10138},"十五b-树的写入代价","十五、B+ 树的写入代价",[18,10141,10142],{},"B+ 树并不是只有优点。",[18,10144,10145],{},"插入新记录时，需要先找到目标叶子页。如果页面空间不足，可能发生页分裂：",[279,10147,10150],{"className":10148,"code":10149,"language":284,"meta":285},[282],"一个满页\n ↓\n分裂为两个页\n ↓\n更新父节点目录项\n",[25,10151,10149],{"__ignoreMap":285},[18,10153,10154],{},"删除大量记录后，也可能触发页面合并或树结构收缩。",[18,10156,10157],{},"随机主键写入容易把数据分散到不同叶子页，可能带来：",[245,10159,10160,10163,10166,10169],{},[211,10161,10162],{},"更多随机页面访问；",[211,10164,10165],{},"页分裂；",[211,10167,10168],{},"页面利用率下降；",[211,10170,10171],{},"Buffer Pool 压力增加。",[18,10173,10174],{},"顺序递增键通常更容易写入索引右侧页面，但高并发场景下也可能形成右侧热点。主键选择需要结合实际写入模式评估。",[14,10176,10178],{"id":10177},"十六常见误区","十六、常见误区",[237,10180,10182],{"id":10181},"误区-1mysql-所有索引都是-b-树","误区 1：MySQL 所有索引都是 B+ 树",[18,10184,10185],{},"不准确。这里主要讨论 InnoDB 的普通索引。空间索引、全文索引和内部自适应哈希索引采用不同结构或机制。",[237,10187,10189],{"id":10188},"误区-2b-树的所有数据都只存在叶子节点","误区 2：B+ 树的所有数据都只存在叶子节点",[18,10191,10192],{},"需要区分“完整索引记录”和“分隔键”。非叶子节点也会保存用于导航的键，但完整索引记录集中在叶子节点。",[237,10194,10196],{"id":10195},"误区-3b-树一定比-b-树快","误区 3：B+ 树一定比 B 树快",[18,10198,10199],{},"不一定。纯内存、单次等值查询中，B 树可能提前在非叶子节点命中。B+ 树的优势主要体现在页面扇出、稳定查询路径和范围扫描。",[237,10201,10203],{"id":10202},"误区-4使用-b-树后查询一定只需要三次-io","误区 4：使用 B+ 树后查询一定只需要三次 I\u002FO",[18,10205,10206],{},"树高不是固定值，取决于页面大小、键长度、记录大小、填充率和数据量。页面还可能已经位于 Buffer Pool 中，因此树层访问次数也不能直接等同于磁盘 I\u002FO 次数。",[237,10208,10210],{"id":10209},"误区-5建立索引就一定能提高性能","误区 5：建立索引就一定能提高性能",[18,10212,10213,10214,5067,10217,5067,10219,10221],{},"索引会占用空间并增加 ",[25,10215,10216],{},"INSERT",[25,10218,7462],{},[25,10220,7465],{}," 的维护成本。低选择性索引、无法满足最左前缀的查询或返回大量数据的查询，也可能不使用索引。",[14,10223,10225],{"id":10224},"十七回答时可以怎样组织","十七、回答时可以怎样组织",[18,10227,10228],{},"面试时可以按照以下顺序回答：",[279,10230,10233],{"className":10231,"code":10232,"language":284,"meta":285},[282],"先说结构差异\n ↓\n再说数据库按页读取\n ↓\n解释扇出更大、树高更低\n ↓\n解释叶子节点有序，适合范围扫描\n ↓\n结合 InnoDB 聚簇索引和二级索引\n",[25,10234,10232],{"__ignoreMap":285},[18,10236,10237,10238,10240],{},"重点不是只说“B+ 树查询复杂度是 ",[25,10239,9522],{},"”，而是说明：",[56,10242,10243],{},[18,10244,10245],{},"InnoDB 通过页组织索引，B+ 树让一个非叶子页保存更多导航项，从而用较少层级管理大量数据；定位到叶子页后，又能沿有序叶子页完成范围扫描。",[14,10247,1191],{"id":1191},[245,10249,10250,10257,10264,10271,10278],{},[211,10251,10252],{},[70,10253,10256],{"href":10254,"rel":10255},"https:\u002F\u002Fdev.mysql.com\u002Fdoc\u002Frefman\u002F8.4\u002Fen\u002Finnodb-index-types.html",[1200],"MySQL 8.4 Reference Manual：Clustered and Secondary Indexes",[211,10258,10259],{},[70,10260,10263],{"href":10261,"rel":10262},"https:\u002F\u002Fdev.mysql.com\u002Fdoc\u002Frefman\u002F8.4\u002Fen\u002Finnodb-physical-structure.html",[1200],"MySQL 8.4 Reference Manual：The Physical Structure of an InnoDB Index",[211,10265,10266],{},[70,10267,10270],{"href":10268,"rel":10269},"https:\u002F\u002Fdev.mysql.com\u002Fdoc\u002Frefman\u002F8.4\u002Fen\u002Fcolumn-indexes.html",[1200],"MySQL 8.4 Reference Manual：Column Indexes",[211,10272,10273],{},[70,10274,10277],{"href":10275,"rel":10276},"https:\u002F\u002Fdev.mysql.com\u002Fdoc\u002Frefman\u002F8.4\u002Fen\u002Findex-btree-hash.html",[1200],"MySQL 8.4 Reference Manual：Comparison of B-Tree and Hash Indexes",[211,10279,10280],{},[70,10281,10284],{"href":10282,"rel":10283},"https:\u002F\u002Fdev.mysql.com\u002Fdoc\u002Frefman\u002F8.4\u002Fen\u002Finnodb-file-space.html",[1200],"MySQL 8.4 Reference Manual：File Space Management",[1224,10286,10287],{},"html pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}",{"title":285,"searchDepth":343,"depth":343,"links":10289},[10290,10293,10294,10295,10296,10297,10298,10299,10300,10301,10302,10303,10304,10305,10306,10307,10308,10309,10310,10317,10318],{"id":16,"depth":343,"text":16,"children":10291},[10292],{"id":7495,"depth":359,"text":7495},{"id":66,"depth":343,"text":66},{"id":83,"depth":343,"text":83},{"id":9235,"depth":343,"text":9236},{"id":9285,"depth":343,"text":9286},{"id":9331,"depth":343,"text":9332},{"id":9383,"depth":343,"text":9384},{"id":9497,"depth":343,"text":9498},{"id":9531,"depth":343,"text":9532},{"id":9578,"depth":343,"text":9579},{"id":9635,"depth":343,"text":9636},{"id":9752,"depth":343,"text":9753},{"id":9778,"depth":343,"text":9779},{"id":9885,"depth":343,"text":9886},{"id":9954,"depth":343,"text":9955},{"id":10089,"depth":343,"text":10090},{"id":10111,"depth":343,"text":10112},{"id":10138,"depth":343,"text":10139},{"id":10177,"depth":343,"text":10178,"children":10311},[10312,10313,10314,10315,10316],{"id":10181,"depth":359,"text":10182},{"id":10188,"depth":359,"text":10189},{"id":10195,"depth":359,"text":10196},{"id":10202,"depth":359,"text":10203},{"id":10209,"depth":359,"text":10210},{"id":10224,"depth":343,"text":10225},{"id":1191,"depth":343,"text":1191},"wiki:java:mysql-bplus-tree-vs-btree","从磁盘页、树高、扇出、范围查询和 InnoDB 索引组织方式出发，解释 MySQL 为何采用 B+ 树，并对比 B 树、红黑树与哈希索引。",{},76,"\u002Fjava\u002Fmysql-bplus-tree-vs-btree",{"title":9182,"description":10320},"java\u002Fmysql-bplus-tree-vs-btree","2026-07-25","jndYWwP27t-baJwZJsdJfVBgvgmQyLB_Z7vIQtvgXow",{"id":10329,"title":10330,"body":10331,"commentId":15069,"description":15070,"difficulty":1276,"draft":1277,"extension":1278,"meta":15071,"navigation":1280,"order":15072,"path":15073,"section":1283,"seo":15074,"stem":15075,"updated":10326,"__hash__":15076},"java\u002Fjava\u002Fmysql-index-failure-scenarios.md","MySQL 索引在什么情况下会失效？",{"type":7,"value":10332,"toc":15002},[10333,10336,10338,10341,10371,10374,10417,10439,10441,10446,10448,10457,10459,10463,10466,10470,10473,10476,10489,10492,10523,10526,10530,10533,10535,10547,10550,10606,10621,10630,10634,10637,10643,10646,10649,10653,10656,10666,10683,10686,10692,10695,10776,10789,10792,10835,10838,10841,10845,10848,10853,10856,10859,10869,10871,10903,10906,10930,10933,10943,10947,10953,10965,10968,11002,11012,11015,11056,11059,11115,11118,11134,11137,11140,11152,11157,11163,11166,11186,11201,11204,11220,11223,11250,11253,11271,11274,11319,11321,11335,11339,11342,11370,11373,11390,11393,11409,11412,11415,11429,11432,11435,11440,11444,11446,11463,11466,11483,11490,11493,11520,11523,11526,11537,11547,11551,11558,11600,11607,11610,11630,11635,11639,11646,11649,11673,11675,11714,11717,11723,11729,11735,11738,11802,11808,11818,11860,11863,11869,11874,11881,11895,11904,11907,11930,11933,11937,11944,11954,11956,11981,11984,12000,12003,12006,12010,12013,12063,12066,12071,12074,12080,12083,12089,12093,12096,12125,12130,12136,12139,12142,12166,12170,12176,12179,12189,12191,12225,12234,12237,12260,12265,12268,12285,12288,12290,12300,12303,12347,12356,12362,12367,12400,12411,12417,12430,12433,12476,12491,12494,12497,12584,12598,12604,12615,12628,12631,12634,12637,12659,12662,12695,12698,12701,12718,12725,12745,12748,12765,12768,12773,12779,12791,12797,12801,12804,12818,12821,12824,12840,12843,12846,12850,12853,12887,12889,12981,12988,13000,13003,13008,13011,13017,13020,13022,13048,13058,13066,13074,13077,13083,13089,13095,13100,13103,13168,13171,13200,13203,13234,13237,13243,13248,13263,13290,13293,13308,13313,13318,13323,13331,13336,13343,13345,13395,13448,13459,13465,13472,13479,13524,13530,13535,13537,13552,13580,13586,13592,13598,13603,13619,13633,13636,13641,13684,13699,13706,13711,13714,13754,13757,13763,13769,13807,13809,13837,13845,13848,13874,13877,13883,13892,13898,13906,13909,13928,13933,13939,13945,13949,13952,13955,13965,13967,14015,14023,14026,14032,14040,14046,14049,14054,14061,14067,14070,14084,14087,14094,14099,14106,14111,14117,14129,14131,14142,14160,14170,14173,14179,14184,14187,14210,14218,14226,14233,14238,14241,14247,14250,14271,14273,14303,14308,14314,14317,14336,14342,14346,14486,14491,14496,14500,14507,14539,14549,14554,14588,14591,14597,14600,14632,14635,14710,14715,14721,14724,14727,14741,14748,14751,14757,14766,14769,14775,14778,14781,14787,14792,14795,14826,14830,14833,14880,14884,14888,14891,14895,14898,14908,14911,14917,14920,14924,14927,14934,14937,14941,14999],[10,10334,10330],{"id":10335},"mysql-索引在什么情况下会失效",[14,10337,16],{"id":16},[18,10339,10340],{},"所谓“索引失效”并不是 MySQL 的正式术语，实际需要区分三种情况：",[208,10342,10343,10349,10368],{},[211,10344,10345,10346,10348],{},"SQL 写法或索引结构决定了索引无法用于快速定位，例如联合索引没有满足最左前缀、查询的是索引列的计算结果但索引只保存原始列值、",[25,10347,9848],{}," 以通配符开头。",[211,10350,10351,10352,10355,10356,10359,10360,10363,10364,10367],{},"索引可以使用，但只能使用其中一部分。例如联合索引 ",[25,10353,10354],{},"(a,b,c)"," 查询 ",[25,10357,10358],{},"a=1 AND b>10 AND c=3"," 时，通常可以用 ",[25,10361,10362],{},"a、b"," 确定扫描范围，",[25,10365,10366],{},"c"," 可能通过索引条件下推继续过滤，却不能进一步缩小连续的索引扫描区间。",[211,10369,10370],{},"索引具备使用条件，但优化器估算全表扫描成本更低，于是主动不选。例如查询返回大量数据、索引选择性很低或回表成本过高。",[18,10372,10373],{},"常见场景包括：",[245,10375,10376,10379,10382,10385,10394,10400,10411,10414],{},[211,10377,10378],{},"联合索引不满足最左前缀；",[211,10380,10381],{},"在索引列上执行函数、计算或不匹配的表达式；",[211,10383,10384],{},"比较两侧数据类型、字符集或排序规则不兼容，引发隐式转换；",[211,10386,10387,5414,10390,10393],{},[25,10388,10389],{},"LIKE '%keyword'",[25,10391,10392],{},"LIKE '%keyword%'"," 以通配符开头；",[211,10395,10396,10399],{},[25,10397,10398],{},"OR"," 的某个分支缺少可用索引，且优化器无法采用合适的 Index Merge；",[211,10401,10402,5067,10404,5067,10407,10410],{},[25,10403,4045],{},[25,10405,10406],{},"NOT IN",[25,10408,10409],{},"IS NOT NULL"," 等条件命中数据过多；",[211,10412,10413],{},"查询需要返回表中很大比例的数据，优化器认为全表扫描更便宜；",[211,10415,10416],{},"索引统计信息不准确，导致优化器成本估算偏差。",[18,10418,10419,10420,10423,10424,5414,10427,10430,10431,10434,10435,10438],{},"判断索引是否真正有效，不能只看 ",[25,10421,10422],{},"possible_keys","，应使用 ",[25,10425,10426],{},"EXPLAIN",[25,10428,10429],{},"EXPLAIN ANALYZE","，重点观察实际选择的 ",[25,10432,10433],{},"key","、访问类型 ",[25,10436,10437],{},"type","、预计或实际扫描行数，以及是否发生大量回表。",[237,10440,7495],{"id":7495},[56,10442,10443],{},[18,10444,10445],{},"索引失效要区分“不能用、只用一部分、能用但优化器不选”；排查时先看索引结构和 SQL 写法，再用执行计划验证实际扫描成本。",[14,10447,66],{"id":66},[18,10449,10450],{},[70,10451,10454],{"href":10452,"target":73,"rel":10453},"\u002Fimages\u002Fwiki\u002Fjava\u002Fmysql-index-failure-scenarios.svg",[75,76],[78,10455],{"src":10452,"alt":10456},"MySQL 索引失效的三类情况与排查路径",[14,10458,83],{"id":83},[14,10460,10462],{"id":10461},"一先区分三种索引失效","一、先区分三种“索引失效”",[18,10464,10465],{},"日常讨论经常把所有没有达到预期性能的情况都叫作“索引失效”，但这会掩盖真正的问题。",[237,10467,10469],{"id":10468},"_1-索引无法用于定位","1. 索引无法用于定位",[18,10471,10472],{},"索引的有序结构与查询条件不匹配，MySQL 无法根据该条件确定一个有效的索引查找范围。",[18,10474,10475],{},"例如索引为：",[279,10477,10479],{"className":7797,"code":10478,"language":7799,"meta":285,"style":285},"KEY idx_user_time (user_id, created_at)\n",[25,10480,10481],{"__ignoreMap":285},[315,10482,10483,10486],{"class":317,"line":318},[315,10484,10485],{"class":325},"KEY",[315,10487,10488],{"class":333}," idx_user_time (user_id, created_at)\n",[18,10490,10491],{},"查询只使用第二列：",[279,10493,10495],{"className":7797,"code":10494,"language":7799,"meta":285,"style":285},"SELECT *\nFROM orders\nWHERE created_at >= '2026-07-01';\n",[25,10496,10497,10503,10509],{"__ignoreMap":285},[315,10498,10499,10501],{"class":317,"line":318},[315,10500,7483],{"class":325},[315,10502,9651],{"class":325},[315,10504,10505,10507],{"class":317,"line":343},[315,10506,9656],{"class":325},[315,10508,7981],{"class":333},[315,10510,10511,10513,10516,10518,10521],{"class":317,"line":359},[315,10512,7858],{"class":325},[315,10514,10515],{"class":333}," created_at ",[315,10517,9713],{"class":325},[315,10519,10520],{"class":329}," '2026-07-01'",[315,10522,7876],{"class":333},[18,10524,10525],{},"传统的联合索引范围查找无法绕过第一列，直接按照第二列定位连续区间。",[237,10527,10529],{"id":10528},"_2-只使用了部分索引能力","2. 只使用了部分索引能力",[18,10531,10532],{},"SQL 使用了索引，但索引没有把扫描范围缩小到预期程度。",[18,10534,3181],{},[279,10536,10538],{"className":7797,"code":10537,"language":7799,"meta":285,"style":285},"KEY idx_abc (a, b, c)\n",[25,10539,10540],{"__ignoreMap":285},[315,10541,10542,10544],{"class":317,"line":318},[315,10543,10485],{"class":325},[315,10545,10546],{"class":333}," idx_abc (a, b, c)\n",[18,10548,10549],{},"查询：",[279,10551,10553],{"className":7797,"code":10552,"language":7799,"meta":285,"style":285},"SELECT *\nFROM t\nWHERE a = 1\n AND b > 10\n AND c = 3;\n",[25,10554,10555,10561,10568,10580,10592],{"__ignoreMap":285},[315,10556,10557,10559],{"class":317,"line":318},[315,10558,7483],{"class":325},[315,10560,9651],{"class":325},[315,10562,10563,10565],{"class":317,"line":343},[315,10564,9656],{"class":325},[315,10566,10567],{"class":333}," t\n",[315,10569,10570,10572,10575,10577],{"class":317,"line":359},[315,10571,7858],{"class":325},[315,10573,10574],{"class":333}," a ",[315,10576,2511],{"class":325},[315,10578,10579],{"class":839}," 1\n",[315,10581,10582,10584,10587,10589],{"class":317,"line":375},[315,10583,8627],{"class":325},[315,10585,10586],{"class":333}," b ",[315,10588,337],{"class":325},[315,10590,10591],{"class":839}," 10\n",[315,10593,10594,10596,10599,10601,10604],{"class":317,"line":391},[315,10595,8627],{"class":325},[315,10597,10598],{"class":333}," c ",[315,10600,2511],{"class":325},[315,10602,10603],{"class":839}," 3",[315,10605,7876],{"class":333},[18,10607,10608,10609,10612,10613,10616,10617,10620],{},"通常可以使用 ",[25,10610,10611],{},"a=1 AND b>10"," 构造索引扫描范围。由于 ",[25,10614,10615],{},"b"," 是范围条件，",[25,10618,10619],{},"c=3"," 一般不能继续把这个范围切成更小的连续区间。",[18,10622,10623,10624,10626,10627,10629],{},"但这不等于 ",[25,10625,10366],{}," 完全没用。满足条件时，MySQL 可以通过索引条件下推（Index Condition Pushdown，ICP），在索引层先判断 ",[25,10628,10619],{},"，减少回表数量。",[237,10631,10633],{"id":10632},"_3-优化器主动不选择索引","3. 优化器主动不选择索引",[18,10635,10636],{},"索引本身可用，但 MySQL 优化器根据统计信息估算：",[279,10638,10641],{"className":10639,"code":10640,"language":284,"meta":285},[282],"使用二级索引扫描 + 大量回表\n >\n顺序扫描整张表\n",[25,10642,10640],{"__ignoreMap":285},[18,10644,10645],{},"于是执行计划选择全表扫描。",[18,10647,10648],{},"这种情况不是索引结构失效，而是成本选择。强行使用索引不一定更快。",[14,10650,10652],{"id":10651},"二联合索引不满足最左前缀","二、联合索引不满足最左前缀",[18,10654,10655],{},"假设存在联合索引：",[279,10657,10658],{"className":7797,"code":10537,"language":7799,"meta":285,"style":285},[25,10659,10660],{"__ignoreMap":285},[315,10661,10662,10664],{"class":317,"line":318},[315,10663,10485],{"class":325},[315,10665,10546],{"class":333},[18,10667,10668,10669,10671,10672,10674,10675,10671,10677,10679,10680,10682],{},"B+ 树中的记录首先按 ",[25,10670,70],{}," 排序；",[25,10673,70],{}," 相同时，再按 ",[25,10676,10615],{},[25,10678,10362],{}," 都相同时，才按 ",[25,10681,10366],{}," 排序。",[18,10684,10685],{},"可以近似理解为：",[279,10687,10690],{"className":10688,"code":10689,"language":284,"meta":285},[282],"(a=1, b=1, c=1)\n(a=1, b=1, c=5)\n(a=1, b=2, c=2)\n(a=2, b=1, c=3)\n",[25,10691,10689],{"__ignoreMap":285},[18,10693,10694],{},"因此以下条件通常能够使用联合索引定位：",[279,10696,10698],{"className":7797,"code":10697,"language":7799,"meta":285,"style":285},"WHERE a = 1\nWHERE a = 1 AND b = 2\nWHERE a = 1 AND b = 2 AND c = 3\nWHERE a = 1 AND c = 3\n",[25,10699,10700,10710,10730,10758],{"__ignoreMap":285},[315,10701,10702,10704,10706,10708],{"class":317,"line":318},[315,10703,7858],{"class":325},[315,10705,10574],{"class":333},[315,10707,2511],{"class":325},[315,10709,10579],{"class":839},[315,10711,10712,10714,10716,10718,10721,10723,10725,10727],{"class":317,"line":343},[315,10713,7858],{"class":325},[315,10715,10574],{"class":333},[315,10717,2511],{"class":325},[315,10719,10720],{"class":839}," 1",[315,10722,7870],{"class":325},[315,10724,10586],{"class":333},[315,10726,2511],{"class":325},[315,10728,10729],{"class":839}," 2\n",[315,10731,10732,10734,10736,10738,10740,10742,10744,10746,10749,10751,10753,10755],{"class":317,"line":359},[315,10733,7858],{"class":325},[315,10735,10574],{"class":333},[315,10737,2511],{"class":325},[315,10739,10720],{"class":839},[315,10741,7870],{"class":325},[315,10743,10586],{"class":333},[315,10745,2511],{"class":325},[315,10747,10748],{"class":839}," 2",[315,10750,7870],{"class":325},[315,10752,10598],{"class":333},[315,10754,2511],{"class":325},[315,10756,10757],{"class":839}," 3\n",[315,10759,10760,10762,10764,10766,10768,10770,10772,10774],{"class":317,"line":375},[315,10761,7858],{"class":325},[315,10763,10574],{"class":333},[315,10765,2511],{"class":325},[315,10767,10720],{"class":839},[315,10769,7870],{"class":325},[315,10771,10598],{"class":333},[315,10773,2511],{"class":325},[315,10775,10757],{"class":839},[18,10777,10778,10779,10782,10783,10785,10786,10788],{},"最后一个条件仍然可以通过 ",[25,10780,10781],{},"a=1"," 定位范围，只是缺少 ",[25,10784,10615],{}," 后，",[25,10787,10619],{}," 通常不能继续缩小查找区间。",[18,10790,10791],{},"以下查询没有使用最左列：",[279,10793,10795],{"className":7797,"code":10794,"language":7799,"meta":285,"style":285},"WHERE b = 2\nWHERE c = 3\nWHERE b = 2 AND c = 3\n",[25,10796,10797,10807,10817],{"__ignoreMap":285},[315,10798,10799,10801,10803,10805],{"class":317,"line":318},[315,10800,7858],{"class":325},[315,10802,10586],{"class":333},[315,10804,2511],{"class":325},[315,10806,10729],{"class":839},[315,10808,10809,10811,10813,10815],{"class":317,"line":343},[315,10810,7858],{"class":325},[315,10812,10598],{"class":333},[315,10814,2511],{"class":325},[315,10816,10757],{"class":839},[315,10818,10819,10821,10823,10825,10827,10829,10831,10833],{"class":317,"line":359},[315,10820,7858],{"class":325},[315,10822,10586],{"class":333},[315,10824,2511],{"class":325},[315,10826,10748],{"class":839},[315,10828,7870],{"class":325},[315,10830,10598],{"class":333},[315,10832,2511],{"class":325},[315,10834,10757],{"class":839},[18,10836,10837],{},"它们通常无法使用传统的最左前缀方式直接定位。",[18,10839,10840],{},"需要注意，MySQL 8.0 在满足条件时可能使用 Skip Scan，把缺失的最左列按多个可能值分别扫描。因此“缺少最左列一定完全不用索引”也不是绝对结论，最终必须以执行计划为准。",[14,10842,10844],{"id":10843},"三范围条件之后的列还能不能使用","三、范围条件之后的列还能不能使用",[18,10846,10847],{},"常见说法是：",[56,10849,10850],{},[18,10851,10852],{},"联合索引遇到范围查询后，后面的列全部失效。",[18,10854,10855],{},"这个说法过于绝对。",[18,10857,10858],{},"索引为：",[279,10860,10861],{"className":7797,"code":10537,"language":7799,"meta":285,"style":285},[25,10862,10863],{"__ignoreMap":285},[315,10864,10865,10867],{"class":317,"line":318},[315,10866,10485],{"class":325},[315,10868,10546],{"class":333},[18,10870,10549],{},[279,10872,10874],{"className":7797,"code":10873,"language":7799,"meta":285,"style":285},"WHERE a = 1 AND b > 10 AND c = 3\n",[25,10875,10876],{"__ignoreMap":285},[315,10877,10878,10880,10882,10884,10886,10888,10890,10892,10895,10897,10899,10901],{"class":317,"line":318},[315,10879,7858],{"class":325},[315,10881,10574],{"class":333},[315,10883,2511],{"class":325},[315,10885,10720],{"class":839},[315,10887,7870],{"class":325},[315,10889,10586],{"class":333},[315,10891,337],{"class":325},[315,10893,10894],{"class":839}," 10",[315,10896,7870],{"class":325},[315,10898,10598],{"class":333},[315,10900,2511],{"class":325},[315,10902,10757],{"class":839},[18,10904,10905],{},"更准确的理解是：",[245,10907,10908,10916,10921,10927],{},[211,10909,10910,28,10912,10915],{},[25,10911,10781],{},[25,10913,10914],{},"b>10"," 可以共同确定扫描范围；",[211,10917,10918,10920],{},[25,10919,10619],{}," 通常不能继续缩小这个连续范围；",[211,10922,10923,10924,10926],{},"如果启用了 ICP，",[25,10925,10619],{}," 仍可能在索引层参与过滤；",[211,10928,10929],{},"如果查询列都包含在索引中，还可能形成覆盖索引，避免回表。",[18,10931,10932],{},"所以“能否参与范围定位”“能否参与索引层过滤”和“能否避免回表”是三个不同问题。",[18,10934,10935,10936,10939,10940,10942],{},"另外，",[25,10937,10938],{},"IN"," 在很多情况下会被转换成多个等值范围，不应简单地把所有 ",[25,10941,10938],{}," 都视为遇到范围后索引失效。",[14,10944,10946],{"id":10945},"四在索引列上进行函数或计算","四、在索引列上进行函数或计算",[18,10948,8151,10949,10952],{},[25,10950,10951],{},"created_at"," 上有普通索引：",[279,10954,10956],{"className":7797,"code":10955,"language":7799,"meta":285,"style":285},"KEY idx_created_at (created_at)\n",[25,10957,10958],{"__ignoreMap":285},[315,10959,10960,10962],{"class":317,"line":318},[315,10961,10485],{"class":325},[315,10963,10964],{"class":333}," idx_created_at (created_at)\n",[18,10966,10967],{},"下面的写法把函数作用在索引列上：",[279,10969,10971],{"className":7797,"code":10970,"language":7799,"meta":285,"style":285},"SELECT *\nFROM orders\nWHERE DATE(created_at) = '2026-07-25';\n",[25,10972,10973,10979,10985],{"__ignoreMap":285},[315,10974,10975,10977],{"class":317,"line":318},[315,10976,7483],{"class":325},[315,10978,9651],{"class":325},[315,10980,10981,10983],{"class":317,"line":343},[315,10982,9656],{"class":325},[315,10984,7981],{"class":333},[315,10986,10987,10989,10992,10995,10997,11000],{"class":317,"line":359},[315,10988,7858],{"class":325},[315,10990,10991],{"class":325}," DATE",[315,10993,10994],{"class":333},"(created_at) ",[315,10996,2511],{"class":325},[315,10998,10999],{"class":329}," '2026-07-25'",[315,11001,7876],{"class":333},[18,11003,11004,11005,11007,11008,11011],{},"普通索引保存的是原始 ",[25,11006,10951],{}," 值，而不是 ",[25,11009,11010],{},"DATE(created_at)"," 的计算结果。MySQL 通常无法直接根据普通索引定位函数结果。",[18,11013,11014],{},"可以改写为范围条件：",[279,11016,11018],{"className":7797,"code":11017,"language":7799,"meta":285,"style":285},"SELECT *\nFROM orders\nWHERE created_at >= '2026-07-25 00:00:00'\n AND created_at \u003C '2026-07-26 00:00:00';\n",[25,11019,11020,11026,11032,11043],{"__ignoreMap":285},[315,11021,11022,11024],{"class":317,"line":318},[315,11023,7483],{"class":325},[315,11025,9651],{"class":325},[315,11027,11028,11030],{"class":317,"line":343},[315,11029,9656],{"class":325},[315,11031,7981],{"class":333},[315,11033,11034,11036,11038,11040],{"class":317,"line":359},[315,11035,7858],{"class":325},[315,11037,10515],{"class":333},[315,11039,9713],{"class":325},[315,11041,11042],{"class":329}," '2026-07-25 00:00:00'\n",[315,11044,11045,11047,11049,11051,11054],{"class":317,"line":375},[315,11046,8627],{"class":325},[315,11048,10515],{"class":333},[315,11050,2436],{"class":325},[315,11052,11053],{"class":329}," '2026-07-26 00:00:00'",[315,11055,7876],{"class":333},[18,11057,11058],{},"类似问题还包括：",[279,11060,11062],{"className":7797,"code":11061,"language":7799,"meta":285,"style":285},"WHERE amount + 1 = 100\nWHERE LOWER(username) = 'tom'\nWHERE CAST(order_no AS UNSIGNED) = 1001\n",[25,11063,11064,11079,11094],{"__ignoreMap":285},[315,11065,11066,11068,11070,11073,11075,11077],{"class":317,"line":318},[315,11067,7858],{"class":325},[315,11069,7861],{"class":333},[315,11071,11072],{"class":325},"+",[315,11074,10720],{"class":839},[315,11076,8633],{"class":325},[315,11078,8262],{"class":839},[315,11080,11081,11083,11086,11089,11091],{"class":317,"line":343},[315,11082,7858],{"class":325},[315,11084,11085],{"class":839}," LOWER",[315,11087,11088],{"class":333},"(username) ",[315,11090,2511],{"class":325},[315,11092,11093],{"class":329}," 'tom'\n",[315,11095,11096,11098,11101,11104,11107,11110,11112],{"class":317,"line":359},[315,11097,7858],{"class":325},[315,11099,11100],{"class":839}," CAST",[315,11102,11103],{"class":333},"(order_no ",[315,11105,11106],{"class":325},"AS",[315,11108,11109],{"class":333}," UNSIGNED) ",[315,11111,2511],{"class":325},[315,11113,11114],{"class":839}," 1001\n",[18,11116,11117],{},"应优先把运算移动到常量一侧：",[279,11119,11121],{"className":7797,"code":11120,"language":7799,"meta":285,"style":285},"WHERE amount = 99\n",[25,11122,11123],{"__ignoreMap":285},[315,11124,11125,11127,11129,11131],{"class":317,"line":318},[315,11126,7858],{"class":325},[315,11128,7861],{"class":333},[315,11130,2511],{"class":325},[315,11132,11133],{"class":839}," 99\n",[18,11135,11136],{},"这里所说的“对索引列进行未建立函数索引的运算”，可以用下面的例子理解。",[18,11138,11139],{},"普通索引：",[279,11141,11143],{"className":7797,"code":11142,"language":7799,"meta":285,"style":285},"KEY idx_amount (amount)\n",[25,11144,11145],{"__ignoreMap":285},[315,11146,11147,11149],{"class":317,"line":318},[315,11148,10485],{"class":325},[315,11150,11151],{"class":333}," idx_amount (amount)\n",[18,11153,11154,11155,3382],{},"保存并排序的是原始 ",[25,11156,8154],{},[279,11158,11161],{"className":11159,"code":11160,"language":284,"meta":285},[282],"10 → 20 → 30 → 40\n",[25,11162,11160],{"__ignoreMap":285},[18,11164,11165],{},"查询条件却是：",[279,11167,11169],{"className":7797,"code":11168,"language":7799,"meta":285,"style":285},"WHERE amount + 1 = 31\n",[25,11170,11171],{"__ignoreMap":285},[315,11172,11173,11175,11177,11179,11181,11183],{"class":317,"line":318},[315,11174,7858],{"class":325},[315,11176,7861],{"class":333},[315,11178,11072],{"class":325},[315,11180,10720],{"class":839},[315,11182,8633],{"class":325},[315,11184,11185],{"class":839}," 31\n",[18,11187,11188,11189,11192,11193,11196,11197,11200],{},"MySQL 需要比较的是 ",[25,11190,11191],{},"amount + 1"," 的结果，而普通索引中没有保存这个结果。它通常无法直接在 ",[25,11194,11195],{},"idx_amount"," 中查找 ",[25,11198,11199],{},"31","，而需要对候选记录计算表达式。",[18,11202,11203],{},"这个条件可以直接改写为：",[279,11205,11207],{"className":7797,"code":11206,"language":7799,"meta":285,"style":285},"WHERE amount = 30\n",[25,11208,11209],{"__ignoreMap":285},[315,11210,11211,11213,11215,11217],{"class":317,"line":318},[315,11212,7858],{"class":325},[315,11214,7861],{"class":333},[315,11216,2511],{"class":325},[315,11218,11219],{"class":839}," 30\n",[18,11221,11222],{},"如果业务确实需要长期按照某个表达式查询，MySQL 8.0.13 及以上版本支持函数索引：",[279,11224,11226],{"className":7797,"code":11225,"language":7799,"meta":285,"style":285},"CREATE INDEX idx_amount_plus_one\nON orders ((amount + 1));\n",[25,11227,11228,11237],{"__ignoreMap":285},[315,11229,11230,11232,11234],{"class":317,"line":318},[315,11231,8165],{"class":325},[315,11233,8168],{"class":325},[315,11235,11236],{"class":321}," idx_amount_plus_one\n",[315,11238,11239,11241,11244,11246,11248],{"class":317,"line":343},[315,11240,8684],{"class":325},[315,11242,11243],{"class":333}," orders ((amount ",[315,11245,11072],{"class":325},[315,11247,10720],{"class":839},[315,11249,4354],{"class":333},[18,11251,11252],{},"之后与索引表达式匹配的查询才可以直接检索表达式结果：",[279,11254,11255],{"className":7797,"code":11168,"language":7799,"meta":285,"style":285},[25,11256,11257],{"__ignoreMap":285},[315,11258,11259,11261,11263,11265,11267,11269],{"class":317,"line":318},[315,11260,7858],{"class":325},[315,11262,7861],{"class":333},[315,11264,11072],{"class":325},[315,11266,10720],{"class":839},[315,11268,8633],{"class":325},[315,11270,11185],{"class":839},[18,11272,11273],{},"也可以创建生成列，再为生成列建立索引：",[279,11275,11277],{"className":7797,"code":11276,"language":7799,"meta":285,"style":285},"ALTER TABLE orders\nADD COLUMN order_date DATE AS (DATE(created_at)),\nADD INDEX idx_order_date (order_date);\n",[25,11278,11279,11289,11310],{"__ignoreMap":285},[315,11280,11281,11284,11287],{"class":317,"line":318},[315,11282,11283],{"class":325},"ALTER",[315,11285,11286],{"class":325}," TABLE",[315,11288,7981],{"class":333},[315,11290,11291,11294,11297,11300,11303,11305,11307],{"class":317,"line":343},[315,11292,11293],{"class":325},"ADD",[315,11295,11296],{"class":333}," COLUMN order_date ",[315,11298,11299],{"class":325},"DATE",[315,11301,11302],{"class":325}," AS",[315,11304,4311],{"class":333},[315,11306,11299],{"class":325},[315,11308,11309],{"class":333},"(created_at)),\n",[315,11311,11312,11314,11316],{"class":317,"line":359},[315,11313,11293],{"class":325},[315,11315,8168],{"class":325},[315,11317,11318],{"class":333}," idx_order_date (order_date);\n",[18,11320,3971],{},[245,11322,11323,11326,11329,11332],{},[211,11324,11325],{},"函数索引保存的是表达式计算结果，不是让任意函数都自动使用原列索引；",[211,11327,11328],{},"查询中的表达式需要与索引定义匹配；",[211,11330,11331],{},"函数索引会占用空间，也会增加写入和更新成本；",[211,11333,11334],{},"能通过等价范围条件改写的 SQL，通常优先改写，未必需要新增索引。",[14,11336,11338],{"id":11337},"五隐式类型转换","五、隐式类型转换",[18,11340,11341],{},"假设订单号是字符串：",[279,11343,11345],{"className":7797,"code":11344,"language":7799,"meta":285,"style":285},"order_no VARCHAR(32),\nKEY idx_order_no (order_no)\n",[25,11346,11347,11363],{"__ignoreMap":285},[315,11348,11349,11352,11355,11357,11360],{"class":317,"line":318},[315,11350,11351],{"class":333},"order_no ",[315,11353,11354],{"class":325},"VARCHAR",[315,11356,4349],{"class":333},[315,11358,11359],{"class":839},"32",[315,11361,11362],{"class":333},"),\n",[315,11364,11365,11367],{"class":317,"line":343},[315,11366,10485],{"class":325},[315,11368,11369],{"class":333}," idx_order_no (order_no)\n",[18,11371,11372],{},"推荐使用相同类型进行比较：",[279,11374,11376],{"className":7797,"code":11375,"language":7799,"meta":285,"style":285},"WHERE order_no = '10001'\n",[25,11377,11378],{"__ignoreMap":285},[315,11379,11380,11382,11385,11387],{"class":317,"line":318},[315,11381,7858],{"class":325},[315,11383,11384],{"class":333}," order_no ",[315,11386,2511],{"class":325},[315,11388,11389],{"class":329}," '10001'\n",[18,11391,11392],{},"如果写成：",[279,11394,11396],{"className":7797,"code":11395,"language":7799,"meta":285,"style":285},"WHERE order_no = 10001\n",[25,11397,11398],{"__ignoreMap":285},[315,11399,11400,11402,11404,11406],{"class":317,"line":318},[315,11401,7858],{"class":325},[315,11403,11384],{"class":333},[315,11405,2511],{"class":325},[315,11407,11408],{"class":839}," 10001\n",[18,11410,11411],{},"MySQL 需要按照类型转换规则比较字符串与数字，可能对索引列执行转换，导致无法按原有字符串顺序高效定位。",[18,11413,11414],{},"排查时要检查：",[245,11416,11417,11420,11423,11426],{},[211,11418,11419],{},"数字列是否与字符串参数比较；",[211,11421,11422],{},"字符串列的字符集是否一致；",[211,11424,11425],{},"字符串列的排序规则是否兼容；",[211,11427,11428],{},"JOIN 两侧字段的类型、长度、字符集和排序规则是否匹配。",[18,11430,11431],{},"例如两个字符串列字符集不兼容时，即使两侧都有索引，也可能无法高效使用索引完成连接。",[18,11433,11434],{},"最稳妥的原则是：",[56,11436,11437],{},[18,11438,11439],{},"SQL 参数类型应与索引列类型一致，JOIN 字段的类型和字符规则也应保持一致。",[14,11441,11443],{"id":11442},"六like-以通配符开头","六、LIKE 以通配符开头",[18,11445,10858],{},[279,11447,11449],{"className":7797,"code":11448,"language":7799,"meta":285,"style":285},"KEY idx_name (name)\n",[25,11450,11451],{"__ignoreMap":285},[315,11452,11453,11455,11458,11460],{"class":317,"line":318},[315,11454,10485],{"class":325},[315,11456,11457],{"class":333}," idx_name (",[315,11459,9989],{"class":325},[315,11461,11462],{"class":333},")\n",[18,11464,11465],{},"以下前缀匹配通常可以利用 B+ 树的有序性：",[279,11467,11469],{"className":7797,"code":11468,"language":7799,"meta":285,"style":285},"WHERE name LIKE 'zhizhi%'\n",[25,11470,11471],{"__ignoreMap":285},[315,11472,11473,11475,11477,11480],{"class":317,"line":318},[315,11474,7858],{"class":325},[315,11476,10020],{"class":325},[315,11478,11479],{"class":325}," LIKE",[315,11481,11482],{"class":329}," 'zhizhi%'\n",[18,11484,11485,11486,11489],{},"MySQL 可以定位到以 ",[25,11487,11488],{},"zhizhi"," 开头的索引范围。",[18,11491,11492],{},"以下写法无法确定字符串起始位置：",[279,11494,11496],{"className":7797,"code":11495,"language":7799,"meta":285,"style":285},"WHERE name LIKE '%zhizhi'\nWHERE name LIKE '%zhizhi%'\n",[25,11497,11498,11509],{"__ignoreMap":285},[315,11499,11500,11502,11504,11506],{"class":317,"line":318},[315,11501,7858],{"class":325},[315,11503,10020],{"class":325},[315,11505,11479],{"class":325},[315,11507,11508],{"class":329}," '%zhizhi'\n",[315,11510,11511,11513,11515,11517],{"class":317,"line":343},[315,11512,7858],{"class":325},[315,11514,10020],{"class":325},[315,11516,11479],{"class":325},[315,11518,11519],{"class":329}," '%zhizhi%'\n",[18,11521,11522],{},"普通 B+ 树索引通常无法据此快速定位范围。",[18,11524,11525],{},"如果查询是高频的任意位置文本搜索，应根据业务考虑：",[245,11527,11528,11531,11534],{},[211,11529,11530],{},"FULLTEXT 全文索引；",[211,11532,11533],{},"Elasticsearch 等搜索系统；",[211,11535,11536],{},"调整业务模型，保存可索引的前缀或结构化字段。",[18,11538,11539,11540,11542,11543,11546],{},"需要注意，如果查询需要的列全部包含在索引中，优化器仍可能选择扫描整个索引，因为索引比数据行更窄。此时执行计划中的 ",[25,11541,10437],{}," 可能是 ",[25,11544,11545],{},"index","，但这仍然是全索引扫描，并不是高效的范围查找。",[14,11548,11550],{"id":11549},"七or-中存在无法使用索引的分支","七、OR 中存在无法使用索引的分支",[18,11552,11553,11554,11557],{},"假设只有 ",[25,11555,11556],{},"user_id"," 有索引：",[279,11559,11561],{"className":7797,"code":11560,"language":7799,"meta":285,"style":285},"SELECT *\nFROM orders\nWHERE user_id = 100\n OR remark = 'manual';\n",[25,11562,11563,11569,11575,11585],{"__ignoreMap":285},[315,11564,11565,11567],{"class":317,"line":318},[315,11566,7483],{"class":325},[315,11568,9651],{"class":325},[315,11570,11571,11573],{"class":317,"line":343},[315,11572,9656],{"class":325},[315,11574,7981],{"class":333},[315,11576,11577,11579,11581,11583],{"class":317,"line":359},[315,11578,7858],{"class":325},[315,11580,8618],{"class":333},[315,11582,2511],{"class":325},[315,11584,8262],{"class":839},[315,11586,11587,11590,11593,11595,11598],{"class":317,"line":375},[315,11588,11589],{"class":325}," OR",[315,11591,11592],{"class":333}," remark ",[315,11594,2511],{"class":325},[315,11596,11597],{"class":329}," 'manual'",[315,11599,7876],{"class":333},[18,11601,11602,11603,11606],{},"即使第一部分能够使用索引，为了找出满足 ",[25,11604,11605],{},"remark='manual'"," 的记录，MySQL 仍可能需要扫描大量数据，最终选择全表扫描。",[18,11608,11609],{},"常见优化方式包括：",[208,11611,11612,11615,11621,11627],{},[211,11613,11614],{},"为确实需要的条件建立合适索引；",[211,11616,11617,11618,734],{},"在语义允许且执行计划更优时拆成两个查询并使用 ",[25,11619,11620],{},"UNION ALL",[211,11622,11623,11624,11626],{},"检查重复数据处理，不能为了用索引直接把 ",[25,11625,10398],{}," 改坏；",[211,11628,11629],{},"观察优化器是否采用 Index Merge，而不是假设多个单列索引一定会被组合。",[18,11631,491,11632,11634],{},[25,11633,10398],{}," 两侧分别有可用索引，MySQL 可能选择 Index Merge，也可能根据成本选择其他计划。",[237,11636,11638],{"id":11637},"index-merge-是什么","Index Merge 是什么",[18,11640,11641,11642,11645],{},"Index Merge 是 MySQL 在",[61,11643,11644],{},"同一张表","上分别扫描多个索引，再合并这些索引扫描结果的访问方式。",[18,11647,11648],{},"假设存在两个单列索引：",[279,11650,11652],{"className":7797,"code":11651,"language":7799,"meta":285,"style":285},"KEY idx_user_id (user_id),\nKEY idx_status (status)\n",[25,11653,11654,11661],{"__ignoreMap":285},[315,11655,11656,11658],{"class":317,"line":318},[315,11657,10485],{"class":325},[315,11659,11660],{"class":333}," idx_user_id (user_id),\n",[315,11662,11663,11665,11668,11671],{"class":317,"line":343},[315,11664,10485],{"class":325},[315,11666,11667],{"class":333}," idx_status (",[315,11669,11670],{"class":325},"status",[315,11672,11462],{"class":333},[18,11674,10549],{},[279,11676,11678],{"className":7797,"code":11677,"language":7799,"meta":285,"style":285},"SELECT *\nFROM orders\nWHERE user_id = 100\n OR status = 1;\n",[25,11679,11680,11686,11692,11702],{"__ignoreMap":285},[315,11681,11682,11684],{"class":317,"line":318},[315,11683,7483],{"class":325},[315,11685,9651],{"class":325},[315,11687,11688,11690],{"class":317,"line":343},[315,11689,9656],{"class":325},[315,11691,7981],{"class":333},[315,11693,11694,11696,11698,11700],{"class":317,"line":359},[315,11695,7858],{"class":325},[315,11697,8618],{"class":333},[315,11699,2511],{"class":325},[315,11701,8262],{"class":839},[315,11703,11704,11706,11708,11710,11712],{"class":317,"line":375},[315,11705,11589],{"class":325},[315,11707,8630],{"class":325},[315,11709,8633],{"class":325},[315,11711,10720],{"class":839},[315,11713,7876],{"class":333},[18,11715,11716],{},"MySQL 可以分别得到：",[279,11718,11721],{"className":11719,"code":11720,"language":284,"meta":285},[282],"idx_user_id 扫描结果：满足 user_id=100 的行 ID\nidx_status 扫描结果：满足 status=1 的行 ID\n ↓\n 合并并去重\n ↓\n 读取完整记录\n",[25,11722,11720],{"__ignoreMap":285},[18,11724,11725,11726,11728],{},"在 ",[25,11727,10426],{}," 中通常表现为：",[279,11730,11733],{"className":11731,"code":11732,"language":284,"meta":285},[282],"type: index_merge\nkey: idx_user_id,idx_status\nExtra: Using union(...)\n",[25,11734,11732],{"__ignoreMap":285},[18,11736,11737],{},"Index Merge 主要有三种合并方式：",[98,11739,11740,11753],{},[101,11741,11742],{},[104,11743,11744,11747,11750],{},[107,11745,11746],{},"方式",[107,11748,11749],{},"适用逻辑",[107,11751,11752],{},"处理方式",[114,11754,11755,11772,11786],{},[104,11756,11757,11762,11769],{},[119,11758,11759],{},[25,11760,11761],{},"Using intersect(...)",[119,11763,11764,11765,11768],{},"多个条件用 ",[25,11766,11767],{},"AND"," 连接",[119,11770,11771],{},"取多个索引结果的交集",[104,11773,11774,11779,11783],{},[119,11775,11776],{},[25,11777,11778],{},"Using union(...)",[119,11780,11764,11781,11768],{},[25,11782,10398],{},[119,11784,11785],{},"取多个索引结果的并集",[104,11787,11788,11793,11799],{},[119,11789,11790],{},[25,11791,11792],{},"Using sort_union(...)",[119,11794,11795,11796,11798],{},"多个范围条件用 ",[25,11797,10398],{}," 连接，但不能直接使用 union 算法",[119,11800,11801],{},"收集全部行 ID，排序、去重后再读取记录",[237,11803,11805,11807],{"id":11804},"using-sort_union-是什么意思",[25,11806,11792],{}," 是什么意思",[18,11809,11810,11811,28,11814,11817],{},"先看一个典型查询。假设 ",[25,11812,11813],{},"key_col1",[25,11815,11816],{},"key_col2"," 分别建立了单列索引：",[279,11819,11821],{"className":7797,"code":11820,"language":7799,"meta":285,"style":285},"SELECT *\nFROM orders\nWHERE key_col1 \u003C 10\n OR key_col2 \u003C 20;\n",[25,11822,11823,11829,11835,11846],{"__ignoreMap":285},[315,11824,11825,11827],{"class":317,"line":318},[315,11826,7483],{"class":325},[315,11828,9651],{"class":325},[315,11830,11831,11833],{"class":317,"line":343},[315,11832,9656],{"class":325},[315,11834,7981],{"class":333},[315,11836,11837,11839,11842,11844],{"class":317,"line":359},[315,11838,7858],{"class":325},[315,11840,11841],{"class":333}," key_col1 ",[315,11843,2436],{"class":325},[315,11845,10591],{"class":839},[315,11847,11848,11850,11853,11855,11858],{"class":317,"line":375},[315,11849,11589],{"class":325},[315,11851,11852],{"class":333}," key_col2 ",[315,11854,2436],{"class":325},[315,11856,11857],{"class":839}," 20",[315,11859,7876],{"class":333},[18,11861,11862],{},"优化器可以分别扫描两个索引，但这两个范围扫描产生的行 ID 不能直接按 union 算法边扫描边归并。此时可能采用 sort-union：",[279,11864,11867],{"className":11865,"code":11866,"language":284,"meta":285},[282],"扫描 key_col1 \u003C 10，收集行 ID\n \\\n → 汇总全部行 ID → 按行 ID 排序 → 去重 → 读取完整记录\n \u002F\n扫描 key_col2 \u003C 20，收集行 ID\n",[25,11868,11866],{"__ignoreMap":285},[18,11870,11871,11872,4224],{},"以 InnoDB 二级索引为例，这里的“行 ID”通常可以理解为索引记录中携带的主键值。排序的对象是这些用于定位记录的标识，不是对最终查询结果执行 ",[25,11873,9734],{},[18,11875,11876,5589,11878,11880],{},[25,11877,11778],{},[25,11879,11792],{}," 的关键区别是：",[245,11882,11883,11889],{},[211,11884,11885,11888],{},[25,11886,11887],{},"union"," 可以对多个索引扫描产生的有序行 ID 流直接归并；",[211,11890,11891,11894],{},[25,11892,11893],{},"sort_union"," 需要先收集所有行 ID，再排序和去重，因此在完成收集与排序前不能开始返回记录。",[18,11896,11897,11898,11900,11901,11903],{},"所以 ",[25,11899,11893],{}," 通常比直接的 ",[25,11902,11887],{}," 多出行 ID 缓冲、排序和去重成本。候选记录很多时，优化器也可能认为全表扫描更便宜，最终不选择 Index Merge。",[18,11905,11906],{},"需要特别区分：",[245,11908,11909,11914,11921],{},[211,11910,11911,11913],{},[25,11912,11792],{}," 是同一张表内部多个索引扫描结果的合并算法；",[211,11915,11916,11917,11920],{},"SQL 的 ",[25,11918,11919],{},"UNION"," 是多个查询结果集的集合运算；",[211,11922,11923,11926,11927,11929],{},[25,11924,11925],{},"Using filesort"," 通常表示为了满足 ",[25,11928,9734],{}," 等要求进行额外排序。",[18,11931,11932],{},"这三者不是一回事。",[237,11934,11936],{"id":11935},"index-merge-从哪个版本开始支持","Index Merge 从哪个版本开始支持",[18,11938,11939,11940,11943],{},"Index Merge 从 ",[61,11941,11942],{},"MySQL 5.0"," 开始引入。在此之前，一张表在一次查询访问中通常至多选择一个索引；MySQL 5.0 开始可以在同一张表上扫描多个索引并合并结果。",[18,11945,11946,11947,5067,11950,11953],{},"需要注意，Index Merge 本身是 MySQL 5.0 就有的访问方式，而用于显式影响它的 ",[25,11948,11949],{},"INDEX_MERGE",[25,11951,11952],{},"NO_INDEX_MERGE"," 优化器 Hint 是后续版本才增加的能力，不应把两者的版本混为一谈。",[18,11955,3181],{},[279,11957,11959],{"className":7797,"code":11958,"language":7799,"meta":285,"style":285},"WHERE user_id = 100\n AND status = 1\n",[25,11960,11961,11971],{"__ignoreMap":285},[315,11962,11963,11965,11967,11969],{"class":317,"line":318},[315,11964,7858],{"class":325},[315,11966,8618],{"class":333},[315,11968,2511],{"class":325},[315,11970,8262],{"class":839},[315,11972,11973,11975,11977,11979],{"class":317,"line":343},[315,11974,8627],{"class":325},[315,11976,8630],{"class":325},[315,11978,8633],{"class":325},[315,11980,10579],{"class":839},[18,11982,11983],{},"优化器可能分别扫描两个索引后取交集。不过，很多情况下建立符合查询模式的联合索引：",[279,11985,11987],{"className":7797,"code":11986,"language":7799,"meta":285,"style":285},"KEY idx_user_status (user_id, status)\n",[25,11988,11989],{"__ignoreMap":285},[315,11990,11991,11993,11996,11998],{"class":317,"line":318},[315,11992,10485],{"class":325},[315,11994,11995],{"class":333}," idx_user_status (user_id, ",[315,11997,11670],{"class":325},[315,11999,11462],{"class":333},[18,12001,12002],{},"会比扫描并合并两个单列索引更直接。",[18,12004,12005],{},"因此 Index Merge 是优化器可选择的一种方案，不代表“多个单列索引一定等价于联合索引”。它也只合并同一张表上的索引扫描，不负责合并不同表的索引。",[14,12007,12009],{"id":12008},"八否定条件和低选择性条件","八、否定条件和低选择性条件",[18,12011,12012],{},"以下条件经常返回大量记录：",[279,12014,12016],{"className":7797,"code":12015,"language":7799,"meta":285,"style":285},"WHERE status != 1\nWHERE type NOT IN (1, 2)\nWHERE deleted_at IS NOT NULL\n",[25,12017,12018,12029,12053],{"__ignoreMap":285},[315,12019,12020,12022,12024,12027],{"class":317,"line":318},[315,12021,7858],{"class":325},[315,12023,8630],{"class":325},[315,12025,12026],{"class":325}," !=",[315,12028,10579],{"class":839},[315,12030,12031,12033,12036,12039,12042,12044,12046,12048,12051],{"class":317,"line":343},[315,12032,7858],{"class":325},[315,12034,12035],{"class":325}," type",[315,12037,12038],{"class":325}," NOT",[315,12040,12041],{"class":325}," IN",[315,12043,4311],{"class":333},[315,12045,1560],{"class":839},[315,12047,4327],{"class":333},[315,12049,12050],{"class":839},"2",[315,12052,11462],{"class":333},[315,12054,12055,12057,12060],{"class":317,"line":359},[315,12056,7858],{"class":325},[315,12058,12059],{"class":333}," deleted_at ",[315,12061,12062],{"class":325},"IS NOT NULL\n",[18,12064,12065],{},"这些操作符并不意味着语法上绝对不能使用索引。真正的问题通常是选择性：",[56,12067,12068],{},[18,12069,12070],{},"如果条件会命中表中大部分记录，使用二级索引定位后再逐条回表，可能比全表扫描更贵。",[18,12072,12073],{},"同理，以下字段即使有索引，也可能因为区分度太低而不被选择：",[279,12075,12078],{"className":12076,"code":12077,"language":284,"meta":285},[282],"性别\n是否删除\n只有少量枚举值的状态\n大量相同值的业务类型\n",[25,12079,12077],{"__ignoreMap":285},[18,12081,12082],{},"低基数字段并非永远不适合索引。如果它与其他字段组成联合索引、查询命中比例很低，或者能够形成覆盖索引，依然可能产生价值。",[18,12084,10935,12085,12088],{},[25,12086,12087],{},"IS NULL"," 可以使用索引，不应把它列为固定的索引失效规则。",[14,12090,12092],{"id":12091},"九查询返回数据过多","九、查询返回数据过多",[18,12094,12095],{},"假设表中有 100 万行，而条件预计返回 80 万行：",[279,12097,12099],{"className":7797,"code":12098,"language":7799,"meta":285,"style":285},"SELECT *\nFROM orders\nWHERE status = 1;\n",[25,12100,12101,12107,12113],{"__ignoreMap":285},[315,12102,12103,12105],{"class":317,"line":318},[315,12104,7483],{"class":325},[315,12106,9651],{"class":325},[315,12108,12109,12111],{"class":317,"line":343},[315,12110,9656],{"class":325},[315,12112,7981],{"class":333},[315,12114,12115,12117,12119,12121,12123],{"class":317,"line":359},[315,12116,7858],{"class":325},[315,12118,8630],{"class":325},[315,12120,8633],{"class":325},[315,12122,10720],{"class":839},[315,12124,7876],{"class":333},[18,12126,491,12127,12129],{},[25,12128,11670],{}," 是二级索引，执行过程可能是：",[279,12131,12134],{"className":12132,"code":12133,"language":284,"meta":285},[282],"扫描大量二级索引记录\n ↓\n根据主键逐条回表\n ↓\n读取完整行\n",[25,12135,12133],{"__ignoreMap":285},[18,12137,12138],{},"大量离散回表的成本可能高于直接扫描聚簇索引，因此优化器会主动选择全表扫描。",[18,12140,12141],{},"可以从以下方向优化：",[245,12143,12144,12147,12150,12153,12156,12159],{},[211,12145,12146],{},"确认业务是否真的需要返回如此多的数据；",[211,12148,12149],{},"增加更有区分度的查询条件；",[211,12151,12152],{},"建立符合查询模式的联合索引；",[211,12154,12155],{},"只查询必要字段，评估覆盖索引；",[211,12157,12158],{},"分页或分批处理；",[211,12160,12161,12162,12165],{},"避免用 ",[25,12163,12164],{},"FORCE INDEX"," 掩盖不合理的数据访问方式。",[14,12167,12169],{"id":12168},"十order-by-或-group-by-没有匹配索引顺序","十、ORDER BY 或 GROUP BY 没有匹配索引顺序",[18,12171,12172,12173,12175],{},"索引不仅可以用于 ",[25,12174,7858],{}," 过滤，也可以帮助排序和分组，但需要满足相应的顺序条件。",[18,12177,12178],{},"例如索引：",[279,12180,12181],{"className":7797,"code":10478,"language":7799,"meta":285,"style":285},[25,12182,12183],{"__ignoreMap":285},[315,12184,12185,12187],{"class":317,"line":318},[315,12186,10485],{"class":325},[315,12188,10488],{"class":333},[18,12190,10549],{},[279,12192,12194],{"className":7797,"code":12193,"language":7799,"meta":285,"style":285},"SELECT *\nFROM orders\nWHERE user_id = 100\nORDER BY created_at;\n",[25,12195,12196,12202,12208,12218],{"__ignoreMap":285},[315,12197,12198,12200],{"class":317,"line":318},[315,12199,7483],{"class":325},[315,12201,9651],{"class":325},[315,12203,12204,12206],{"class":317,"line":343},[315,12205,9656],{"class":325},[315,12207,7981],{"class":333},[315,12209,12210,12212,12214,12216],{"class":317,"line":359},[315,12211,7858],{"class":325},[315,12213,8618],{"class":333},[315,12215,2511],{"class":325},[315,12217,8262],{"class":839},[315,12219,12220,12222],{"class":317,"line":375},[315,12221,9734],{"class":325},[315,12223,12224],{"class":333}," created_at;\n",[18,12226,12227,12228,12230,12231,12233],{},"通常可以利用索引中同一 ",[25,12229,11556],{}," 下 ",[25,12232,10951],{}," 有序的特点。",[18,12235,12236],{},"但下面的查询未限定最左列：",[279,12238,12240],{"className":7797,"code":12239,"language":7799,"meta":285,"style":285},"SELECT *\nFROM orders\nORDER BY created_at;\n",[25,12241,12242,12248,12254],{"__ignoreMap":285},[315,12243,12244,12246],{"class":317,"line":318},[315,12245,7483],{"class":325},[315,12247,9651],{"class":325},[315,12249,12250,12252],{"class":317,"line":343},[315,12251,9656],{"class":325},[315,12253,7981],{"class":333},[315,12255,12256,12258],{"class":317,"line":359},[315,12257,9734],{"class":325},[315,12259,12224],{"class":333},[18,12261,12262,12264],{},[25,12263,10951],{}," 在整棵联合索引中并不是全局连续有序，通常无法直接利用该索引消除排序。",[18,12266,12267],{},"以下情况也可能无法直接使用索引顺序：",[245,12269,12270,12273,12276,12279,12282],{},[211,12271,12272],{},"排序列顺序与联合索引不匹配；",[211,12274,12275],{},"联合索引中，排序列前面存在没有被固定为常量的索引列；",[211,12277,12278],{},"对排序列执行表达式或函数；",[211,12280,12281],{},"多张表连接后按非驱动表字段排序；",[211,12283,12284],{},"混合升降序与索引定义不匹配。",[237,12286,12287],{"id":12287},"过滤条件如何影响索引顺序",[18,12289,10655],{},[279,12291,12292],{"className":7797,"code":10537,"language":7799,"meta":285,"style":285},[25,12293,12294],{"__ignoreMap":285},[315,12295,12296,12298],{"class":317,"line":318},[315,12297,10485],{"class":325},[315,12299,10546],{"class":333},[18,12301,12302],{},"下面的查询可以利用索引顺序：",[279,12304,12306],{"className":7797,"code":12305,"language":7799,"meta":285,"style":285},"SELECT *\nFROM t\nWHERE a = 1\n AND b = 2\nORDER BY c;\n",[25,12307,12308,12314,12320,12330,12340],{"__ignoreMap":285},[315,12309,12310,12312],{"class":317,"line":318},[315,12311,7483],{"class":325},[315,12313,9651],{"class":325},[315,12315,12316,12318],{"class":317,"line":343},[315,12317,9656],{"class":325},[315,12319,10567],{"class":333},[315,12321,12322,12324,12326,12328],{"class":317,"line":359},[315,12323,7858],{"class":325},[315,12325,10574],{"class":333},[315,12327,2511],{"class":325},[315,12329,10579],{"class":839},[315,12331,12332,12334,12336,12338],{"class":317,"line":375},[315,12333,8627],{"class":325},[315,12335,10586],{"class":333},[315,12337,2511],{"class":325},[315,12339,10729],{"class":839},[315,12341,12342,12344],{"class":317,"line":391},[315,12343,9734],{"class":325},[315,12345,12346],{"class":333}," c;\n",[18,12348,12349,12350,12352,12353,12355],{},"因为 ",[25,12351,10362],{}," 都固定为常量，剩余记录天然按照 ",[25,12354,10366],{}," 排序：",[279,12357,12360],{"className":12358,"code":12359,"language":284,"meta":285},[282],"(a=1, b=2, c=1)\n(a=1, b=2, c=2)\n(a=1, b=2, c=3)\n",[25,12361,12359],{"__ignoreMap":285},[18,12363,12364,12365,3382],{},"如果只固定 ",[25,12366,70],{},[279,12368,12370],{"className":7797,"code":12369,"language":7799,"meta":285,"style":285},"SELECT *\nFROM t\nWHERE a = 1\nORDER BY c;\n",[25,12371,12372,12378,12384,12394],{"__ignoreMap":285},[315,12373,12374,12376],{"class":317,"line":318},[315,12375,7483],{"class":325},[315,12377,9651],{"class":325},[315,12379,12380,12382],{"class":317,"line":343},[315,12381,9656],{"class":325},[315,12383,10567],{"class":333},[315,12385,12386,12388,12390,12392],{"class":317,"line":359},[315,12387,7858],{"class":325},[315,12389,10574],{"class":333},[315,12391,2511],{"class":325},[315,12393,10579],{"class":839},[315,12395,12396,12398],{"class":317,"line":375},[315,12397,9734],{"class":325},[315,12399,12346],{"class":333},[18,12401,12402,12403,12405,12406,12408,12409,12355],{},"索引记录先按照 ",[25,12404,10615],{}," 排序，再在相同 ",[25,12407,10615],{}," 中按照 ",[25,12410,10366],{},[279,12412,12415],{"className":12413,"code":12414,"language":284,"meta":285},[282],"(a=1, b=1, c=1)\n(a=1, b=1, c=9)\n(a=1, b=2, c=2)\n(a=1, b=2, c=8)\n",[25,12416,12414],{"__ignoreMap":285},[18,12418,12419,12420,12422,12423,12426,12427,4224],{},"从整体看，",[25,12421,10366],{}," 的顺序是 ",[25,12424,12425],{},"1、9、2、8","，并不是全局有序，因此通常仍需 ",[25,12428,12429],{},"filesort",[18,12431,12432],{},"范围条件也可能产生类似效果：",[279,12434,12436],{"className":7797,"code":12435,"language":7799,"meta":285,"style":285},"SELECT *\nFROM t\nWHERE a = 1\n AND b > 10\nORDER BY c;\n",[25,12437,12438,12444,12450,12460,12470],{"__ignoreMap":285},[315,12439,12440,12442],{"class":317,"line":318},[315,12441,7483],{"class":325},[315,12443,9651],{"class":325},[315,12445,12446,12448],{"class":317,"line":343},[315,12447,9656],{"class":325},[315,12449,10567],{"class":333},[315,12451,12452,12454,12456,12458],{"class":317,"line":359},[315,12453,7858],{"class":325},[315,12455,10574],{"class":333},[315,12457,2511],{"class":325},[315,12459,10579],{"class":839},[315,12461,12462,12464,12466,12468],{"class":317,"line":375},[315,12463,8627],{"class":325},[315,12465,10586],{"class":333},[315,12467,337],{"class":325},[315,12469,10591],{"class":839},[315,12471,12472,12474],{"class":317,"line":391},[315,12473,9734],{"class":325},[315,12475,12346],{"class":333},[18,12477,12478,12479,12481,12482,12484,12485,12487,12488,12490],{},"扫描结果首先按不同的 ",[25,12480,10615],{}," 值分组，每个 ",[25,12483,10615],{}," 内部才按 ",[25,12486,10366],{}," 排序，所以不能直接保证全局 ",[25,12489,10366],{}," 有序。",[237,12492,12493],{"id":12493},"为什么按非驱动表字段排序通常需要额外排序",[18,12495,12496],{},"假设查询：",[279,12498,12500],{"className":7797,"code":12499,"language":7799,"meta":285,"style":285},"SELECT o.id, u.name\nFROM orders o\nJOIN users u ON u.id = o.user_id\nWHERE o.created_at >= '2026-07-01'\nORDER BY u.name;\n",[25,12501,12502,12523,12530,12556,12572],{"__ignoreMap":285},[315,12503,12504,12506,12509,12511,12513,12515,12518,12520],{"class":317,"line":318},[315,12505,7483],{"class":325},[315,12507,12508],{"class":839}," o",[315,12510,8885],{"class":333},[315,12512,8275],{"class":839},[315,12514,4327],{"class":333},[315,12516,12517],{"class":839},"u",[315,12519,8885],{"class":333},[315,12521,12522],{"class":839},"name\n",[315,12524,12525,12527],{"class":317,"line":343},[315,12526,9656],{"class":325},[315,12528,12529],{"class":333}," orders o\n",[315,12531,12532,12535,12538,12540,12543,12545,12547,12549,12551,12553],{"class":317,"line":359},[315,12533,12534],{"class":325},"JOIN",[315,12536,12537],{"class":333}," users u ",[315,12539,8684],{"class":325},[315,12541,12542],{"class":839}," u",[315,12544,8885],{"class":333},[315,12546,8275],{"class":839},[315,12548,8633],{"class":325},[315,12550,12508],{"class":839},[315,12552,8885],{"class":333},[315,12554,12555],{"class":839},"user_id\n",[315,12557,12558,12560,12562,12564,12566,12569],{"class":317,"line":375},[315,12559,7858],{"class":325},[315,12561,12508],{"class":839},[315,12563,8885],{"class":333},[315,12565,10951],{"class":839},[315,12567,12568],{"class":325}," >=",[315,12570,12571],{"class":329}," '2026-07-01'\n",[315,12573,12574,12576,12578,12580,12582],{"class":317,"line":391},[315,12575,9734],{"class":325},[315,12577,12542],{"class":839},[315,12579,8885],{"class":333},[315,12581,9989],{"class":839},[315,12583,7876],{"class":333},[18,12585,12586,12587,12590,12591,12594,12595,12597],{},"假设优化器选择 ",[25,12588,12589],{},"orders"," 作为第一个非 ",[25,12592,12593],{},"const"," 表，也就是先按订单时间读取订单，再逐条根据 ",[25,12596,11556],{}," 查询用户：",[279,12599,12602],{"className":12600,"code":12601,"language":284,"meta":285},[282],"按 orders.created_at 读取订单\n ↓\n逐条查找对应 users\n ↓\n得到的 u.name 没有全局顺序\n ↓\n对连接结果执行 filesort\n",[25,12603,12601],{"__ignoreMap":285},[18,12605,12606,12607,12610,12611,12614],{},"即使 ",[25,12608,12609],{},"users.name"," 上有索引，这个索引也只保证从 ",[25,12612,12613],{},"users"," 出发扫描时的姓名顺序，不能保证“先读取订单、再查用户”得到的连接结果按姓名有序。",[18,12616,12617,12618,12620,12621,12623,12624,12627],{},"如果优化器能够把 ",[25,12619,12613],{}," 调整为驱动表，并且从 ",[25,12622,12609],{}," 索引按顺序读取，再连接订单，就可能利用该顺序。但是否能够这样执行，还取决于过滤条件、连接关系、成本估算和 ",[25,12625,12626],{},"LIMIT"," 等因素。",[237,12629,12630],{"id":12630},"索引方向与查询方向如何匹配",[18,12632,12633],{},"MySQL 8.0 支持降序索引，也支持反向扫描 B+ 树索引。",[18,12635,12636],{},"索引：",[279,12638,12640],{"className":7797,"code":12639,"language":7799,"meta":285,"style":285},"KEY idx_ab (a ASC, b ASC)\n",[25,12641,12642],{"__ignoreMap":285},[315,12643,12644,12646,12649,12652,12655,12657],{"class":317,"line":318},[315,12645,10485],{"class":325},[315,12647,12648],{"class":333}," idx_ab (a ",[315,12650,12651],{"class":325},"ASC",[315,12653,12654],{"class":333},", b ",[315,12656,12651],{"class":325},[315,12658,11462],{"class":333},[18,12660,12661],{},"通常可以支持：",[279,12663,12665],{"className":7797,"code":12664,"language":7799,"meta":285,"style":285},"ORDER BY a ASC, b ASC\nORDER BY a DESC, b DESC\n",[25,12666,12667,12681],{"__ignoreMap":285},[315,12668,12669,12671,12673,12675,12678],{"class":317,"line":318},[315,12670,9734],{"class":325},[315,12672,10574],{"class":333},[315,12674,12651],{"class":325},[315,12676,12677],{"class":333},", b ",[315,12679,12680],{"class":325},"ASC\n",[315,12682,12683,12685,12687,12690,12692],{"class":317,"line":343},[315,12684,9734],{"class":325},[315,12686,10574],{"class":333},[315,12688,12689],{"class":325},"DESC",[315,12691,12654],{"class":333},[315,12693,12694],{"class":325},"DESC\n",[18,12696,12697],{},"第二条可以通过整体反向扫描完成。",[18,12699,12700],{},"但混合方向：",[279,12702,12704],{"className":7797,"code":12703,"language":7799,"meta":285,"style":285},"ORDER BY a ASC, b DESC\n",[25,12705,12706],{"__ignoreMap":285},[315,12707,12708,12710,12712,12714,12716],{"class":317,"line":318},[315,12709,9734],{"class":325},[315,12711,10574],{"class":333},[315,12713,12651],{"class":325},[315,12715,12654],{"class":333},[315,12717,12694],{"class":325},[18,12719,12720,12721,12724],{},"与 ",[25,12722,12723],{},"(a ASC, b ASC)"," 的排序关系不同。要直接使用索引顺序，应建立方向相匹配的索引：",[279,12726,12728],{"className":7797,"code":12727,"language":7799,"meta":285,"style":285},"KEY idx_ab_mixed (a ASC, b DESC)\n",[25,12729,12730],{"__ignoreMap":285},[315,12731,12732,12734,12737,12739,12741,12743],{"class":317,"line":318},[315,12733,10485],{"class":325},[315,12735,12736],{"class":333}," idx_ab_mixed (a ",[315,12738,12651],{"class":325},[315,12740,12654],{"class":333},[315,12742,12689],{"class":325},[315,12744,11462],{"class":333},[18,12746,12747],{},"这个索引也可以通过整体反向扫描支持：",[279,12749,12751],{"className":7797,"code":12750,"language":7799,"meta":285,"style":285},"ORDER BY a DESC, b ASC\n",[25,12752,12753],{"__ignoreMap":285},[315,12754,12755,12757,12759,12761,12763],{"class":317,"line":318},[315,12756,9734],{"class":325},[315,12758,10574],{"class":333},[315,12760,12689],{"class":325},[315,12762,12654],{"class":333},[315,12764,12680],{"class":325},[18,12766,12767],{},"所以更准确的规则是：",[56,12769,12770],{},[18,12771,12772],{},"所有列同向时，升序索引可以正向或反向扫描；升降序混合时，索引各列的方向关系需要与查询一致，或者与查询整体相反。",[18,12774,12775,12776,12778],{},"MySQL 5.7 及更早版本虽然允许在索引定义中书写 ",[25,12777,12689],{},"，但通常不会真正按降序存储键值。讨论索引方向时必须结合实际 MySQL 版本。",[18,12780,12781,12782,12784,12785,12788,12789,4224],{},"此时 ",[25,12783,10426],{}," 的 ",[25,12786,12787],{},"Extra"," 中可能出现 ",[25,12790,11925],{},[18,12792,12793,12794,12796],{},"需要注意，",[25,12795,11925],{}," 表示没有直接利用索引顺序完成排序，并不保证真的使用磁盘文件；数据较小时也可能在内存中排序。",[14,12798,12800],{"id":12799},"十一索引统计信息不准确","十一、索引统计信息不准确",[18,12802,12803],{},"MySQL 优化器依赖统计信息估算：",[245,12805,12806,12809,12812,12815],{},[211,12807,12808],{},"条件会命中多少行；",[211,12810,12811],{},"不同索引的选择性；",[211,12813,12814],{},"扫描和回表成本；",[211,12816,12817],{},"JOIN 的顺序及成本。",[18,12819,12820],{},"如果数据分布发生剧烈变化，而统计信息未能反映真实情况，优化器可能选错索引或改用全表扫描。",[18,12822,12823],{},"可以先通过执行计划验证估算行数与实际行数是否偏差明显，再根据情况评估：",[279,12825,12827],{"className":7797,"code":12826,"language":7799,"meta":285,"style":285},"ANALYZE TABLE orders;\n",[25,12828,12829],{"__ignoreMap":285},[315,12830,12831,12834,12837],{"class":317,"line":318},[315,12832,12833],{"class":333},"ANALYZE ",[315,12835,12836],{"class":325},"TABLE",[315,12838,12839],{"class":333}," orders;\n",[18,12841,12842],{},"MySQL 8.0 还可以使用直方图帮助优化器理解非索引列或数据分布不均匀字段的值分布。",[18,12844,12845],{},"不要在没有验证的情况下频繁更新统计信息，也不要把所有执行计划问题都归因于统计信息。",[14,12847,12849],{"id":12848},"十二如何用-explain-判断","十二、如何用 EXPLAIN 判断",[18,12851,12852],{},"基础排查可以执行：",[279,12854,12856],{"className":7797,"code":12855,"language":7799,"meta":285,"style":285},"EXPLAIN\nSELECT *\nFROM orders\nWHERE user_id = 100;\n",[25,12857,12858,12863,12869,12875],{"__ignoreMap":285},[315,12859,12860],{"class":317,"line":318},[315,12861,12862],{"class":333},"EXPLAIN\n",[315,12864,12865,12867],{"class":317,"line":343},[315,12866,7483],{"class":325},[315,12868,9651],{"class":325},[315,12870,12871,12873],{"class":317,"line":359},[315,12872,9656],{"class":325},[315,12874,7981],{"class":333},[315,12876,12877,12879,12881,12883,12885],{"class":317,"line":375},[315,12878,7858],{"class":325},[315,12880,8618],{"class":333},[315,12882,2511],{"class":325},[315,12884,7867],{"class":839},[315,12886,7876],{"class":333},[18,12888,514],{},[98,12890,12891,12900],{},[101,12892,12893],{},[104,12894,12895,12897],{},[107,12896,1679],{},[107,12898,12899],{},"关注点",[114,12901,12902,12911,12920,12930,12952,12962,12972],{},[104,12903,12904,12908],{},[119,12905,12906],{},[25,12907,10422],{},[119,12909,12910],{},"理论上可能使用哪些索引",[104,12912,12913,12917],{},[119,12914,12915],{},[25,12916,10433],{},[119,12918,12919],{},"优化器最终选择了哪个索引",[104,12921,12922,12927],{},[119,12923,12924],{},[25,12925,12926],{},"key_len",[119,12928,12929],{},"实际使用的索引长度，可辅助判断联合索引用到哪一部分",[104,12931,12932,12936],{},[119,12933,12934],{},[25,12935,10437],{},[119,12937,12938,12939,5067,12941,5067,12944,5067,12947,5067,12949],{},"访问方式，如 ",[25,12940,12593],{},[25,12942,12943],{},"ref",[25,12945,12946],{},"range",[25,12948,11545],{},[25,12950,12951],{},"ALL",[104,12953,12954,12959],{},[119,12955,12956],{},[25,12957,12958],{},"rows",[119,12960,12961],{},"预计需要检查的行数",[104,12963,12964,12969],{},[119,12965,12966],{},[25,12967,12968],{},"filtered",[119,12970,12971],{},"经过表条件过滤后预计保留的百分比",[104,12973,12974,12978],{},[119,12975,12976],{},[25,12977,12787],{},[119,12979,12980],{},"是否覆盖索引、ICP、额外排序或临时表等",[237,12982,12984,12985,12987],{"id":12983},"_1-type-到底表示什么","1. ",[25,12986,10437],{}," 到底表示什么",[18,12989,12990,12992,12993,12996,12997,4224],{},[25,12991,10437],{}," 表示 MySQL 访问当前表中记录的方式。在 ",[25,12994,12995],{},"EXPLAIN FORMAT=JSON"," 中，对应字段名是 ",[25,12998,12999],{},"access_type",[18,13001,13002],{},"它回答的不是“有没有索引”这么简单，而是：",[56,13004,13005],{},[18,13006,13007],{},"MySQL 准备通过唯一键直接取一行、按普通索引查一组记录、扫描一个索引范围，还是扫描整棵索引或整张表？",[18,13009,13010],{},"官方文档通常按照下面的顺序描述常见访问类型：",[279,13012,13015],{"className":13013,"code":13014,"language":284,"meta":285},[282],"system\n ↓\nconst\n ↓\neq_ref\n ↓\nref\n ↓\nrange\n ↓\nindex\n ↓\nALL\n",[25,13016,13014],{"__ignoreMap":285},[18,13018,13019],{},"越靠前通常代表定位越精确，但这不是脱离数据量的绝对性能排名。",[18,13021,3181],{},[245,13023,13024,13030,13038,13043],{},[211,13025,13026,13027,13029],{},"小表使用 ",[25,13028,12951],{}," 可能只扫描几十行，成本很低；",[211,13031,13032,13034,13035,13037],{},[25,13033,12943],{}," 虽然比 ",[25,13036,12946],{}," 靠前，但如果某个值匹配几十万行，仍然可能很慢；",[211,13039,13040,13042],{},[25,13041,12946],{}," 如果只扫描十行，通常会非常高效；",[211,13044,13045,13047],{},[25,13046,11545],{}," 虽然使用了索引，却可能把整个索引扫描一遍。",[18,13049,13050,13051,13053,13054,13057],{},"所以查看 ",[25,13052,10437],{}," 后，还必须结合 ",[25,13055,13056],{},"key、rows、filtered、Extra"," 以及实际耗时判断。",[237,13059,13061,13062,13065],{"id":13060},"_2-system表中只有一行","2. ",[25,13063,13064],{},"system","：表中只有一行",[18,13067,13068,13070,13071,13073],{},[25,13069,13064],{}," 是 ",[25,13072,12593],{}," 的特殊情况，表示优化器判断当前表只有一行。",[18,13075,13076],{},"访问过程可以理解为：",[279,13078,13081],{"className":13079,"code":13080,"language":284,"meta":285},[282],"整张表只有一行\n ↓\n直接读取这一行\n",[25,13082,13080],{"__ignoreMap":285},[18,13084,13085,13086,13088],{},"它在普通 InnoDB 业务表的执行计划中并不常见。看到 ",[25,13087,13064],{}," 时，不需要把它理解成某种特殊索引；它表达的是表规模已经确定为单行，因此没有查找范围可言。",[237,13090,5586,13092,13094],{"id":13091},"_3-const通过主键或唯一键最多定位一行",[25,13093,12593],{},"：通过主键或唯一键最多定位一行",[18,13096,13097,13099],{},[25,13098,12593],{}," 表示当前表最多只有一条记录满足条件，并且这条记录在查询开始时只需要读取一次。",[18,13101,13102],{},"典型场景是使用常量匹配主键或完整唯一索引：",[279,13104,13106],{"className":7797,"code":13105,"language":7799,"meta":285,"style":285},"CREATE TABLE users (\n id BIGINT PRIMARY KEY,\n email VARCHAR(128) NOT NULL,\n UNIQUE KEY uk_email (email)\n);\n",[25,13107,13108,13120,13134,13153,13164],{"__ignoreMap":285},[315,13109,13110,13112,13114,13117],{"class":317,"line":318},[315,13111,8165],{"class":325},[315,13113,11286],{"class":325},[315,13115,13116],{"class":321}," users",[315,13118,13119],{"class":333}," (\n",[315,13121,13122,13125,13128,13131],{"class":317,"line":343},[315,13123,13124],{"class":333}," id ",[315,13126,13127],{"class":325},"BIGINT",[315,13129,13130],{"class":325}," PRIMARY KEY",[315,13132,13133],{"class":333},",\n",[315,13135,13136,13139,13141,13143,13146,13149,13151],{"class":317,"line":359},[315,13137,13138],{"class":333}," email ",[315,13140,11354],{"class":325},[315,13142,4349],{"class":333},[315,13144,13145],{"class":839},"128",[315,13147,13148],{"class":333},") ",[315,13150,9903],{"class":325},[315,13152,13133],{"class":333},[315,13154,13155,13158,13161],{"class":317,"line":375},[315,13156,13157],{"class":325}," UNIQUE",[315,13159,13160],{"class":325}," KEY",[315,13162,13163],{"class":333}," uk_email (email)\n",[315,13165,13166],{"class":317,"line":391},[315,13167,8034],{"class":333},[18,13169,13170],{},"查询主键：",[279,13172,13174],{"className":7797,"code":13173,"language":7799,"meta":285,"style":285},"SELECT *\nFROM users\nWHERE id = 100;\n",[25,13175,13176,13182,13188],{"__ignoreMap":285},[315,13177,13178,13180],{"class":317,"line":318},[315,13179,7483],{"class":325},[315,13181,9651],{"class":325},[315,13183,13184,13186],{"class":317,"line":343},[315,13185,9656],{"class":325},[315,13187,10013],{"class":333},[315,13189,13190,13192,13194,13196,13198],{"class":317,"line":359},[315,13191,7858],{"class":325},[315,13193,8257],{"class":333},[315,13195,2511],{"class":325},[315,13197,7867],{"class":839},[315,13199,7876],{"class":333},[18,13201,13202],{},"或者查询唯一键：",[279,13204,13206],{"className":7797,"code":13205,"language":7799,"meta":285,"style":285},"SELECT *\nFROM users\nWHERE email = 'tom@example.com';\n",[25,13207,13208,13214,13220],{"__ignoreMap":285},[315,13209,13210,13212],{"class":317,"line":318},[315,13211,7483],{"class":325},[315,13213,9651],{"class":325},[315,13215,13216,13218],{"class":317,"line":343},[315,13217,9656],{"class":325},[315,13219,10013],{"class":333},[315,13221,13222,13224,13227,13229,13232],{"class":317,"line":359},[315,13223,7858],{"class":325},[315,13225,13226],{"class":333}," email ",[315,13228,2511],{"class":325},[315,13230,13231],{"class":329}," 'tom@example.com'",[315,13233,7876],{"class":333},[18,13235,13236],{},"由于主键或唯一键能够保证最多返回一行，MySQL 可以直接定位目标记录：",[279,13238,13241],{"className":13239,"code":13240,"language":284,"meta":285},[282],"常量值\n ↓\n主键或唯一索引查找\n ↓\n最多一条记录\n",[25,13242,13240],{"__ignoreMap":285},[18,13244,13245,13246,3382],{},"如果是联合唯一索引，需要把能够确定唯一记录的索引列完整匹配，才容易形成 ",[25,13247,12593],{},[279,13249,13251],{"className":7797,"code":13250,"language":7799,"meta":285,"style":285},"UNIQUE KEY uk_tenant_order (tenant_id, order_no)\n",[25,13252,13253],{"__ignoreMap":285},[315,13254,13255,13258,13260],{"class":317,"line":318},[315,13256,13257],{"class":325},"UNIQUE",[315,13259,13160],{"class":325},[315,13261,13262],{"class":333}," uk_tenant_order (tenant_id, order_no)\n",[279,13264,13266],{"className":7797,"code":13265,"language":7799,"meta":285,"style":285},"WHERE tenant_id = 10\n AND order_no = 'A1001'\n",[25,13267,13268,13279],{"__ignoreMap":285},[315,13269,13270,13272,13275,13277],{"class":317,"line":318},[315,13271,7858],{"class":325},[315,13273,13274],{"class":333}," tenant_id ",[315,13276,2511],{"class":325},[315,13278,10591],{"class":839},[315,13280,13281,13283,13285,13287],{"class":317,"line":343},[315,13282,8627],{"class":325},[315,13284,11384],{"class":333},[315,13286,2511],{"class":325},[315,13288,13289],{"class":329}," 'A1001'\n",[18,13291,13292],{},"如果只查询：",[279,13294,13296],{"className":7797,"code":13295,"language":7799,"meta":285,"style":285},"WHERE tenant_id = 10\n",[25,13297,13298],{"__ignoreMap":285},[315,13299,13300,13302,13304,13306],{"class":317,"line":318},[315,13301,7858],{"class":325},[315,13303,13274],{"class":333},[315,13305,2511],{"class":325},[315,13307,10591],{"class":839},[18,13309,13310,13311,4224],{},"可能返回多行，通常就不是 ",[25,13312,12593],{},[18,13314,13315,13317],{},[25,13316,12593],{}," 的核心不是“使用了等号”，而是：",[56,13319,13320],{},[18,13321,13322],{},"通过常量和唯一约束，能够确定当前表最多只返回一条记录。",[237,13324,13326,13327,13330],{"id":13325},"_4-eq_refjoin-时每条前表记录最多匹配一行","4. ",[25,13328,13329],{},"eq_ref","：JOIN 时每条前表记录最多匹配一行",[18,13332,13333,13335],{},[25,13334,13329],{}," 最常见于多表 JOIN。",[18,13337,13338,13339,13342],{},"它表示对于前面表产生的每一条记录，MySQL 都通过主键或 ",[25,13340,13341],{},"UNIQUE NOT NULL"," 索引，在当前表中最多查到一条记录。",[18,13344,3181],{},[279,13346,13348],{"className":7797,"code":13347,"language":7799,"meta":285,"style":285},"CREATE TABLE orders (\n id BIGINT PRIMARY KEY,\n user_id BIGINT NOT NULL,\n KEY idx_user_id (user_id)\n);\n",[25,13349,13350,13361,13371,13383,13391],{"__ignoreMap":285},[315,13351,13352,13354,13356,13359],{"class":317,"line":318},[315,13353,8165],{"class":325},[315,13355,11286],{"class":325},[315,13357,13358],{"class":321}," orders",[315,13360,13119],{"class":333},[315,13362,13363,13365,13367,13369],{"class":317,"line":343},[315,13364,13124],{"class":333},[315,13366,13127],{"class":325},[315,13368,13130],{"class":325},[315,13370,13133],{"class":333},[315,13372,13373,13376,13378,13381],{"class":317,"line":359},[315,13374,13375],{"class":333}," user_id ",[315,13377,13127],{"class":325},[315,13379,13380],{"class":325}," NOT NULL",[315,13382,13133],{"class":333},[315,13384,13385,13388],{"class":317,"line":375},[315,13386,13387],{"class":325}," KEY",[315,13389,13390],{"class":333}," idx_user_id (user_id)\n",[315,13392,13393],{"class":317,"line":391},[315,13394,8034],{"class":333},[279,13396,13398],{"className":7797,"code":13397,"language":7799,"meta":285,"style":285},"SELECT o.id, u.name\nFROM orders o\nJOIN users u ON u.id = o.user_id;\n",[25,13399,13400,13418,13424],{"__ignoreMap":285},[315,13401,13402,13404,13406,13408,13410,13412,13414,13416],{"class":317,"line":318},[315,13403,7483],{"class":325},[315,13405,12508],{"class":839},[315,13407,8885],{"class":333},[315,13409,8275],{"class":839},[315,13411,4327],{"class":333},[315,13413,12517],{"class":839},[315,13415,8885],{"class":333},[315,13417,12522],{"class":839},[315,13419,13420,13422],{"class":317,"line":343},[315,13421,9656],{"class":325},[315,13423,12529],{"class":333},[315,13425,13426,13428,13430,13432,13434,13436,13438,13440,13442,13444,13446],{"class":317,"line":359},[315,13427,12534],{"class":325},[315,13429,12537],{"class":333},[315,13431,8684],{"class":325},[315,13433,12542],{"class":839},[315,13435,8885],{"class":333},[315,13437,8275],{"class":839},[315,13439,8633],{"class":325},[315,13441,12508],{"class":839},[315,13443,8885],{"class":333},[315,13445,11556],{"class":839},[315,13447,7876],{"class":333},[18,13449,13450,13451,13453,13454,10355,13457,3382],{},"假设执行顺序是先读取 ",[25,13452,12589],{},"，再根据 ",[25,13455,13456],{},"o.user_id",[25,13458,12613],{},[279,13460,13463],{"className":13461,"code":13462,"language":284,"meta":285},[282],"orders 的一条记录\n ↓\nu.id = o.user_id\n ↓\n通过 users 主键最多定位一行\n",[25,13464,13462],{"__ignoreMap":285},[18,13466,12781,13467,13469,13470,4224],{},[25,13468,12613],{}," 表的访问类型可能是 ",[25,13471,13329],{},[18,13473,13474,28,13476,13478],{},[25,13475,12593],{},[25,13477,13329],{}," 的区别是：",[98,13480,13481,13494],{},[101,13482,13483],{},[104,13484,13485,13488,13491],{},[107,13486,13487],{},"类型",[107,13489,13490],{},"查找值来自哪里",[107,13492,13493],{},"典型场景",[114,13495,13496,13510],{},[104,13497,13498,13502,13505],{},[119,13499,13500],{},[25,13501,12593],{},[119,13503,13504],{},"SQL 中的常量",[119,13506,13507],{},[25,13508,13509],{},"WHERE id = 100",[104,13511,13512,13516,13519],{},[119,13513,13514],{},[25,13515,13329],{},[119,13517,13518],{},"前面表的列值",[119,13520,13521],{},[25,13522,13523],{},"u.id = o.user_id",[237,13525,4237,13527,13529],{"id":13526},"_5-ref通过非唯一索引等值查找一组记录",[25,13528,12943],{},"：通过非唯一索引等值查找一组记录",[18,13531,13532,13534],{},[25,13533,12943],{}," 表示使用普通索引或联合索引的非唯一前缀进行等值查找，可能返回多条具有相同索引值的记录。",[18,13536,3181],{},[279,13538,13540],{"className":7797,"code":13539,"language":7799,"meta":285,"style":285},"KEY idx_status (status)\n",[25,13541,13542],{"__ignoreMap":285},[315,13543,13544,13546,13548,13550],{"class":317,"line":318},[315,13545,10485],{"class":325},[315,13547,11667],{"class":333},[315,13549,11670],{"class":325},[315,13551,11462],{"class":333},[279,13553,13554],{"className":7797,"code":12098,"language":7799,"meta":285,"style":285},[25,13555,13556,13562,13568],{"__ignoreMap":285},[315,13557,13558,13560],{"class":317,"line":318},[315,13559,7483],{"class":325},[315,13561,9651],{"class":325},[315,13563,13564,13566],{"class":317,"line":343},[315,13565,9656],{"class":325},[315,13567,7981],{"class":333},[315,13569,13570,13572,13574,13576,13578],{"class":317,"line":359},[315,13571,7858],{"class":325},[315,13573,8630],{"class":325},[315,13575,8633],{"class":325},[315,13577,10720],{"class":839},[315,13579,7876],{"class":333},[18,13581,491,13582,13585],{},[25,13583,13584],{},"status=1"," 对应多条订单，访问过程是：",[279,13587,13590],{"className":13588,"code":13589,"language":284,"meta":285},[282],"在 idx_status 中定位 status=1 的起点\n ↓\n连续读取所有 status=1 的索引记录\n ↓\n按需回表\n",[25,13591,13589],{"__ignoreMap":285},[18,13593,13594,13595,13597],{},"因此，",[25,13596,12943],{}," 不代表只读取一行。它可能读取几行，也可能读取几十万行，实际成本取决于索引选择性和回表数量。",[18,13599,13600,13601,3382],{},"联合索引只使用左侧一部分时，也可能出现 ",[25,13602,12943],{},[279,13604,13606],{"className":7797,"code":13605,"language":7799,"meta":285,"style":285},"KEY idx_tenant_status (tenant_id, status)\n",[25,13607,13608],{"__ignoreMap":285},[315,13609,13610,13612,13615,13617],{"class":317,"line":318},[315,13611,10485],{"class":325},[315,13613,13614],{"class":333}," idx_tenant_status (tenant_id, ",[315,13616,11670],{"class":325},[315,13618,11462],{"class":333},[279,13620,13621],{"className":7797,"code":13295,"language":7799,"meta":285,"style":285},[25,13622,13623],{"__ignoreMap":285},[315,13624,13625,13627,13629,13631],{"class":317,"line":318},[315,13626,7858],{"class":325},[315,13628,13274],{"class":333},[315,13630,2511],{"class":325},[315,13632,10591],{"class":839},[18,13634,13635],{},"虽然使用了索引最左列，但同一个租户可能有大量记录，所以仍然是非唯一匹配。",[18,13637,13638,13639,3382],{},"JOIN 中如果使用普通索引关联，也常见 ",[25,13640,12943],{},[279,13642,13644],{"className":7797,"code":13643,"language":7799,"meta":285,"style":285},"SELECT *\nFROM users u\nJOIN orders o ON o.user_id = u.id;\n",[25,13645,13646,13652,13659],{"__ignoreMap":285},[315,13647,13648,13650],{"class":317,"line":318},[315,13649,7483],{"class":325},[315,13651,9651],{"class":325},[315,13653,13654,13656],{"class":317,"line":343},[315,13655,9656],{"class":325},[315,13657,13658],{"class":333}," users u\n",[315,13660,13661,13663,13666,13668,13670,13672,13674,13676,13678,13680,13682],{"class":317,"line":359},[315,13662,12534],{"class":325},[315,13664,13665],{"class":333}," orders o ",[315,13667,8684],{"class":325},[315,13669,12508],{"class":839},[315,13671,8885],{"class":333},[315,13673,11556],{"class":839},[315,13675,8633],{"class":325},[315,13677,12542],{"class":839},[315,13679,8885],{"class":333},[315,13681,8275],{"class":839},[315,13683,7876],{"class":333},[18,13685,13686,13687,13690,13691,13693,13694,13696,13697,4224],{},"对于每个用户，普通索引 ",[25,13688,13689],{},"orders.idx_user_id"," 可能匹配多条订单，因此 ",[25,13692,12589],{}," 的访问类型可能是 ",[25,13695,12943],{},"，而不是 ",[25,13698,13329],{},[237,13700,13702,13703,13705],{"id":13701},"_6-range扫描索引中的一个或多个区间","6. ",[25,13704,12946],{},"：扫描索引中的一个或多个区间",[18,13707,13708,13710],{},[25,13709,12946],{}," 表示 MySQL 先根据条件确定一个或多个索引区间，然后只扫描这些区间中的记录。",[18,13712,13713],{},"典型范围查询：",[279,13715,13717],{"className":7797,"code":13716,"language":7799,"meta":285,"style":285},"SELECT *\nFROM orders\nWHERE created_at >= '2026-07-01'\n AND created_at \u003C '2026-08-01';\n",[25,13718,13719,13725,13731,13741],{"__ignoreMap":285},[315,13720,13721,13723],{"class":317,"line":318},[315,13722,7483],{"class":325},[315,13724,9651],{"class":325},[315,13726,13727,13729],{"class":317,"line":343},[315,13728,9656],{"class":325},[315,13730,7981],{"class":333},[315,13732,13733,13735,13737,13739],{"class":317,"line":359},[315,13734,7858],{"class":325},[315,13736,10515],{"class":333},[315,13738,9713],{"class":325},[315,13740,12571],{"class":329},[315,13742,13743,13745,13747,13749,13752],{"class":317,"line":375},[315,13744,8627],{"class":325},[315,13746,10515],{"class":333},[315,13748,2436],{"class":325},[315,13750,13751],{"class":329}," '2026-08-01'",[315,13753,7876],{"class":333},[18,13755,13756],{},"索引访问过程可以理解为：",[279,13758,13761],{"className":13759,"code":13760,"language":284,"meta":285},[282],"定位 2026-07-01 的索引位置\n ↓\n沿叶子节点向后扫描\n ↓\n到达 2026-08-01 时停止\n",[25,13762,13760],{"__ignoreMap":285},[18,13764,13765,13766,13768],{},"常见能够形成 ",[25,13767,12946],{}," 的条件包括：",[245,13770,13771,13781,13785,13791,13795,13800],{},[211,13772,13773,5067,13775,5067,13777,5067,13779,734],{},[25,13774,337],{},[25,13776,9713],{},[25,13778,2436],{},[25,13780,9718],{},[211,13782,13783,734],{},[25,13784,7864],{},[211,13786,13787,13790],{},[25,13788,13789],{},"IN (...)"," 形成多个离散范围；",[211,13792,13793,734],{},[25,13794,12087],{},[211,13796,13797,13798,734],{},"能确定前缀范围的 ",[25,13799,9728],{},[211,13801,13802,13803,13806],{},"某些 ",[25,13804,13805],{},"\u003C>"," 或其他可转化为索引区间的条件。",[18,13808,3181],{},[279,13810,13812],{"className":7797,"code":13811,"language":7799,"meta":285,"style":285},"WHERE id IN (10, 20, 30)\n",[25,13813,13814],{"__ignoreMap":285},[315,13815,13816,13818,13820,13822,13824,13826,13828,13830,13832,13835],{"class":317,"line":318},[315,13817,7858],{"class":325},[315,13819,8257],{"class":333},[315,13821,10938],{"class":325},[315,13823,4311],{"class":333},[315,13825,1590],{"class":839},[315,13827,4327],{"class":333},[315,13829,9327],{"class":839},[315,13831,4327],{"class":333},[315,13833,13834],{"class":839},"30",[315,13836,11462],{"class":333},[18,13838,13839,13840,13842,13843,4224],{},"虽然使用的是多个等值条件，优化器也可能把它组织成多个索引范围，因此 ",[25,13841,10437],{}," 显示为 ",[25,13844,12946],{},[18,13846,13847],{},"具体来说，范围优化器可以把：",[279,13849,13850],{"className":7797,"code":13811,"language":7799,"meta":285,"style":285},[25,13851,13852],{"__ignoreMap":285},[315,13853,13854,13856,13858,13860,13862,13864,13866,13868,13870,13872],{"class":317,"line":318},[315,13855,7858],{"class":325},[315,13857,8257],{"class":333},[315,13859,10938],{"class":325},[315,13861,4311],{"class":333},[315,13863,1590],{"class":839},[315,13865,4327],{"class":333},[315,13867,9327],{"class":839},[315,13869,4327],{"class":333},[315,13871,13834],{"class":839},[315,13873,11462],{"class":333},[18,13875,13876],{},"转换为同一个索引上的三个单点区间：",[279,13878,13881],{"className":13879,"code":13880,"language":284,"meta":285},[282],"[10, 10]\n∪\n[20, 20]\n∪\n[30, 30]\n",[25,13882,13880],{"__ignoreMap":285},[18,13884,13885,13886,13888,13889,13891],{},"执行时并不是从 ",[25,13887,1590],{}," 一直扫描到 ",[25,13890,13834],{},"，而是分别在同一棵 B+ 树中定位这些单点范围，再合并访问结果：",[279,13893,13896],{"className":13894,"code":13895,"language":284,"meta":285},[282],"定位 id=10\n定位 id=20\n定位 id=30\n ↓\n返回三个范围的记录\n",[25,13897,13895],{"__ignoreMap":285},[18,13899,13900,13901,13903,13904,4224],{},"因此，SQL 语义上虽然是多个等值条件，物理访问方式仍属于“扫描一个或多个索引范围”，",[25,13902,10437],{}," 可以显示为 ",[25,13905,12946],{},[18,13907,13908],{},"这与 Index Merge 不同：",[245,13910,13911,13921],{},[211,13912,13913,13916,13917,13920],{},[25,13914,13915],{},"IN (10,20,30)"," 通常是在",[61,13918,13919],{},"同一个索引","上构造多个范围；",[211,13922,13923,13924,13927],{},"Index Merge 是扫描",[61,13925,13926],{},"同一张表的多个索引","，再合并结果。",[18,13929,13930,13932],{},[25,13931,12946],{}," 是否高效，主要看范围大小：",[279,13934,13937],{"className":13935,"code":13936,"language":284,"meta":285},[282],"扫描 10 条索引记录 → 通常很快\n扫描 80 万条索引记录 → 仍可能很慢\n",[25,13938,13936],{"__ignoreMap":285},[18,13940,13941,13942,13944],{},"所以不能看到 ",[25,13943,12946],{}," 就直接认定 SQL 已经优化完成。",[237,13946,13948],{"id":13947},"_7-icp在回表前用索引中的字段过滤","7. ICP：在回表前用索引中的字段过滤",[18,13950,13951],{},"ICP 全称是 Index Condition Pushdown，中文通常称为“索引条件下推”。",[18,13953,13954],{},"仍然使用联合索引：",[279,13956,13957],{"className":7797,"code":10537,"language":7799,"meta":285,"style":285},[25,13958,13959],{"__ignoreMap":285},[315,13960,13961,13963],{"class":317,"line":318},[315,13962,10485],{"class":325},[315,13964,10546],{"class":333},[18,13966,10549],{},[279,13968,13969],{"className":7797,"code":10552,"language":7799,"meta":285,"style":285},[25,13970,13971,13977,13983,13993,14003],{"__ignoreMap":285},[315,13972,13973,13975],{"class":317,"line":318},[315,13974,7483],{"class":325},[315,13976,9651],{"class":325},[315,13978,13979,13981],{"class":317,"line":343},[315,13980,9656],{"class":325},[315,13982,10567],{"class":333},[315,13984,13985,13987,13989,13991],{"class":317,"line":359},[315,13986,7858],{"class":325},[315,13988,10574],{"class":333},[315,13990,2511],{"class":325},[315,13992,10579],{"class":839},[315,13994,13995,13997,13999,14001],{"class":317,"line":375},[315,13996,8627],{"class":325},[315,13998,10586],{"class":333},[315,14000,337],{"class":325},[315,14002,10591],{"class":839},[315,14004,14005,14007,14009,14011,14013],{"class":317,"line":391},[315,14006,8627],{"class":325},[315,14008,10598],{"class":333},[315,14010,2511],{"class":325},[315,14012,10603],{"class":839},[315,14014,7876],{"class":333},[18,14016,14017,14019,14020,14022],{},[25,14018,10611],{}," 可以确定索引扫描范围，但 ",[25,14021,10619],{}," 通常不能继续缩小这个连续范围。",[18,14024,14025],{},"没有 ICP 时，过程近似为：",[279,14027,14030],{"className":14028,"code":14029,"language":284,"meta":285},[282],"扫描满足 a=1、b>10 的二级索引记录\n ↓\n每一条都根据主键回表\n ↓\n取得完整行后判断 c=3\n",[25,14031,14029],{"__ignoreMap":285},[18,14033,14034,14035,14037,14038,3382],{},"开启 ICP 后，由于 ",[25,14036,10366],{}," 也存储在联合索引中，存储引擎可以先检查索引记录中的 ",[25,14039,10366],{},[279,14041,14044],{"className":14042,"code":14043,"language":284,"meta":285},[282],"扫描满足 a=1、b>10 的二级索引记录\n ↓\n直接在索引记录中判断 c=3\n ├─ 不满足：跳过，不回表\n └─ 满足：根据主键回表\n",[25,14045,14043],{"__ignoreMap":285},[18,14047,14048],{},"它的主要收益是：",[56,14050,14051],{},[18,14052,14053],{},"减少不必要的聚簇索引回表，而不是进一步缩小最初的索引扫描范围。",[18,14055,11725,14056,12784,14058,14060],{},[25,14057,10426],{},[25,14059,12787],{}," 中通常显示：",[279,14062,14065],{"className":14063,"code":14064,"language":284,"meta":285},[282],"Using index condition\n",[25,14066,14064],{"__ignoreMap":285},[18,14068,14069],{},"ICP 与覆盖索引也不同：",[245,14071,14072,14075],{},[211,14073,14074],{},"ICP：仍可能需要回表，只是先在索引层过滤；",[211,14076,14077,14078,14080,14081,4224],{},"覆盖索引：查询所需数据全部在索引中，最终也不需要回表，",[25,14079,12787],{}," 常见 ",[25,14082,14083],{},"Using index",[18,14085,14086],{},"只有能够利用当前索引记录判断的条件，才适合下推到存储引擎；依赖其他表、存储函数或无法从索引记录取得的数据，通常不能这样处理。",[237,14088,14090,14091,14093],{"id":14089},"_8-index把整棵索引扫描一遍","8. ",[25,14092,11545],{},"：把整棵索引扫描一遍",[18,14095,14096,14098],{},[25,14097,11545],{}," 很容易被误解为“查询已经通过索引精准定位”。",[18,14100,14101,14102,14105],{},"实际上，",[25,14103,14104],{},"type=index"," 通常表示：",[56,14107,14108],{},[18,14109,14110],{},"MySQL 没有通过索引条件缩小扫描区间，而是把选中的整棵索引从头到尾扫描一遍。",[18,14112,14113,14114,14116],{},"它与 ",[25,14115,12951],{}," 的共同点是都可能读取全部记录；区别在于：",[245,14118,14119,14124],{},[211,14120,14121,14123],{},[25,14122,11545],{}," 扫描索引树；",[211,14125,14126,14128],{},[25,14127,12951],{}," 扫描表数据。",[18,14130,3181],{},[279,14132,14134],{"className":7797,"code":14133,"language":7799,"meta":285,"style":285},"KEY idx_user_id (user_id)\n",[25,14135,14136],{"__ignoreMap":285},[315,14137,14138,14140],{"class":317,"line":318},[315,14139,10485],{"class":325},[315,14141,13390],{"class":333},[279,14143,14145],{"className":7797,"code":14144,"language":7799,"meta":285,"style":285},"SELECT user_id\nFROM orders;\n",[25,14146,14147,14154],{"__ignoreMap":285},[315,14148,14149,14151],{"class":317,"line":318},[315,14150,7483],{"class":325},[315,14152,14153],{"class":333}," user_id\n",[315,14155,14156,14158],{"class":317,"line":343},[315,14157,9656],{"class":325},[315,14159,12839],{"class":333},[18,14161,14162,14163,14165,14166,14169],{},"如果查询只需要 ",[25,14164,11556],{},"，二级索引已经包含全部所需数据，MySQL 可以扫描更窄的 ",[25,14167,14168],{},"idx_user_id","，而不必扫描保存完整行的聚簇索引。",[18,14171,14172],{},"执行计划可能显示：",[279,14174,14177],{"className":14175,"code":14176,"language":284,"meta":285},[282],"type: index\nkey: idx_user_id\nExtra: Using index\n",[25,14178,14176],{"__ignoreMap":285},[18,14180,7639,14181,14183],{},[25,14182,14083],{}," 表示覆盖索引：查询需要的数据可以直接从索引取得，不需要回表。",[18,14185,14186],{},"另一个常见场景是利用索引顺序避免额外排序：",[279,14188,14190],{"className":7797,"code":14189,"language":7799,"meta":285,"style":285},"SELECT id\nFROM orders\nORDER BY created_at;\n",[25,14191,14192,14198,14204],{"__ignoreMap":285},[315,14193,14194,14196],{"class":317,"line":318},[315,14195,7483],{"class":325},[315,14197,10056],{"class":333},[315,14199,14200,14202],{"class":317,"line":343},[315,14201,9656],{"class":325},[315,14203,7981],{"class":333},[315,14205,14206,14208],{"class":317,"line":359},[315,14207,9734],{"class":325},[315,14209,12224],{"class":333},[18,14211,14212,14213,14215,14216,4224],{},"如果存在适合的 ",[25,14214,10951],{}," 索引，优化器可能按索引顺序扫描全部记录，以避免 ",[25,14217,12429],{},[18,14219,14220,14222,14223,14225],{},[25,14221,11545],{}," 可能比 ",[25,14224,12951],{}," 快，因为二级索引通常更窄，缓存命中和读取的数据量更小；但它本质上仍是全索引扫描，数据量大时成本依然很高。",[237,14227,14229,14230,14232],{"id":14228},"_9-all扫描整张表","9. ",[25,14231,12951],{},"：扫描整张表",[18,14234,14235,14237],{},[25,14236,12951],{}," 表示全表扫描。",[18,14239,14240],{},"对于 InnoDB，可以把它近似理解为扫描保存完整行数据的聚簇索引：",[279,14242,14245],{"className":14243,"code":14244,"language":284,"meta":285},[282],"聚簇索引第一条记录\n ↓\n逐条向后读取\n ↓\n检查 WHERE 条件\n ↓\n直到最后一条记录\n",[25,14246,14244],{"__ignoreMap":285},[18,14248,14249],{},"典型原因包括：",[245,14251,14252,14255,14258,14262,14265,14268],{},[211,14253,14254],{},"查询条件没有可用索引；",[211,14256,14257],{},"在索引列上进行了导致无法定位的函数或转换；",[211,14259,14260,10393],{},[25,14261,9848],{},[211,14263,14264],{},"条件会返回表中大部分数据；",[211,14266,14267],{},"表很小，全表扫描成本更低；",[211,14269,14270],{},"优化器根据统计信息判断使用索引加回表更贵。",[18,14272,3181],{},[279,14274,14276],{"className":7797,"code":14275,"language":7799,"meta":285,"style":285},"SELECT *\nFROM orders\nWHERE remark LIKE '%manual%';\n",[25,14277,14278,14284,14290],{"__ignoreMap":285},[315,14279,14280,14282],{"class":317,"line":318},[315,14281,7483],{"class":325},[315,14283,9651],{"class":325},[315,14285,14286,14288],{"class":317,"line":343},[315,14287,9656],{"class":325},[315,14289,7981],{"class":333},[315,14291,14292,14294,14296,14298,14301],{"class":317,"line":359},[315,14293,7858],{"class":325},[315,14295,11592],{"class":333},[315,14297,9848],{"class":325},[315,14299,14300],{"class":329}," '%manual%'",[315,14302,7876],{"class":333},[18,14304,14305,14306,4224],{},"普通 B+ 树索引无法按照任意位置包含关系定位，执行计划很可能是 ",[25,14307,12951],{},[18,14309,14310,14311,14313],{},"但 ",[25,14312,12951],{}," 不等于必须立刻创建索引。",[18,14315,14316],{},"如果表只有几十行，或者查询本来就要读取 80% 的数据，全表扫描可能是合理选择。真正需要关注的是：",[245,14318,14319,14322,14327,14330,14333],{},[211,14320,14321],{},"表有多大；",[211,14323,14324,14326],{},[25,14325,12958],{}," 预计扫描多少行；",[211,14328,14329],{},"查询执行频率多高；",[211,14331,14332],{},"是否处于 JOIN 的内层并被重复扫描；",[211,14334,14335],{},"实际耗时和资源消耗是否不可接受。",[18,14337,14338,14339,14341],{},"特别是在 JOIN 中，如果前表返回一万行，而后表对每条前表记录都执行一次 ",[25,14340,12951],{},"，成本可能被放大得非常严重。",[237,14343,14345],{"id":14344},"_10-常见类型对比","10. 常见类型对比",[98,14347,14348,14368],{},[101,14349,14350],{},[104,14351,14352,14356,14359,14362,14365],{},[107,14353,14354],{},[25,14355,10437],{},[107,14357,14358],{},"核心含义",[107,14360,14361],{"align":7543},"是否精准定位",[107,14363,14364],{"align":7543},"可能读取的记录数",[107,14366,14367],{},"常见场景",[114,14369,14370,14388,14408,14428,14451,14469],{},[104,14371,14372,14376,14379,14382,14385],{},[119,14373,14374],{},[25,14375,13064],{},[119,14377,14378],{},"表中只有一行",[119,14380,14381],{"align":7543},"无需查找",[119,14383,14384],{"align":7543},"1 行",[119,14386,14387],{},"单行表",[104,14389,14390,14394,14397,14400,14403],{},[119,14391,14392],{},[25,14393,12593],{},[119,14395,14396],{},"通过常量匹配主键或唯一键",[119,14398,14399],{"align":7543},"是",[119,14401,14402],{"align":7543},"最多 1 行",[119,14404,14405],{},[25,14406,14407],{},"WHERE id=100",[104,14409,14410,14414,14417,14420,14423],{},[119,14411,14412],{},[25,14413,12943],{},[119,14415,14416],{},"通过普通索引做等值查找",[119,14418,14419],{"align":7543},"是，但结果不唯一",[119,14421,14422],{"align":7543},"1 行到大量记录",[119,14424,14425],{},[25,14426,14427],{},"WHERE status=1",[104,14429,14430,14434,14437,14440,14443],{},[119,14431,14432],{},[25,14433,12946],{},[119,14435,14436],{},"扫描一个或多个索引区间",[119,14438,14439],{"align":7543},"定位区间",[119,14441,14442],{"align":7543},"取决于范围大小",[119,14444,14445,5067,14447,5067,14449],{},[25,14446,7864],{},[25,14448,10938],{},[25,14450,337],{},[104,14452,14453,14457,14460,14463,14466],{},[119,14454,14455],{},[25,14456,11545],{},[119,14458,14459],{},"扫描整棵索引",[119,14461,14462],{"align":7543},"否",[119,14464,14465],{"align":7543},"通常为整个索引",[119,14467,14468],{},"覆盖索引全扫描、按索引顺序遍历",[104,14470,14471,14475,14478,14480,14483],{},[119,14472,14473],{},[25,14474,12951],{},[119,14476,14477],{},"扫描整张表",[119,14479,14462],{"align":7543},[119,14481,14482],{"align":7543},"通常为整张表",[119,14484,14485],{},"无可用索引或全表扫描更便宜",[18,14487,14488,14489,3382],{},"还应单独记住 JOIN 中的 ",[25,14490,13329],{},[56,14492,14493],{},[18,14494,14495],{},"对前表的每一条记录，通过当前表的主键或唯一非空索引最多匹配一行。",[237,14497,14499],{"id":14498},"_11-explain-与-explain-analyze-的区别","11. EXPLAIN 与 EXPLAIN ANALYZE 的区别",[18,14501,14502,14504,14505,3382],{},[25,14503,10426],{}," 只展示优化器计划如何执行 SQL，并不会真正执行普通 ",[25,14506,7483],{},[279,14508,14509],{"className":7797,"code":12855,"language":7799,"meta":285,"style":285},[25,14510,14511,14515,14521,14527],{"__ignoreMap":285},[315,14512,14513],{"class":317,"line":318},[315,14514,12862],{"class":333},[315,14516,14517,14519],{"class":317,"line":343},[315,14518,7483],{"class":325},[315,14520,9651],{"class":325},[315,14522,14523,14525],{"class":317,"line":359},[315,14524,9656],{"class":325},[315,14526,7981],{"class":333},[315,14528,14529,14531,14533,14535,14537],{"class":317,"line":375},[315,14530,7858],{"class":325},[315,14532,8618],{"class":333},[315,14534,2511],{"class":325},[315,14536,7867],{"class":839},[315,14538,7876],{"class":333},[18,14540,14541,14542,14545,14546,4224],{},"其中的 ",[25,14543,14544],{},"rows、filtered、cost"," 等主要来自统计信息和成本模型，是",[61,14547,14548],{},"估算值",[18,14550,14551,14553],{},[25,14552,10429],{}," 会真正执行查询，并在执行计划中同时展示估算值和实际运行数据：",[279,14555,14557],{"className":7797,"code":14556,"language":7799,"meta":285,"style":285},"EXPLAIN ANALYZE\nSELECT *\nFROM orders\nWHERE user_id = 100;\n",[25,14558,14559,14564,14570,14576],{"__ignoreMap":285},[315,14560,14561],{"class":317,"line":318},[315,14562,14563],{"class":333},"EXPLAIN ANALYZE\n",[315,14565,14566,14568],{"class":317,"line":343},[315,14567,7483],{"class":325},[315,14569,9651],{"class":325},[315,14571,14572,14574],{"class":317,"line":359},[315,14573,9656],{"class":325},[315,14575,7981],{"class":333},[315,14577,14578,14580,14582,14584,14586],{"class":317,"line":375},[315,14579,7858],{"class":325},[315,14581,8618],{"class":333},[315,14583,2511],{"class":325},[315,14585,7867],{"class":839},[315,14587,7876],{"class":333},[18,14589,14590],{},"典型输出片段：",[279,14592,14595],{"className":14593,"code":14594,"language":284,"meta":285},[282],"Index lookup on orders using idx_user_id\n (cost=10.2 rows=20)\n (actual time=0.08..0.15 rows=350 loops=1)\n",[25,14596,14594],{"__ignoreMap":285},[18,14598,14599],{},"可以重点对比：",[245,14601,14602,14608,14614,14620,14626],{},[211,14603,14604,14607],{},[25,14605,14606],{},"cost","：优化器估算成本；",[211,14609,14610,14611,14613],{},"前一个 ",[25,14612,12958],{},"：预计返回行数；",[211,14615,14616,14619],{},[25,14617,14618],{},"actual time","：实际首行时间和完成时间；",[211,14621,14622,14623,14625],{},"后一个 ",[25,14624,12958],{},"：每次循环实际返回行数；",[211,14627,14628,14631],{},[25,14629,14630],{},"loops","：该执行节点实际执行次数。",[18,14633,14634],{},"两者的核心区别：",[98,14636,14637,14651],{},[101,14638,14639],{},[104,14640,14641,14643,14647],{},[107,14642,2925],{},[107,14644,14645],{},[25,14646,10426],{},[107,14648,14649],{},[25,14650,10429],{},[114,14652,14653,14666,14677,14688,14699],{},[104,14654,14655,14658,14663],{},[119,14656,14657],{},"是否真正执行查询",[119,14659,7480,14660,14662],{},[25,14661,7483],{}," 不执行",[119,14664,14665],{},"会真实执行",[104,14667,14668,14671,14674],{},[119,14669,14670],{},"行数与成本",[119,14672,14673],{},"主要是估算值",[119,14675,14676],{},"同时提供估算与实际数据",[104,14678,14679,14682,14685],{},[119,14680,14681],{},"实际耗时",[119,14683,14684],{},"不提供",[119,14686,14687],{},"提供各执行节点耗时",[104,14689,14690,14693,14696],{},[119,14691,14692],{},"主要用途",[119,14694,14695],{},"上线前检查计划、低风险分析",[119,14697,14698],{},"验证估算偏差、定位真实瓶颈",[104,14700,14701,14704,14707],{},[119,14702,14703],{},"使用风险",[119,14705,14706],{},"较低",[119,14708,14709],{},"慢 SQL 会真实消耗资源",[18,14711,14712,14714],{},[25,14713,10429],{}," 能发现这类问题：",[279,14716,14719],{"className":14717,"code":14718,"language":284,"meta":285},[282],"优化器预计返回 20 行\n实际返回 350000 行\n",[25,14720,14718],{"__ignoreMap":285},[18,14722,14723],{},"这种巨大偏差可能与统计信息、数据倾斜、条件相关性或估算模型有关。",[18,14725,14726],{},"使用时必须注意：",[245,14728,14729,14732,14735,14738],{},[211,14730,14731],{},"它会真实执行查询，慢查询会真实占用 CPU、I\u002FO 和锁资源；",[211,14733,14734],{},"对复杂 SQL 应优先在测试或影子环境执行；",[211,14736,14737],{},"不要在生产高峰期随意分析可能扫描海量数据的语句；",[211,14739,14740],{},"对数据修改语句尤其谨慎，不能把它当成完全无副作用的静态分析工具。",[237,14742,14744,14745,14747],{"id":14743},"_12-不要只根据-type-判断性能","12. 不要只根据 ",[25,14746,10437],{}," 判断性能",[18,14749,14750],{},"下面两个计划：",[279,14752,14755],{"className":14753,"code":14754,"language":284,"meta":285},[282],"计划 A：type=ref，rows=500000\n计划 B：type=range，rows=20\n",[25,14756,14754],{"__ignoreMap":285},[18,14758,14759,14760,14762,14763,14765],{},"虽然官方列表中 ",[25,14761,12943],{}," 排在 ",[25,14764,12946],{}," 前面，但计划 B 很可能扫描更少、执行更快。",[18,14767,14768],{},"同理：",[279,14770,14773],{"className":14771,"code":14772,"language":284,"meta":285},[282],"计划 A：type=ALL，rows=30\n计划 B：type=ref，rows=100000\n",[25,14774,14772],{"__ignoreMap":285},[18,14776,14777],{},"对只有 30 行的小表执行全表扫描，不一定是问题。",[18,14779,14780],{},"因此，合理的判断方式是：",[279,14782,14785],{"className":14783,"code":14784,"language":284,"meta":285},[282],"type\n +\nkey \u002F key_len\n +\nrows \u002F filtered\n +\nExtra\n +\nEXPLAIN ANALYZE 的实际行数与耗时\n",[25,14786,14784],{"__ignoreMap":285},[18,14788,14789,14791],{},[25,14790,10437],{}," 是执行计划的重要入口，但不是最终结论。",[18,14793,14794],{},"几个常见误区：",[245,14796,14797,14802,14807,14812,14818,14823],{},[211,14798,14799,14801],{},[25,14800,10422],{}," 有值，不代表最终使用了索引；",[211,14803,14804,14806],{},[25,14805,10433],{}," 有值，不代表查询一定高效；",[211,14808,14809,14811],{},[25,14810,14104],{}," 通常表示全索引扫描，不等于范围定位；",[211,14813,14814,14817],{},[25,14815,14816],{},"type=ALL"," 是全表扫描，但小表全表扫描可能就是合理计划；",[211,14819,14820,14822],{},[25,14821,14083],{}," 通常表示覆盖索引，不等于“使用索引定位”；",[211,14824,14825],{},"预计扫描行数少，也可能因估算偏差与实际执行差异很大。",[14,14827,14829],{"id":14828},"十三排查顺序","十三、排查顺序",[18,14831,14832],{},"遇到“明明建了索引却很慢”，可以按下面顺序检查：",[208,14834,14835,14838,14841,14856,14859,14862,14865,14868,14874],{},[211,14836,14837],{},"确认慢 SQL、参数值和数据量，不能只拿脱离现场的 SQL 模板分析。",[211,14839,14840],{},"查看表结构、索引顺序、字段类型、字符集和排序规则。",[211,14842,787,14843,14845,14846,5067,14848,5067,14850,5067,14852,28,14854,4224],{},[25,14844,10426],{}," 检查 ",[25,14847,10433],{},[25,14849,10437],{},[25,14851,12958],{},[25,14853,12968],{},[25,14855,12787],{},[211,14857,14858],{},"检查联合索引是否满足最左前缀，范围条件之后是否只剩过滤能力。",[211,14860,14861],{},"检查索引列上是否存在函数、计算或隐式转换。",[211,14863,14864],{},"估算查询命中比例和回表次数，判断优化器放弃索引是否合理。",[211,14866,14867],{},"对比估算行数与实际行数，检查统计信息是否明显失真。",[211,14869,14870,14871,14873],{},"在可控环境中使用 ",[25,14872,10429],{}," 验证真实执行路径。",[211,14875,14876,14877,14879],{},"调整 SQL 或索引后，在可控环境中使用 ",[25,14878,10429],{}," 验证实际执行情况，并结合线上灰度后的查询耗时、扫描行数、回表量及资源指标持续观察，不能只看静态执行计划就宣布优化完成。只有涉及高并发、容量上限或锁竞争的场景，才需要进一步进行专项压测。",[14,14881,14883],{"id":14882},"十四常见错误结论","十四、常见错误结论",[237,14885,14887],{"id":14886},"_1-联合索引中间断了一列整个索引都失效","1. 联合索引中间断了一列，整个索引都失效",[18,14889,14890],{},"不准确。最左侧连续部分仍可能用于定位，后续列也可能通过 ICP 或覆盖索引发挥作用。",[237,14892,14894],{"id":14893},"_2-遇到范围查询后面的索引列完全没用","2. 遇到范围查询，后面的索引列完全没用",[18,14896,14897],{},"不准确。后续列通常不能继续缩小连续范围，但仍可能用于索引层过滤或覆盖查询。",[237,14899,5586,14901,5067,14903,5067,14905,14907],{"id":14900},"_3-not-inis-null-一定不走索引",[25,14902,4045],{},[25,14904,10406],{},[25,14906,12087],{}," 一定不走索引",[18,14909,14910],{},"不准确。是否选择索引取决于数据分布、命中比例、覆盖情况和优化器成本估算。",[237,14912,13326,14914,14916],{"id":14913},"_4-key-不为-null-就说明索引使用良好",[25,14915,10433],{}," 不为 NULL 就说明索引使用良好",[18,14918,14919],{},"不准确。可能扫描了大部分索引，也可能发生大量回表。",[237,14921,14923],{"id":14922},"_5-全表扫描一定比索引慢","5. 全表扫描一定比索引慢",[18,14925,14926],{},"不准确。小表或需要读取大部分数据时，顺序全表扫描可能是成本更低的方案。",[237,14928,14930,14931,14933],{"id":14929},"_6-使用-force-index-就能解决问题","6. 使用 ",[25,14932,12164],{}," 就能解决问题",[18,14935,14936],{},"不准确。强制索引可能暂时改变执行计划，也可能在数据分布变化后变得更慢。应先找到优化器不选择索引的真实原因。",[14,14938,14940],{"id":14939},"十五参考资料","十五、参考资料",[245,14942,14943,14950,14957,14964,14971,14978,14985,14992],{},[211,14944,14945],{},[70,14946,14949],{"href":14947,"rel":14948},"https:\u002F\u002Fdev.mysql.com\u002Fdoc\u002Frefman\u002F8.0\u002Fen\u002Fmysql-indexes.html",[1200],"MySQL 8.0 Reference Manual：How MySQL Uses Indexes",[211,14951,14952],{},[70,14953,14956],{"href":14954,"rel":14955},"https:\u002F\u002Fdev.mysql.com\u002Fdoc\u002Frefman\u002F8.0\u002Fen\u002Foptimization-indexes.html",[1200],"MySQL 8.0 Reference Manual：Optimization and Indexes",[211,14958,14959],{},[70,14960,14963],{"href":14961,"rel":14962},"https:\u002F\u002Fdev.mysql.com\u002Fdoc\u002Frefman\u002F8.0\u002Fen\u002Fexplain.html",[1200],"MySQL 8.0 Reference Manual：EXPLAIN Statement",[211,14965,14966],{},[70,14967,14970],{"href":14968,"rel":14969},"https:\u002F\u002Fdev.mysql.com\u002Fdoc\u002Frefman\u002F8.0\u002Fen\u002Findex-merge-optimization.html",[1200],"MySQL 8.0 Reference Manual：Index Merge Optimization",[211,14972,14973],{},[70,14974,14977],{"href":14975,"rel":14976},"https:\u002F\u002Fdev.mysql.com\u002Fdoc\u002Frefman\u002F8.0\u002Fen\u002Findex-condition-pushdown-optimization.html",[1200],"MySQL 8.0 Reference Manual：Index Condition Pushdown Optimization",[211,14979,14980],{},[70,14981,14984],{"href":14982,"rel":14983},"https:\u002F\u002Fdev.mysql.com\u002Fdoc\u002Frefman\u002F8.0\u002Fen\u002Forder-by-optimization.html",[1200],"MySQL 8.0 Reference Manual：ORDER BY Optimization",[211,14986,14987],{},[70,14988,14991],{"href":14989,"rel":14990},"https:\u002F\u002Fdev.mysql.com\u002Fdoc\u002Frefman\u002F8.0\u002Fen\u002Fcreate-index.html",[1200],"MySQL 8.0 Reference Manual：CREATE INDEX Statement",[211,14993,14994],{},[70,14995,14998],{"href":14996,"rel":14997},"https:\u002F\u002Fdev.mysql.com\u002Fdoc\u002Frefman\u002F8.0\u002Fen\u002Fgenerated-column-index-optimizations.html",[1200],"MySQL 8.0 Reference Manual：Optimizer Use of Generated Column Indexes",[1224,15000,15001],{},"html pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}",{"title":285,"searchDepth":343,"depth":343,"links":15003},[15004,15007,15008,15009,15014,15015,15016,15017,15018,15019,15025,15026,15027,15032,15033,15056,15057,15068],{"id":16,"depth":343,"text":16,"children":15005},[15006],{"id":7495,"depth":359,"text":7495},{"id":66,"depth":343,"text":66},{"id":83,"depth":343,"text":83},{"id":10461,"depth":343,"text":10462,"children":15010},[15011,15012,15013],{"id":10468,"depth":359,"text":10469},{"id":10528,"depth":359,"text":10529},{"id":10632,"depth":359,"text":10633},{"id":10651,"depth":343,"text":10652},{"id":10843,"depth":343,"text":10844},{"id":10945,"depth":343,"text":10946},{"id":11337,"depth":343,"text":11338},{"id":11442,"depth":343,"text":11443},{"id":11549,"depth":343,"text":11550,"children":15020},[15021,15022,15024],{"id":11637,"depth":359,"text":11638},{"id":11804,"depth":359,"text":15023},"Using sort_union(...) 是什么意思",{"id":11935,"depth":359,"text":11936},{"id":12008,"depth":343,"text":12009},{"id":12091,"depth":343,"text":12092},{"id":12168,"depth":343,"text":12169,"children":15028},[15029,15030,15031],{"id":12287,"depth":359,"text":12287},{"id":12493,"depth":359,"text":12493},{"id":12630,"depth":359,"text":12630},{"id":12799,"depth":343,"text":12800},{"id":12848,"depth":343,"text":12849,"children":15034},[15035,15037,15039,15041,15043,15045,15047,15048,15050,15052,15053,15054],{"id":12983,"depth":359,"text":15036},"1. type 到底表示什么",{"id":13060,"depth":359,"text":15038},"2. system：表中只有一行",{"id":13091,"depth":359,"text":15040},"3. const：通过主键或唯一键最多定位一行",{"id":13325,"depth":359,"text":15042},"4. eq_ref：JOIN 时每条前表记录最多匹配一行",{"id":13526,"depth":359,"text":15044},"5. ref：通过非唯一索引等值查找一组记录",{"id":13701,"depth":359,"text":15046},"6. range：扫描索引中的一个或多个区间",{"id":13947,"depth":359,"text":13948},{"id":14089,"depth":359,"text":15049},"8. index：把整棵索引扫描一遍",{"id":14228,"depth":359,"text":15051},"9. ALL：扫描整张表",{"id":14344,"depth":359,"text":14345},{"id":14498,"depth":359,"text":14499},{"id":14743,"depth":359,"text":15055},"12. 不要只根据 type 判断性能",{"id":14828,"depth":343,"text":14829},{"id":14882,"depth":343,"text":14883,"children":15058},[15059,15060,15061,15063,15065,15066],{"id":14886,"depth":359,"text":14887},{"id":14893,"depth":359,"text":14894},{"id":14900,"depth":359,"text":15062},"3. !=、NOT IN、IS NULL 一定不走索引",{"id":14913,"depth":359,"text":15064},"4. key 不为 NULL 就说明索引使用良好",{"id":14922,"depth":359,"text":14923},{"id":14929,"depth":359,"text":15067},"6. 使用 FORCE INDEX 就能解决问题",{"id":14939,"depth":343,"text":14940},"wiki:java:mysql-index-failure-scenarios","从联合索引、函数运算、隐式转换、LIKE、OR、选择性和优化器成本等角度，系统解释 MySQL 索引无法使用、部分使用及主动放弃索引的常见场景。",{},77,"\u002Fjava\u002Fmysql-index-failure-scenarios",{"title":10330,"description":15070},"java\u002Fmysql-index-failure-scenarios","Z4hbUCudKpBrIxf2AeaWFne0fjdxJ0cTwR0Q_5IRNh0",{"id":15078,"title":15079,"body":15080,"commentId":16265,"description":16266,"difficulty":3724,"draft":1277,"extension":1278,"meta":16267,"navigation":1280,"order":16268,"path":16269,"section":1283,"seo":16270,"stem":16271,"updated":16272,"__hash__":16273},"java\u002Fjava\u002Frocketmq-message-types-and-use-cases.md","RocketMQ 都有哪些消息类型？使用场景是什么？",{"type":7,"value":15081,"toc":16210},[15082,15085,15087,15090,15116,15119,15121,15128,15130,15139,15141,15145,15148,15216,15219,15222,15236,15239,15243,15247,15250,15256,15259,15262,15267,15271,15274,15297,15300,15306,15309,15313,15316,15327,15330,15334,15338,15341,15344,15350,15353,15359,15369,15373,15376,15379,15385,15388,15392,15395,15398,15401,15404,15407,15410,15413,15419,15423,15443,15447,15450,15453,15470,15473,15477,15481,15484,15490,15493,15540,15544,15550,15553,15557,15580,15583,15589,15592,15596,15603,15620,15623,15627,15630,15636,15643,15646,15650,15654,15657,15662,15665,15673,15676,15682,15686,15692,15695,15701,15704,15707,15724,15728,15731,15733,15739,15742,15759,15762,15766,15769,15775,15778,15838,15841,15845,15849,15852,15858,15861,15875,15879,15882,15885,15891,15897,15910,15913,15917,15920,15923,15940,15944,15947,15953,15965,15969,15972,15978,15981,15985,15988,15994,15997,16031,16034,16037,16056,16059,16073,16076,16080,16084,16087,16091,16094,16098,16101,16105,16108,16112,16115,16119,16123,16126,16130,16133,16137,16140,16144,16147,16151,16154,16156,16207],[10,15083,15079],{"id":15084},"rocketmq-都有哪些消息类型使用场景是什么",[14,15086,16],{"id":16},[18,15088,15089],{},"RocketMQ 5.x 按消息的传输语义正式分为四种类型：",[208,15091,15092,15098,15104,15110],{},[211,15093,15094,15097],{},[61,15095,15096],{},"普通消息 Normal","：没有顺序、定时或事务等特殊语义，发送成功后即可被消费，适合微服务解耦、异步通知、日志和数据集成。",[211,15099,15100,15103],{},[61,15101,15102],{},"顺序消息 FIFO","：同一 Message Group 内的消息按照发送、存储和投递顺序处理，适合同一订单的创建、支付、发货等状态流转，以及 Binlog 增量同步。",[211,15105,15106,15109],{},[61,15107,15108],{},"定时与延时消息 Delay","：消息到指定时间后才对消费者可见，适合订单超时关闭、延迟检查、定时通知和任务调度。",[211,15111,15112,15115],{},[61,15113,15114],{},"事务消息 Transaction","：通过半事务消息、本地事务确认和事务回查，保证本地事务与消息发送的最终一致性，适合下单后发放积分、扣款后发送通知等场景。",[18,15117,15118],{},"RocketMQ 5.x 可以为 Topic 声明消息类型，一个 Topic 只应承载一种消息类型。批量消息属于发送方式，重试消息和死信消息属于消费失败后的系统处理状态，Request-Reply 属于通信模式，它们都不属于上述四种正式 MessageType。",[18,15120,54],{},[56,15122,15123],{},[18,15124,15125],{},[61,15126,15127],{},"无特殊要求用普通消息；同一业务实体需要按序处理用 FIFO；需要未来触发用 Delay；本地事务必须和消息发送保持最终一致用 Transaction。",[14,15129,66],{"id":66},[18,15131,15132],{},[70,15133,15136],{"href":15134,"target":73,"rel":15135},"\u002Fimages\u002Fwiki\u002Fjava\u002Frocketmq-message-types-and-use-cases.svg",[75,76],[78,15137],{"src":15134,"alt":15138},"RocketMQ 四种消息类型、核心语义、典型场景及选择方法",[14,15140,83],{"id":83},[14,15142,15144],{"id":15143},"一先明确-rocketmq-的正式分类","一、先明确 RocketMQ 的正式分类",[18,15146,15147],{},"RocketMQ 5.x 定义了四种 MessageType：",[98,15149,15150,15162],{},[101,15151,15152],{},[104,15153,15154,15157,15160],{},[107,15155,15156],{},"消息类型",[107,15158,15159],{},"核心语义",[107,15161,13493],{},[114,15163,15164,15177,15190,15203],{},[104,15165,15166,15171,15174],{},[119,15167,15168],{},[25,15169,15170],{},"NORMAL",[119,15172,15173],{},"发送后立即进入可消费状态",[119,15175,15176],{},"异步解耦、事件通知、日志传输",[104,15178,15179,15184,15187],{},[119,15180,15181],{},[25,15182,15183],{},"FIFO",[119,15185,15186],{},"同一 Message Group 内按顺序处理",[119,15188,15189],{},"订单状态流转、Binlog 同步",[104,15191,15192,15197,15200],{},[119,15193,15194],{},[25,15195,15196],{},"DELAY",[119,15198,15199],{},"到指定时间后才允许消费",[119,15201,15202],{},"超时关闭、延迟检查、定时任务",[104,15204,15205,15210,15213],{},[119,15206,15207],{},[25,15208,15209],{},"TRANSACTION",[119,15211,15212],{},"本地事务与消息发送最终一致",[119,15214,15215],{},"交易完成后驱动下游业务",[18,15217,15218],{},"这四种类型不是按照消息内容划分，而是按照消息需要具备的传输和投递语义划分。",[18,15220,15221],{},"例如，同样是“订单创建”事件：",[245,15223,15224,15227,15230,15233],{},[211,15225,15226],{},"创建后立即异步通知风控，可以使用普通消息；",[211,15228,15229],{},"必须与后续支付、发货事件保持同一订单内的顺序，可以使用顺序消息；",[211,15231,15232],{},"创建三十分钟后检查是否支付，可以使用延时消息；",[211,15234,15235],{},"只有订单数据库事务成功后才能向下游投递，可以使用事务消息。",[18,15237,15238],{},"因此，消息类型的选择取决于业务语义，而不是消息中装了什么数据。",[14,15240,15242],{"id":15241},"二普通消息-normal","二、普通消息 Normal",[237,15244,15246],{"id":15245},"_1-什么是普通消息","1. 什么是普通消息",[18,15248,15249],{},"普通消息没有顺序、定时和事务等特殊语义。Broker 接收并保存消息后，消息进入 Ready 状态，Consumer 可以正常获取并处理。",[279,15251,15254],{"className":15252,"code":15253,"language":284,"meta":285},[282],"Producer\n │ 发送\n ▼\nBroker 持久化\n │ 立即可见\n ▼\nConsumer 消费\n",[25,15255,15253],{"__ignoreMap":285},[18,15257,15258],{},"“普通”不代表不可靠。普通消息同样可以使用发送确认、Broker 持久化、消费重试、死信队列和业务幂等机制。",[18,15260,15261],{},"它只表示：",[56,15263,15264],{},[18,15265,15266],{},"消息之间没有需要 RocketMQ 额外维护的顺序、时间或事务关系。",[237,15268,15270],{"id":15269},"_2-适用场景","2. 适用场景",[18,15272,15273],{},"普通消息适合绝大多数异步业务：",[245,15275,15276,15279,15282,15285,15288,15291,15294],{},[211,15277,15278],{},"微服务之间异步解耦；",[211,15280,15281],{},"用户注册后异步发送欢迎短信；",[211,15283,15284],{},"订单创建后异步更新搜索索引；",[211,15286,15287],{},"操作日志、埋点和审计事件传输；",[211,15289,15290],{},"缓存失效通知；",[211,15292,15293],{},"数据采集和数据集成；",[211,15295,15296],{},"不要求严格顺序的业务事件广播。",[18,15298,15299],{},"例如，订单创建后需要通知多个独立系统：",[279,15301,15304],{"className":15302,"code":15303,"language":284,"meta":285},[282],"订单服务\n │\n └── OrderCreated 普通消息\n ├── 风控服务\n ├── 推荐服务\n └── 数据分析服务\n",[25,15305,15303],{"__ignoreMap":285},[18,15307,15308],{},"这些下游之间不存在必须先后执行的关系，使用普通消息能够获得更好的并发能力。",[237,15310,15312],{"id":15311},"_3-不适合的场景","3. 不适合的场景",[18,15314,15315],{},"以下要求不能只依赖普通消息：",[245,15317,15318,15321,15324],{},[211,15319,15320],{},"同一订单的支付必须在创建之后处理；",[211,15322,15323],{},"消息必须在未来某个时间触发；",[211,15325,15326],{},"本地数据库事务失败时消息绝对不能对下游可见。",[18,15328,15329],{},"这时应分别考虑 FIFO、Delay 或 Transaction。",[14,15331,15333],{"id":15332},"三顺序消息-fifo","三、顺序消息 FIFO",[237,15335,15337],{"id":15336},"_1-顺序消息保证什么","1. 顺序消息保证什么",[18,15339,15340],{},"RocketMQ 5.x 使用 Message Group 标识需要保持顺序的一组消息。同一个 Message Group 中的消息按照先进先出顺序处理。",[18,15342,15343],{},"例如以订单号作为 Message Group：",[279,15345,15348],{"className":15346,"code":15347,"language":284,"meta":285},[282],"Message Group = order-1001\n\n创建订单 → 支付成功 → 仓库出库 → 物流发货\n",[25,15349,15347],{"__ignoreMap":285},[18,15351,15352],{},"另一个订单可以使用不同的 Message Group：",[279,15354,15357],{"className":15355,"code":15356,"language":284,"meta":285},[282],"order-1001：创建 → 支付 → 发货\norder-1002：创建 → 取消\n",[25,15358,15356],{"__ignoreMap":285},[18,15360,15361,15362,15365,15366,4224],{},"两个订单之间不要求顺序，可以并发处理；同一订单内部保持顺序。这通常称为",[61,15363,15364],{},"局部顺序","或",[61,15367,15368],{},"分组顺序",[237,15370,15372],{"id":15371},"_2-为什么不追求整个-topic-的全局顺序","2. 为什么不追求整个 Topic 的全局顺序",[18,15374,15375],{},"如果一个 Topic 的全部消息都要求全局顺序，就只能把所有消息串行发送、存储和消费，并发能力会受到严重限制。",[18,15377,15378],{},"按订单号、用户 ID、账户 ID 等业务键划分 Message Group，可以做到：",[279,15380,15383],{"className":15381,"code":15382,"language":284,"meta":285},[282],"组内有序\n+\n组间并行\n",[25,15384,15382],{"__ignoreMap":285},[18,15386,15387],{},"这更符合大多数业务的真实要求。",[237,15389,15391],{"id":15390},"_3-保证顺序需要满足哪些条件","3. 保证顺序需要满足哪些条件",[18,15393,15394],{},"完整的顺序需要覆盖三个阶段。",[5611,15396,15397],{"id":15397},"发送顺序",[18,15399,15400],{},"同一 Message Group 的消息需要由生产端按业务顺序串行发送。如果多个线程或多个生产者同时发送，即使 Message Group 相同，RocketMQ 也无法推断业务上谁应该在前。",[5611,15402,15403],{"id":15403},"存储顺序",[18,15405,15406],{},"RocketMQ 将同一 Message Group 的消息存入同一个队列，并保持接收顺序。",[5611,15408,15409],{"id":15409},"消费顺序",[18,15411,15412],{},"Consumer 必须遵循“接收、处理、确认”的顺序。不能收到消息后随意提交给异步线程并立即确认，否则业务实际完成顺序仍可能被打乱。",[279,15414,15417],{"className":15415,"code":15416,"language":284,"meta":285},[282],"发送有序\n ↓\n存储有序\n ↓\n投递有序\n ↓\n业务处理有序\n",[25,15418,15416],{"__ignoreMap":285},[237,15420,15422],{"id":15421},"_4-适用场景","4. 适用场景",[245,15424,15425,15428,15431,15434,15437,15440],{},[211,15426,15427],{},"同一订单的创建、支付、取消和发货；",[211,15429,15430],{},"同一账户的充值、扣款和退款；",[211,15432,15433],{},"同一用户的状态变更；",[211,15435,15436],{},"数据库 Binlog 增量同步；",[211,15438,15439],{},"工作流节点推进；",[211,15441,15442],{},"交易撮合等要求按到达顺序处理的场景。",[237,15444,15446],{"id":15445},"_5-使用代价与风险","5. 使用代价与风险",[18,15448,15449],{},"顺序消息会牺牲部分并发能力，并且前面的消息处理失败时，后续消息可能等待。",[18,15451,15452],{},"需要重点关注：",[245,15454,15455,15458,15461,15464,15467],{},[211,15456,15457],{},"Message Group 是否过热；",[211,15459,15460],{},"单条消息是否持续重试并阻塞后续消息；",[211,15462,15463],{},"消费逻辑是否包含慢 SQL、慢 RPC；",[211,15465,15466],{},"是否错误地在消费端进行异步并发处理；",[211,15468,15469],{},"是否真的需要顺序，还是使用状态机和幂等就能解决。",[18,15471,15472],{},"不要把所有消息都设置为同一个 Message Group，否则会把系统退化成串行消费。",[14,15474,15476],{"id":15475},"四定时与延时消息-delay","四、定时与延时消息 Delay",[237,15478,15480],{"id":15479},"_1-定时消息和延时消息有什么区别","1. 定时消息和延时消息有什么区别",[18,15482,15483],{},"业务表达方式不同，但在 RocketMQ 5.x 中本质相同：都是设置一个未来的投递时间戳。",[279,15485,15488],{"className":15486,"code":15487,"language":284,"meta":285},[282],"延时消息：10 分钟后投递\n定时消息：2026-07-26 18:00:00 投递\n",[25,15489,15487],{"__ignoreMap":285},[18,15491,15492],{},"延时消息也需要先计算出最终投递时间：",[279,15494,15496],{"className":2173,"code":15495,"language":2175,"meta":285,"style":285},"long deliveryTimestamp =\n System.currentTimeMillis() + Duration.ofMinutes(10).toMillis();\n",[25,15497,15498,15509],{"__ignoreMap":285},[315,15499,15500,15503,15506],{"class":317,"line":318},[315,15501,15502],{"class":325},"long",[315,15504,15505],{"class":333}," deliveryTimestamp ",[315,15507,15508],{"class":325},"=\n",[315,15510,15511,15514,15517,15520,15522,15525,15528,15530,15532,15535,15538],{"class":317,"line":343},[315,15512,15513],{"class":333}," System.",[315,15515,15516],{"class":321},"currentTimeMillis",[315,15518,15519],{"class":333},"() ",[315,15521,11072],{"class":325},[315,15523,15524],{"class":333}," Duration.",[315,15526,15527],{"class":321},"ofMinutes",[315,15529,4349],{"class":333},[315,15531,1590],{"class":839},[315,15533,15534],{"class":333},").",[315,15536,15537],{"class":321},"toMillis",[315,15539,2520],{"class":333},[237,15541,15543],{"id":15542},"_2-消息生命周期","2. 消息生命周期",[279,15545,15548],{"className":15546,"code":15547,"language":284,"meta":285},[282],"Producer 发送\n ↓\nTiming：Broker 按时间暂存\n ↓ 到达投递时间\nReady：转入普通存储并对 Consumer 可见\n ↓\nConsumer 消费并确认\n",[25,15549,15547],{"__ignoreMap":285},[18,15551,15552],{},"消息到达 Broker 并不代表 Consumer 立即可见。只有达到投递时间，消息才进入可以消费的状态。",[237,15554,15556],{"id":15555},"_3-适用场景","3. 适用场景",[245,15558,15559,15562,15565,15568,15571,15574,15577],{},[211,15560,15561],{},"订单创建三十分钟后检查是否支付；",[211,15563,15564],{},"支付处理中，五分钟后查询渠道结果；",[211,15566,15567],{},"优惠券到期提醒；",[211,15569,15570],{},"用户预约通知；",[211,15572,15573],{},"延迟重试；",[211,15575,15576],{},"定时清理任务；",[211,15578,15579],{},"分布式定时调度。",[18,15581,15582],{},"例如订单超时关闭：",[279,15584,15587],{"className":15585,"code":15586,"language":284,"meta":285},[282],"创建订单\n │\n ├── 写入订单数据\n └── 发送 30 分钟后投递的 Delay 消息\n ↓\n Consumer 查询订单状态\n ├── 未支付：关闭订单\n └── 已支付：忽略消息\n",[25,15588,15586],{"__ignoreMap":285},[18,15590,15591],{},"Consumer 收到延时消息后仍然必须重新检查业务状态。消息表达的是“现在应该检查”，不是“订单一定未支付”。",[237,15593,15595],{"id":15594},"_4-延时消息不是精确定时器","4. 延时消息不是精确定时器",[18,15597,15598,15599,15602],{},"设置的时间表示消息",[61,15600,15601],{},"不应早于该时间被消费","，但以下因素可能使实际处理晚于目标时间：",[245,15604,15605,15608,15611,15614,15617],{},[211,15606,15607],{},"Broker 当前负载较高；",[211,15609,15610],{},"大量消息设置了相同投递时间；",[211,15612,15613],{},"消费端发生积压；",[211,15615,15616],{},"Consumer 执行较慢或暂时不可用；",[211,15618,15619],{},"存储系统故障或重启。",[18,15621,15622],{},"因此，对秒级严格准点有强要求的业务不能只依赖消息到达时间，还要监控投递延迟并准备补偿扫描。",[237,15624,15626],{"id":15625},"_5-rocketmq-4x-与-5x-的区别","5. RocketMQ 4.x 与 5.x 的区别",[18,15628,15629],{},"RocketMQ 4.x 常见实现使用固定的延迟级别，例如：",[279,15631,15634],{"className":15632,"code":15633,"language":284,"meta":285},[282],"1 秒、5 秒、10 秒、30 秒、1 分钟……\n",[25,15635,15633],{"__ignoreMap":285},[18,15637,15638,15639,15642],{},"生产者通过 ",[25,15640,15641],{},"delayTimeLevel"," 选择预设级别。",[18,15644,15645],{},"RocketMQ 5.x 的正式 Delay 消息使用毫秒级 Unix 时间戳表示投递时间，不再局限于旧版固定延迟级别。面试时需要先说明讨论的是哪个版本，避免把 4.x 的十八个延迟级别直接当作 5.x 的唯一实现。",[14,15647,15649],{"id":15648},"五事务消息-transaction","五、事务消息 Transaction",[237,15651,15653],{"id":15652},"_1-事务消息解决什么问题","1. 事务消息解决什么问题",[18,15655,15656],{},"事务消息解决的是：",[56,15658,15659],{},[18,15660,15661],{},"本地事务与消息发送之间的最终一致性。",[18,15663,15664],{},"例如订单服务需要同时完成：",[208,15666,15667,15670],{},[211,15668,15669],{},"在本地数据库创建订单；",[211,15671,15672],{},"向 RocketMQ 发送订单创建消息。",[18,15674,15675],{},"如果先提交数据库再发送消息，数据库成功后消息可能发送失败；如果先发送消息再写数据库，消息可能已被消费，但数据库事务最终失败。",[279,15677,15680],{"className":15678,"code":15679,"language":284,"meta":285},[282],"数据库事务成功，消息失败 → 下游永远不知道订单已创建\n消息发送成功，数据库失败 → 下游处理了一笔不存在的订单\n",[25,15681,15679],{"__ignoreMap":285},[237,15683,15685],{"id":15684},"_2-核心流程","2. 核心流程",[279,15687,15690],{"className":15688,"code":15689,"language":284,"meta":285},[282],"Producer 发送 Half Message\n ↓\nBroker 保存消息，但暂不向 Consumer 投递\n ↓\nProducer 执行本地事务\n ┌───┴────────┐\n │ │\n Commit Rollback\n │ │\n消息可见并投递 消息回滚\n",[25,15691,15689],{"__ignoreMap":285},[18,15693,15694],{},"如果 Broker 长时间没有收到明确结果，会回查 Producer：",[279,15696,15699],{"className":15697,"code":15698,"language":284,"meta":285},[282],"Broker 发起事务回查\n ↓\nProducer 查询本地事务记录\n ┌────┼─────┐\n Commit Unknown Rollback\n",[25,15700,15698],{"__ignoreMap":285},[18,15702,15703],{},"Producer 的事务回查不能只依赖内存变量，需要根据订单表、事务日志或本地 Outbox 等持久化数据判断。",[237,15705,15556],{"id":15706},"_3-适用场景-1",[245,15708,15709,15712,15715,15718,15721],{},[211,15710,15711],{},"订单创建成功后通知库存、积分系统；",[211,15713,15714],{},"扣款成功后发送账务事件；",[211,15716,15717],{},"账户入账成功后通知下游；",[211,15719,15720],{},"数据库状态变化后更新搜索索引；",[211,15722,15723],{},"本地事务成功后驱动跨服务异步流程。",[237,15725,15727],{"id":15726},"_4-事务消息不保证什么","4. 事务消息不保证什么",[18,15729,15730],{},"事务消息保证的是本地事务与消息是否投递之间的最终一致性，不等于整个分布式业务已经成功。",[18,15732,3181],{},[279,15734,15737],{"className":15735,"code":15736,"language":284,"meta":285},[282],"订单本地事务成功\n ↓\n事务消息 Commit\n ↓\n积分服务消费失败\n",[25,15738,15736],{"__ignoreMap":285},[18,15740,15741],{},"RocketMQ 可以重试投递，但积分服务仍需实现：",[245,15743,15744,15747,15750,15753,15756],{},[211,15745,15746],{},"消费幂等；",[211,15748,15749],{},"失败重试；",[211,15751,15752],{},"死信处理；",[211,15754,15755],{},"对账与补偿；",[211,15757,15758],{},"业务状态机。",[18,15760,15761],{},"事务消息也不是跨多个数据库的强一致分布式事务。它更适合能够接受异步执行和最终一致性的业务。",[14,15763,15765],{"id":15764},"六四种消息类型如何选择","六、四种消息类型如何选择",[18,15767,15768],{},"可以按照下面的顺序判断：",[279,15770,15773],{"className":15771,"code":15772,"language":284,"meta":285},[282],"本地事务是否必须与消息发送保持最终一致？\n ├── 是 → Transaction\n └── 否\n ↓\n消息是否需要到未来某个时间才可消费？\n ├── 是 → Delay\n └── 否\n ↓\n同一业务实体的事件是否必须按顺序处理？\n ├── 是 → FIFO\n └── 否 → Normal\n",[25,15774,15772],{"__ignoreMap":285},[18,15776,15777],{},"对应关系：",[98,15779,15780,15793],{},[101,15781,15782],{},[104,15783,15784,15787,15790],{},[107,15785,15786],{},"业务要求",[107,15788,15789],{},"推荐类型",[107,15791,15792],{},"关键设计点",[114,15794,15795,15806,15816,15827],{},[104,15796,15797,15800,15803],{},[119,15798,15799],{},"只需要可靠异步传输",[119,15801,15802],{},"Normal",[119,15804,15805],{},"重试、幂等、监控",[104,15807,15808,15811,15813],{},[119,15809,15810],{},"同一订单内有先后关系",[119,15812,15183],{},[119,15814,15815],{},"Message Group、串行处理",[104,15817,15818,15821,15824],{},[119,15819,15820],{},"未来某个时间触发",[119,15822,15823],{},"Delay",[119,15825,15826],{},"投递时间、状态复查、延迟监控",[104,15828,15829,15832,15835],{},[119,15830,15831],{},"本地事务成功后才能投递",[119,15833,15834],{},"Transaction",[119,15836,15837],{},"Half Message、事务回查、持久化事务状态",[18,15839,15840],{},"不要因为高级消息类型“功能更多”就默认使用。每种特殊语义都会增加约束、运维成本或吞吐损耗；没有特殊要求时，普通消息通常是更简单的选择。",[14,15842,15844],{"id":15843},"七这些算不算消息类型","七、这些算不算消息类型",[237,15846,15848],{"id":15847},"_1-批量消息","1. 批量消息",[18,15850,15851],{},"批量消息不是独立 MessageType，而是一种发送或消费方式。",[279,15853,15856],{"className":15854,"code":15855,"language":284,"meta":285},[282],"单条发送：一次请求发送一条消息\n批量发送：一次请求携带多条消息\n",[25,15857,15855],{"__ignoreMap":285},[18,15859,15860],{},"批量能够减少网络往返和请求开销，适合日志采集、数据同步等吞吐优先的场景，但需要注意：",[245,15862,15863,15866,15869,15872],{},[211,15864,15865],{},"控制整个批次的大小；",[211,15867,15868],{},"批次失败后的重试粒度；",[211,15870,15871],{},"顺序消息不应随意并行批处理；",[211,15873,15874],{},"批量消费部分成功时的幂等和重试问题。",[237,15876,15878],{"id":15877},"_2-重试消息","2. 重试消息",[18,15880,15881],{},"重试消息是普通消息、FIFO 消息等消费失败后，RocketMQ 根据消费重试策略重新投递形成的系统处理过程，不是业务创建 Topic 时选择的正式 MessageType。",[18,15883,15884],{},"对于 PushConsumer，一次消费及失败重试可以简化为：",[279,15886,15889],{"className":15887,"code":15888,"language":284,"meta":285},[282],"Ready\n ↓ Consumer 获取消息\nInflight\n ├─ 消费成功并返回结果 → Commit\n └─ 消费失败或等待结果超时 → WaitingRetry\n ├─ 到达重试时间 → Ready\n └─ 超过最大重试次数 → DLQ\n",[25,15890,15888],{"__ignoreMap":285},[18,15892,15893,15896],{},[25,15894,15895],{},"Inflight"," 表示消息已经被 Consumer 获取，Consumer 正在执行业务逻辑，但消费结果还没有返回给 Broker。它可以理解为“正在处理中、等待确认”，不是一种新的消息类型。",[18,15898,15899,15902,15903,15905,15906,15909],{},[25,15900,15901],{},"WaitingRetry"," 是 PushConsumer 重试状态机中的状态。消息消费失败或 Broker 等待消费结果超时后，如果尚未达到最大重试次数，消息会先进入 ",[25,15904,15901],{},"；重试间隔结束后重新回到 ",[25,15907,15908],{},"Ready","，等待下一次投递。",[18,15911,15912],{},"Consumer 必须按消息可能重复投递来设计幂等。",[237,15914,15916],{"id":15915},"_3-死信消息","3. 死信消息",[18,15918,15919],{},"消息超过最大消费重试次数后，可能进入死信队列。死信消息代表消息进入异常隔离状态，也不是四种正式业务 MessageType 之一。",[18,15921,15922],{},"死信队列需要配套：",[245,15924,15925,15928,15931,15934,15937],{},[211,15926,15927],{},"告警；",[211,15929,15930],{},"失败原因记录；",[211,15932,15933],{},"人工检查；",[211,15935,15936],{},"修复后的重投；",[211,15938,15939],{},"对账和业务补偿。",[237,15941,15943],{"id":15942},"_4-request-reply-消息","4. Request-Reply 消息",[18,15945,15946],{},"Request-Reply 是一种通信模式：",[279,15948,15951],{"className":15949,"code":15950,"language":284,"meta":285},[282],"请求方发送消息\n ↓\n处理方消费并返回响应\n ↓\n请求方等待响应\n",[25,15952,15950],{"__ignoreMap":285},[18,15954,15955,15956,5067,15958,5067,15960,5067,15962,15964],{},"它描述生产者和消费者如何交互，不属于 ",[25,15957,15170],{},[25,15959,15183],{},[25,15961,15196],{},[25,15963,15209],{}," 之外的第五种正式 MessageType。",[237,15966,15968],{"id":15967},"_5-同步异步和单向消息","5. 同步、异步和单向消息",[18,15970,15971],{},"同步发送、异步发送和单向发送描述的是 Producer 调用发送接口的方式，也不是消息类型。",[279,15973,15976],{"className":15974,"code":15975,"language":284,"meta":285},[282],"同步发送：等待 Broker 返回结果\n异步发送：通过回调接收结果\n单向发送：发送后不等待结果\n",[25,15977,15975],{"__ignoreMap":285},[18,15979,15980],{},"不要把“发送方式”和“消息传输语义”混为一谈。",[14,15982,15984],{"id":15983},"八rocketmq-5x-为什么要求-topic-类型一致","八、RocketMQ 5.x 为什么要求 Topic 类型一致",[18,15986,15987],{},"RocketMQ 5.x 支持在 Topic 上声明消息类型：",[279,15989,15992],{"className":15990,"code":15991,"language":284,"meta":285},[282],".\u002Fbin\u002Fmqadmin updateTopic \\\n -n 127.0.0.1:9876 \\\n -t order-events \\\n -c DefaultCluster \\\n -a \"+message.type=FIFO\"\n",[25,15993,15991],{"__ignoreMap":285},[18,15995,15996],{},"其中：",[245,15998,15999,16005,16011,16017],{},[211,16000,16001,16004],{},[25,16002,16003],{},"-n"," 指定 NameServer 地址；",[211,16006,16007,16010],{},[25,16008,16009],{},"-t"," 指定 Topic 名称；",[211,16012,16013,16016],{},[25,16014,16015],{},"-c"," 指定目标集群；",[211,16018,16019,16022,16023,5067,16025,5067,16027,5414,16029,4224],{},[25,16020,16021],{},"message.type"," 可设置为 ",[25,16024,15170],{},[25,16026,15183],{},[25,16028,15196],{},[25,16030,15209],{},[18,16032,16033],{},"上面创建的是 FIFO Topic。创建其他类型时，只需要替换最后一个参数的类型值。",[18,16035,16036],{},"启用类型校验后，一个 Topic 只允许发送与其类型一致的消息。例如：",[245,16038,16039,16047,16053],{},[211,16040,16041,16043,16044,16046],{},[25,16042,15183],{}," 消息不能发送到 ",[25,16045,15170],{}," Topic；",[211,16048,16049,16043,16051,16046],{},[25,16050,15209],{},[25,16052,15196],{},[211,16054,16055],{},"同一个 Topic 不应同时承载普通消息和顺序消息。",[18,16057,16058],{},"这样做的价值是：",[245,16060,16061,16064,16067,16070],{},[211,16062,16063],{},"让 Topic 的行为语义清晰；",[211,16065,16066],{},"避免客户端误用高级消息能力；",[211,16068,16069],{},"便于 Broker 按消息类型管理；",[211,16071,16072],{},"降低运维和故障排查复杂度。",[18,16074,16075],{},"为了兼容旧客户端，5.x 的强制类型校验能力需要结合服务端配置判断。面试中可以说“5.x 支持并推荐一个 Topic 对应一种消息类型”，不要绝对化为所有兼容部署都默认强制拒绝。",[14,16077,16079],{"id":16078},"九常见追问","九、常见追问",[237,16081,16083],{"id":16082},"_1-普通消息一定无序吗","1. 普通消息一定无序吗",[18,16085,16086],{},"普通消息在某个物理队列中自然存在存储先后，但业务没有建立端到端 FIFO 约束。多队列发送、并发消费、失败重试都可能使业务完成顺序变化，因此不能依赖普通消息保证业务顺序。",[237,16088,16090],{"id":16089},"_2-顺序消息能否保证整个-topic-全局有序","2. 顺序消息能否保证整个 Topic 全局有序",[18,16092,16093],{},"实际通常保证同一 Message Group 内有序。理论上把所有消息放入一个组可以接近全局串行，但会形成热点并严重限制吞吐，不建议这样设计。",[237,16095,16097],{"id":16096},"_3-延时消息到点后一定立即执行吗","3. 延时消息到点后一定立即执行吗",[18,16099,16100],{},"不一定。到点表示消息可以进入可消费状态，Broker 调度延迟、消息积压和 Consumer 处理能力都会影响最终业务执行时间。",[237,16102,16104],{"id":16103},"_4-事务消息消费成功是否与本地事务强一致","4. 事务消息消费成功是否与本地事务强一致",[18,16106,16107],{},"不是。事务消息只保证本地事务结果与消息是否投递之间的最终一致性。Consumer 的业务处理仍然是独立的异步过程，需要重试、幂等和补偿。",[237,16109,16111],{"id":16110},"_5-fifo-和-transaction-能否同时使用","5. FIFO 和 Transaction 能否同时使用",[18,16113,16114],{},"从 RocketMQ 5.x 的 Topic 类型模型看，一个 Topic 只对应一种正式消息类型，不能把同一条消息同时声明为 FIFO 和 Transaction。业务同时需要“事务一致性”和“顺序处理”时，需要重新审视领域流程，常见做法是用事务消息可靠发布业务事件，再由下游状态机、版本号、业务序号或独立 FIFO 流程处理顺序要求。",[14,16116,16118],{"id":16117},"十容易答错的地方","十、容易答错的地方",[237,16120,16122],{"id":16121},"错误一rocketmq-有五种消息包含批量消息","错误一：RocketMQ 有五种消息，包含批量消息",[18,16124,16125],{},"批量是发送方式，不是 RocketMQ 5.x 的正式 MessageType。正式类型是 Normal、FIFO、Delay、Transaction。",[237,16127,16129],{"id":16128},"错误二顺序消息保证整个-topic-全局有序","错误二：顺序消息保证整个 Topic 全局有序",[18,16131,16132],{},"通常保证同一 Message Group 内的局部顺序，不同组之间允许并发。",[237,16134,16136],{"id":16135},"错误三延时消息到了时间就保证业务已经执行","错误三：延时消息到了时间就保证业务已经执行",[18,16138,16139],{},"到达投递时间只表示消息对 Consumer 可见，实际业务完成还受积压、消费能力和重试影响。",[237,16141,16143],{"id":16142},"错误四事务消息保证上下游所有业务一起提交","错误四：事务消息保证上下游所有业务一起提交",[18,16145,16146],{},"事务消息保证本地事务与消息投递最终一致，下游消费结果仍然需要独立保障。",[237,16148,16150],{"id":16149},"错误五普通消息可靠性低","错误五：普通消息可靠性低",[18,16152,16153],{},"普通消息只是没有高级传输语义，不代表不持久化、不重试或不可靠。",[14,16155,1191],{"id":1191},[245,16157,16158,16165,16172,16179,16186,16193,16200],{},[211,16159,16160],{},[70,16161,16164],{"href":16162,"rel":16163},"https:\u002F\u002Frocketmq.apache.org\u002Fdocs\u002FdomainModel\u002F02topic\u002F",[1200],"Apache RocketMQ 5.0：Topic 与 MessageType",[211,16166,16167],{},[70,16168,16171],{"href":16169,"rel":16170},"https:\u002F\u002Frocketmq.apache.org\u002Fdocs\u002FfeatureBehavior\u002F01normalmessage\u002F",[1200],"Apache RocketMQ 5.0：普通消息",[211,16173,16174],{},[70,16175,16178],{"href":16176,"rel":16177},"https:\u002F\u002Frocketmq.apache.org\u002Fdocs\u002FfeatureBehavior\u002F03fifomessage\u002F",[1200],"Apache RocketMQ 5.0：顺序消息",[211,16180,16181],{},[70,16182,16185],{"href":16183,"rel":16184},"https:\u002F\u002Frocketmq.apache.org\u002Fdocs\u002FfeatureBehavior\u002F02delaymessage\u002F",[1200],"Apache RocketMQ 5.0：定时与延时消息",[211,16187,16188],{},[70,16189,16192],{"href":16190,"rel":16191},"https:\u002F\u002Frocketmq.apache.org\u002Fdocs\u002FfeatureBehavior\u002F04transactionmessage\u002F",[1200],"Apache RocketMQ 5.0：事务消息",[211,16194,16195],{},[70,16196,16199],{"href":16197,"rel":16198},"https:\u002F\u002Frocketmq.apache.org\u002Fdocs\u002FfeatureBehavior\u002F10consumerretrypolicy\u002F",[1200],"Apache RocketMQ 5.0：消费重试",[211,16201,16202],{},[70,16203,16206],{"href":16204,"rel":16205},"https:\u002F\u002Frocketmq.apache.org\u002Fdocs\u002F4.x\u002Fproducer\u002F04message3\u002F",[1200],"Apache RocketMQ 4.x：延时消息级别",[1224,16208,16209],{},"html pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":285,"searchDepth":343,"depth":343,"links":16211},[16212,16213,16214,16215,16216,16221,16228,16235,16241,16242,16249,16250,16257,16264],{"id":16,"depth":343,"text":16},{"id":66,"depth":343,"text":66},{"id":83,"depth":343,"text":83},{"id":15143,"depth":343,"text":15144},{"id":15241,"depth":343,"text":15242,"children":16217},[16218,16219,16220],{"id":15245,"depth":359,"text":15246},{"id":15269,"depth":359,"text":15270},{"id":15311,"depth":359,"text":15312},{"id":15332,"depth":343,"text":15333,"children":16222},[16223,16224,16225,16226,16227],{"id":15336,"depth":359,"text":15337},{"id":15371,"depth":359,"text":15372},{"id":15390,"depth":359,"text":15391},{"id":15421,"depth":359,"text":15422},{"id":15445,"depth":359,"text":15446},{"id":15475,"depth":343,"text":15476,"children":16229},[16230,16231,16232,16233,16234],{"id":15479,"depth":359,"text":15480},{"id":15542,"depth":359,"text":15543},{"id":15555,"depth":359,"text":15556},{"id":15594,"depth":359,"text":15595},{"id":15625,"depth":359,"text":15626},{"id":15648,"depth":343,"text":15649,"children":16236},[16237,16238,16239,16240],{"id":15652,"depth":359,"text":15653},{"id":15684,"depth":359,"text":15685},{"id":15706,"depth":359,"text":15556},{"id":15726,"depth":359,"text":15727},{"id":15764,"depth":343,"text":15765},{"id":15843,"depth":343,"text":15844,"children":16243},[16244,16245,16246,16247,16248],{"id":15847,"depth":359,"text":15848},{"id":15877,"depth":359,"text":15878},{"id":15915,"depth":359,"text":15916},{"id":15942,"depth":359,"text":15943},{"id":15967,"depth":359,"text":15968},{"id":15983,"depth":343,"text":15984},{"id":16078,"depth":343,"text":16079,"children":16251},[16252,16253,16254,16255,16256],{"id":16082,"depth":359,"text":16083},{"id":16089,"depth":359,"text":16090},{"id":16096,"depth":359,"text":16097},{"id":16103,"depth":359,"text":16104},{"id":16110,"depth":359,"text":16111},{"id":16117,"depth":343,"text":16118,"children":16258},[16259,16260,16261,16262,16263],{"id":16121,"depth":359,"text":16122},{"id":16128,"depth":359,"text":16129},{"id":16135,"depth":359,"text":16136},{"id":16142,"depth":359,"text":16143},{"id":16149,"depth":359,"text":16150},{"id":1191,"depth":343,"text":1191},"wiki:java:rocketmq-message-types-and-use-cases","系统介绍 RocketMQ 5.x 的普通消息、顺序消息、定时与延时消息、事务消息，说明各自语义、适用场景、使用限制，并澄清批量消息、重试消息和死信消息是否属于消息类型。",{},78,"\u002Fjava\u002Frocketmq-message-types-and-use-cases",{"title":15079,"description":16266},"java\u002Frocketmq-message-types-and-use-cases","2026-07-26","0Dk0ULElt6DDqSea9SIrQh6YmMktZE9yv-Ac_3lFtCs",{"id":16275,"title":16276,"body":16277,"commentId":18344,"description":18345,"difficulty":3724,"draft":1277,"extension":1278,"meta":18346,"navigation":1280,"order":18347,"path":18348,"section":1283,"seo":18349,"stem":18350,"updated":1286,"__hash__":18351},"java\u002Fjava\u002Fjava-thread-pool-core-parameters-and-practice.md","Java 线程池核心参数有哪些？日常应该怎么使用？",{"type":7,"value":16278,"toc":18300},[16279,16282,16284,16317,16320,16323,16325,16332,16334,16343,16345,16349,16352,16366,16369,16375,16379,16382,16451,16455,16460,16463,16478,16481,16499,16504,16508,16513,16516,16522,16527,16531,16537,16545,16558,16561,16564,16572,16576,16583,16600,16603,16607,16613,16616,16689,16692,16709,16712,16716,16721,16735,16738,16744,16747,16751,16754,16757,16829,16832,16836,16839,16854,16859,16865,16868,16871,16875,16878,16884,16887,16893,16899,16908,16912,16916,16919,16922,16928,16931,16935,16938,16944,16947,16953,16956,16973,16976,16980,16983,16997,17000,17006,17009,17013,17016,17709,17712,17736,17739,17743,17749,17753,17762,17768,17772,17778,17784,17795,17798,17804,17810,17821,17827,17831,17833,17845,17858,17861,17887,17917,17929,17933,17936,17938,17944,17947,17964,17967,17971,17974,18079,18082,18102,18105,18109,18118,18124,18127,18133,18136,18146,18154,18160,18165,18171,18175,18179,18182,18186,18189,18193,18198,18202,18205,18209,18220,18224,18227,18231,18272,18274,18297],[10,16280,16276],{"id":16281},"java-线程池核心参数有哪些日常应该怎么使用",[14,16283,16],{"id":16},[18,16285,16286,16289,16290,16293,16294,16297,16298,16301,16302,16305,16306,16309,16310,16313,16314,4224],{},[25,16287,16288],{},"ThreadPoolExecutor"," 有七个核心参数：核心线程数 ",[25,16291,16292],{},"corePoolSize","、最大线程数 ",[25,16295,16296],{},"maximumPoolSize","、非核心线程空闲存活时间 ",[25,16299,16300],{},"keepAliveTime","、时间单位 ",[25,16303,16304],{},"unit","、任务队列 ",[25,16307,16308],{},"workQueue","、线程工厂 ",[25,16311,16312],{},"threadFactory"," 和拒绝策略 ",[25,16315,16316],{},"handler",[18,16318,16319],{},"提交任务后，线程池先判断当前工作线程数是否小于核心线程数，是则创建线程执行；否则尝试将任务放入队列。队列已满时，如果线程数还没有达到最大线程数，就继续创建非核心线程；线程数达到最大值后仍无法接收任务，才执行拒绝策略。因此，最大线程数是否生效与队列是否有界密切相关。",[18,16321,16322],{},"日常使用时，应根据任务是 CPU 密集型还是 I\u002FO 密集型划分独立线程池，明确核心线程数、最大线程数和有界队列，设置有业务含义的线程名，并根据业务选择可观测、可补偿的拒绝策略。同时监控活跃线程数、队列长度、拒绝次数、排队耗时和执行耗时，应用停止时进行优雅关闭。线程数和队列容量不能只靠固定公式决定，还要结合机器 CPU、任务等待与计算比例、下游容量及允许的业务延迟进行压测和调整。",[18,16324,54],{},[56,16326,16327],{},[18,16328,16329],{},[61,16330,16331],{},"线程池用有限的线程和队列承接任务；日常配置的核心不是把参数设大，而是明确资源上限、过载行为和监控补偿机制。",[14,16333,66],{"id":66},[18,16335,16336],{},[70,16337,16340],{"href":16338,"target":73,"rel":16339},"\u002Fimages\u002Fwiki\u002Fjava\u002Fjava-thread-pool-core-parameters-and-practice.svg",[75,76],[78,16341],{"src":16338,"alt":16342},"Java 线程池七个核心参数、任务提交流程和日常使用原则",[14,16344,83],{"id":83},[14,16346,16348],{"id":16347},"一为什么使用线程池","一、为什么使用线程池",[18,16350,16351],{},"如果每个任务都创建一个新线程，会带来以下问题：",[245,16353,16354,16357,16360,16363],{},[211,16355,16356],{},"创建和销毁线程需要消耗时间与内存；",[211,16358,16359],{},"线程数量缺少上限，突发流量可能耗尽系统资源；",[211,16361,16362],{},"大量线程会增加上下文切换和调度开销；",[211,16364,16365],{},"无法统一管理任务排队、拒绝、监控和关闭。",[18,16367,16368],{},"线程池的核心价值不是单纯复用线程，而是对并发资源进行治理：",[279,16370,16373],{"className":16371,"code":16372,"language":284,"meta":285},[282],"控制线程数量\n+ 缓冲暂时处理不了的任务\n+ 定义系统过载时的行为\n+ 统一监控和生命周期管理\n",[25,16374,16372],{"__ignoreMap":285},[14,16376,16378],{"id":16377},"二threadpoolexecutor-的七个核心参数","二、ThreadPoolExecutor 的七个核心参数",[18,16380,16381],{},"常用构造方法如下：",[279,16383,16385],{"className":2173,"code":16384,"language":2175,"meta":285,"style":285},"public ThreadPoolExecutor(\n int corePoolSize,\n int maximumPoolSize,\n long keepAliveTime,\n TimeUnit unit,\n BlockingQueue\u003CRunnable> workQueue,\n ThreadFactory threadFactory,\n RejectedExecutionHandler handler)\n",[25,16386,16387,16398,16406,16413,16421,16426,16441,16446],{"__ignoreMap":285},[315,16388,16389,16392,16395],{"class":317,"line":318},[315,16390,16391],{"class":325},"public",[315,16393,16394],{"class":321}," ThreadPoolExecutor",[315,16396,16397],{"class":333},"(\n",[315,16399,16400,16403],{"class":317,"line":343},[315,16401,16402],{"class":325}," int",[315,16404,16405],{"class":333}," corePoolSize,\n",[315,16407,16408,16410],{"class":317,"line":359},[315,16409,16402],{"class":325},[315,16411,16412],{"class":333}," maximumPoolSize,\n",[315,16414,16415,16418],{"class":317,"line":375},[315,16416,16417],{"class":325}," long",[315,16419,16420],{"class":333}," keepAliveTime,\n",[315,16422,16423],{"class":317,"line":391},[315,16424,16425],{"class":333}," TimeUnit unit,\n",[315,16427,16428,16431,16433,16436,16438],{"class":317,"line":2562},[315,16429,16430],{"class":333}," BlockingQueue",[315,16432,2436],{"class":325},[315,16434,16435],{"class":333},"Runnable",[315,16437,337],{"class":325},[315,16439,16440],{"class":333}," workQueue,\n",[315,16442,16443],{"class":317,"line":2580},[315,16444,16445],{"class":333}," ThreadFactory threadFactory,\n",[315,16447,16448],{"class":317,"line":2586},[315,16449,16450],{"class":333}," RejectedExecutionHandler handler)\n",[237,16452,16454],{"id":16453},"_1-corepoolsize核心线程数","1. corePoolSize：核心线程数",[18,16456,16457,16459],{},[25,16458,16292],{}," 表示线程池希望长期保留的基本工作线程数量。",[18,16461,16462],{},"默认情况下，核心线程也不是在线程池创建时立即启动，而是在任务到来后按需创建。需要提前完成线程创建时，可以调用：",[279,16464,16466],{"className":2173,"code":16465,"language":2175,"meta":285,"style":285},"threadPool.prestartAllCoreThreads();\n",[25,16467,16468],{"__ignoreMap":285},[315,16469,16470,16473,16476],{"class":317,"line":318},[315,16471,16472],{"class":333},"threadPool.",[315,16474,16475],{"class":321},"prestartAllCoreThreads",[315,16477,2520],{"class":333},[18,16479,16480],{},"核心线程默认不会因为空闲而退出。调用以下方法后，核心线程也可以受空闲超时控制：",[279,16482,16484],{"className":2173,"code":16483,"language":2175,"meta":285,"style":285},"threadPool.allowCoreThreadTimeOut(true);\n",[25,16485,16486],{"__ignoreMap":285},[315,16487,16488,16490,16493,16495,16497],{"class":317,"line":318},[315,16489,16472],{"class":333},[315,16491,16492],{"class":321},"allowCoreThreadTimeOut",[315,16494,4349],{"class":333},[315,16496,4314],{"class":839},[315,16498,8034],{"class":333},[18,16500,12781,16501,16503],{},[25,16502,16300],{}," 必须大于零。",[237,16505,16507],{"id":16506},"_2-maximumpoolsize最大线程数","2. maximumPoolSize：最大线程数",[18,16509,16510,16512],{},[25,16511,16296],{}," 是线程池允许存在的最大工作线程数量，必须大于或等于核心线程数。",[18,16514,16515],{},"它并不是任务一多就立即生效。只有满足以下条件时，线程池才会创建超过核心数量的线程：",[279,16517,16520],{"className":16518,"code":16519,"language":284,"meta":285},[282],"核心线程都在工作\n+ workQueue 已满\n+ 当前线程数小于 maximumPoolSize\n",[25,16521,16519],{"__ignoreMap":285},[18,16523,16524,16525,4224],{},"如果使用不会被填满的无界队列，任务会持续进入队列，线程池通常不会扩展到 ",[25,16526,16296],{},[237,16528,16530],{"id":16529},"_3-keepalivetime空闲线程存活时间","3. keepAliveTime：空闲线程存活时间",[18,16532,16533,16534,16536],{},"当工作线程数量超过 ",[25,16535,16292],{}," 时，多出来的线程如果在指定时间内没有获取到任务，就会被回收。",[18,16538,16539,16541,16542,16544],{},[25,16540,16300],{}," 决定空闲等待时长，",[25,16543,16304],{}," 决定它的时间单位：",[279,16546,16548],{"className":2173,"code":16547,"language":2175,"meta":285,"style":285},"60L, TimeUnit.SECONDS\n",[25,16549,16550],{"__ignoreMap":285},[315,16551,16552,16555],{"class":317,"line":318},[315,16553,16554],{"class":839},"60L",[315,16556,16557],{"class":333},", TimeUnit.SECONDS\n",[18,16559,16560],{},"它们共同表示空闲线程最多等待 60 秒。",[18,16562,16563],{},"该参数是在以下两者之间取舍：",[245,16565,16566,16569],{},[211,16567,16568],{},"设置较短：流量下降后能更快释放线程资源，但下一次突发流量需要重新创建线程；",[211,16570,16571],{},"设置较长：可以减少线程反复创建，但空闲线程会占用更多内存。",[237,16573,16575],{"id":16574},"_4-unit时间单位","4. unit：时间单位",[18,16577,16578,13070,16580,16582],{},[25,16579,16304],{},[25,16581,16300],{}," 的单位，常用值包括：",[245,16584,16585,16590,16595],{},[211,16586,16587],{},[25,16588,16589],{},"TimeUnit.MILLISECONDS",[211,16591,16592],{},[25,16593,16594],{},"TimeUnit.SECONDS",[211,16596,16597],{},[25,16598,16599],{},"TimeUnit.MINUTES",[18,16601,16602],{},"把时间值和单位拆开传入，可以避免代码中出现含义不清的裸数字。",[237,16604,16606],{"id":16605},"_5-workqueue任务队列","5. workQueue：任务队列",[18,16608,16609,16610,16612],{},"当核心线程都在工作时，新任务会先尝试进入 ",[25,16611,16308],{}," 等待，而不是立即创建非核心线程。",[18,16614,16615],{},"常见队列如下：",[98,16617,16618,16631],{},[101,16619,16620],{},[104,16621,16622,16625,16628],{},[107,16623,16624],{},"队列",[107,16626,16627],{},"特点",[107,16629,16630],{},"适用场景与注意事项",[114,16632,16633,16646,16663,16676],{},[104,16634,16635,16640,16643],{},[119,16636,16637],{},[25,16638,16639],{},"ArrayBlockingQueue",[119,16641,16642],{},"基于数组的有界队列，容量固定",[119,16644,16645],{},"资源边界明确，适合大多数需要控制积压的服务端任务",[104,16647,16648,16653,16656],{},[119,16649,16650],{},[25,16651,16652],{},"LinkedBlockingQueue",[119,16654,16655],{},"基于链表，可指定容量",[119,16657,16658,16659,16662],{},"不传容量时上限为 ",[25,16660,16661],{},"Integer.MAX_VALUE","，容易隐藏长期积压",[104,16664,16665,16670,16673],{},[119,16666,16667],{},[25,16668,16669],{},"SynchronousQueue",[119,16671,16672],{},"不保存任务，每次提交都直接移交给工作线程",[119,16674,16675],{},"适合希望快速扩展线程、任务很短且能够严格控制最大线程数的场景",[104,16677,16678,16683,16686],{},[119,16679,16680],{},[25,16681,16682],{},"PriorityBlockingQueue",[119,16684,16685],{},"按优先级取任务，通常是无界队列",[119,16687,16688],{},"任务需要可比较；要防止低优先级任务长期得不到执行",[18,16690,16691],{},"队列容量并非越大越好。大队列虽然能暂时降低拒绝次数，却可能带来：",[245,16693,16694,16697,16700,16703,16706],{},[211,16695,16696],{},"任务排队时间不断增长；",[211,16698,16699],{},"内存占用上升；",[211,16701,16702],{},"故障被延迟暴露；",[211,16704,16705],{},"应用关闭时遗留大量未完成任务；",[211,16707,16708],{},"请求已经失去业务时效后仍在执行。",[18,16710,16711],{},"有界队列能够让系统在达到承载上限时尽早进入明确的过载处理流程。",[237,16713,16715],{"id":16714},"_6-threadfactory线程工厂","6. threadFactory：线程工厂",[18,16717,16718,16720],{},[25,16719,16312],{}," 负责创建工作线程，可以统一设置：",[245,16722,16723,16726,16729,16732],{},[211,16724,16725],{},"线程名称；",[211,16727,16728],{},"是否为守护线程；",[211,16730,16731],{},"线程优先级；",[211,16733,16734],{},"未捕获异常处理器。",[18,16736,16737],{},"线程名应体现业务用途，例如：",[279,16739,16742],{"className":16740,"code":16741,"language":284,"meta":285},[282],"order-notify-1\norder-notify-2\n",[25,16743,16741],{"__ignoreMap":285},[18,16745,16746],{},"出现高 CPU、死锁或任务堆积时，有业务含义的线程名能显著降低线程栈排查成本。",[237,16748,16750],{"id":16749},"_7-handler拒绝策略","7. handler：拒绝策略",[18,16752,16753],{},"当线程池没有运行，或者同时满足“线程数达到最大值、任务队列已满”时，新任务会被拒绝。",[18,16755,16756],{},"JDK 提供四种常用策略：",[98,16758,16759,16772],{},[101,16760,16761],{},[104,16762,16763,16766,16769],{},[107,16764,16765],{},"策略",[107,16767,16768],{},"行为",[107,16770,16771],{},"适用提醒",[114,16773,16774,16790,16803,16816],{},[104,16775,16776,16781,16787],{},[119,16777,16778],{},[25,16779,16780],{},"AbortPolicy",[119,16782,16783,16784],{},"抛出 ",[25,16785,16786],{},"RejectedExecutionException",[119,16788,16789],{},"默认策略，能够明确暴露过载，调用方需要处理异常",[104,16791,16792,16797,16800],{},[119,16793,16794],{},[25,16795,16796],{},"CallerRunsPolicy",[119,16798,16799],{},"由提交任务的线程直接执行",[119,16801,16802],{},"可以减慢生产者形成一定反压，但会增加调用线程延迟",[104,16804,16805,16810,16813],{},[119,16806,16807],{},[25,16808,16809],{},"DiscardPolicy",[119,16811,16812],{},"静默丢弃新任务",[119,16814,16815],{},"只适合明确允许丢弃且有独立监控的低价值任务",[104,16817,16818,16823,16826],{},[119,16819,16820],{},[25,16821,16822],{},"DiscardOldestPolicy",[119,16824,16825],{},"丢弃队列头任务，再尝试提交新任务",[119,16827,16828],{},"可能丢掉等待最久或优先级最高的任务，使用前必须确认业务语义",[18,16830,16831],{},"拒绝策略没有适用于所有业务的统一答案。核心交易任务通常不能静默丢弃，可以抛出异常后进入降级、补偿或持久化重试；允许采样的日志、指标任务才可能接受丢弃。",[14,16833,16835],{"id":16834},"三任务提交后的完整流程","三、任务提交后的完整流程",[18,16837,16838],{},"调用：",[279,16840,16842],{"className":2173,"code":16841,"language":2175,"meta":285,"style":285},"threadPool.execute(task);\n",[25,16843,16844],{"__ignoreMap":285},[315,16845,16846,16848,16851],{"class":317,"line":318},[315,16847,16472],{"class":333},[315,16849,16850],{"class":321},"execute",[315,16852,16853],{"class":333},"(task);\n",[18,16855,16856,16858],{},[25,16857,16288],{}," 的处理流程可以概括为：",[279,16860,16863],{"className":16861,"code":16862,"language":284,"meta":285},[282],"1. 当前工作线程数小于 corePoolSize\n → 创建核心工作线程执行任务\n\n2. 当前工作线程数已达到 corePoolSize\n → 尝试将任务加入 workQueue\n\n3. workQueue 已满，且工作线程数小于 maximumPoolSize\n → 创建非核心工作线程执行任务\n\n4. workQueue 已满，且工作线程数已达到 maximumPoolSize\n → 执行拒绝策略\n",[25,16864,16862],{"__ignoreMap":285},[18,16866,16867],{},"任务成功入队后，线程池还会再次检查运行状态。如果线程池在入队期间已经停止，会尝试移除该任务并拒绝；如果池中没有工作线程，则会补充一个工作线程负责消费队列。",[18,16869,16870],{},"这个二次检查避免了任务已经进入队列，却因为线程池状态变化或没有消费者而一直得不到执行。",[14,16872,16874],{"id":16873},"四队列与最大线程数如何相互影响","四、队列与最大线程数如何相互影响",[18,16876,16877],{},"假设配置如下：",[279,16879,16882],{"className":16880,"code":16881,"language":284,"meta":285},[282],"corePoolSize = 8\nmaximumPoolSize = 16\nworkQueue 容量 = 500\n",[25,16883,16881],{"__ignoreMap":285},[18,16885,16886],{},"任务增长过程是：",[279,16888,16891],{"className":16889,"code":16890,"language":284,"meta":285},[282],"前 8 个并发任务\n→ 创建至 8 个核心线程\n\n核心线程忙碌后的新任务\n→ 最多 500 个进入队列\n\n队列满后的新任务\n→ 继续创建线程，最多扩展到 16 个\n\n16 个线程都忙且队列仍满\n→ 触发拒绝策略\n",[25,16892,16890],{"__ignoreMap":285},[18,16894,16895,16896,16898],{},"如果把队列改成默认构造的 ",[25,16897,16652],{},"，它的容量接近无界，任务通常只会继续排队，线程数量很难从 8 扩展到 16。",[18,16900,16901,16902,16904,16905,16907],{},"因此不能孤立地解释 ",[25,16903,16296],{},"，必须和 ",[25,16906,16308],{}," 一起分析。",[14,16909,16911],{"id":16910},"五线程数应该怎么估算","五、线程数应该怎么估算",[237,16913,16915],{"id":16914},"_1-cpu-密集型任务","1. CPU 密集型任务",[18,16917,16918],{},"CPU 密集型任务的大部分时间都在执行计算，例如加密、压缩、图像处理和复杂规则计算。",[18,16920,16921],{},"可以把下面的数值作为初始估算：",[279,16923,16926],{"className":16924,"code":16925,"language":284,"meta":285},[282],"线程数 ≈ CPU 核数 + 1\n",[25,16927,16925],{"__ignoreMap":285},[18,16929,16930],{},"线程数明显超过 CPU 并行能力，通常只会增加上下文切换，并不会线性提升吞吐。",[237,16932,16934],{"id":16933},"_2-io-密集型任务","2. I\u002FO 密集型任务",[18,16936,16937],{},"I\u002FO 密集型任务会花较多时间等待数据库、网络、文件或远程服务，可以用以下公式进行初始估算：",[279,16939,16942],{"className":16940,"code":16941,"language":284,"meta":285},[282],"线程数 ≈ CPU 核数 ×（1 + 平均等待时间 ÷ 平均计算时间）\n",[25,16943,16941],{"__ignoreMap":285},[18,16945,16946],{},"例如任务平均计算 10 毫秒、等待下游 40 毫秒，机器有 8 个 CPU 核：",[279,16948,16951],{"className":16949,"code":16950,"language":284,"meta":285},[282],"8 ×（1 + 40 ÷ 10）= 40\n",[25,16952,16950],{"__ignoreMap":285},[18,16954,16955],{},"40 只能作为起始测试值，不能直接当作生产结论。真实上限还受以下因素约束：",[245,16957,16958,16961,16964,16967,16970],{},[211,16959,16960],{},"数据库连接池只有多少连接；",[211,16962,16963],{},"下游接口允许多少并发；",[211,16965,16966],{},"单任务占用多少内存；",[211,16968,16969],{},"机器 CPU、内存和网络容量；",[211,16971,16972],{},"业务允许的超时和排队时长。",[18,16974,16975],{},"如果数据库连接池只有 20 个可用连接，把线程池配置成 200 个线程，往往只是让更多线程阻塞在等待连接上。",[237,16977,16979],{"id":16978},"_3-队列容量怎么定","3. 队列容量怎么定",[18,16981,16982],{},"队列容量应结合四个维度：",[208,16984,16985,16988,16991,16994],{},[211,16986,16987],{},"高峰任务到达速率；",[211,16989,16990],{},"线程池稳定处理速率；",[211,16992,16993],{},"业务允许的最大排队时间；",[211,16995,16996],{},"单个排队任务占用的内存。",[18,16998,16999],{},"假设高峰期每秒比稳定处理能力多出 100 个任务，业务最多允许这种峰值持续 3 秒，可以从约 300 个队列容量开始评估：",[279,17001,17004],{"className":17002,"code":17003,"language":284,"meta":285},[282],"暂时积压量\n≈（任务到达速率－稳定处理速率）× 峰值持续时间\n",[25,17005,17003],{"__ignoreMap":285},[18,17007,17008],{},"还必须验证队列排满时的内存占用和最老任务等待时间。容量评估的目标不是永不拒绝，而是在允许的延迟和资源范围内吸收短时突发。",[14,17010,17012],{"id":17011},"六日常推荐写法","六、日常推荐写法",[18,17014,17015],{},"下面是一个边界清晰的业务线程池示例：",[279,17017,17019],{"className":2173,"code":17018,"language":2175,"meta":285,"style":285},"import java.util.List;\nimport java.util.concurrent.ArrayBlockingQueue;\nimport java.util.concurrent.RejectedExecutionException;\nimport java.util.concurrent.ThreadFactory;\nimport java.util.concurrent.ThreadPoolExecutor;\nimport java.util.concurrent.TimeUnit;\nimport java.util.concurrent.atomic.AtomicInteger;\n\npublic final class OrderAsyncExecutor {\n\n private static final AtomicInteger THREAD_ID = new AtomicInteger();\n\n private static final ThreadFactory THREAD_FACTORY = task -> {\n Thread thread = new Thread(\n task,\n \"order-async-\" + THREAD_ID.incrementAndGet()\n );\n thread.setUncaughtExceptionHandler((currentThread, error) ->\n System.err.println(\n currentThread.getName() + \": \" + error.getMessage()\n )\n );\n return thread;\n };\n\n private static final ThreadPoolExecutor EXECUTOR =\n new ThreadPoolExecutor(\n 8,\n 16,\n 60L,\n TimeUnit.SECONDS,\n new ArrayBlockingQueue\u003C>(500),\n THREAD_FACTORY,\n new ThreadPoolExecutor.AbortPolicy()\n );\n\n private OrderAsyncExecutor() {\n }\n\n public static void execute(Runnable task) {\n try {\n EXECUTOR.execute(task);\n } catch (RejectedExecutionException exception) {\n \u002F\u002F 根据业务接入告警、降级、持久化重试或补偿流程\n throw exception;\n }\n }\n\n public static void shutdown() {\n EXECUTOR.shutdown();\n try {\n if (!EXECUTOR.awaitTermination(30, TimeUnit.SECONDS)) {\n List\u003CRunnable> notStartedTasks = EXECUTOR.shutdownNow();\n if (!notStartedTasks.isEmpty()) {\n System.err.println(\n \"未开始执行的任务数：\" + notStartedTasks.size()\n );\n }\n if (!EXECUTOR.awaitTermination(30, TimeUnit.SECONDS)) {\n System.err.println(\"线程池在中断请求后仍未终止\");\n }\n }\n } catch (InterruptedException exception) {\n EXECUTOR.shutdownNow();\n Thread.currentThread().interrupt();\n }\n }\n}\n",[25,17020,17021,17029,17036,17043,17050,17057,17064,17071,17075,17090,17095,17118,17123,17144,17159,17165,17183,17189,17204,17214,17240,17246,17251,17260,17266,17271,17285,17295,17303,17311,17319,17325,17339,17345,17357,17362,17367,17377,17382,17387,17410,17418,17428,17445,17451,17460,17466,17471,17476,17490,17501,17508,17532,17553,17572,17582,17598,17604,17610,17629,17643,17648,17654,17668,17677,17694,17699,17704],{"__ignoreMap":285},[315,17022,17023,17026],{"class":317,"line":318},[315,17024,17025],{"class":325},"import",[315,17027,17028],{"class":333}," java.util.List;\n",[315,17030,17031,17033],{"class":317,"line":343},[315,17032,17025],{"class":325},[315,17034,17035],{"class":333}," java.util.concurrent.ArrayBlockingQueue;\n",[315,17037,17038,17040],{"class":317,"line":359},[315,17039,17025],{"class":325},[315,17041,17042],{"class":333}," java.util.concurrent.RejectedExecutionException;\n",[315,17044,17045,17047],{"class":317,"line":375},[315,17046,17025],{"class":325},[315,17048,17049],{"class":333}," java.util.concurrent.ThreadFactory;\n",[315,17051,17052,17054],{"class":317,"line":391},[315,17053,17025],{"class":325},[315,17055,17056],{"class":333}," java.util.concurrent.ThreadPoolExecutor;\n",[315,17058,17059,17061],{"class":317,"line":2562},[315,17060,17025],{"class":325},[315,17062,17063],{"class":333}," java.util.concurrent.TimeUnit;\n",[315,17065,17066,17068],{"class":317,"line":2580},[315,17067,17025],{"class":325},[315,17069,17070],{"class":333}," java.util.concurrent.atomic.AtomicInteger;\n",[315,17072,17073],{"class":317,"line":2586},[315,17074,2525],{"emptyLinePlaceholder":1280},[315,17076,17077,17079,17082,17085,17088],{"class":317,"line":2591},[315,17078,16391],{"class":325},[315,17080,17081],{"class":325}," final",[315,17083,17084],{"class":325}," class",[315,17086,17087],{"class":321}," OrderAsyncExecutor",[315,17089,4034],{"class":333},[315,17091,17093],{"class":317,"line":17092},10,[315,17094,2525],{"emptyLinePlaceholder":1280},[315,17096,17098,17101,17104,17106,17109,17111,17113,17116],{"class":317,"line":17097},11,[315,17099,17100],{"class":325}," private",[315,17102,17103],{"class":325}," static",[315,17105,17081],{"class":325},[315,17107,17108],{"class":333}," AtomicInteger THREAD_ID ",[315,17110,2511],{"class":325},[315,17112,2514],{"class":325},[315,17114,17115],{"class":321}," AtomicInteger",[315,17117,2520],{"class":333},[315,17119,17121],{"class":317,"line":17120},12,[315,17122,2525],{"emptyLinePlaceholder":1280},[315,17124,17126,17128,17130,17132,17135,17137,17140,17142],{"class":317,"line":17125},13,[315,17127,17100],{"class":325},[315,17129,17103],{"class":325},[315,17131,17081],{"class":325},[315,17133,17134],{"class":333}," ThreadFactory THREAD_FACTORY ",[315,17136,2511],{"class":325},[315,17138,17139],{"class":333}," task ",[315,17141,4031],{"class":325},[315,17143,4034],{"class":333},[315,17145,17147,17150,17152,17154,17157],{"class":317,"line":17146},14,[315,17148,17149],{"class":333}," Thread thread ",[315,17151,2511],{"class":325},[315,17153,2514],{"class":325},[315,17155,17156],{"class":321}," Thread",[315,17158,16397],{"class":333},[315,17160,17162],{"class":317,"line":17161},15,[315,17163,17164],{"class":333}," task,\n",[315,17166,17168,17171,17174,17177,17180],{"class":317,"line":17167},16,[315,17169,17170],{"class":329}," \"order-async-\"",[315,17172,17173],{"class":325}," +",[315,17175,17176],{"class":333}," THREAD_ID.",[315,17178,17179],{"class":321},"incrementAndGet",[315,17181,17182],{"class":333},"()\n",[315,17184,17186],{"class":317,"line":17185},17,[315,17187,17188],{"class":333}," );\n",[315,17190,17192,17195,17198,17201],{"class":317,"line":17191},18,[315,17193,17194],{"class":333}," thread.",[315,17196,17197],{"class":321},"setUncaughtExceptionHandler",[315,17199,17200],{"class":333},"((currentThread, error) ",[315,17202,17203],{"class":325},"->\n",[315,17205,17207,17210,17212],{"class":317,"line":17206},19,[315,17208,17209],{"class":333}," System.err.",[315,17211,2533],{"class":321},[315,17213,16397],{"class":333},[315,17215,17217,17220,17223,17225,17227,17230,17232,17235,17238],{"class":317,"line":17216},20,[315,17218,17219],{"class":333}," currentThread.",[315,17221,17222],{"class":321},"getName",[315,17224,15519],{"class":333},[315,17226,11072],{"class":325},[315,17228,17229],{"class":329}," \": \"",[315,17231,17173],{"class":325},[315,17233,17234],{"class":333}," error.",[315,17236,17237],{"class":321},"getMessage",[315,17239,17182],{"class":333},[315,17241,17243],{"class":317,"line":17242},21,[315,17244,17245],{"class":333}," )\n",[315,17247,17249],{"class":317,"line":17248},22,[315,17250,17188],{"class":333},[315,17252,17254,17257],{"class":317,"line":17253},23,[315,17255,17256],{"class":325}," return",[315,17258,17259],{"class":333}," thread;\n",[315,17261,17263],{"class":317,"line":17262},24,[315,17264,17265],{"class":333}," };\n",[315,17267,17269],{"class":317,"line":17268},25,[315,17270,2525],{"emptyLinePlaceholder":1280},[315,17272,17274,17276,17278,17280,17283],{"class":317,"line":17273},26,[315,17275,17100],{"class":325},[315,17277,17103],{"class":325},[315,17279,17081],{"class":325},[315,17281,17282],{"class":333}," ThreadPoolExecutor EXECUTOR ",[315,17284,15508],{"class":325},[315,17286,17288,17291,17293],{"class":317,"line":17287},27,[315,17289,17290],{"class":325}," new",[315,17292,16394],{"class":321},[315,17294,16397],{"class":333},[315,17296,17298,17301],{"class":317,"line":17297},28,[315,17299,17300],{"class":839}," 8",[315,17302,13133],{"class":333},[315,17304,17306,17309],{"class":317,"line":17305},29,[315,17307,17308],{"class":839}," 16",[315,17310,13133],{"class":333},[315,17312,17314,17317],{"class":317,"line":17313},30,[315,17315,17316],{"class":839}," 60L",[315,17318,13133],{"class":333},[315,17320,17322],{"class":317,"line":17321},31,[315,17323,17324],{"class":333}," TimeUnit.SECONDS,\n",[315,17326,17328,17331,17334,17337],{"class":317,"line":17327},32,[315,17329,17330],{"class":325}," new",[315,17332,17333],{"class":333}," ArrayBlockingQueue\u003C>(",[315,17335,17336],{"class":839},"500",[315,17338,11362],{"class":333},[315,17340,17342],{"class":317,"line":17341},33,[315,17343,17344],{"class":333}," THREAD_FACTORY,\n",[315,17346,17348,17350,17353,17355],{"class":317,"line":17347},34,[315,17349,17330],{"class":325},[315,17351,17352],{"class":333}," ThreadPoolExecutor.",[315,17354,16780],{"class":321},[315,17356,17182],{"class":333},[315,17358,17359],{"class":317,"line":2807},[315,17360,17361],{"class":333}," );\n",[315,17363,17365],{"class":317,"line":17364},36,[315,17366,2525],{"emptyLinePlaceholder":1280},[315,17368,17370,17372,17374],{"class":317,"line":17369},37,[315,17371,17100],{"class":325},[315,17373,17087],{"class":321},[315,17375,17376],{"class":333},"() {\n",[315,17378,17380],{"class":317,"line":17379},38,[315,17381,4070],{"class":333},[315,17383,17385],{"class":317,"line":17384},39,[315,17386,2525],{"emptyLinePlaceholder":1280},[315,17388,17390,17393,17395,17398,17401,17404,17408],{"class":317,"line":17389},40,[315,17391,17392],{"class":325}," public",[315,17394,17103],{"class":325},[315,17396,17397],{"class":325}," void",[315,17399,17400],{"class":321}," execute",[315,17402,17403],{"class":333},"(Runnable ",[315,17405,17407],{"class":17406},"s4XuR","task",[315,17409,4051],{"class":333},[315,17411,17413,17416],{"class":317,"line":17412},41,[315,17414,17415],{"class":325}," try",[315,17417,4034],{"class":333},[315,17419,17421,17424,17426],{"class":317,"line":17420},42,[315,17422,17423],{"class":333}," EXECUTOR.",[315,17425,16850],{"class":321},[315,17427,16853],{"class":333},[315,17429,17431,17434,17437,17440,17443],{"class":317,"line":17430},43,[315,17432,17433],{"class":333}," } ",[315,17435,17436],{"class":325},"catch",[315,17438,17439],{"class":333}," (RejectedExecutionException ",[315,17441,17442],{"class":17406},"exception",[315,17444,4051],{"class":333},[315,17446,17448],{"class":317,"line":17447},44,[315,17449,17450],{"class":4056}," \u002F\u002F 根据业务接入告警、降级、持久化重试或补偿流程\n",[315,17452,17454,17457],{"class":317,"line":17453},45,[315,17455,17456],{"class":325}," throw",[315,17458,17459],{"class":333}," exception;\n",[315,17461,17463],{"class":317,"line":17462},46,[315,17464,17465],{"class":333}," }\n",[315,17467,17469],{"class":317,"line":17468},47,[315,17470,4070],{"class":333},[315,17472,17474],{"class":317,"line":17473},48,[315,17475,2525],{"emptyLinePlaceholder":1280},[315,17477,17479,17481,17483,17485,17488],{"class":317,"line":17478},49,[315,17480,17392],{"class":325},[315,17482,17103],{"class":325},[315,17484,17397],{"class":325},[315,17486,17487],{"class":321}," shutdown",[315,17489,17376],{"class":333},[315,17491,17493,17496,17499],{"class":317,"line":17492},50,[315,17494,17495],{"class":333}," EXECUTOR.",[315,17497,17498],{"class":321},"shutdown",[315,17500,2520],{"class":333},[315,17502,17504,17506],{"class":317,"line":17503},51,[315,17505,17415],{"class":325},[315,17507,4034],{"class":333},[315,17509,17511,17514,17516,17519,17522,17525,17527,17529],{"class":317,"line":17510},52,[315,17512,17513],{"class":325}," if",[315,17515,4311],{"class":333},[315,17517,17518],{"class":325},"!",[315,17520,17521],{"class":333},"EXECUTOR.",[315,17523,17524],{"class":321},"awaitTermination",[315,17526,4349],{"class":333},[315,17528,13834],{"class":839},[315,17530,17531],{"class":333},", TimeUnit.SECONDS)) {\n",[315,17533,17535,17538,17540,17543,17545,17548,17551],{"class":317,"line":17534},53,[315,17536,17537],{"class":333}," List\u003C",[315,17539,16435],{"class":325},[315,17541,17542],{"class":333},"> notStartedTasks ",[315,17544,2511],{"class":325},[315,17546,17547],{"class":333}," EXECUTOR.",[315,17549,17550],{"class":321},"shutdownNow",[315,17552,2520],{"class":333},[315,17554,17556,17559,17561,17563,17566,17569],{"class":317,"line":17555},54,[315,17557,17558],{"class":325}," if",[315,17560,4311],{"class":333},[315,17562,17518],{"class":325},[315,17564,17565],{"class":333},"notStartedTasks.",[315,17567,17568],{"class":321},"isEmpty",[315,17570,17571],{"class":333},"()) {\n",[315,17573,17575,17578,17580],{"class":317,"line":17574},55,[315,17576,17577],{"class":333}," System.err.",[315,17579,2533],{"class":321},[315,17581,16397],{"class":333},[315,17583,17585,17588,17590,17593,17596],{"class":317,"line":17584},56,[315,17586,17587],{"class":329}," \"未开始执行的任务数：\"",[315,17589,17173],{"class":325},[315,17591,17592],{"class":333}," notStartedTasks.",[315,17594,17595],{"class":321},"size",[315,17597,17182],{"class":333},[315,17599,17601],{"class":317,"line":17600},57,[315,17602,17603],{"class":333}," );\n",[315,17605,17607],{"class":317,"line":17606},58,[315,17608,17609],{"class":333}," }\n",[315,17611,17613,17615,17617,17619,17621,17623,17625,17627],{"class":317,"line":17612},59,[315,17614,17558],{"class":325},[315,17616,4311],{"class":333},[315,17618,17518],{"class":325},[315,17620,17521],{"class":333},[315,17622,17524],{"class":321},[315,17624,4349],{"class":333},[315,17626,13834],{"class":839},[315,17628,17531],{"class":333},[315,17630,17632,17634,17636,17638,17641],{"class":317,"line":17631},60,[315,17633,17577],{"class":333},[315,17635,2533],{"class":321},[315,17637,4349],{"class":333},[315,17639,17640],{"class":329},"\"线程池在中断请求后仍未终止\"",[315,17642,8034],{"class":333},[315,17644,17646],{"class":317,"line":17645},61,[315,17647,17609],{"class":333},[315,17649,17651],{"class":317,"line":17650},62,[315,17652,17653],{"class":333}," }\n",[315,17655,17657,17659,17661,17664,17666],{"class":317,"line":17656},63,[315,17658,17433],{"class":333},[315,17660,17436],{"class":325},[315,17662,17663],{"class":333}," (InterruptedException ",[315,17665,17442],{"class":17406},[315,17667,4051],{"class":333},[315,17669,17671,17673,17675],{"class":317,"line":17670},64,[315,17672,17423],{"class":333},[315,17674,17550],{"class":321},[315,17676,2520],{"class":333},[315,17678,17680,17683,17686,17689,17692],{"class":317,"line":17679},65,[315,17681,17682],{"class":333}," Thread.",[315,17684,17685],{"class":321},"currentThread",[315,17687,17688],{"class":333},"().",[315,17690,17691],{"class":321},"interrupt",[315,17693,2520],{"class":333},[315,17695,17697],{"class":317,"line":17696},66,[315,17698,17465],{"class":333},[315,17700,17702],{"class":317,"line":17701},67,[315,17703,4070],{"class":333},[315,17705,17707],{"class":317,"line":17706},68,[315,17708,2583],{"class":333},[18,17710,17711],{},"这个示例体现了几个基本原则：",[245,17713,17714,17717,17720,17723,17726,17729],{},[211,17715,17716],{},"线程池被复用，而不是每次请求临时创建；",[211,17718,17719],{},"核心线程、最大线程和队列容量都有明确上限；",[211,17721,17722],{},"线程名能够定位到业务；",[211,17724,17725],{},"拒绝不会被静默忽略；",[211,17727,17728],{},"停止应用时先等待已有任务完成，超时后再中断；",[211,17730,17731,17732,17735],{},"捕获 ",[25,17733,17734],{},"InterruptedException"," 后恢复当前线程的中断状态。",[18,17737,17738],{},"实际业务应把告警、指标和补偿接入统一基础设施，而不是只输出错误信息。",[14,17740,17742],{"id":17741},"七为什么不建议盲目使用-executors-工厂方法","七、为什么不建议盲目使用 Executors 工厂方法",[18,17744,17745,17748],{},[25,17746,17747],{},"Executors"," 提供的工厂方法使用方便，但部分方法隐藏了重要的资源边界。",[237,17750,17752],{"id":17751},"_1-newfixedthreadpool-和-newsinglethreadexecutor","1. newFixedThreadPool 和 newSingleThreadExecutor",[18,17754,17755,17756,17758,17759,17761],{},"它们内部使用没有指定容量的 ",[25,17757,16652],{},"。该队列的默认容量是 ",[25,17760,16661],{},"，从业务运行角度看，等同于没有设置可控的任务积压上限：",[279,17763,17766],{"className":17764,"code":17765,"language":284,"meta":285},[282],"生产速度长期大于处理速度\n→ 队列持续增长\n→ 排队延迟和内存占用持续上升\n",[25,17767,17765],{"__ignoreMap":285},[237,17769,17771],{"id":17770},"_2-newcachedthreadpool","2. newCachedThreadPool",[18,17773,17774,17777],{},[25,17775,17776],{},"newCachedThreadPool"," 的主要风险确实来自最大线程数接近无上限。它的关键参数可以简化为：",[279,17779,17782],{"className":17780,"code":17781,"language":284,"meta":285},[282],"corePoolSize = 0\nmaximumPoolSize = Integer.MAX_VALUE\nworkQueue = SynchronousQueue\nkeepAliveTime = 60 秒\n",[25,17783,17781],{"__ignoreMap":285},[18,17785,17786,17788,17789,17791,17792,17794],{},[25,17787,16669],{}," 本身不保存任务。提交任务时，如果没有空闲线程能够接手，线程池就会创建新线程；而 ",[25,17790,16296],{}," 又被设置为 ",[25,17793,16661],{},"，因此任务持续到达或长期阻塞时，线程数量可能快速增长，最终造成大量线程占用内存、频繁上下文切换，甚至耗尽系统资源。",[18,17796,17797],{},"所以它的风险不是任务在队列中无限积压，而是：",[279,17799,17802],{"className":17800,"code":17801,"language":284,"meta":285},[282],"SynchronousQueue 不缓冲任务\n+ maximumPoolSize 接近无上限\n→ 没有空闲线程时持续创建新线程\n",[25,17803,17801],{"__ignoreMap":285},[18,17805,17806,17807,17809],{},"因此在资源敏感的服务端业务中，显式创建 ",[25,17808,16288],{}," 通常更容易表达：",[245,17811,17812,17815,17818],{},[211,17813,17814],{},"最多允许多少并发线程；",[211,17816,17817],{},"最多允许积压多少任务；",[211,17819,17820],{},"超出能力后如何处理。",[18,17822,17823,17824,17826],{},"这并不表示所有 ",[25,17825,17747],{}," 方法都不能使用，而是需要先理解其内部参数和运行边界。",[14,17828,17830],{"id":17829},"八execute-和-submit-有什么区别","八、execute 和 submit 有什么区别",[237,17832,16850],{"id":16850},[279,17834,17835],{"className":2173,"code":16841,"language":2175,"meta":285,"style":285},[25,17836,17837],{"__ignoreMap":285},[315,17838,17839,17841,17843],{"class":317,"line":318},[315,17840,16472],{"class":333},[315,17842,16850],{"class":321},[315,17844,16853],{"class":333},[245,17846,17847,17852,17855],{},[211,17848,17849,17850,734],{},"只接收 ",[25,17851,16435],{},[211,17853,17854],{},"没有任务结果；",[211,17856,17857],{},"任务抛出的未捕获异常可以到达线程的未捕获异常处理流程。",[237,17859,17860],{"id":17860},"submit",[279,17862,17864],{"className":2173,"code":17863,"language":2175,"meta":285,"style":285},"Future\u003CResult> future = threadPool.submit(callable);\n",[25,17865,17866],{"__ignoreMap":285},[315,17867,17868,17871,17874,17877,17879,17882,17884],{"class":317,"line":318},[315,17869,17870],{"class":333},"Future\u003C",[315,17872,17873],{"class":325},"Result",[315,17875,17876],{"class":333},"> future ",[315,17878,2511],{"class":325},[315,17880,17881],{"class":333}," threadPool.",[315,17883,17860],{"class":321},[315,17885,17886],{"class":333},"(callable);\n",[245,17888,17889,17897,17903],{},[211,17890,17891,17892,5414,17894,734],{},"可以接收 ",[25,17893,16435],{},[25,17895,17896],{},"Callable",[211,17898,17899,17900,17902],{},"返回 ",[25,17901,4013],{},"，可以获取结果、等待完成或取消任务；",[211,17904,17905,17906,17908,17909,17912,17913,17916],{},"任务异常会被封装在 ",[25,17907,4013],{}," 中，调用 ",[25,17910,17911],{},"get()"," 时以 ",[25,17914,17915],{},"ExecutionException"," 抛出。",[18,17918,17919,17920,17923,17924,17926,17927,4224],{},"如果调用 ",[25,17921,17922],{},"submit()"," 后既不保存 ",[25,17925,4013],{},"，也不检查任务结果，异常很容易被忽略。此时应在任务内部记录异常，或统一检查 ",[25,17928,4013],{},[14,17930,17932],{"id":17931},"九不同类型的任务为什么要隔离线程池","九、不同类型的任务为什么要隔离线程池",[18,17934,17935],{},"把所有异步任务放进同一个线程池，会产生资源相互影响。",[18,17937,3181],{},[279,17939,17942],{"className":17940,"code":17941,"language":284,"meta":285},[282],"慢第三方接口占满全部线程\n→ 订单本地计算任务无法执行\n→ 两类本来无关的业务一起超时\n",[25,17943,17941],{"__ignoreMap":285},[18,17945,17946],{},"可以按资源特征或故障域拆分：",[245,17948,17949,17952,17955,17958,17961],{},[211,17950,17951],{},"CPU 计算任务使用计算线程池；",[211,17953,17954],{},"数据库写入任务使用受连接池容量约束的线程池；",[211,17956,17957],{},"慢第三方接口使用独立线程池；",[211,17959,17960],{},"核心交易和非核心通知分开；",[211,17962,17963],{},"不同下游服务使用独立的并发上限。",[18,17965,17966],{},"线程池隔离不是越细越好。线程池过多会增加线程总数和管理成本，应围绕“是否共享同一个资源上限、是否应该相互影响”来划分。",[14,17968,17970],{"id":17969},"十需要监控哪些指标","十、需要监控哪些指标",[18,17972,17973],{},"线程池上线后至少应监控：",[98,17975,17976,17985],{},[101,17977,17978],{},[104,17979,17980,17982],{},[107,17981,6163],{},[107,17983,17984],{},"说明",[114,17986,17987,17998,18009,18020,18028,18036,18047,18055,18063,18071],{},[104,17988,17989,17995],{},[119,17990,17991,17992],{},"当前线程数 ",[25,17993,17994],{},"poolSize",[119,17996,17997],{},"线程池当前拥有的工作线程数量",[104,17999,18000,18006],{},[119,18001,18002,18003],{},"活跃线程数 ",[25,18004,18005],{},"activeCount",[119,18007,18008],{},"正在执行任务的线程数量",[104,18010,18011,18017],{},[119,18012,18013,18014],{},"历史最大线程数 ",[25,18015,18016],{},"largestPoolSize",[119,18018,18019],{},"是否曾经逼近最大线程数",[104,18021,18022,18025],{},[119,18023,18024],{},"队列长度",[119,18026,18027],{},"当前排队任务数量",[104,18029,18030,18033],{},[119,18031,18032],{},"队列剩余容量",[119,18034,18035],{},"距离队列满还有多少空间",[104,18037,18038,18044],{},[119,18039,18040,18041],{},"已完成任务数 ",[25,18042,18043],{},"completedTaskCount",[119,18045,18046],{},"任务是否持续推进",[104,18048,18049,18052],{},[119,18050,18051],{},"拒绝次数",[119,18053,18054],{},"线程池是否已经过载",[104,18056,18057,18060],{},[119,18058,18059],{},"任务排队耗时",[119,18061,18062],{},"任务从提交到开始执行等待了多久",[104,18064,18065,18068],{},[119,18066,18067],{},"任务执行耗时",[119,18069,18070],{},"业务逻辑自身耗时",[104,18072,18073,18076],{},[119,18074,18075],{},"任务成功率与异常数",[119,18077,18078],{},"是否存在持续失败或异常被吞掉",[18,18080,18081],{},"常见告警信号包括：",[245,18083,18084,18087,18090,18093,18096,18099],{},[211,18085,18086],{},"活跃线程数长时间接近最大线程数；",[211,18088,18089],{},"队列长度持续上升而不是短时波动；",[211,18091,18092],{},"排队耗时接近业务超时时间；",[211,18094,18095],{},"拒绝次数持续增长；",[211,18097,18098],{},"已完成任务数停止增长；",[211,18100,18101],{},"下游连接池和线程池同时耗尽。",[18,18103,18104],{},"只监控线程数量不够。很多线程池故障的第一表现不是线程数异常，而是队列等待时间持续增加。",[14,18106,18108],{"id":18107},"十一如何优雅关闭线程池","十一、如何优雅关闭线程池",[18,18110,18111,28,18114,18117],{},[25,18112,18113],{},"shutdown()",[25,18115,18116],{},"shutdownNow()"," 的语义不同：",[279,18119,18122],{"className":18120,"code":18121,"language":284,"meta":285},[282],"shutdown()\n→ 不再接收新任务\n→ 继续执行已提交任务\n\nshutdownNow()\n→ 尝试中断正在执行的任务\n→ 返回队列中尚未开始的任务\n",[25,18123,18121],{"__ignoreMap":285},[18,18125,18126],{},"常见关闭流程是：",[279,18128,18131],{"className":18129,"code":18130,"language":284,"meta":285},[282],"调用 shutdown()\n→ 在限定时间内 awaitTermination()\n→ 超时后调用 shutdownNow()\n→ 记录尚未开始执行的任务\n→ 再次 awaitTermination()，等待已收到中断请求的工作线程退出\n",[25,18132,18130],{"__ignoreMap":285},[18,18134,18135],{},"这里的“再次等待”不是重复做同一件事。",[18,18137,18138,18139,18142,18143,18145],{},"第一次 ",[25,18140,18141],{},"awaitTermination()"," 等待线程池在不接收新任务的前提下，自然执行完已经提交的任务。如果超时，",[25,18144,18116],{}," 会：",[208,18147,18148,18151],{},[211,18149,18150],{},"尝试中断正在执行的工作线程；",[211,18152,18153],{},"返回队列中尚未开始执行的任务列表。",[18,18155,18156,18157,18159],{},"调用方可以记录或补偿这批尚未开始的任务。随后第二次调用 ",[25,18158,18141],{},"，是给已经收到中断请求的工作线程留出退出时间。如果第二次仍然超时，说明某些任务可能没有正确响应中断，需要记录告警并进一步排查。",[18,18161,12793,18162,18164],{},[25,18163,18116],{}," 只能发出中断请求，不能强制终止线程。如果任务忽略中断，线程池仍可能无法及时结束。",[18,18166,18167,18168,18170],{},"任务代码还必须正确响应中断。阻塞调用收到 ",[25,18169,17734],{}," 后，不应随意吞掉中断状态。",[14,18172,18174],{"id":18173},"十二常见误区","十二、常见误区",[237,18176,18178],{"id":18177},"_1-最大线程数越大处理能力越强","1. 最大线程数越大，处理能力越强",[18,18180,18181],{},"线程数量超过 CPU、数据库连接池或下游承载能力后，只会增加竞争、等待和上下文切换。",[237,18183,18185],{"id":18184},"_2-队列越大越不容易出问题","2. 队列越大，越不容易出问题",[18,18187,18188],{},"大队列可能只是把拒绝转化为更长的延迟和更高的内存风险。",[237,18190,18192],{"id":18191},"_3-使用-callerrunspolicy-就解决了限流","3. 使用 CallerRunsPolicy 就解决了限流",[18,18194,18195,18197],{},[25,18196,16796],{}," 会让提交线程执行任务，从而减慢生产者，但它不是严格的 QPS 限流器。调用线程可能是 Web 请求线程、消息消费线程或定时调度线程，执行任务会影响这些上游组件的延迟和可用性。",[237,18199,18201],{"id":18200},"_4-threadpoolexecutor-线程安全任务就一定线程安全","4. ThreadPoolExecutor 线程安全，任务就一定线程安全",[18,18203,18204],{},"线程池只负责安全调度任务，不会自动保护任务访问的共享对象。任务内部仍要正确使用锁、原子类、并发容器或不可变对象。",[237,18206,18208],{"id":18207},"_5-submit-后没有异常日志就表示任务成功","5. submit 后没有异常日志，就表示任务成功",[18,18210,18211,18213,18214,18216,18217,18219],{},[25,18212,17922],{}," 会把异常保存到 ",[25,18215,4013],{},"。如果从未调用 ",[25,18218,17911],{}," 或没有统一异常处理，失败可能没有明显日志。",[237,18221,18223],{"id":18222},"_6-线程池能够无限吸收突发流量","6. 线程池能够无限吸收突发流量",[18,18225,18226],{},"线程池只能在有限线程和有限队列范围内吸收波动。持续过载必须通过限流、降级、削峰、扩容或优化下游能力解决。",[14,18228,18230],{"id":18229},"十三日常使用检查清单","十三、日常使用检查清单",[245,18232,18233,18236,18239,18242,18245,18248,18251,18254,18262,18269],{},[211,18234,18235],{},"是否按照任务类型和下游资源进行合理隔离；",[211,18237,18238],{},"是否明确设置线程数和有界队列；",[211,18240,18241],{},"线程数量是否与 CPU、连接池和下游容量匹配；",[211,18243,18244],{},"是否设置可识别的线程名称；",[211,18246,18247],{},"拒绝策略是否符合业务语义；",[211,18249,18250],{},"被拒绝任务是否有告警、降级或补偿；",[211,18252,18253],{},"是否记录排队耗时、执行耗时和拒绝次数；",[211,18255,18256,18258,18259,18261],{},[25,18257,17922],{}," 返回的 ",[25,18260,4013],{}," 是否被正确处理；",[211,18263,18264,18265,18268],{},"任务是否支持中断，是否会泄漏 ",[25,18266,18267],{},"ThreadLocal"," 上下文；",[211,18270,18271],{},"应用关闭时是否执行线程池优雅停止。",[14,18273,1191],{"id":1191},[245,18275,18276,18283,18290],{},[211,18277,18278],{},[70,18279,18282],{"href":18280,"rel":18281},"https:\u002F\u002Fdocs.oracle.com\u002Fjavase\u002F8\u002Fdocs\u002Fapi\u002Fjava\u002Futil\u002Fconcurrent\u002FThreadPoolExecutor.html",[1200],"ThreadPoolExecutor Java 8 API",[211,18284,18285],{},[70,18286,18289],{"href":18287,"rel":18288},"https:\u002F\u002Fdocs.oracle.com\u002Fjavase\u002F8\u002Fdocs\u002Fapi\u002Fjava\u002Futil\u002Fconcurrent\u002FExecutors.html",[1200],"Executors Java 8 API",[211,18291,18292],{},[70,18293,18296],{"href":18294,"rel":18295},"https:\u002F\u002Fdocs.oracle.com\u002Fjavase\u002F8\u002Fdocs\u002Fapi\u002Fjava\u002Futil\u002Fconcurrent\u002FRejectedExecutionHandler.html",[1200],"RejectedExecutionHandler Java 8 API",[1224,18298,18299],{},"html pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .s4XuR, html code.shiki .s4XuR{--shiki-default:#E36209;--shiki-dark:#FFAB70}html pre.shiki code .sJ8bj, html code.shiki .sJ8bj{--shiki-default:#6A737D;--shiki-dark:#6A737D}",{"title":285,"searchDepth":343,"depth":343,"links":18301},[18302,18303,18304,18305,18306,18315,18316,18317,18322,18323,18327,18331,18332,18333,18334,18342,18343],{"id":16,"depth":343,"text":16},{"id":66,"depth":343,"text":66},{"id":83,"depth":343,"text":83},{"id":16347,"depth":343,"text":16348},{"id":16377,"depth":343,"text":16378,"children":18307},[18308,18309,18310,18311,18312,18313,18314],{"id":16453,"depth":359,"text":16454},{"id":16506,"depth":359,"text":16507},{"id":16529,"depth":359,"text":16530},{"id":16574,"depth":359,"text":16575},{"id":16605,"depth":359,"text":16606},{"id":16714,"depth":359,"text":16715},{"id":16749,"depth":359,"text":16750},{"id":16834,"depth":343,"text":16835},{"id":16873,"depth":343,"text":16874},{"id":16910,"depth":343,"text":16911,"children":18318},[18319,18320,18321],{"id":16914,"depth":359,"text":16915},{"id":16933,"depth":359,"text":16934},{"id":16978,"depth":359,"text":16979},{"id":17011,"depth":343,"text":17012},{"id":17741,"depth":343,"text":17742,"children":18324},[18325,18326],{"id":17751,"depth":359,"text":17752},{"id":17770,"depth":359,"text":17771},{"id":17829,"depth":343,"text":17830,"children":18328},[18329,18330],{"id":16850,"depth":359,"text":16850},{"id":17860,"depth":359,"text":17860},{"id":17931,"depth":343,"text":17932},{"id":17969,"depth":343,"text":17970},{"id":18107,"depth":343,"text":18108},{"id":18173,"depth":343,"text":18174,"children":18335},[18336,18337,18338,18339,18340,18341],{"id":18177,"depth":359,"text":18178},{"id":18184,"depth":359,"text":18185},{"id":18191,"depth":359,"text":18192},{"id":18200,"depth":359,"text":18201},{"id":18207,"depth":359,"text":18208},{"id":18222,"depth":359,"text":18223},{"id":18229,"depth":343,"text":18230},{"id":1191,"depth":343,"text":1191},"wiki:java:java-thread-pool-core-parameters-and-practice","系统讲解 ThreadPoolExecutor 七个核心参数、任务提交流程、阻塞队列与拒绝策略选择，并给出线程池配置、监控、关闭和容量评估的日常实践。",{},79,"\u002Fjava\u002Fjava-thread-pool-core-parameters-and-practice",{"title":16276,"description":18345},"java\u002Fjava-thread-pool-core-parameters-and-practice","di9Q_z1vSXT1dkyqU0bFHy7k2NFzb6V7vRHzB-lGKx4",{"id":18353,"title":18354,"body":18355,"commentId":21045,"description":21046,"difficulty":1276,"draft":1277,"extension":1278,"meta":21047,"navigation":1280,"order":21048,"path":21049,"section":1283,"seo":21050,"stem":21051,"updated":1286,"__hash__":21052},"java\u002Fjava\u002Fspring-bean-lifecycle-and-extension-points.md","Spring Bean 生命周期有哪些阶段？都有哪些扩展点？",{"type":7,"value":18356,"toc":20984},[18357,18360,18362,18368,18386,18411,18425,18456,18458,18465,18467,18476,18478,18482,18485,18489,18492,18498,18502,18505,18511,18519,18523,18528,18551,18554,18580,18583,18587,18593,18595,18606,18612,18616,18624,18626,18637,18641,18650,18703,18709,18723,18740,18744,18747,18752,18794,18797,18800,18817,18824,18837,18840,18850,18854,18860,18863,18964,18967,19003,19006,19009,19015,19025,19029,19036,19040,19045,19048,19054,19057,19061,19070,19123,19126,19132,19135,19141,19148,19363,19375,19381,19451,19457,19461,19464,19526,19532,19536,19539,19560,19566,19570,19573,19577,19580,19586,19589,19600,19611,19615,19618,19624,19627,19633,19635,19649,19653,19660,19671,19677,19681,19687,19693,19697,19703,19706,19725,19728,19732,19735,19738,19822,19832,19835,19839,19842,19856,19858,19872,19876,19884,19887,19893,19897,19900,19918,19920,20031,20034,20094,20100,20103,20114,20117,20121,20124,20137,20140,20154,20160,20163,20169,20178,20182,20185,20189,20192,20225,20227,20242,20245,20249,20254,20256,20291,20294,20297,20301,20306,20369,20372,20389,20395,20399,20402,20405,20429,20437,20440,20457,20461,20468,20471,20477,20481,20619,20623,20630,20723,20729,20735,20742,20746,20749,20775,20785,20788,20805,20809,20813,20816,20820,20825,20829,20832,20836,20842,20846,20849,20853,20864,20868,20871,20877,20880,20886,20890,20942,20944,20981],[10,18358,18354],{"id":18359},"spring-bean-生命周期有哪些阶段都有哪些扩展点",[14,18361,16],{"id":16},[18,18363,18364,18365,4224],{},"Spring Bean 的完整生命周期可以分为：",[61,18366,18367],{},"Bean 定义注册与修改、实例化、属性填充、Aware 回调、初始化前处理、初始化、初始化后处理、Bean 就绪，以及容器关闭时的销毁",[18,18369,18370,18371,4224,18374,18377,18378,18381,18382,18385],{},"容器启动后，首先读取配置并注册 ",[25,18372,18373],{},"BeanDefinition",[25,18375,18376],{},"BeanDefinitionRegistryPostProcessor"," 可以继续注册或删除定义，",[25,18379,18380],{},"BeanFactoryPostProcessor"," 可以在 Bean 创建前修改定义。随后 Spring 注册所有 ",[25,18383,18384],{},"BeanPostProcessor","，再创建非懒加载单例。",[18,18387,18388,18389,18392,18393,5067,18396,5067,18399,18402,18403,18406,18407,18410],{},"创建单个 Bean 时，Spring先选择构造方法并实例化对象，再进行依赖注入；随后执行 ",[25,18390,18391],{},"Aware"," 回调、",[25,18394,18395],{},"BeanPostProcessor#postProcessBeforeInitialization()",[25,18397,18398],{},"@PostConstruct",[25,18400,18401],{},"InitializingBean#afterPropertiesSet()"," 和自定义 ",[25,18404,18405],{},"init-method","，最后执行 ",[25,18408,18409],{},"postProcessAfterInitialization()","。Spring AOP 通常在初始化后处理阶段返回代理对象。",[18,18412,18413,18414,18417,18418,18421,18422,18424],{},"这条主线还有一个特殊分支：目标对象实例化之前，",[25,18415,18416],{},"InstantiationAwareBeanPostProcessor#postProcessBeforeInstantiation()"," 可以返回替代对象。返回 ",[25,18419,18420],{},"null"," 才会继续正常创建；返回非 ",[25,18423,18420],{}," 时会跳过原 Bean 的实例化、属性填充和初始化，并对替代对象执行初始化后处理。",[18,18426,18427,18428,18431,18432,18435,18436,18439,18440,18443,18444,18447,18448,18451,18452,18455],{},"所有普通非懒加载单例创建完成后，可以使用 ",[25,18429,18430],{},"SmartInitializingSingleton"," 或监听 ",[25,18433,18434],{},"ContextRefreshedEvent"," 执行全局初始化；需要管理组件启动和停止顺序时，可以使用 ",[25,18437,18438],{},"SmartLifecycle","。容器关闭时，先由 ",[25,18441,18442],{},"DestructionAwareBeanPostProcessor"," 执行销毁前处理，其中 ",[25,18445,18446],{},"CommonAnnotationBeanPostProcessor"," 会调用 ",[25,18449,18450],{},"@PreDestroy","；之后再执行 ",[25,18453,18454],{},"DisposableBean#destroy()"," 和自定义销毁方法。",[18,18457,54],{},[56,18459,18460],{},[18,18461,18462],{},[61,18463,18464],{},"Spring 先处理 BeanDefinition，再通过 BeanPostProcessor 贯穿 Bean 的创建过程；Bean 初始化完成不等于容器全部就绪，批量就绪、运行启停和销毁分别有对应扩展点。",[14,18466,66],{"id":66},[18,18468,18469],{},[70,18470,18473],{"href":18471,"target":73,"rel":18472},"\u002Fimages\u002Fwiki\u002Fjava\u002Fspring-bean-lifecycle-and-extension-points.svg",[75,76],[78,18474],{"src":18471,"alt":18475},"Spring 容器启动、Bean 创建、就绪运行和销毁阶段及主要扩展点",[14,18477,83],{"id":83},[14,18479,18481],{"id":18480},"一先区分两个生命周期","一、先区分两个生命周期",[18,18483,18484],{},"讨论“Spring 生命周期”时，容易把两个概念混在一起：",[237,18486,18488],{"id":18487},"_1-applicationcontext-容器生命周期","1. ApplicationContext 容器生命周期",[18,18490,18491],{},"容器负责：",[279,18493,18496],{"className":18494,"code":18495,"language":284,"meta":285},[282],"加载配置\n→ 注册和修改 BeanDefinition\n→ 注册容器级后处理器\n→ 创建非懒加载单例\n→ 发布刷新完成事件\n→ 启动 Lifecycle 组件\n→ 关闭并销毁单例\n",[25,18497,18495],{"__ignoreMap":285},[237,18499,18501],{"id":18500},"_2-单个-bean-的生命周期","2. 单个 Bean 的生命周期",[18,18503,18504],{},"单个 Bean 经历：",[279,18506,18509],{"className":18507,"code":18508,"language":284,"meta":285},[282],"实例化\n→ 属性填充\n→ Aware 回调\n→ 初始化前处理\n→ 初始化回调\n→ 初始化后处理\n→ 对外提供\n→ 销毁\n",[25,18510,18508],{"__ignoreMap":285},[18,18512,18513,18515,18516,18518],{},[25,18514,18380],{}," 作用于整个容器中的 Bean 定义；",[25,18517,18384],{}," 作用于容器创建的 Bean 实例。两者所处层次不同。",[14,18520,18522],{"id":18521},"二阶段一加载并注册-beandefinition","二、阶段一：加载并注册 BeanDefinition",[18,18524,18525,18527],{},[25,18526,18373],{}," 是 Spring 创建 Bean 的配置模型，记录了：",[245,18529,18530,18533,18536,18539,18542,18545,18548],{},[211,18531,18532],{},"Bean 类型；",[211,18534,18535],{},"作用域；",[211,18537,18538],{},"是否懒加载；",[211,18540,18541],{},"构造参数和属性值；",[211,18543,18544],{},"初始化方法和销毁方法；",[211,18546,18547],{},"依赖关系；",[211,18549,18550],{},"是否允许作为自动注入候选项。",[18,18552,18553],{},"Bean 定义可能来自：",[245,18555,18556,18562,18568,18571,18574],{},[211,18557,18558,18561],{},[25,18559,18560],{},"@Component"," 组件扫描；",[211,18563,18564,18567],{},[25,18565,18566],{},"@Bean"," 方法；",[211,18569,18570],{},"XML；",[211,18572,18573],{},"程序化注册；",[211,18575,18576,18579],{},[25,18577,18578],{},"@Import"," 导入。",[18,18581,18582],{},"这一阶段还没有创建普通业务 Bean，处理的是“如何创建 Bean”的元数据。",[237,18584,18586],{"id":18585},"_1-importselector","1. ImportSelector",[18,18588,18589,18592],{},[25,18590,18591],{},"ImportSelector"," 根据导入类的元数据，返回需要注册的配置类名称。",[18,18594,3472],{},[245,18596,18597,18600,18603],{},[211,18598,18599],{},"按条件组合一组配置；",[211,18601,18602],{},"模块化装配；",[211,18604,18605],{},"框架自动配置入口。",[18,18607,18608,18611],{},[25,18609,18610],{},"DeferredImportSelector"," 会在普通配置类处理之后再决定导入内容，Spring Boot 自动配置大量使用了这类机制。",[237,18613,18615],{"id":18614},"_2-importbeandefinitionregistrar","2. ImportBeanDefinitionRegistrar",[18,18617,18618,18621,18622,4224],{},[25,18619,18620],{},"ImportBeanDefinitionRegistrar"," 可以直接向注册表写入 ",[25,18623,18373],{},[18,18625,3472],{},[245,18627,18628,18631,18634],{},[211,18629,18630],{},"根据注解属性动态注册 Bean；",[211,18632,18633],{},"为接口生成代理 BeanDefinition；",[211,18635,18636],{},"注册数量或名称在编译期不固定的组件。",[237,18638,18640],{"id":18639},"_3-beandefinitionregistrypostprocessor","3. BeanDefinitionRegistryPostProcessor",[18,18642,18643,18644,18646,18647,3382],{},"它是 ",[25,18645,18380],{}," 的子接口，核心能力是操作 ",[25,18648,18649],{},"BeanDefinitionRegistry",[279,18651,18653],{"className":2173,"code":18652,"language":2175,"meta":285,"style":285},"public interface BeanDefinitionRegistryPostProcessor\n extends BeanFactoryPostProcessor {\n\n void postProcessBeanDefinitionRegistry(\n BeanDefinitionRegistry registry);\n}\n",[25,18654,18655,18665,18675,18679,18689,18699],{"__ignoreMap":285},[315,18656,18657,18659,18662],{"class":317,"line":318},[315,18658,16391],{"class":325},[315,18660,18661],{"class":325}," interface",[315,18663,18664],{"class":321}," BeanDefinitionRegistryPostProcessor\n",[315,18666,18667,18670,18673],{"class":317,"line":343},[315,18668,18669],{"class":325}," extends",[315,18671,18672],{"class":321}," BeanFactoryPostProcessor",[315,18674,4034],{"class":333},[315,18676,18677],{"class":317,"line":359},[315,18678,2525],{"emptyLinePlaceholder":1280},[315,18680,18681,18684,18687],{"class":317,"line":375},[315,18682,18683],{"class":325}," void",[315,18685,18686],{"class":321}," postProcessBeanDefinitionRegistry",[315,18688,16397],{"class":333},[315,18690,18691,18694,18697],{"class":317,"line":391},[315,18692,18693],{"class":333}," BeanDefinitionRegistry ",[315,18695,18696],{"class":17406},"registry",[315,18698,8034],{"class":333},[315,18700,18701],{"class":317,"line":2562},[315,18702,2583],{"class":333},[18,18704,18705,18706,18708],{},"它可以在普通 ",[25,18707,18380],{}," 执行前：",[245,18710,18711,18714,18717,18720],{},[211,18712,18713],{},"注册新的 BeanDefinition；",[211,18715,18716],{},"删除或替换已有 BeanDefinition；",[211,18718,18719],{},"扫描额外的组件；",[211,18721,18722],{},"根据外部配置动态扩展容器。",[18,18724,18725,18728,18729,5067,18732,5067,18735,28,18737,18739],{},[25,18726,18727],{},"ConfigurationClassPostProcessor"," 就是重要实现，它负责解析 ",[25,18730,18731],{},"@Configuration",[25,18733,18734],{},"@ComponentScan",[25,18736,18578],{},[25,18738,18566],{}," 等配置。",[14,18741,18743],{"id":18742},"三阶段二修改-beandefinition","三、阶段二：修改 BeanDefinition",[237,18745,18380],{"id":18746},"beanfactorypostprocessor",[18,18748,18749,18750,3382],{},"所有 BeanDefinition 基本注册完成后，Spring 调用 ",[25,18751,18380],{},[279,18753,18755],{"className":2173,"code":18754,"language":2175,"meta":285,"style":285},"public interface BeanFactoryPostProcessor {\n\n void postProcessBeanFactory(\n ConfigurableListableBeanFactory beanFactory);\n}\n",[25,18756,18757,18767,18771,18780,18790],{"__ignoreMap":285},[315,18758,18759,18761,18763,18765],{"class":317,"line":318},[315,18760,16391],{"class":325},[315,18762,18661],{"class":325},[315,18764,18672],{"class":321},[315,18766,4034],{"class":333},[315,18768,18769],{"class":317,"line":343},[315,18770,2525],{"emptyLinePlaceholder":1280},[315,18772,18773,18775,18778],{"class":317,"line":359},[315,18774,18683],{"class":325},[315,18776,18777],{"class":321}," postProcessBeanFactory",[315,18779,16397],{"class":333},[315,18781,18782,18785,18788],{"class":317,"line":375},[315,18783,18784],{"class":333}," ConfigurableListableBeanFactory ",[315,18786,18787],{"class":17406},"beanFactory",[315,18789,8034],{"class":333},[315,18791,18792],{"class":317,"line":391},[315,18793,2583],{"class":333},[18,18795,18796],{},"它处理的是 BeanDefinition，而不是已经创建好的业务对象。",[18,18798,18799],{},"典型能力包括：",[245,18801,18802,18805,18808,18811,18814],{},[211,18803,18804],{},"修改属性值；",[211,18806,18807],{},"修改作用域和懒加载配置；",[211,18809,18810],{},"调整自动注入候选状态；",[211,18812,18813],{},"解析配置占位符；",[211,18815,18816],{},"注册容器级基础设施。",[18,18818,18819,18820,18823],{},"例如 ",[25,18821,18822],{},"PropertySourcesPlaceholderConfigurer"," 会把：",[279,18825,18827],{"className":3895,"code":18826,"language":3897,"meta":285,"style":285},"order.timeout=${ORDER_TIMEOUT}\n",[25,18828,18829],{"__ignoreMap":285},[315,18830,18831,18834],{"class":317,"line":318},[315,18832,18833],{"class":325},"order.timeout",[315,18835,18836],{"class":333},"=${ORDER_TIMEOUT}\n",[18,18838,18839],{},"中的占位符替换为环境中的实际值。",[18,18841,18842,18843,18846,18847,18849],{},"不要在这个阶段随意调用 ",[25,18844,18845],{},"getBean()","。这会导致普通 Bean 提前创建，使它可能绕过尚未注册完成的 ",[25,18848,18384],{},"，进而错过依赖注入、AOP 等处理。",[14,18851,18853],{"id":18852},"四阶段三注册-beanpostprocessor","四、阶段三：注册 BeanPostProcessor",[18,18855,18856,18857,18859],{},"Spring 会提前创建并注册所有 ",[25,18858,18384],{},"，使它们能够处理后续创建的 Bean。",[18,18861,18862],{},"基础接口如下：",[279,18864,18866],{"className":2173,"code":18865,"language":2175,"meta":285,"style":285},"public interface BeanPostProcessor {\n\n default Object postProcessBeforeInitialization(\n Object bean, String beanName) {\n return bean;\n }\n\n default Object postProcessAfterInitialization(\n Object bean, String beanName) {\n return bean;\n }\n}\n",[25,18867,18868,18879,18883,18896,18912,18919,18923,18927,18938,18950,18956,18960],{"__ignoreMap":285},[315,18869,18870,18872,18874,18877],{"class":317,"line":318},[315,18871,16391],{"class":325},[315,18873,18661],{"class":325},[315,18875,18876],{"class":321}," BeanPostProcessor",[315,18878,4034],{"class":333},[315,18880,18881],{"class":317,"line":343},[315,18882,2525],{"emptyLinePlaceholder":1280},[315,18884,18885,18888,18891,18894],{"class":317,"line":359},[315,18886,18887],{"class":325}," default",[315,18889,18890],{"class":333}," Object ",[315,18892,18893],{"class":321},"postProcessBeforeInitialization",[315,18895,16397],{"class":333},[315,18897,18898,18901,18904,18907,18910],{"class":317,"line":375},[315,18899,18900],{"class":333}," Object ",[315,18902,18903],{"class":17406},"bean",[315,18905,18906],{"class":333},", String ",[315,18908,18909],{"class":17406},"beanName",[315,18911,4051],{"class":333},[315,18913,18914,18916],{"class":317,"line":391},[315,18915,17256],{"class":325},[315,18917,18918],{"class":333}," bean;\n",[315,18920,18921],{"class":317,"line":2562},[315,18922,4070],{"class":333},[315,18924,18925],{"class":317,"line":2580},[315,18926,2525],{"emptyLinePlaceholder":1280},[315,18928,18929,18931,18933,18936],{"class":317,"line":2586},[315,18930,18887],{"class":325},[315,18932,18890],{"class":333},[315,18934,18935],{"class":321},"postProcessAfterInitialization",[315,18937,16397],{"class":333},[315,18939,18940,18942,18944,18946,18948],{"class":317,"line":2591},[315,18941,18900],{"class":333},[315,18943,18903],{"class":17406},[315,18945,18906],{"class":333},[315,18947,18909],{"class":17406},[315,18949,4051],{"class":333},[315,18951,18952,18954],{"class":317,"line":17092},[315,18953,17256],{"class":325},[315,18955,18918],{"class":333},[315,18957,18958],{"class":317,"line":17097},[315,18959,4070],{"class":333},[315,18961,18962],{"class":317,"line":17120},[315,18963,2583],{"class":333},[18,18965,18966],{},"常见功能很多都建立在 BeanPostProcessor 体系上：",[245,18968,18969,18978,18984,18987,18992,18997,19000],{},[211,18970,18971,5067,18974,18977],{},[25,18972,18973],{},"@Autowired",[25,18975,18976],{},"@Value"," 注入；",[211,18979,18980,5067,18982,734],{},[25,18981,18398],{},[25,18983,18450],{},[211,18985,18986],{},"AOP 自动代理；",[211,18988,18989,734],{},[25,18990,18991],{},"@Async",[211,18993,18994,734],{},[25,18995,18996],{},"@Scheduled",[211,18998,18999],{},"事务代理；",[211,19001,19002],{},"异常转换。",[237,19004,19005],{"id":19005},"执行顺序",[18,19007,19008],{},"多个后处理器通常按照以下优先级排序：",[279,19010,19013],{"className":19011,"code":19012,"language":284,"meta":285},[282],"PriorityOrdered\n→ Ordered\n→ 未实现排序接口\n",[25,19014,19012],{"__ignoreMap":285},[18,19016,19017,19018,19021,19022,4224],{},"程序化调用 ",[25,19019,19020],{},"addBeanPostProcessor()"," 注册时，主要按照实际注册顺序执行，不应只依赖 ",[25,19023,19024],{},"Ordered",[14,19026,19028],{"id":19027},"五阶段四实例化-bean","五、阶段四：实例化 Bean",[18,19030,19031,19032,19035],{},"Spring 在 ",[25,19033,19034],{},"AbstractAutowireCapableBeanFactory#createBean()"," 中进入单个 Bean 的创建流程。",[237,19037,19039],{"id":19038},"_1-实例化前扩展","1. 实例化前扩展",[18,19041,19042,19044],{},[25,19043,18416],{}," 在目标对象真正实例化前执行。",[18,19046,19047],{},"它可以直接返回一个对象，例如代理：",[279,19049,19052],{"className":19050,"code":19051,"language":284,"meta":285},[282],"返回 null\n→ 继续正常实例化流程\n\n返回非 null\n→ 跳过普通实例化、属性填充和初始化流程\n→ 对返回对象执行初始化后处理\n",[25,19053,19051],{"__ignoreMap":285},[18,19055,19056],{},"这属于特殊扩展点，主要用于框架基础设施，不适合承载普通业务初始化。",[237,19058,19060],{"id":19059},"_2-为什么同时存在两个-before-回调","2. 为什么同时存在两个 Before 回调",[18,19062,19063,28,19066,19069],{},[25,19064,19065],{},"postProcessBeforeInstantiation()",[25,19067,19068],{},"postProcessBeforeInitialization()"," 名称相似，但位置、作用和接收到的参数完全不同：",[98,19071,19072,19088],{},[101,19073,19074],{},[104,19075,19076,19079,19082,19085],{},[107,19077,19078],{},"回调",[107,19080,19081],{},"所属接口",[107,19083,19084],{},"执行位置",[107,19086,19087],{},"此时原 Bean 是否存在",[114,19089,19090,19107],{},[104,19091,19092,19096,19101,19104],{},[119,19093,19094],{},[25,19095,19065],{},[119,19097,19098],{},[25,19099,19100],{},"InstantiationAwareBeanPostProcessor",[119,19102,19103],{},"构造方法或工厂方法执行前",[119,19105,19106],{},"不存在",[104,19108,19109,19113,19117,19120],{},[119,19110,19111],{},[25,19112,19068],{},[119,19114,19115],{},[25,19116,18384],{},[119,19118,19119],{},"实例化、属性填充和 Aware 回调之后，初始化方法之前",[119,19121,19122],{},"已经存在",[18,19124,19125],{},"正常创建路径如下：",[279,19127,19130],{"className":19128,"code":19129,"language":284,"meta":285},[282],"postProcessBeforeInstantiation 返回 null\n→ 选择构造方法并实例化\n→ postProcessAfterInstantiation\n→ postProcessProperties\n→ 属性填充\n→ Aware 回调\n→ postProcessBeforeInitialization\n → @PostConstruct\n→ afterPropertiesSet\n→ 自定义 init-method\n→ postProcessAfterInitialization\n",[25,19131,19129],{"__ignoreMap":285},[18,19133,19134],{},"短路路径则是：",[279,19136,19139],{"className":19137,"code":19138,"language":284,"meta":285},[282],"postProcessBeforeInstantiation 返回非 null 对象\n→ 跳过原 Bean 的实例化、属性填充和初始化\n→ 对返回对象执行 postProcessAfterInitialization\n→ 返回对象成为最终 Bean\n",[25,19140,19138],{"__ignoreMap":285},[18,19142,19143,19144,19147],{},"下面的处理器会在 ",[25,19145,19146],{},"GreetingServiceImpl"," 实例化之前直接返回一个 JDK 动态代理：",[279,19149,19151],{"className":2173,"code":19150,"language":2175,"meta":285,"style":285},"@Component\npublic class GreetingInstantiationPostProcessor\n implements InstantiationAwareBeanPostProcessor {\n\n @Override\n public Object postProcessBeforeInstantiation(\n Class\u003C?> beanClass,\n String beanName) {\n\n if (beanClass != GreetingServiceImpl.class) {\n return null;\n }\n\n return Proxy.newProxyInstance(\n beanClass.getClassLoader(),\n beanClass.getInterfaces(),\n (proxy, method, args) -> {\n if (\"hello\".equals(method.getName())) {\n return \"hello from proxy\";\n }\n return null;\n });\n }\n}\n",[25,19152,19153,19161,19170,19180,19184,19192,19203,19219,19228,19232,19245,19254,19258,19262,19274,19285,19294,19303,19326,19336,19341,19350,19355,19359],{"__ignoreMap":285},[315,19154,19155,19158],{"class":317,"line":318},[315,19156,19157],{"class":333},"@",[315,19159,19160],{"class":325},"Component\n",[315,19162,19163,19165,19167],{"class":317,"line":343},[315,19164,16391],{"class":325},[315,19166,17084],{"class":325},[315,19168,19169],{"class":321}," GreetingInstantiationPostProcessor\n",[315,19171,19172,19175,19178],{"class":317,"line":359},[315,19173,19174],{"class":325}," implements",[315,19176,19177],{"class":321}," InstantiationAwareBeanPostProcessor",[315,19179,4034],{"class":333},[315,19181,19182],{"class":317,"line":375},[315,19183,2525],{"emptyLinePlaceholder":1280},[315,19185,19186,19189],{"class":317,"line":391},[315,19187,19188],{"class":333}," @",[315,19190,19191],{"class":325},"Override\n",[315,19193,19194,19196,19198,19201],{"class":317,"line":2562},[315,19195,17392],{"class":325},[315,19197,18890],{"class":333},[315,19199,19200],{"class":321},"postProcessBeforeInstantiation",[315,19202,16397],{"class":333},[315,19204,19205,19208,19211,19214,19217],{"class":317,"line":2580},[315,19206,19207],{"class":333}," Class\u003C",[315,19209,19210],{"class":325},"?",[315,19212,19213],{"class":333},"> ",[315,19215,19216],{"class":17406},"beanClass",[315,19218,13133],{"class":333},[315,19220,19221,19224,19226],{"class":317,"line":2586},[315,19222,19223],{"class":333}," String ",[315,19225,18909],{"class":17406},[315,19227,4051],{"class":333},[315,19229,19230],{"class":317,"line":2591},[315,19231,2525],{"emptyLinePlaceholder":1280},[315,19233,19234,19237,19240,19242],{"class":317,"line":17092},[315,19235,19236],{"class":325}," if",[315,19238,19239],{"class":333}," (beanClass ",[315,19241,4045],{"class":325},[315,19243,19244],{"class":333}," GreetingServiceImpl.class) {\n",[315,19246,19247,19250,19252],{"class":317,"line":17097},[315,19248,19249],{"class":325}," return",[315,19251,4048],{"class":839},[315,19253,7876],{"class":333},[315,19255,19256],{"class":317,"line":17120},[315,19257,17465],{"class":333},[315,19259,19260],{"class":317,"line":17125},[315,19261,2525],{"emptyLinePlaceholder":1280},[315,19263,19264,19266,19269,19272],{"class":317,"line":17146},[315,19265,17256],{"class":325},[315,19267,19268],{"class":333}," Proxy.",[315,19270,19271],{"class":321},"newProxyInstance",[315,19273,16397],{"class":333},[315,19275,19276,19279,19282],{"class":317,"line":17161},[315,19277,19278],{"class":333}," beanClass.",[315,19280,19281],{"class":321},"getClassLoader",[315,19283,19284],{"class":333},"(),\n",[315,19286,19287,19289,19292],{"class":317,"line":17167},[315,19288,19278],{"class":333},[315,19290,19291],{"class":321},"getInterfaces",[315,19293,19284],{"class":333},[315,19295,19296,19299,19301],{"class":317,"line":17185},[315,19297,19298],{"class":333}," (proxy, method, args) ",[315,19300,4031],{"class":325},[315,19302,4034],{"class":333},[315,19304,19305,19308,19310,19313,19315,19318,19321,19323],{"class":317,"line":17191},[315,19306,19307],{"class":325}," if",[315,19309,4311],{"class":333},[315,19311,19312],{"class":329},"\"hello\"",[315,19314,8885],{"class":333},[315,19316,19317],{"class":321},"equals",[315,19319,19320],{"class":333},"(method.",[315,19322,17222],{"class":321},[315,19324,19325],{"class":333},"())) {\n",[315,19327,19328,19331,19334],{"class":317,"line":17206},[315,19329,19330],{"class":325}," return",[315,19332,19333],{"class":329}," \"hello from proxy\"",[315,19335,7876],{"class":333},[315,19337,19338],{"class":317,"line":17216},[315,19339,19340],{"class":333}," }\n",[315,19342,19343,19346,19348],{"class":317,"line":17242},[315,19344,19345],{"class":325}," return",[315,19347,4048],{"class":839},[315,19349,7876],{"class":333},[315,19351,19352],{"class":317,"line":17248},[315,19353,19354],{"class":333}," });\n",[315,19356,19357],{"class":317,"line":17253},[315,19358,4070],{"class":333},[315,19360,19361],{"class":317,"line":17262},[315,19362,2583],{"class":333},[18,19364,8151,19365,19367,19368,19371,19372,19374],{},[25,19366,19146],{}," 实现了 ",[25,19369,19370],{},"GreetingService"," 接口，那么容器最终保存的是代理对象，原类的构造方法和 ",[25,19373,18398],{}," 都不会执行。使用 JDK 动态代理时应通过接口类型获取或注入该 Bean，不能把最终对象强制转换为实现类。",[18,19376,19377,19378,19380],{},"如果这个方法返回 ",[25,19379,18420],{},"，Spring才会继续创建原对象：",[279,19382,19384],{"className":2173,"code":19383,"language":2175,"meta":285,"style":285},"@Override\npublic Object postProcessBeforeInstantiation(\n Class\u003C?> beanClass,\n String beanName) {\n\n System.out.println(\"实例化前：\" + beanName);\n return null;\n}\n",[25,19385,19386,19392,19402,19413,19418,19422,19438,19447],{"__ignoreMap":285},[315,19387,19388,19390],{"class":317,"line":318},[315,19389,19157],{"class":333},[315,19391,19191],{"class":325},[315,19393,19394,19396,19398,19400],{"class":317,"line":343},[315,19395,16391],{"class":325},[315,19397,18890],{"class":333},[315,19399,19200],{"class":321},[315,19401,16397],{"class":333},[315,19403,19404,19407,19410],{"class":317,"line":359},[315,19405,19406],{"class":333}," Class",[315,19408,19409],{"class":325},"\u003C?>",[315,19411,19412],{"class":333}," beanClass,\n",[315,19414,19415],{"class":317,"line":375},[315,19416,19417],{"class":333}," String beanName) {\n",[315,19419,19420],{"class":317,"line":391},[315,19421,2525],{"emptyLinePlaceholder":1280},[315,19423,19424,19426,19428,19430,19433,19435],{"class":317,"line":2562},[315,19425,2565],{"class":333},[315,19427,2533],{"class":321},[315,19429,4349],{"class":333},[315,19431,19432],{"class":329},"\"实例化前：\"",[315,19434,17173],{"class":325},[315,19436,19437],{"class":333}," beanName);\n",[315,19439,19440,19443,19445],{"class":317,"line":2580},[315,19441,19442],{"class":325}," return",[315,19444,4048],{"class":839},[315,19446,7876],{"class":333},[315,19448,19449],{"class":317,"line":2586},[315,19450,2583],{"class":333},[18,19452,19453,19454,19456],{},"还要注意，普通 Spring AOP 通常在 ",[25,19455,18409],{}," 中创建代理。实例化前直接返回代理属于特殊的短路能力，不能把它理解为所有 AOP 代理的常规创建位置。",[237,19458,19460],{"id":19459},"_3-instantiationawarebeanpostprocessor-不只在实例化前工作","3. InstantiationAwareBeanPostProcessor 不只在实例化前工作",[18,19462,19463],{},"这个接口名称表示它能够感知 Bean 的实例化过程，但它的回调分布在多个阶段：",[98,19465,19466,19476],{},[101,19467,19468],{},[104,19469,19470,19473],{},[107,19471,19472],{},"方法",[107,19474,19475],{},"执行阶段",[114,19477,19478,19487,19497,19507,19517],{},[104,19479,19480,19484],{},[119,19481,19482],{},[25,19483,19065],{},[119,19485,19486],{},"目标对象实例化前",[104,19488,19489,19494],{},[119,19490,19491],{},[25,19492,19493],{},"postProcessAfterInstantiation()",[119,19495,19496],{},"目标对象实例化后、属性填充前",[104,19498,19499,19504],{},[119,19500,19501],{},[25,19502,19503],{},"postProcessProperties()",[119,19505,19506],{},"属性填充阶段",[104,19508,19509,19514],{},[119,19510,19511,19512],{},"继承的 ",[25,19513,19068],{},[119,19515,19516],{},"初始化方法前",[104,19518,19519,19523],{},[119,19520,19511,19521],{},[25,19522,18409],{},[119,19524,19525],{},"初始化方法后",[18,19527,19528,19529,19531],{},"因此，准确的说法不是“",[25,19530,19100],{}," 只在实例化前执行”，而是“它提供了实例化前、实例化后和属性填充阶段的扩展能力，同时继承了 BeanPostProcessor 的初始化前后回调”。",[237,19533,19535],{"id":19534},"_4-选择构造方法","4. 选择构造方法",[18,19537,19538],{},"Spring需要决定使用：",[245,19540,19541,19544,19547,19552,19555],{},[211,19542,19543],{},"默认构造方法；",[211,19545,19546],{},"显式指定的构造方法；",[211,19548,19549,19551],{},[25,19550,18973],{}," 构造方法；",[211,19553,19554],{},"工厂方法；",[211,19556,19557,4224],{},[25,19558,19559],{},"Supplier",[18,19561,19562,19565],{},[25,19563,19564],{},"SmartInstantiationAwareBeanPostProcessor#determineCandidateConstructors()"," 可以参与候选构造方法选择。",[237,19567,19569],{"id":19568},"_5-创建原始对象","5. 创建原始对象",[18,19571,19572],{},"构造方法或工厂方法执行完成后，得到的是原始 Bean 实例。此时依赖属性通常还没有填充，初始化回调也没有执行。",[14,19574,19576],{"id":19575},"六阶段五处理合并后的-beandefinition","六、阶段五：处理合并后的 BeanDefinition",[18,19578,19579],{},"父子 BeanDefinition、配置覆盖和类型解析完成后，Spring 得到合并后的 BeanDefinition。",[18,19581,19582,19585],{},[25,19583,19584],{},"MergedBeanDefinitionPostProcessor#postProcessMergedBeanDefinition()"," 可以缓存与具体 Bean 类型有关的元数据。",[18,19587,19588],{},"常见用途包括：",[245,19590,19591,19594,19597],{},[211,19592,19593],{},"扫描注入点；",[211,19595,19596],{},"缓存注解元数据；",[211,19598,19599],{},"为后续属性注入和销毁处理做准备。",[18,19601,19602,19605,19606,5067,19608,19610],{},[25,19603,19604],{},"AutowiredAnnotationBeanPostProcessor"," 会在这里分析 ",[25,19607,18973],{},[25,19609,18976],{}," 等注入信息，避免每次都重新反射扫描。",[14,19612,19614],{"id":19613},"七阶段六提前暴露引用","七、阶段六：提前暴露引用",[18,19616,19617],{},"对于允许循环依赖处理的单例，Spring可能在属性填充前暴露一个对象工厂：",[279,19619,19622],{"className":19620,"code":19621,"language":284,"meta":285},[282],"singletonFactories\n→ earlySingletonObjects\n→ singletonObjects\n",[25,19623,19621],{"__ignoreMap":285},[18,19625,19626],{},"这里暴露的不是“已经完成初始化的 Bean”，而是用于打破依赖环的早期引用。",[18,19628,19629,19632],{},[25,19630,19631],{},"SmartInstantiationAwareBeanPostProcessor#getEarlyBeanReference()"," 可以决定早期暴露什么对象。AOP 自动代理创建器会利用这个扩展点，尽量让循环依赖中的其他 Bean 获得代理引用，而不是直接获得原始对象。",[18,19634,3971],{},[245,19636,19637,19640,19643,19646],{},[211,19638,19639],{},"这主要处理单例的属性或 Setter 注入循环依赖；",[211,19641,19642],{},"构造器循环依赖无法靠提前暴露一个尚未构造完成的对象解决；",[211,19644,19645],{},"原型 Bean 的循环依赖也不能通过三级缓存解决；",[211,19647,19648],{},"不应把三级缓存当成设计循环依赖的理由。",[14,19650,19652],{"id":19651},"八阶段七属性填充与依赖注入","八、阶段七：属性填充与依赖注入",[18,19654,19655,19656,19659],{},"实例创建后，Spring进入 ",[25,19657,19658],{},"populateBean()","，为对象填充依赖。",[18,19661,19662,19664,19665,19667,19668,19670],{},[25,19663,19658],{}," 是这一阶段的主流程入口，不要把它与 ",[25,19666,19503],{}," 混为一谈。前者负责组织整个属性填充阶段，后者只是 ",[25,19669,19100],{}," 在该阶段提供的扩展回调。其主要调用关系可以简化为：",[279,19672,19675],{"className":19673,"code":19674,"language":284,"meta":285},[282],"populateBean\n├── postProcessAfterInstantiation\n├── postProcessProperties\n└── 应用 BeanDefinition 中配置的属性值\n",[25,19676,19674],{"__ignoreMap":285},[237,19678,19680],{"id":19679},"_1-postprocessafterinstantiation","1. postProcessAfterInstantiation",[18,19682,19683,19686],{},[25,19684,19685],{},"InstantiationAwareBeanPostProcessor#postProcessAfterInstantiation()"," 在对象已经实例化、属性填充尚未开始时执行。",[18,19688,17899,19689,19692],{},[25,19690,19691],{},"false"," 可以阻止 Spring继续执行常规属性填充，因此属于影响较大的底层扩展点。",[237,19694,19696],{"id":19695},"_2-postprocessproperties","2. postProcessProperties",[18,19698,19699,19702],{},[25,19700,19701],{},"InstantiationAwareBeanPostProcessor#postProcessProperties()"," 可以处理属性注入。",[18,19704,19705],{},"典型实现：",[245,19707,19708,19717],{},[211,19709,19710,19712,19713,28,19715,734],{},[25,19711,19604],{},"：处理 ",[25,19714,18973],{},[25,19716,18976],{},[211,19718,19719,19712,19721,19724],{},[25,19720,18446],{},[25,19722,19723],{},"@Resource"," 等 Jakarta 注解。",[18,19726,19727],{},"随后 Spring还会应用 BeanDefinition 中显式配置的属性值。",[14,19729,19731],{"id":19730},"九阶段八aware-回调","九、阶段八：Aware 回调",[18,19733,19734],{},"依赖注入完成后，Spring让 Bean 感知容器提供的基础设施。",[18,19736,19737],{},"常见接口包括：",[98,19739,19740,19750],{},[101,19741,19742],{},[104,19743,19744,19747],{},[107,19745,19746],{},"Aware 接口",[107,19748,19749],{},"能够获得的对象",[114,19751,19752,19762,19772,19782,19792,19802,19812],{},[104,19753,19754,19759],{},[119,19755,19756],{},[25,19757,19758],{},"BeanNameAware",[119,19760,19761],{},"当前 Bean 名称",[104,19763,19764,19769],{},[119,19765,19766],{},[25,19767,19768],{},"BeanClassLoaderAware",[119,19770,19771],{},"Bean 类加载器",[104,19773,19774,19779],{},[119,19775,19776],{},[25,19777,19778],{},"BeanFactoryAware",[119,19780,19781],{},"当前 BeanFactory",[104,19783,19784,19789],{},[119,19785,19786],{},[25,19787,19788],{},"EnvironmentAware",[119,19790,19791],{},"Environment",[104,19793,19794,19799],{},[119,19795,19796],{},[25,19797,19798],{},"ApplicationEventPublisherAware",[119,19800,19801],{},"事件发布器",[104,19803,19804,19809],{},[119,19805,19806],{},[25,19807,19808],{},"ResourceLoaderAware",[119,19810,19811],{},"资源加载器",[104,19813,19814,19819],{},[119,19815,19816],{},[25,19817,19818],{},"ApplicationContextAware",[119,19820,19821],{},"ApplicationContext",[18,19823,19824,19825,19827,19828,19831],{},"前三个由 BeanFactory 初始化流程直接调用；",[25,19826,19818],{}," 等接口通常由 ",[25,19829,19830],{},"ApplicationContextAwareProcessor"," 这个 BeanPostProcessor 处理。",[18,19833,19834],{},"Aware 适合获取容器基础设施，但会让业务类与 Spring 接口耦合。普通业务依赖仍应优先采用构造器注入。",[14,19836,19838],{"id":19837},"十阶段九初始化前处理","十、阶段九：初始化前处理",[18,19840,19841],{},"Spring依次调用所有：",[279,19843,19845],{"className":2173,"code":19844,"language":2175,"meta":285,"style":285},"BeanPostProcessor#postProcessBeforeInitialization()\n",[25,19846,19847],{"__ignoreMap":285},[315,19848,19849,19852,19854],{"class":317,"line":318},[315,19850,19851],{"class":333},"BeanPostProcessor#",[315,19853,18893],{"class":321},[315,19855,17182],{"class":333},[18,19857,19588],{},[245,19859,19860,19863,19866,19869],{},[211,19861,19862],{},"识别并执行生命周期注解；",[211,19864,19865],{},"对 Bean 做初始化前检查；",[211,19867,19868],{},"注入容器上下文相关能力；",[211,19870,19871],{},"包装或替换 Bean。",[237,19873,19875],{"id":19874},"postconstruct-在哪里执行","@PostConstruct 在哪里执行",[18,19877,19878,19880,19881,19883],{},[25,19879,18398],{}," 不是 Spring硬编码在初始化流程中的独立步骤，而是由 ",[25,19882,18446],{}," 在初始化前处理阶段识别并调用。",[18,19885,19886],{},"因此从宏观顺序看：",[279,19888,19891],{"className":19889,"code":19890,"language":284,"meta":285},[282],"Aware 回调\n→ postProcessBeforeInitialization\n → @PostConstruct\n→ InitializingBean\n→ 自定义 init-method\n",[25,19892,19890],{"__ignoreMap":285},[14,19894,19896],{"id":19895},"十一阶段十执行初始化回调","十一、阶段十：执行初始化回调",[18,19898,19899],{},"同一个 Bean 同时使用多种初始化机制且方法名不同时，调用顺序是：",[208,19901,19902,19906,19910],{},[211,19903,19904,734],{},[25,19905,18398],{},[211,19907,19908,734],{},[25,19909,18401],{},[211,19911,19912,19915,19916,4224],{},[25,19913,19914],{},"@Bean(initMethod = \"...\")"," 或 XML ",[25,19917,18405],{},[18,19919,2498],{},[279,19921,19923],{"className":2173,"code":19922,"language":2175,"meta":285,"style":285},"public class PaymentClient implements InitializingBean {\n\n @PostConstruct\n public void validateConfiguration() {\n \u002F\u002F 校验配置\n }\n\n @Override\n public void afterPropertiesSet() {\n \u002F\u002F Spring 接口回调\n }\n\n public void init() {\n \u002F\u002F 自定义初始化方法\n }\n}\n",[25,19924,19925,19942,19946,19953,19964,19969,19973,19977,19983,19994,19999,20003,20007,20018,20023,20027],{"__ignoreMap":285},[315,19926,19927,19929,19931,19934,19937,19940],{"class":317,"line":318},[315,19928,16391],{"class":325},[315,19930,17084],{"class":325},[315,19932,19933],{"class":321}," PaymentClient",[315,19935,19936],{"class":325}," implements",[315,19938,19939],{"class":321}," InitializingBean",[315,19941,4034],{"class":333},[315,19943,19944],{"class":317,"line":343},[315,19945,2525],{"emptyLinePlaceholder":1280},[315,19947,19948,19950],{"class":317,"line":359},[315,19949,19188],{"class":333},[315,19951,19952],{"class":325},"PostConstruct\n",[315,19954,19955,19957,19959,19962],{"class":317,"line":375},[315,19956,17392],{"class":325},[315,19958,17397],{"class":325},[315,19960,19961],{"class":321}," validateConfiguration",[315,19963,17376],{"class":333},[315,19965,19966],{"class":317,"line":391},[315,19967,19968],{"class":4056}," \u002F\u002F 校验配置\n",[315,19970,19971],{"class":317,"line":2562},[315,19972,4070],{"class":333},[315,19974,19975],{"class":317,"line":2580},[315,19976,2525],{"emptyLinePlaceholder":1280},[315,19978,19979,19981],{"class":317,"line":2586},[315,19980,19188],{"class":333},[315,19982,19191],{"class":325},[315,19984,19985,19987,19989,19992],{"class":317,"line":2591},[315,19986,17392],{"class":325},[315,19988,17397],{"class":325},[315,19990,19991],{"class":321}," afterPropertiesSet",[315,19993,17376],{"class":333},[315,19995,19996],{"class":317,"line":17092},[315,19997,19998],{"class":4056}," \u002F\u002F Spring 接口回调\n",[315,20000,20001],{"class":317,"line":17097},[315,20002,4070],{"class":333},[315,20004,20005],{"class":317,"line":17120},[315,20006,2525],{"emptyLinePlaceholder":1280},[315,20008,20009,20011,20013,20016],{"class":317,"line":17125},[315,20010,17392],{"class":325},[315,20012,17397],{"class":325},[315,20014,20015],{"class":321}," init",[315,20017,17376],{"class":333},[315,20019,20020],{"class":317,"line":17146},[315,20021,20022],{"class":4056}," \u002F\u002F 自定义初始化方法\n",[315,20024,20025],{"class":317,"line":17161},[315,20026,4070],{"class":333},[315,20028,20029],{"class":317,"line":17167},[315,20030,2583],{"class":333},[18,20032,20033],{},"配置：",[279,20035,20037],{"className":2173,"code":20036,"language":2175,"meta":285,"style":285},"@Bean(initMethod = \"init\", destroyMethod = \"close\")\npublic PaymentClient paymentClient() {\n return new PaymentClient();\n}\n",[25,20038,20039,20068,20080,20090],{"__ignoreMap":285},[315,20040,20041,20043,20046,20048,20051,20053,20056,20058,20061,20063,20066],{"class":317,"line":318},[315,20042,19157],{"class":333},[315,20044,20045],{"class":325},"Bean",[315,20047,4349],{"class":333},[315,20049,20050],{"class":839},"initMethod",[315,20052,8633],{"class":325},[315,20054,20055],{"class":329}," \"init\"",[315,20057,4327],{"class":333},[315,20059,20060],{"class":839},"destroyMethod",[315,20062,8633],{"class":325},[315,20064,20065],{"class":329}," \"close\"",[315,20067,11462],{"class":333},[315,20069,20070,20072,20075,20078],{"class":317,"line":343},[315,20071,16391],{"class":325},[315,20073,20074],{"class":333}," PaymentClient ",[315,20076,20077],{"class":321},"paymentClient",[315,20079,17376],{"class":333},[315,20081,20082,20084,20086,20088],{"class":317,"line":359},[315,20083,19442],{"class":325},[315,20085,2514],{"class":325},[315,20087,19933],{"class":321},[315,20089,2520],{"class":333},[315,20091,20092],{"class":317,"line":375},[315,20093,2583],{"class":333},[18,20095,20096,20097,20099],{},"业务代码通常优先选择 ",[25,20098,18398],{}," 或自定义初始化方法，避免为了生命周期回调而强耦合 Spring 接口。",[18,20101,20102],{},"初始化方法适合：",[245,20104,20105,20108,20111],{},[211,20106,20107],{},"校验必要配置；",[211,20109,20110],{},"构造只依赖当前 Bean 状态的内存结构；",[211,20112,20113],{},"完成本地资源准备。",[18,20115,20116],{},"不适合在初始化方法中启动复杂异步任务，或者访问大量其他 Bean。初始化发生在单例创建过程中，过重或存在交叉访问的逻辑可能延长启动时间，甚至引发初始化死锁。",[14,20118,20120],{"id":20119},"十二阶段十一初始化后处理与-aop-代理","十二、阶段十一：初始化后处理与 AOP 代理",[18,20122,20123],{},"初始化回调完成后，Spring调用：",[279,20125,20127],{"className":2173,"code":20126,"language":2175,"meta":285,"style":285},"BeanPostProcessor#postProcessAfterInitialization()\n",[25,20128,20129],{"__ignoreMap":285},[315,20130,20131,20133,20135],{"class":317,"line":318},[315,20132,19851],{"class":333},[315,20134,18935],{"class":321},[315,20136,17182],{"class":333},[18,20138,20139],{},"后处理器可以返回：",[245,20141,20142,20145,20148,20151],{},[211,20143,20144],{},"原对象；",[211,20146,20147],{},"包装对象；",[211,20149,20150],{},"代理对象；",[211,20152,20153],{},"其他兼容对象。",[18,20155,20156,20157,20159],{},"Spring AOP 的自动代理创建器属于 ",[25,20158,18384],{},"。它会判断当前 Bean 是否匹配 Advisor；如果匹配，就创建 JDK 动态代理或 CGLIB 代理。",[18,20161,20162],{},"因此容器最终对外暴露的对象可能不是原始对象：",[279,20164,20167],{"className":20165,"code":20166,"language":284,"meta":285},[282],"原始 Bean\n→ 初始化回调\n→ AOP 后处理器\n→ 代理 Bean\n→ singletonObjects\n",[25,20168,20166],{"__ignoreMap":285},[18,20170,20171,20172,20174,20175,20177],{},"这也解释了为什么在 ",[25,20173,18398],{}," 中调用自身的事务方法，通常不会经过当前 Bean 的事务代理：初始化回调执行时，完整代理尚未作为最终 Bean 对外提供，而且调用方式仍然是对象内部的 ",[25,20176,1416],{}," 调用。",[14,20179,20181],{"id":20180},"十三bean-初始化完成后容器何时才算就绪","十三、Bean 初始化完成后，容器何时才算就绪",[18,20183,20184],{},"单个 Bean 完成初始化，并不代表所有单例都已经创建完成。",[237,20186,20188],{"id":20187},"_1-smartinitializingsingleton","1. SmartInitializingSingleton",[18,20190,20191],{},"所有常规非懒加载单例完成实例化后，Spring调用：",[279,20193,20195],{"className":2173,"code":20194,"language":2175,"meta":285,"style":285},"public interface SmartInitializingSingleton {\n\n void afterSingletonsInstantiated();\n}\n",[25,20196,20197,20208,20212,20221],{"__ignoreMap":285},[315,20198,20199,20201,20203,20206],{"class":317,"line":318},[315,20200,16391],{"class":325},[315,20202,18661],{"class":325},[315,20204,20205],{"class":321}," SmartInitializingSingleton",[315,20207,4034],{"class":333},[315,20209,20210],{"class":317,"line":343},[315,20211,2525],{"emptyLinePlaceholder":1280},[315,20213,20214,20216,20219],{"class":317,"line":359},[315,20215,18683],{"class":325},[315,20217,20218],{"class":321}," afterSingletonsInstantiated",[315,20220,2520],{"class":333},[315,20222,20223],{"class":317,"line":375},[315,20224,2583],{"class":333},[18,20226,3472],{},[245,20228,20229,20232,20235],{},[211,20230,20231],{},"需要确认其他单例已经准备完成的检查；",[211,20233,20234],{},"汇总多个 Bean 建立注册表；",[211,20236,20237,20238,20241],{},"避免因为主动 ",[25,20239,20240],{},"getBeansOfType()"," 导致意外提前初始化。",[18,20243,20244],{},"它只对单例 Bean 有意义。",[237,20246,20248],{"id":20247},"_2-contextrefreshedevent","2. ContextRefreshedEvent",[18,20250,20251,20252,4224],{},"容器刷新完成后会发布 ",[25,20253,18434],{},[18,20255,667],{},[279,20257,20259],{"className":2173,"code":20258,"language":2175,"meta":285,"style":285},"@EventListener(ContextRefreshedEvent.class)\npublic void onContextReady() {\n \u002F\u002F 容器刷新完成后的逻辑\n}\n",[25,20260,20261,20271,20282,20287],{"__ignoreMap":285},[315,20262,20263,20265,20268],{"class":317,"line":318},[315,20264,19157],{"class":333},[315,20266,20267],{"class":325},"EventListener",[315,20269,20270],{"class":333},"(ContextRefreshedEvent.class)\n",[315,20272,20273,20275,20277,20280],{"class":317,"line":343},[315,20274,16391],{"class":325},[315,20276,17397],{"class":325},[315,20278,20279],{"class":321}," onContextReady",[315,20281,17376],{"class":333},[315,20283,20284],{"class":317,"line":359},[315,20285,20286],{"class":4056}," \u002F\u002F 容器刷新完成后的逻辑\n",[315,20288,20289],{"class":317,"line":375},[315,20290,2583],{"class":333},[18,20292,20293],{},"适合需要基于 ApplicationContext 刷新完成事件触发的逻辑。",[18,20295,20296],{},"需要注意，ApplicationContext 可以被刷新多次时，监听逻辑也可能执行多次，业务代码应考虑幂等。",[237,20298,20300],{"id":20299},"_3-smartlifecycle","3. SmartLifecycle",[18,20302,20303,20304,3382],{},"需要启动和停止后台消费者、调度器、长连接等有运行状态的组件时，优先考虑 ",[25,20305,18438],{},[279,20307,20309],{"className":2173,"code":20308,"language":2175,"meta":285,"style":285},"public interface SmartLifecycle extends Lifecycle, Phased {\n\n boolean isAutoStartup();\n\n void stop(Runnable callback);\n}\n",[25,20310,20311,20333,20337,20347,20351,20365],{"__ignoreMap":285},[315,20312,20313,20315,20317,20320,20323,20326,20328,20331],{"class":317,"line":318},[315,20314,16391],{"class":325},[315,20316,18661],{"class":325},[315,20318,20319],{"class":321}," SmartLifecycle",[315,20321,20322],{"class":325}," extends",[315,20324,20325],{"class":321}," Lifecycle",[315,20327,4327],{"class":333},[315,20329,20330],{"class":321},"Phased",[315,20332,4034],{"class":333},[315,20334,20335],{"class":317,"line":343},[315,20336,2525],{"emptyLinePlaceholder":1280},[315,20338,20339,20342,20345],{"class":317,"line":359},[315,20340,20341],{"class":325}," boolean",[315,20343,20344],{"class":321}," isAutoStartup",[315,20346,2520],{"class":333},[315,20348,20349],{"class":317,"line":375},[315,20350,2525],{"emptyLinePlaceholder":1280},[315,20352,20353,20355,20358,20360,20363],{"class":317,"line":391},[315,20354,18683],{"class":325},[315,20356,20357],{"class":321}," stop",[315,20359,17403],{"class":333},[315,20361,20362],{"class":17406},"callback",[315,20364,8034],{"class":333},[315,20366,20367],{"class":317,"line":2562},[315,20368,2583],{"class":333},[18,20370,20371],{},"它支持：",[245,20373,20374,20377,20383,20386],{},[211,20375,20376],{},"容器刷新后自动启动；",[211,20378,20379,20382],{},[25,20380,20381],{},"phase"," 控制启动和停止顺序；",[211,20384,20385],{},"异步停止完成回调；",[211,20387,20388],{},"运行状态检查。",[18,20390,20391,20392,20394],{},"启动时通常先启动较小的 ",[25,20393,20381],{},"，关闭时反向停止。依赖其他组件的服务应根据依赖关系设计 phase，而不是随意填写。",[14,20396,20398],{"id":20397},"十四阶段十二容器关闭与-bean-销毁","十四、阶段十二：容器关闭与 Bean 销毁",[18,20400,20401],{},"容器正常关闭时，Spring先停止需要运行期管理的 Lifecycle 组件，再销毁受管理的单例 Bean。",[18,20403,20404],{},"同一个 Bean 配置多种销毁机制且方法名不同时，可以按下面的层次理解：",[208,20406,20407,20417,20421],{},[211,20408,20409,18443,20412,20414,20415,734],{},[25,20410,20411],{},"DestructionAwareBeanPostProcessor#postProcessBeforeDestruction()",[25,20413,18446],{}," 调用 ",[25,20416,18450],{},[211,20418,20419,734],{},[25,20420,18454],{},[211,20422,20423,19915,20426,4224],{},[25,20424,20425],{},"@Bean(destroyMethod = \"...\")",[25,20427,20428],{},"destroy-method",[18,20430,13594,20431,20433,20434,20436],{},[25,20432,18450],{}," 不是脱离后处理器单独运行的一轮流程，而是 ",[25,20435,18442],{}," 体系提供的具体生命周期回调。",[18,20438,20439],{},"销毁阶段适合：",[245,20441,20442,20445,20448,20451,20454],{},[211,20443,20444],{},"停止后台任务；",[211,20446,20447],{},"关闭线程池；",[211,20449,20450],{},"关闭网络连接；",[211,20452,20453],{},"刷新缓冲数据；",[211,20455,20456],{},"注销服务或监听器。",[237,20458,20460],{"id":20459},"原型-bean-的特殊点","原型 Bean 的特殊点",[18,20462,20463,20464,20467],{},"对于 ",[25,20465,20466],{},"prototype"," Bean，Spring负责创建和注入，但把实例交给调用方后通常不再跟踪其完整生命周期，因此不会自动调用普通销毁回调。",[18,20469,20470],{},"如果原型 Bean 持有必须释放的资源，应由使用方显式关闭，或者改用更合适的作用域和资源管理方式。",[18,20472,20473,20474,20476],{},"应用被强制终止时，销毁回调也不保证一定执行。重要数据不能只依赖 ",[25,20475,18450],{}," 才落盘。",[14,20478,20480],{"id":20479},"十五常见扩展点应该怎么选择","十五、常见扩展点应该怎么选择",[98,20482,20483,20492],{},[101,20484,20485],{},[104,20486,20487,20489],{},[107,20488,5772],{},[107,20490,20491],{},"优先考虑的扩展点",[114,20493,20494,20505,20516,20525,20535,20546,20558,20567,20577,20586,20597,20607],{},[104,20495,20496,20499],{},[119,20497,20498],{},"导入一组配置类",[119,20500,20501,5067,20503],{},[25,20502,18591],{},[25,20504,18610],{},[104,20506,20507,20510],{},[119,20508,20509],{},"动态注册 BeanDefinition",[119,20511,20512,5067,20514],{},[25,20513,18620],{},[25,20515,18376],{},[104,20517,20518,20521],{},[119,20519,20520],{},"在创建 Bean 前修改配置元数据",[119,20522,20523],{},[25,20524,18380],{},[104,20526,20527,20530],{},[119,20528,20529],{},"自定义注入、实例化或代理",[119,20531,20532,20534],{},[25,20533,18384],{}," 及其子接口",[104,20536,20537,20540],{},[119,20538,20539],{},"获得 Bean 名称或容器对象",[119,20541,20542,20543,20545],{},"对应的 ",[25,20544,18391],{}," 接口",[104,20547,20548,20551],{},[119,20549,20550],{},"依赖注入完成后校验当前 Bean",[119,20552,20553,20555,20556],{},[25,20554,18398],{}," 或自定义 ",[25,20557,20050],{},[104,20559,20560,20563],{},[119,20561,20562],{},"所有普通单例创建完成后执行",[119,20564,20565],{},[25,20566,18430],{},[104,20568,20569,20572],{},[119,20570,20571],{},"容器刷新完成后执行",[119,20573,20574,20575],{},"监听 ",[25,20576,18434],{},[104,20578,20579,20582],{},[119,20580,20581],{},"管理后台组件的启动和停止",[119,20583,20584],{},[25,20585,18438],{},[104,20587,20588,20591],{},[119,20589,20590],{},"释放 Bean 自身资源",[119,20592,20593,20555,20595],{},[25,20594,18450],{},[25,20596,20060],{},[104,20598,20599,20602],{},[119,20600,20601],{},"创建复杂对象并把产物交给容器",[119,20603,20604],{},[25,20605,20606],{},"FactoryBean",[104,20608,20609,20612],{},[119,20610,20611],{},"定义新的 Bean 作用域",[119,20613,20614,20615,20618],{},"实现 ",[25,20616,20617],{},"Scope"," 并注册",[14,20620,20622],{"id":20621},"十六factorybean-是什么扩展点","十六、FactoryBean 是什么扩展点",[18,20624,20625,20626,20629],{},"普通 BeanDefinition 描述“这个类本身如何被创建”；",[25,20627,20628],{},"FactoryBean\u003CT>"," 描述“通过这个工厂生产什么对象”。",[279,20631,20633],{"className":2173,"code":20632,"language":2175,"meta":285,"style":285},"public interface FactoryBean\u003CT> {\n\n T getObject() throws Exception;\n\n Class\u003C?> getObjectType();\n\n default boolean isSingleton() {\n return true;\n }\n}\n",[25,20634,20635,20652,20656,20672,20676,20690,20694,20706,20715,20719],{"__ignoreMap":285},[315,20636,20637,20639,20641,20644,20646,20649],{"class":317,"line":318},[315,20638,16391],{"class":325},[315,20640,18661],{"class":325},[315,20642,20643],{"class":321}," FactoryBean",[315,20645,2436],{"class":333},[315,20647,20648],{"class":325},"T",[315,20650,20651],{"class":333},"> {\n",[315,20653,20654],{"class":317,"line":343},[315,20655,2525],{"emptyLinePlaceholder":1280},[315,20657,20658,20661,20664,20666,20669],{"class":317,"line":359},[315,20659,20660],{"class":333}," T ",[315,20662,20663],{"class":321},"getObject",[315,20665,15519],{"class":333},[315,20667,20668],{"class":325},"throws",[315,20670,20671],{"class":333}," Exception;\n",[315,20673,20674],{"class":317,"line":375},[315,20675,2525],{"emptyLinePlaceholder":1280},[315,20677,20678,20681,20683,20685,20688],{"class":317,"line":391},[315,20679,20680],{"class":333}," Class\u003C",[315,20682,19210],{"class":325},[315,20684,19213],{"class":333},[315,20686,20687],{"class":321},"getObjectType",[315,20689,2520],{"class":333},[315,20691,20692],{"class":317,"line":2562},[315,20693,2525],{"emptyLinePlaceholder":1280},[315,20695,20696,20698,20701,20704],{"class":317,"line":2580},[315,20697,18887],{"class":325},[315,20699,20700],{"class":325}," boolean",[315,20702,20703],{"class":321}," isSingleton",[315,20705,17376],{"class":333},[315,20707,20708,20710,20713],{"class":317,"line":2586},[315,20709,17256],{"class":325},[315,20711,20712],{"class":839}," true",[315,20714,7876],{"class":333},[315,20716,20717],{"class":317,"line":2591},[315,20718,4070],{"class":333},[315,20720,20721],{"class":317,"line":17092},[315,20722,2583],{"class":333},[18,20724,20725,20726,3382],{},"假设 Bean 名称为 ",[25,20727,20728],{},"clientFactory",[279,20730,20733],{"className":20731,"code":20732,"language":284,"meta":285},[282],"getBean(\"clientFactory\")\n→ 获得 FactoryBean 生产的对象\n\ngetBean(\"&clientFactory\")\n→ 获得 FactoryBean 本身\n",[25,20734,20732],{"__ignoreMap":285},[18,20736,20737,20738,20741],{},"它适合创建代理、客户端、会话工厂等构造过程复杂的对象。MyBatis 与 Spring 集成中的 ",[25,20739,20740],{},"SqlSessionFactoryBean"," 就使用了这一机制。",[14,20743,20745],{"id":20744},"十七自定义-scope","十七、自定义 Scope",[18,20747,20748],{},"默认常见作用域包括：",[245,20750,20751,20756,20760],{},[211,20752,20753,734],{},[25,20754,20755],{},"singleton",[211,20757,20758,734],{},[25,20759,20466],{},[211,20761,20762,20763,5067,20766,5067,20769,5067,20772,4224],{},"Web 环境中的 ",[25,20764,20765],{},"request",[25,20767,20768],{},"session",[25,20770,20771],{},"application",[25,20773,20774],{},"websocket",[18,20776,20614,20777,20780,20781,20784],{},[25,20778,20779],{},"org.springframework.beans.factory.config.Scope"," 并通过 ",[25,20782,20783],{},"ConfigurableBeanFactory#registerScope()"," 注册，可以定义租户、任务、线程上下文等自定义作用域。",[18,20786,20787],{},"自定义 Scope 必须明确：",[245,20789,20790,20793,20796,20799,20802],{},[211,20791,20792],{},"实例保存在哪里；",[211,20794,20795],{},"何时创建和复用；",[211,20797,20798],{},"上下文结束时如何执行销毁回调；",[211,20800,20801],{},"上下文如何跨线程传播；",[211,20803,20804],{},"作用域 Bean 被单例依赖时是否需要代理。",[14,20806,20808],{"id":20807},"十八常见误区","十八、常见误区",[237,20810,20812],{"id":20811},"_1-bean-构造完成就可以使用","1. Bean 构造完成就可以使用",[18,20814,20815],{},"构造完成后还没有完成属性注入、Aware、初始化回调和后处理，不能把构造完成等同于 Bean 就绪。",[237,20817,20819],{"id":20818},"_2-postconstruct-发生在-aop-代理之后","2. @PostConstruct 发生在 AOP 代理之后",[18,20821,20822,20824],{},[25,20823,18398],{}," 属于初始化前处理阶段；AOP 代理通常在初始化后处理中形成并作为最终对象暴露。",[237,20826,20828],{"id":20827},"_3-beanpostprocessor-只在初始化前后各做一次简单回调","3. BeanPostProcessor 只在初始化前后各做一次简单回调",[18,20830,20831],{},"基础接口只有两个方法，但其子接口参与实例化前、构造器选择、属性填充、早期代理、合并定义和销毁等多个阶段。",[237,20833,20835],{"id":20834},"_4-beanfactorypostprocessor-可以直接修改业务-bean","4. BeanFactoryPostProcessor 可以直接修改业务 Bean",[18,20837,20838,20839,20841],{},"它应该修改 BeanDefinition。调用 ",[25,20840,18845],{}," 可能造成提前实例化并绕过其他基础设施。",[237,20843,20845],{"id":20844},"_5-bean-生命周期结束一定会执行销毁方法","5. Bean 生命周期结束一定会执行销毁方法",[18,20847,20848],{},"原型 Bean、进程强杀、机器掉电等场景都可能无法执行正常销毁回调。",[237,20850,20852],{"id":20851},"_6-所有初始化逻辑都放进-postconstruct","6. 所有初始化逻辑都放进 @PostConstruct",[18,20854,20855,20856,20858,20859,20861,20862,4224],{},"Bean 自身的轻量校验可以放在 ",[25,20857,18398],{},"；依赖所有单例完成、容器刷新完成或需要启停管理的任务，应分别选择 ",[25,20860,18430],{},"、容器事件或 ",[25,20863,18438],{},[14,20865,20867],{"id":20866},"十九源码主线","十九、源码主线",[18,20869,20870],{},"阅读 Spring Bean 生命周期源码时，可以沿着以下调用链：",[279,20872,20875],{"className":20873,"code":20874,"language":284,"meta":285},[282],"AbstractApplicationContext#refresh\n├── invokeBeanFactoryPostProcessors\n├── registerBeanPostProcessors\n├── finishBeanFactoryInitialization\n│ └── preInstantiateSingletons\n│ └── getBean\n│ └── AbstractAutowireCapableBeanFactory#createBean\n│ ├── resolveBeforeInstantiation\n│ │ ├── applyBeanPostProcessorsBeforeInstantiation\n│ │ └── applyBeanPostProcessorsAfterInitialization\n│ │ （仅在实例化前返回非 null 对象时）\n│ └── doCreateBean\n│ ├── createBeanInstance\n│ ├── applyMergedBeanDefinitionPostProcessors\n│ ├── addSingletonFactory\n│ ├── populateBean\n│ └── initializeBean\n│ ├── invokeAwareMethods\n│ ├── applyBeanPostProcessorsBeforeInitialization\n│ ├── invokeInitMethods\n│ └── applyBeanPostProcessorsAfterInitialization\n└── finishRefresh\n",[25,20876,20874],{"__ignoreMap":285},[18,20878,20879],{},"销毁主线可以关注：",[279,20881,20884],{"className":20882,"code":20883,"language":284,"meta":285},[282],"AbstractApplicationContext#close\n→ doClose\n→ LifecycleProcessor#onClose\n→ destroyBeans\n→ DisposableBeanAdapter#destroy\n",[25,20885,20883],{"__ignoreMap":285},[14,20887,20889],{"id":20888},"二十复习检查清单","二十、复习检查清单",[245,20891,20892,20895,20903,20906,20915,20918,20925,20928,20936,20939],{},[211,20893,20894],{},"能否区分容器生命周期和单个 Bean 生命周期；",[211,20896,20897,20898,5589,20900,20902],{},"能否说明 ",[25,20899,18380],{},[25,20901,18384],{}," 的区别；",[211,20904,20905],{},"是否知道依赖注入发生在实例化之后、初始化之前；",[211,20907,20908,20909,5067,20911,20914],{},"能否说清 ",[25,20910,18398],{},[25,20912,20913],{},"InitializingBean","、自定义 init 方法的顺序；",[211,20916,20917],{},"是否知道 AOP 代理通常在哪个阶段创建；",[211,20919,20920,20921,20924],{},"能否解释三级缓存和 ",[25,20922,20923],{},"getEarlyBeanReference()"," 的作用；",[211,20926,20927],{},"是否知道单个 Bean 初始化完成后还有哪些容器级扩展点；",[211,20929,20897,20930,20932,20933,20935],{},[25,20931,18430],{},"、容器事件和 ",[25,20934,18438],{}," 的使用边界；",[211,20937,20938],{},"是否知道销毁回调的顺序以及原型 Bean 的限制；",[211,20940,20941],{},"能否按目标选择定义级、实例级、运行级和销毁级扩展点。",[14,20943,1191],{"id":1191},[245,20945,20946,20953,20960,20967,20974],{},[211,20947,20948],{},[70,20949,20952],{"href":20950,"rel":20951},"https:\u002F\u002Fdocs.spring.io\u002Fspring-framework\u002Freference\u002Fcore\u002Fbeans\u002Ffactory-extension.html",[1200],"Spring Framework：Container Extension Points",[211,20954,20955],{},[70,20956,20959],{"href":20957,"rel":20958},"https:\u002F\u002Fdocs.spring.io\u002Fspring-framework\u002Freference\u002Fcore\u002Fbeans\u002Ffactory-nature.html",[1200],"Spring Framework：Customizing the Nature of a Bean",[211,20961,20962],{},[70,20963,20966],{"href":20964,"rel":20965},"https:\u002F\u002Fdocs.spring.io\u002Fspring-framework\u002Freference\u002Fcore\u002Fbeans\u002Fbeanfactory.html",[1200],"Spring Framework：The BeanFactory API",[211,20968,20969],{},[70,20970,20973],{"href":20971,"rel":20972},"https:\u002F\u002Fdocs.spring.io\u002Fspring-framework\u002Fdocs\u002Fcurrent\u002Fjavadoc-api\u002Forg\u002Fspringframework\u002Fbeans\u002Ffactory\u002Fconfig\u002FInstantiationAwareBeanPostProcessor.html",[1200],"InstantiationAwareBeanPostProcessor API",[211,20975,20976],{},[70,20977,20980],{"href":20978,"rel":20979},"https:\u002F\u002Fdocs.spring.io\u002Fspring-framework\u002Fdocs\u002Fcurrent\u002Fjavadoc-api\u002Forg\u002Fspringframework\u002Fbeans\u002Ffactory\u002FSmartInitializingSingleton.html",[1200],"SmartInitializingSingleton API",[1224,20982,20983],{},"html pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .s4XuR, html code.shiki .s4XuR{--shiki-default:#E36209;--shiki-dark:#FFAB70}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .sJ8bj, html code.shiki .sJ8bj{--shiki-default:#6A737D;--shiki-dark:#6A737D}",{"title":285,"searchDepth":343,"depth":343,"links":20985},[20986,20987,20988,20989,20993,20998,21001,21004,21011,21012,21013,21017,21018,21021,21022,21023,21028,21031,21032,21033,21034,21042,21043,21044],{"id":16,"depth":343,"text":16},{"id":66,"depth":343,"text":66},{"id":83,"depth":343,"text":83},{"id":18480,"depth":343,"text":18481,"children":20990},[20991,20992],{"id":18487,"depth":359,"text":18488},{"id":18500,"depth":359,"text":18501},{"id":18521,"depth":343,"text":18522,"children":20994},[20995,20996,20997],{"id":18585,"depth":359,"text":18586},{"id":18614,"depth":359,"text":18615},{"id":18639,"depth":359,"text":18640},{"id":18742,"depth":343,"text":18743,"children":20999},[21000],{"id":18746,"depth":359,"text":18380},{"id":18852,"depth":343,"text":18853,"children":21002},[21003],{"id":19005,"depth":359,"text":19005},{"id":19027,"depth":343,"text":19028,"children":21005},[21006,21007,21008,21009,21010],{"id":19038,"depth":359,"text":19039},{"id":19059,"depth":359,"text":19060},{"id":19459,"depth":359,"text":19460},{"id":19534,"depth":359,"text":19535},{"id":19568,"depth":359,"text":19569},{"id":19575,"depth":343,"text":19576},{"id":19613,"depth":343,"text":19614},{"id":19651,"depth":343,"text":19652,"children":21014},[21015,21016],{"id":19679,"depth":359,"text":19680},{"id":19695,"depth":359,"text":19696},{"id":19730,"depth":343,"text":19731},{"id":19837,"depth":343,"text":19838,"children":21019},[21020],{"id":19874,"depth":359,"text":19875},{"id":19895,"depth":343,"text":19896},{"id":20119,"depth":343,"text":20120},{"id":20180,"depth":343,"text":20181,"children":21024},[21025,21026,21027],{"id":20187,"depth":359,"text":20188},{"id":20247,"depth":359,"text":20248},{"id":20299,"depth":359,"text":20300},{"id":20397,"depth":343,"text":20398,"children":21029},[21030],{"id":20459,"depth":359,"text":20460},{"id":20479,"depth":343,"text":20480},{"id":20621,"depth":343,"text":20622},{"id":20744,"depth":343,"text":20745},{"id":20807,"depth":343,"text":20808,"children":21035},[21036,21037,21038,21039,21040,21041],{"id":20811,"depth":359,"text":20812},{"id":20818,"depth":359,"text":20819},{"id":20827,"depth":359,"text":20828},{"id":20834,"depth":359,"text":20835},{"id":20844,"depth":359,"text":20845},{"id":20851,"depth":359,"text":20852},{"id":20866,"depth":343,"text":20867},{"id":20888,"depth":343,"text":20889},{"id":1191,"depth":343,"text":1191},"wiki:java:spring-bean-lifecycle-and-extension-points","系统讲解 Spring 容器启动、Bean 定义处理、实例化、属性注入、初始化、AOP 代理、就绪与销毁的完整生命周期，并梳理 BeanFactoryPostProcessor、BeanPostProcessor、Aware、初始化回调、SmartInitializingSingleton、事件和 SmartLifecycle 等扩展点。",{},80,"\u002Fjava\u002Fspring-bean-lifecycle-and-extension-points",{"title":18354,"description":21046},"java\u002Fspring-bean-lifecycle-and-extension-points","ZtXQ8TCnwPnWeee0oKnQyksLUPgWGyb866r_87O5X4Q",{"id":4,"title":5,"body":21054,"commentId":1274,"description":1275,"difficulty":1276,"draft":1277,"extension":1278,"meta":21952,"navigation":1280,"order":1281,"path":1282,"section":1283,"seo":21953,"stem":1285,"updated":1286,"__hash__":1287},{"type":7,"value":21055,"toc":21905},[21056,21058,21060,21062,21076,21078,21080,21086,21088,21095,21097,21099,21103,21105,21181,21185,21187,21189,21201,21203,21205,21207,21209,21211,21229,21231,21233,21238,21240,21242,21247,21249,21251,21327,21329,21334,21336,21356,21358,21360,21362,21364,21370,21372,21374,21379,21381,21386,21390,21392,21394,21399,21401,21403,21417,21419,21424,21426,21428,21430,21442,21448,21450,21468,21470,21472,21474,21484,21486,21488,21490,21504,21506,21538,21540,21545,21547,21549,21551,21553,21569,21571,21591,21593,21595,21597,21617,21619,21643,21645,21647,21649,21661,21663,21665,21713,21715,21717,21719,21731,21733,21745,21747,21759,21761,21763,21765,21781,21783,21785,21787,21797,21799,21815,21817,21829,21831,21833,21835,21837,21839,21841,21843,21845,21847,21849,21851,21853,21879,21881,21903],[10,21057,5],{"id":12},[14,21059,16],{"id":16},[18,21061,20],{},[18,21063,23,21064,28,21066,32,21068,36,21070,40,21072,44,21074,48],{},[25,21065,27],{},[25,21067,31],{},[25,21069,35],{},[25,21071,39],{},[25,21073,43],{},[25,21075,47],{},[18,21077,51],{},[18,21079,54],{},[56,21081,21082],{},[18,21083,21084],{},[61,21085,63],{},[14,21087,66],{"id":66},[18,21089,21090],{},[70,21091,21093],{"href":72,"target":73,"rel":21092},[75,76],[78,21094],{"src":72,"alt":80},[14,21096,83],{"id":83},[14,21098,87],{"id":86},[18,21100,21101,93],{},[25,21102,92],{},[18,21104,96],{},[98,21106,21107,21115],{},[101,21108,21109],{},[104,21110,21111,21113],{},[107,21112,109],{},[107,21114,112],{},[114,21116,21117,21125,21133,21141,21149,21157,21165,21173],{},[104,21118,21119,21123],{},[119,21120,21121],{},[25,21122,27],{},[119,21124,125],{},[104,21126,21127,21131],{},[119,21128,21129],{},[25,21130,31],{},[119,21132,134],{},[104,21134,21135,21139],{},[119,21136,21137],{},[25,21138,35],{},[119,21140,143],{},[104,21142,21143,21147],{},[119,21144,21145],{},[25,21146,150],{},[119,21148,153],{},[104,21150,21151,21155],{},[119,21152,21153],{},[25,21154,39],{},[119,21156,162],{},[104,21158,21159,21163],{},[119,21160,21161],{},[25,21162,43],{},[119,21164,171],{},[104,21166,21167,21171],{},[119,21168,21169],{},[25,21170,178],{},[119,21172,181],{},[104,21174,21175,21179],{},[119,21176,186,21177,189],{},[25,21178,47],{},[119,21180,192],{},[18,21182,195,21183,199],{},[25,21184,198],{},[14,21186,203],{"id":202},[18,21188,206],{},[208,21190,21191,21193,21195,21197,21199],{},[211,21192,213],{},[211,21194,216],{},[211,21196,219],{},[211,21198,222],{},[211,21200,225],{},[18,21202,228],{},[18,21204,231],{},[14,21206,235],{"id":234},[237,21208,240],{"id":239},[18,21210,243],{},[245,21212,21213,21215,21217,21219,21221,21223,21225,21227],{},[211,21214,249],{},[211,21216,252],{},[211,21218,255],{},[211,21220,258],{},[211,21222,261],{},[211,21224,264],{},[211,21226,267],{},[211,21228,270],{},[237,21230,274],{"id":273},[18,21232,277],{},[279,21234,21236],{"className":21235,"code":283,"language":284,"meta":285},[282],[25,21237,283],{"__ignoreMap":285},[18,21239,290],{},[18,21241,293],{},[279,21243,21245],{"className":21244,"code":297,"language":284,"meta":285},[282],[25,21246,297],{"__ignoreMap":285},[18,21248,302],{},[237,21250,306],{"id":305},[279,21252,21253],{"className":309,"code":310,"language":311,"meta":285,"style":285},[25,21254,21255,21269,21283,21297,21311],{"__ignoreMap":285},[315,21256,21257,21259,21261,21263,21265,21267],{"class":317,"line":318},[315,21258,322],{"class":321},[315,21260,326],{"class":325},[315,21262,330],{"class":329},[315,21264,334],{"class":333},[315,21266,337],{"class":325},[315,21268,340],{"class":329},[315,21270,21271,21273,21275,21277,21279,21281],{"class":317,"line":343},[315,21272,322],{"class":321},[315,21274,326],{"class":325},[315,21276,330],{"class":329},[315,21278,334],{"class":333},[315,21280,337],{"class":325},[315,21282,356],{"class":329},[315,21284,21285,21287,21289,21291,21293,21295],{"class":317,"line":359},[315,21286,322],{"class":321},[315,21288,326],{"class":325},[315,21290,330],{"class":329},[315,21292,334],{"class":333},[315,21294,337],{"class":325},[315,21296,372],{"class":329},[315,21298,21299,21301,21303,21305,21307,21309],{"class":317,"line":375},[315,21300,322],{"class":321},[315,21302,326],{"class":325},[315,21304,330],{"class":329},[315,21306,334],{"class":333},[315,21308,337],{"class":325},[315,21310,388],{"class":329},[315,21312,21313,21315,21317,21319,21321,21323,21325],{"class":317,"line":391},[315,21314,322],{"class":321},[315,21316,326],{"class":325},[315,21318,330],{"class":329},[315,21320,334],{"class":333},[315,21322,337],{"class":325},[315,21324,404],{"class":329},[315,21326,407],{"class":329},[18,21328,410],{},[279,21330,21332],{"className":21331,"code":414,"language":284,"meta":285},[282],[25,21333,414],{"__ignoreMap":285},[18,21335,419],{},[279,21337,21338],{"className":309,"code":422,"language":311,"meta":285,"style":285},[25,21339,21340],{"__ignoreMap":285},[315,21341,21342,21344,21346,21348,21350,21352,21354],{"class":317,"line":318},[315,21343,322],{"class":321},[315,21345,326],{"class":325},[315,21347,330],{"class":329},[315,21349,334],{"class":333},[315,21351,337],{"class":325},[315,21353,439],{"class":329},[315,21355,442],{"class":329},[18,21357,445],{},[14,21359,449],{"id":448},[18,21361,452],{},[237,21363,456],{"id":455},[18,21365,459,21366,462,21368,466],{},[25,21367,92],{},[25,21369,465],{},[237,21371,470],{"id":469},[18,21373,473],{},[279,21375,21377],{"className":21376,"code":477,"language":284,"meta":285},[282],[25,21378,477],{"__ignoreMap":285},[18,21380,482],{},[279,21382,21384],{"className":21383,"code":486,"language":284,"meta":285},[282],[25,21385,486],{"__ignoreMap":285},[18,21387,491,21388,494],{},[25,21389,198],{},[14,21391,498],{"id":497},[18,21393,501],{},[279,21395,21397],{"className":21396,"code":505,"language":284,"meta":285},[282],[25,21398,505],{"__ignoreMap":285},[237,21400,511],{"id":510},[18,21402,514],{},[245,21404,21405,21407,21409,21411,21413,21415],{},[211,21406,519],{},[211,21408,522],{},[211,21410,525],{},[211,21412,528],{},[211,21414,531],{},[211,21416,534],{},[18,21418,537],{},[279,21420,21422],{"className":21421,"code":541,"language":284,"meta":285},[282],[25,21423,541],{"__ignoreMap":285},[237,21425,547],{"id":546},[18,21427,550],{},[18,21429,553],{},[245,21431,21432,21434,21436,21438,21440],{},[211,21433,558],{},[211,21435,561],{},[211,21437,564],{},[211,21439,567],{},[211,21441,570],{},[18,21443,21444,576,21446,580],{},[25,21445,575],{},[25,21447,579],{},[237,21449,584],{"id":583},[245,21451,21452,21454,21456,21458,21460,21462,21464,21466],{},[211,21453,589],{},[211,21455,592],{},[211,21457,595],{},[211,21459,598],{},[211,21461,601],{},[211,21463,604],{},[211,21465,607],{},[211,21467,610],{},[14,21469,614],{"id":613},[18,21471,617],{},[18,21473,620],{},[208,21475,21476,21478,21480,21482],{},[211,21477,625],{},[211,21479,628],{},[211,21481,631],{},[211,21483,634],{},[18,21485,637],{},[14,21487,641],{"id":640},[18,21489,644],{},[245,21491,21492,21494,21496,21498,21500],{},[211,21493,649],{},[211,21495,652],{},[211,21497,655],{},[211,21499,658],{},[211,21501,21502,664],{},[25,21503,663],{},[18,21505,667],{},[279,21507,21508],{"className":309,"code":670,"language":311,"meta":285,"style":285},[25,21509,21510,21524],{"__ignoreMap":285},[315,21511,21512,21514,21516,21518,21520,21522],{"class":317,"line":318},[315,21513,322],{"class":321},[315,21515,326],{"class":325},[315,21517,330],{"class":329},[315,21519,334],{"class":333},[315,21521,337],{"class":325},[315,21523,687],{"class":329},[315,21525,21526,21528,21530,21532,21534,21536],{"class":317,"line":343},[315,21527,322],{"class":321},[315,21529,326],{"class":325},[315,21531,330],{"class":329},[315,21533,334],{"class":333},[315,21535,337],{"class":325},[315,21537,372],{"class":329},[18,21539,704],{},[279,21541,21543],{"className":21542,"code":708,"language":284,"meta":285},[282],[25,21544,708],{"__ignoreMap":285},[18,21546,713],{},[14,21548,717],{"id":716},[18,21550,720],{},[18,21552,723],{},[245,21554,21555,21557,21561,21563,21565,21567],{},[211,21556,728],{},[211,21558,21559,734],{},[25,21560,733],{},[211,21562,737],{},[211,21564,740],{},[211,21566,743],{},[211,21568,746],{},[18,21570,749],{},[279,21572,21573],{"className":309,"code":422,"language":311,"meta":285,"style":285},[25,21574,21575],{"__ignoreMap":285},[315,21576,21577,21579,21581,21583,21585,21587,21589],{"class":317,"line":318},[315,21578,322],{"class":321},[315,21580,326],{"class":325},[315,21582,330],{"class":329},[315,21584,334],{"class":333},[315,21586,337],{"class":325},[315,21588,439],{"class":329},[315,21590,442],{"class":329},[18,21592,772],{},[14,21594,776],{"id":775},[18,21596,779],{},[245,21598,21599,21601,21605,21607,21609,21613,21615],{},[211,21600,784],{},[211,21602,787,21603,791],{},[25,21604,790],{},[211,21606,794],{},[211,21608,797],{},[211,21610,21611,803],{},[25,21612,802],{},[211,21614,806],{},[211,21616,809],{},[18,21618,812],{},[279,21620,21621],{"className":309,"code":815,"language":311,"meta":285,"style":285},[25,21622,21623,21637],{"__ignoreMap":285},[315,21624,21625,21627,21629,21631,21633,21635],{"class":317,"line":318},[315,21626,322],{"class":321},[315,21628,326],{"class":325},[315,21630,330],{"class":329},[315,21632,334],{"class":333},[315,21634,337],{"class":325},[315,21636,388],{"class":329},[315,21638,21639,21641],{"class":317,"line":343},[315,21640,836],{"class":321},[315,21642,840],{"class":839},[18,21644,843],{},[14,21646,847],{"id":846},[18,21648,850],{},[245,21650,21651,21653,21655,21657,21659],{},[211,21652,855],{},[211,21654,858],{},[211,21656,861],{},[211,21658,864],{},[211,21660,867],{},[18,21662,870],{},[14,21664,874],{"id":873},[98,21666,21667,21675],{},[101,21668,21669],{},[104,21670,21671,21673],{},[107,21672,883],{},[107,21674,886],{},[114,21676,21677,21683,21689,21695,21701,21707],{},[104,21678,21679,21681],{},[119,21680,893],{},[119,21682,896],{},[104,21684,21685,21687],{},[119,21686,901],{},[119,21688,904],{},[104,21690,21691,21693],{},[119,21692,909],{},[119,21694,912],{},[104,21696,21697,21699],{},[119,21698,917],{},[119,21700,920],{},[104,21702,21703,21705],{},[119,21704,925],{},[119,21706,928],{},[104,21708,21709,21711],{},[119,21710,933],{},[119,21712,936],{},[18,21714,939],{},[14,21716,943],{"id":942},[237,21718,946],{"id":946},[245,21720,21721,21723,21725,21727,21729],{},[211,21722,951],{},[211,21724,954],{},[211,21726,957],{},[211,21728,960],{},[211,21730,963],{},[237,21732,966],{"id":966},[245,21734,21735,21737,21739,21741,21743],{},[211,21736,971],{},[211,21738,974],{},[211,21740,977],{},[211,21742,980],{},[211,21744,983],{},[237,21746,986],{"id":986},[245,21748,21749,21751,21753,21755,21757],{},[211,21750,991],{},[211,21752,994],{},[211,21754,997],{},[211,21756,1000],{},[211,21758,1003],{},[18,21760,1006],{},[14,21762,1010],{"id":1009},[18,21764,1013],{},[245,21766,21767,21769,21771,21773,21775,21777,21779],{},[211,21768,1018],{},[211,21770,1021],{},[211,21772,1024],{},[211,21774,1027],{},[211,21776,1030],{},[211,21778,1033],{},[211,21780,1036],{},[18,21782,1039],{},[14,21784,1043],{"id":1042},[237,21786,1047],{"id":1046},[245,21788,21789,21791,21793,21795],{},[211,21790,1052],{},[211,21792,1055],{},[211,21794,1058],{},[211,21796,1061],{},[237,21798,1064],{"id":1064},[245,21800,21801,21803,21805,21807,21809,21811,21813],{},[211,21802,1069],{},[211,21804,1072],{},[211,21806,1075],{},[211,21808,1078],{},[211,21810,1081],{},[211,21812,1084],{},[211,21814,1087],{},[237,21816,1090],{"id":1090},[245,21818,21819,21821,21823,21825,21827],{},[211,21820,1095],{},[211,21822,1098],{},[211,21824,1101],{},[211,21826,1104],{},[211,21828,1107],{},[14,21830,1111],{"id":1110},[237,21832,1115],{"id":1114},[18,21834,1118],{},[237,21836,1122],{"id":1121},[18,21838,1125],{},[237,21840,1129],{"id":1128},[18,21842,1132],{},[237,21844,1136],{"id":1135},[18,21846,1139],{},[237,21848,1143],{"id":1142},[18,21850,1146],{},[14,21852,1150],{"id":1149},[245,21854,21855,21857,21859,21861,21863,21865,21867,21869,21871,21873,21875,21877],{},[211,21856,1155],{},[211,21858,1158],{},[211,21860,1161],{},[211,21862,1164],{},[211,21864,1167],{},[211,21866,1170],{},[211,21868,1173],{},[211,21870,1176],{},[211,21872,1179],{},[211,21874,1182],{},[211,21876,1185],{},[211,21878,1188],{},[14,21880,1191],{"id":1191},[245,21882,21883,21888,21893,21898],{},[211,21884,21885],{},[70,21886,1201],{"href":1198,"rel":21887},[1200],[211,21889,21890],{},[70,21891,1208],{"href":1206,"rel":21892},[1200],[211,21894,21895],{},[70,21896,1215],{"href":1213,"rel":21897},[1200],[211,21899,21900],{},[70,21901,1222],{"href":1220,"rel":21902},[1200],[1224,21904,1226],{},{"title":285,"searchDepth":343,"depth":343,"links":21906},[21907,21908,21909,21910,21911,21912,21917,21921,21926,21927,21928,21929,21930,21931,21932,21937,21938,21943,21950,21951],{"id":16,"depth":343,"text":16},{"id":66,"depth":343,"text":66},{"id":83,"depth":343,"text":83},{"id":86,"depth":343,"text":87},{"id":202,"depth":343,"text":203},{"id":234,"depth":343,"text":235,"children":21913},[21914,21915,21916],{"id":239,"depth":359,"text":240},{"id":273,"depth":359,"text":274},{"id":305,"depth":359,"text":306},{"id":448,"depth":343,"text":449,"children":21918},[21919,21920],{"id":455,"depth":359,"text":456},{"id":469,"depth":359,"text":470},{"id":497,"depth":343,"text":498,"children":21922},[21923,21924,21925],{"id":510,"depth":359,"text":511},{"id":546,"depth":359,"text":547},{"id":583,"depth":359,"text":584},{"id":613,"depth":343,"text":614},{"id":640,"depth":343,"text":641},{"id":716,"depth":343,"text":717},{"id":775,"depth":343,"text":776},{"id":846,"depth":343,"text":847},{"id":873,"depth":343,"text":874},{"id":942,"depth":343,"text":943,"children":21933},[21934,21935,21936],{"id":946,"depth":359,"text":946},{"id":966,"depth":359,"text":966},{"id":986,"depth":359,"text":986},{"id":1009,"depth":343,"text":1010},{"id":1042,"depth":343,"text":1043,"children":21939},[21940,21941,21942],{"id":1046,"depth":359,"text":1047},{"id":1064,"depth":359,"text":1064},{"id":1090,"depth":359,"text":1090},{"id":1110,"depth":343,"text":1111,"children":21944},[21945,21946,21947,21948,21949],{"id":1114,"depth":359,"text":1115},{"id":1121,"depth":359,"text":1122},{"id":1128,"depth":359,"text":1129},{"id":1135,"depth":359,"text":1136},{"id":1142,"depth":359,"text":1143},{"id":1149,"depth":343,"text":1150},{"id":1191,"depth":343,"text":1191},{},{"title":5,"description":1275},1785155718899]