开篇词 | 业务代码真的会有这么多坑？

朱晔



讲述：王少泽大小：13.24M时长：14:28



该思维导图由 AI 生成，仅供参考

你好，我是朱晔，贝壳金服的资深架构师。
我先和你说说我这 15 年的工作经历吧，以加深彼此的了解。前 7 年，我专注于.NET 领域，负责业务项目的同时，也做了很多社区工作。在 CSDN 做版主期间，我因为回答了大量有关.NET 的问题，并把很多问题的答案总结成了博客，获得了 3 次微软 MVP 的称号。
后来，我转到了 Java 领域，也从程序员变为了架构师，更关注开源项目和互联网架构设计。在空中网，我整体负责了百万人在线的大型 MMO 网游《激战》技术平台的架构设计，期间和团队开发了许多性能和稳定性都不错的 Java 框架；在饿了么，我负责过日千万订单量的物流平台的开发管理和架构工作，遇到了许多只有高并发下才会出现的问题，积累了大量的架构经验；现在，我在贝壳金服的基础架构团队，负责基础组件、中间件、基础服务开发规划，制定一些流程和规范，带领团队自研 Java 后端开发框架、微服务治理平台等，在落地 Spring Cloud 结合 Kubernetes 容器云平台技术体系的过程中，摸索出了很多适合公司项目的基础组件和最佳实践。
这 15 年来，我一直没有脱离编码工作，接触过大大小小的项目不下 400 个，自己亲身经历的、见别人踩过的坑不计其数。我感触很深的一点是，业务代码中真的有太多的坑：有些是看似非常简单的知识点反而容易屡次踩坑，比如 Spring 声明式事务不生效的问题；而有些坑因为“潜伏期”长，引发的线上事故造成了大量的人力和资金损失。因此，我系统梳理了这些案例和坑点，最终筛选出 100 个案例，涉及 130 多个坑点，组成了这个课程。
意识不到业务代码的坑，很危险我想看到 100、130 这两个数字，你不禁要问了：“我写了好几年的业务代码了，遇到问题时上网搜一下就有答案，遇到最多的问题就是服务器不稳定，重启一下基本就可以解决，哪里会有这么多坑呢？”带着这个问题，你继续听我往下说吧。
据我观察，很多开发同学没意识到这些坑，有以下三种可能：
意识不到坑的存在，比如所谓的服务器不稳定很可能是代码问题导致的，很多时候遇到 OOM、死锁、超时问题在运维层面通过改配置、重启、扩容等手段解决了，没有反推到开发层面去寻找根本原因。
有些问题只会在特定情况下暴露。比如，缓存击穿、在多线程环境使用非线程安全的类，只有在多线程或高并发的情况才会暴露问题。
有些性能问题不会导致明显的 Bug，只会让程序运行缓慢、内存使用增加，但会在量变到质变的瞬间爆发。
而正是因为没有意识到这些坑和问题，采用了错误的处理方式，最后问题一旦爆发，处理起来就非常棘手，这是非常可怕的。下面这些场景有没有感觉似曾相识呢？
比如，我曾听说过有一个订单量很大的项目，每天总有上千份订单的状态或流程有问题，需要花费大量的时间来核对数据，修复订单状态。开发同学因为每天牵扯太多精力在排查问题上，根本没时间开发新需求。技术负责人为此头痛不已，无奈之下招了专门的技术支持人员。最后痛定思痛，才决定开启明细日志彻查这个问题，结果发现是自调用方法导致事务没生效的坑。
再比如，有个朋友告诉我，他们的金融项目计算利息的代码中，使用了 float 类型而不是 BigDecimal 类来保存和计算金额，导致给用户结算的每一笔利息都多了几分钱。好在，日终对账及时发现了问题。试想一下，结算的有上千个用户，每个用户有上千笔小订单，如果等月终对账的时候再发现，可能已经损失了几百万。
再比如，我们使用 RabbitMQ 做异步处理，业务处理失败的消息会循环不断地进入 MQ。问题爆发之前，可能只影响了消息处理的时效性。但等 MQ 彻底瘫痪时，面对 MQ 中堆积的、混杂了死信和正常消息的几百万条数据，你除了清空又能怎么办。但清空 MQ，就意味着要花费几小时甚至几十小时的时间，来补正常的业务数据，对业务影响时间很长。
像这样由一个小坑引发的重大事故，不仅仅会给公司造成损失，还会因为自责影响工作状态，降低编码的自信心。我就曾遇到过一位比较负责的核心开发同学，因为一个 Bug 给公司带来数万元的经济损失，最后心理上承受不住提出了辞职。
其实，很多时候不是我们不想从根本上解决问题，只是不知道问题到底在了哪里。要避开这些坑、找到这些定时炸弹，第一步就是得知道它们是什么、在哪里、为什么会出现。而讲清楚这些坑点和相关的最佳实践，正是本课程的主要内容。
这个课程是什么？如果用几个关键词概括这个课程的话，那我会选择“Java”“业务开发”“避坑 100 例”这 3 个。接下来，我就和你详细说说这个课程是什么，以及有什么特点。
第一个关键词是“Java”，指的是课程内所有 Demo 都是基于 Java 语言的。
如果你熟悉 Java，那可以 100% 体会到这些坑点，也可以直接用这些 Demo 去检查你的业务代码是否也有类似的错误实现。
如果你不熟悉 Java 问题也不大，现在大部分高级语言的特性和结构都差不多，许多都是共性问题。此外“设计篇”“安全篇”的内容，基本是脱离具体语言层面的、高层次的问题。因此，即使不使用 Java，你也可以有不少收获，这也是本课程的第一个特点。
讲到这里，我要说明的是，这个课程是围绕坑点而不是 Java 语言体系展开的，因此不是系统学习 Java 的教材。
第二个关键词是“业务开发”，也就是说课程内容限定在业务项目的开发，侧重业务项目开发时可能遇到的坑。
我们先看“业务”这个词。做业务开发时间长的同学尤其知道，业务项目有两大特点：
工期紧、逻辑复杂，开发人员会更多地考虑主流程逻辑的正确实现，忽略非主流程逻辑，或保障、补偿、一致性逻辑的实现；
往往缺乏详细的设计、监控和容量规划的闭环，结果就是随着业务发展出现各种各样的事故。
根据这些性质，我总结出了近 30 个方面的内容，力求覆盖业务项目开发的关键问题。案例的全面性，是本课程的第二大特点。
这些案例可以看作是 Java 业务代码的避坑大全，帮助你写出更好的代码，也能帮你进一步补全知识网增加面试的信心。你甚至可以把二级目录当作代码审核的 Checklist，帮助业务项目一起成长和避坑。
我们再看“开发”这个词。为了更聚焦，也更有针对性，我把专栏内容限定在业务开发，不会过多地讨论架构、测试、部署运维等阶段的问题。而“设计篇”，重在讲述架构设计上可能会遇到的坑，不会全面、完整地介绍高可用、高并发、可伸缩性等架构因素。
第三个关键词是“避坑 100 例”。坑就是容易犯的错，避坑就是踩坑后分析根因，避免重复踩同样的坑。
整个课程 30 篇文章，涉及 100 个案例、约 130 个小坑，其中 40% 来自于我经历过或者是见过的 200 多个线上生产事故，剩下的 60% 来自于我开发业务项目，以及日常审核别人的代码发现的问题。贴近实际，而不是讲述过时的或日常开发根本用不到的技术或框架，就是本课程的第三大特点了。
大部分案例我会配合一个可执行的 Demo 来演示，Demo 中不仅有错误实现（踩坑），还有修正后的正确实现（避坑）。完整且连续、授人以渔，是本课程的第四大特点。
完整且连续，知其所以然。我会按照“知识介绍 -> 还原业务场景 -> 错误实现 -> 正确实现 -> 原理分析 -> 小总结 ”来讲解每个案例，针对每个坑点我至少会给出一个解决方案，并会挑选核心的点和你剖析源码。这样一来，你不仅能避坑，更能知道产生坑的根本原因，提升自己的技术能力。
授人以渔。在遇到问题的时候，我们一定是先通过经验和工具来定位分析问题，然后才能定位到坑，并不是一开始就知道为什么的。在这个课程中，我会尽可能地把分析问题的过程完整地呈现给你，而不是直接告诉你为什么，这样你以后遇到问题时也能有解决问题的思路。
这也是为什么，网络上虽然有很多关于 Java 代码踩坑的资料，但很多同学却和我反馈说，看过之后印象不深刻，也因为没吃透导致在一个知识点上重复踩坑。鉴于此，我还会与你分析我根据多年经验和思考，梳理出的一些最佳实践。
看到这里，是不是迫不及待地想要看看这个专栏的内容都会涉及哪些坑点了呢？那就看看下面这张思维导图吧：
鉴于这个专栏的内容和特点，我再和你说说最佳的学习方式是什么。
学习课程的最佳方法我们都知道，编程是一门实践科学，只看不练、不思考，效果通常不会太好。因此，我建议你打开每篇文章后，能够按照下面的方式深入学习：
对于每一个坑点，实际运行调试一下源码，使用文中提到的工具和方法重现问题，眼见为实。
对于每一个坑点，再思考下除了文内的解决方案和思路外，是否还有其他修正方式。
对于坑点根因中涉及的 JDK 或框架源码分析，你可以找到相关类再系统阅读一下源码。
实践课后思考题。这些思考题，有的是对文章内容的补充，有的是额外容易踩的坑。
理解了课程涉及的所有案例后，你应该就对业务代码大部分容易犯错的点了如指掌了，不仅仅自己可以写出更高质量的业务代码，还可以在审核别人代码时发现可能存在的问题，帮助整个团队成长。
当然了，你从这个课程收获的将不仅是解决案例中那些问题的方法，还可以提升自己分析定位问题、阅读源码的能力。当你再遇到其他诡异的坑时，也能有清晰的解决思路，也可以成长为一名救火专家，帮助大家一起定位、分析问题。
好了，以上就是我今天想要和你分享的内容了。请赶快跟随我们的课程开启避坑之旅吧，也欢迎你留言说说自己的情况，你都踩过哪些坑、对写业务代码又有哪些困惑？我们下一讲见！

公开

同步至部落

取消

完成

0/2000

荧光笔

直线

曲线

笔记

复制

AI

深入了解
翻译
英语
中文简体
中文繁体
法语
德语
日语
韩语
俄语
西班牙语
阿拉伯语
解释
总结

这篇文章由贝壳金服的资深架构师朱晔撰写，分享了15年的工作经验和对业务代码中存在的各种坑的深刻认识。他指出业务代码中存在着许多潜在的问题和陷阱，可能导致线上事故、性能问题以及经济损失。文章列举了实际案例，强调了意识到这些坑的重要性。朱晔提出，要避免这些坑，首先需要了解它们的存在、位置和原因，而这正是他所提供的课程的主要内容。课程围绕Java业务开发中的坑点展开，涉及100个案例、约130个小坑，配合可执行的Demo演示，帮助开发者避免常见的陷阱，提供最佳实践。文章突出了作者的丰富经验和对技术问题的深刻洞察，对于开发人员来说具有很高的参考价值。朱晔建议学习者在阅读课程时实际运行调试源码、思考其他修正方式、阅读相关源码，并提供实践课后思考题，以提升自己的技术能力。整体而言，这篇文章为读者提供了一个深入学习业务代码中常见问题的机会，有助于提升技术水平和避免常见陷阱。

2020-03-09153人觉得很赞给文章提建议

仅可试看部分内容，如需阅读全部内容，请付费购买文章所属专栏
《Java 业务开发常见错误 100 例》，新⼈⾸单¥59

立即购买

登录后留言

全部留言(82)

最新
精选

老三
分享一个我在菊花厂踩过的最大的坑, Android的. APP总是莫名其妙的报小概率IOException. 进一步分析是文件句柄被关闭了. 好好的为什么会被关闭呢? 原来是有人在别的位置将文件句柄传到JNI层(C语言)并close了, 原Java层也close了一遍. 话句话说, 有一个地方存在将文件句柄close过两次, 正常来讲也问题不大. 但是会存在小概率情况, 第一次关闭文件句柄之后, 系统将文件句柄指向的内存区域快速分配给第二个IO操作位置(同进程的, 但是代码完全不在一个位置), 而第二次关闭文件句柄, 会将重新分配后的close掉. 导致IOException
作者回复: 这个坑的确很深
2020-03-15
2
62
第一装甲集群司令克莱斯特
Executors.线程池工具类的几种创建线程池的方法，都不适合在生产高并发场景下使用，这是坑。
作者回复: 谢谢，专栏也有提到这个坑
2020-03-09
4
25
李磊磊
全是干货啊，比起“高大上”的架构，这些点滴问题的深入分析、应对，才真正考验开发者的基本功
作者回复: 谢谢
2020-03-13

19
终结者999号
踩过的坑，老是忘记java中引用传递或值传递导致参数根本就没有被修改。。
作者回复: java只有按值传递，只不过引用类型传的值是指针地址，看上去像是传递引用。详细可以参考 https://stackoverflow.com/questions/40480/is-java-pass-by-reference-or-pass-by-value?page=1&tab=votes#tab-top
2020-03-09

18
钱晟龙🐲龍🐉
使用rabbitmq消费消息，正常业务逻辑正常跑着，使用了ack机制。。 prefetch每台instance有一定的数量，测试环境测不出来都被消费了，然而代码没有ack，线上去查，看到unack 几百条，队列积压几w。。。
作者回复: 使用mq一定要针对队列积压做好监控报警
2020-03-10
2
14
jjn0703
踩过SimpleDateFormat的坑，当时企图用一个static的SimpleDateFormat对象通吃，结果再format之后，出现各种莫名其妙的时间
作者回复: 谢谢，专栏也有提到这个坑
2020-03-09
5
11
楼下小黑哥
原本想在发生异常的时候再次重试、然后写了一个while（true）。写好上线确实也没问题，知道有一天，依赖出现问题，重试多少次都不行，这段代码就变成死循环了。就这样把 dubbo 调用者线程池耗尽。原来老师以前是激战背后支撑者，以前开服抽奖的时候，还中过奖品，哈哈哈。
作者回复: 一般重试都是需要有次数限制，并且考虑指数避退策略，可以选择直接使用一些重试框架，比如spring retry
2020-03-11
3
10
yc
同事踩过的坑：spring里通过配置文件注入了一个bean，配置是缺省，单线程下测试正常，多线程下各种异常，后来发现默认的bean是单例的，多线程调用线程不安全
作者回复: 这个点专栏中也会提到
2020-03-09

9
钱晟龙🐲龍🐉
int batchSelectSize = 1000; List<Payment> payments = paymentMapper.findSpecificPayments(0,batchSelectSize); while (CollectionUtils.isNotEmpty(payments)) { List<OrderPayVo> orders = Lists.newArrayList(); buildData(payments, orders); orderPayBiz.syncSaveAuditOrder(orders); payments = paymentMapper.findSpecificPayments( payments.size(), batchSelectSize); } 批量处理分页条件有问题，只有被批量处理数据大于batchSelectSize的时候才会触发的坑无限死循环调用syncSaveAuditOrder，内存疯狂增加。。
作者回复: 感谢分享
2020-03-10

8
6点无痛早起学习的和尚
最近遇到一个坑，多线程情况下 log 日志部分丢失，用的 log4j2，本来想采用AsyncAppender，但是因为用的是封装的日志格式，AsyncAppender不行，最终也没有找到解决办法，就另辟蹊径把需求问题解决了，但是 log 日志部分丢失还是没有解决，Google 上 log4j2 log miss lose 都找了，没有找到解决办法，Stack Overflow 上说可能是因为 os/jvm 问题，频繁往一个 log 文件写东西
作者回复: 非异步日志的话丢失的问题不常见，尝试找一下规律，仅仅是文件日志丢丢失部分日志还是控制台也丢，多大并发会丢失
2020-03-13
3
7

收起评论