源码级排障 · 系列目录

叙事框架：看不懂源码就排不了的疑难杂症 总计 40 篇，已发布 0 篇，40 篇待完善

一、Dubbo / RPC 类

• ⏳ Dubbo 接口调不通：从注册中心到网络层全链路排查
• ⏳ Dubbo 消费端直连模式下调用失败分析
• ⏳ Dubbo 线程池满：Linux 用户线程数限制导致的服务不可用
• ⏳ Dubbo 泛化调用参数传递序列化异常
• ⏳ Dubbo 异步调用回调未执行排查
• ⏳ Dubbo 路由规则配置错误导致服务不可用
• ⏳ Dubbo 服务集群负载均衡策略选型不当
• ⏳ Dubbo + 高版本 Spring 集成兼容性问题
• ⏳ Dubbo Filter 链配置顺序导致日志丢失
• ⏳ Dubbo 服务版本管理不善导致灰度失败

二、Sentinel / 限流熔断类

• ⏳ Sentinel 限流不生效：从滑动窗口源码排查
• ⏳ Sentinel 集群限流一致性哈希分配不均
• ⏳ Sentinel 匀速排队与预热流控效果不符预期
• ⏳ Sentinel 熔断 DegradeSlot 不触发分析
• ⏳ Sentinel 动态数据源配置更新未生效
• ⏳ Sentinel + Dubbo 适配埋点失效排查
• ⏳ 热点参数限流参数提取失败

三、Netty / 网络框架类

• ⏳ Netty ByteBuf 内存泄漏：引用计数不对排查
• ⏳ Netty 线程模型理解错误导致的性能瓶颈
• ⏳ Netty 事件传播机制异常导致 handler 不执行
• ⏳ Netty 客户端连接不上服务端：ChannelFuture 回调排查
• ⏳ Netty 编解码器配置顺序错误导致粘包/半包
• ⏳ Netty 高并发下 Channel 注册失败分析
• ⏳ Netty 零拷贝在文件上传场景的正确使用

四、MyBatis / ORM 类

• ⏳ MyBatis 一级缓存导致的数据不一致
• ⏳ MyBatis 二级缓存脏数据读出的坑
• ⏳ MyBatis Mapper 扫描不生效排查
• ⏳ MyBatis 插件拦截顺序导致 SQL 改写错误
• ⏳ MyBatis 分页插件 PageHelper 使用不当导致 SQL 异常

五、Canal / 数据同步类

• ⏳ Canal binlog 日志 Dump 流程异常导致同步中断
• ⏳ Canal EventParser 解析异常导致数据丢失
• ⏳ Canal Instance 设计问题导致多库同步混乱

六、Seata / 分布式事务类

• ⏳ Seata 全局锁等待导致服务性能雪崩
• ⏳ AT 模式下 UNDO 日志回滚失败排查
• ⏳ Seata TC 宕机后全局事务状态丢失
• ⏳ TCC 模式空回滚与防悬挂问题

七、Skywalking / APM 类

• ⏳ Skywalking Agent 注入导致应用 OOM
• ⏳ Skywalking 链路追踪数据丢失排查
• ⏳ Skywalking OAP 集群数据不一致分析
• ⏳ Agent 插件兼容性问题导致 Span 异常

最后更新：2026-06