程序员的bug修复宝典

本文涉及的产品
日志服务 SLS,月写入数据量 50GB 1个月
简介: 程序员的bug修复宝典

微信截图_20220517200907.png


前言


bug, 又名程序缺陷或者程序漏洞, 是每个程序员每天都回避不了的东西。程序员对bug的感情可谓是五味杂陈:一方面bug非常可恶,尤其是一些偶现的bug,它强大到可以摧毁一个优秀程序员的意志;另一方面很多bug又是程序员自己亲手写下的,无奈之余只能自嘲一句:不写bug我们就要失业了!


作为一名职业程序员,同时也是一名开源创作者, 夸张点说,我解过的bug可以绕地球一圈, 每天写bug解bug几乎是我的日常。


但是,作为一个善于思考和总结的技术up主,我怎么能止步于每天写bug和解bug呢?更何况,人生在世,总得有点追求。既然我不能够阻止bug的产生,那么就让我总结一点bug的修复技巧,让bug消失地更快点吧!


微信截图_20220517200952.png


1.bug修复的生命周期


中医讲究"望闻问切",其实修复一个bug就像给病人看一场病,本质上是相通的。


当我们遇到一个bug(问题)的时候,一般我们需要经历如下6个步骤:


  • 1.了解bug。我们首先需要到底出了什么bug,现象是什么,怎样发生的。


  • 2.复现bug。在了解了bug的大致情况之后,我们需要能够找到复现的路径,这就为后面bug的定位提供可靠的依据。


  • 3.定位bug。当有了稳定的复现途径之后,要做的就是打断点、打日志进行调试,来一步一步分析和定位bug,到底是那块代码导致的错误。


  • 4.确认bug。当我们定位到bug出错的地方之后,我们就需要分析这到底是不是bug。如果是bug,那么这个bug出现的根源是什么,到底能不能解决。


  • 5.修复bug。在明确了bug的根本原因之后,下面就需要发挥我们的聪明才智去修复这个bug了。


  • 6.验证bug。并不是每次我们修复完bug之后就可以万事大吉了,此时我们还需要去重现bug以确保bug被真正修复。除此之外,有条件的我们还需要去验证相关场景,以保证修复该bug不会引入其他bug。


以上可以总结为12字方针--"了解、复现、定位、确认、修复、验证"bug。一般在稍微大一点的公司,都会有对应的流程对bug的修复进行流程控制,最终形成闭环。


可以看到的是,其实修复bug只是解决一个bug的6个步骤中的其中一步。很多刚刚参与工作的程序员经常犯的错误就是一遇到bug,就开始漫无目的地看代码或者是上网各种瞎搜索,又或者各种无脑问,最后搞了一圈可能连自己要解决的bug到底是什么都不知道,这样解决bug的效率可想而知。


可能读到这的你此刻非常想问:怎样才可以更快地修复一个bug呢?那么下面我就根据上面讲的六个步骤来分别讲解一下对应的技巧。


微信截图_20220517201058.png


2.解决bug的艺术


在我看来,修复一个bug是相对容易的。因为修复一个bug的方法可能有很多种,但是如何从根本上解决一个bug,并保证这个bug下次不再复现的话,其实是非常难的,这就需要我们学习一下解决bug的艺术。


2.1 了解bug


俗话说,知己知彼百战不殆。bug修复的第一步当然是先了解bug了。


了解bug是解决bug最重要的一步,它直接决定了后面五步执行的效率和质量。糟糕的错误报告和不负责任的问题描述都是埋葬程序员修复bug意志的罪魁祸首。


在了解bug之前,我们需要收集足够的信息,了解它产生的现象、描述、复现步骤、以及解决后的预期是什么等等。那么我们应该怎么做才能更加全面地了解它呢?


下面我给几点建议供大家参考:


2.1.1 观察现象


光凭文字说明是无法准确领悟到bug的精髓的。因为每个人思考问题的角度以及文字表达描述都是千差万别的。


如果说这个时候能提供一段出错的视频或者问题截图,又或者能够现场演示错误的话,这样观察现象,然后再结合问题描述之后,一定能够帮助你快速地了解这个bug。


2.1.2 询问相关人员


这里你询问的可以不仅限于发现bug的人(一般是测试人员),当然你首先应当询问的还是这个发现bug的人。


这里你需要着重询问bug报告上你觉得迷惑的点,比如出现bug的应用版本、设备型号、bug出现的频率、bug产生的步骤和恢复的途径、bug修复的预期效果等。这里你需要进行刨根问底地询问,因为可能bug发现人觉得一些无关紧要的细节,对你来说却是至关重要的点。


问完发现bug的人之后,我们还可以向bug对应模块的负责人(测试、开发、产品)询问该模块的业务逻辑,说不定能够获取到有价值的信息哦。


2.1.3 提供bug报告模板


一份优秀的bug报告模板,可以让程序员直接跳过bug修复的前三步,直接进入到确认bug步骤,从而能够极大地提高bug修复的效率。那么一份优秀的bug报告模板应当具备哪些内容呢?


  • bug的标题和问题描述


  • 出现bug的应用版本


  • 出现bug的设备信息(型号、版本等)


  • bug产生相关的视频、截图和错误日志


  • bug复现的步骤


  • bug出现的必要条件(环境)和恢复途径


  • bug修复后的预期效果


  • bug对应的模块或者关联bug


有了以上的内容之后,相信程序员能够很快地了解这个bug,定位出bug产生的原因并予以解决。


微信截图_20220517201234.png


2.2 复现bug


如果你在第一步了解bug中获得了良好的bug报告的话,则此部分可以很容易。你只需要按照bug报告中的bug复现步骤,按顺序操作即可稳定复现bug。


当然,很多时候往往并不是一帆风顺的,即使你手握bug报告,做了非常详细的调查工作,然而bug就是无法复现,那么这个时候我们应该怎么做呢?


2.2.1 重新了解bug


此时为了能够复现bug,你可能需要回到上一步,重现去了解bug。因为你之前对bug的理解可能产生偏差,又或者你第一步并没有做好才导致了bug未能复现。这个时候带着疑问去重现了解bug,可能你会发现新的大陆。


2.2.2 将偶现bug转为必现bug


偶现bug算是bug家族中最调皮的一个了。它们以没有规律,难以复现等特性,经常能把以一个好好的程序员给逼疯。


但是既然是要复现bug,那么肯定要找到bug稳定复现的路径,这样才能方便下面bug的定位。这里我推荐大家的一个做法就是想办法把偶现的bug转化为必现的bug。因为即使是偶现的bug,很多也是特定条件下必现的bug,只不过此时你还没发现这个特定条件而已。


那么怎样才能将偶现bug转为必现bug呢?这里我简单介绍一下我常用的技巧:


  • 1.对比法:观察并对比复现和不复现的各方面条件,找到那个必现的特定条件。


  • 2.注释(删除)代码法:对怀疑的代码进行注释(删除),直到彻底将偶现bug转变为必现bug。


微信截图_20220517201316.png


2.3 定位bug


一旦我们找到了bug稳定复现的步骤之后,下面的工作就是开始定位bug产生的地方了。


这一步可以说是解决bug的关键环节,这一步骤的难易程度一般取决于以下几个因素:


  • 1.程序员自身的代码量(工作经验)


  • 2.对项目代码(业务)的熟悉程度。


  • 3.分析问题和解决问题的能力


那么我们如何才能更快地定位出bug产生的位置呢?下面我提供一些思路供大家参考:


  • 1.断点调试法。这是程序员通用,同时也是最有效的定位问题的方式。一个不会断点调试的程序员和瞎子没有本质上的区别。


  • 2.日志分析法。其实并不是所有bug都可以进行断点调试的。比如在一些循环调用或者业务较为复杂的场景下,打日志分析定位是较为适合的方式。


  • 3.排除法。如果一个bug产生的原因可能有多种情况的时候,这个时候采取排除法的方式是最优的。你可以把可能导致bug产生的代码块都打上日志或者断点,然后重现一下bug进行问题的定位。


  • 4.代码回滚法。如果你这个bug在之前的版本是好的,但是在现在版本上又出现了,这个时候就可以使用代码回滚大法。把你的代码回滚到你怀疑的版本,运行看bug是否消失,然后对两个版本之前代码有何区别,最终定位出bug产生的位置。这里我们可以使用二分法来提高代码的回滚效率。


  • 5.注释(删除)代码法。这个我在上一个步骤中也提到过。对于一些难以理解和定位的bug,我们可以使用这个方法进行尝试。不过这个方法使用起来有一定的风险,因为可能你删除的那一串代码虽然能够解决bug,但是却不是bug产生的根源,这个时候你可能会将必现bug改成了偶现bug,让问题变得更加复杂。


  • 6.源码分析法。有的时候有些bug可能并不是你的代码导致的问题。可能是第三方库本身的bug,又或者是系统本身的bug,又或者是你误用api导致的问题,这个时候就需要你拥有源码分析的能力。深入源码中,一层层分析直到最终找到bug产生的原因。


  • 7.联想法。通过一些类似的bug修改经验从而联想猜测出bug产生的位置。这个方法对使用者本身有较高的要求。需要使用者对项目代码和业务逻辑非常熟悉,同时对问题分析的能力有较高的要求。这就是我们常说的牛人能够一眼就能看出问题,他们常用的就是这种方式。


  • 8.场外支援法。这是实在定位不出bug才采取的下下策。因为它并不能提高你定位bug的能力,同时请别人帮忙定位bug,你就需要把你之前所做的工作都要全盘地向他表述一遍,这样不仅会降低bug修复的效率,同时还不一定能保证定位出bug产生的位置,它取决于你表述问题的能力和帮你的人分析和解决问题的能力。


QQ截图20220517201418.png


2.4 确认bug


在我们定位出bug产生的位置后,下面的工作就是分析bug产生的根源了。


这一步可以说是bug修复6个步骤中最为关键的一步。这一步直接决定了这个bug能否被彻底地解决,同时也是最能体现bug修复艺术的步骤。


但是很遗憾的是,这一步往往被很多人给忽视了。我为什么会这样说呢?因为很多时候我们修复bug的时候,都会受到各方面的限制:


  • 1.自身经验水平的限制:一些初入项目的程序员经常因为修复一个bug而导致了另一个bug,又或者只是看到了bug的表象却不能感知到bug产生更深层次的原因,所以10种产生bug的情况他可能只改了一种,将必现问题改成了偶现问题,让bug变得更加复杂。


  • 2.时间限制:这是我们程序员经常碰到的限制。这在互联网企业非常普遍,通常解决一个bug是有时间限制的,例如:这个项目明天就要上线了,并强制要求你今晚就得想办法解决。这个时候你可能就被逼无奈,采取硬编码的方式去临时把这个bug给按住。其实这样虽然bug是被临时解决了,但是却会让这个bug变得愈加复杂。很多公司出现的那些祖传代码就是在这种情况下产生的,动一下就可能产生无数未知的bug,令人绝望。


  • 3.业务限制:很多时候导致代码逻辑非常复杂难懂的罪魁祸首就是这种业务限制。我们在修复一个bug的时候,很多时候就是因为这种业务的限制,导致bug的修复一种不能从根源上予以解决,只要业务一调整就可能导致这个bug反复地出现。


说了这么多限制,那么我们如何才能找到问题的根源呢?


  • 1.多积累经验,提升自身的水平:这是打破自身经验水平的限制。


  • 2.及时处理bug:在收到bug报告的第一时间就去处理,尽可能打破时间的限制。


  • 3.多熟悉业务:有时间就多去了解和梳理业务,深入研究项目代码。这样我们在解决bug的时候也不会因为对业务不熟悉而无法分析出bug产生的根源。


  • 4.准确定位bug:bug定位的准确性直接决定了你能否分析出bug产生的根源。因此你需要仔细分析和定位bug,使用我上面介绍的8种方式去定位bug。


QQ截图20220517201515.png


2.5 修复bug


其实前面的四步都是为这一步所做的铺垫。有了前面四步的工作,相信到这儿也是相对微不足道的了,剩下的就是如何优美地解决这个bug了。


到了这个阶段,bug通常不需要大的修改来修复,因此这一步往往会非常快,当然也就没有什么好的技巧啦。


2.6 验证bug


作为bug修复的最后一步,它是确保bug被真正修复的最后保障。


在这里需要我们着重注意以下几点:


  • 1.重复之前复现bug的步骤来验证bug是否被彻底解决


  • 2.验证bug修复可能改动到的相关模块是否正常,保证bug修复不引入新的bug。


如果上述有任何一点没有达到的话,请返回步骤四和步骤五,重新修复bug!


QQ截图20220517201600.png


3.如何提高bug修复的效率


上文我们着重讲解了解决bug的艺术,为的是能够更好地解决bug。但是如何才能保证既有效,又快速地修复bug,提高bug修复的效率呢?


通过上面对于解决bug的艺术的讲解,我们可以总结出以下影响bug修复效率的几个关键点:


  • 1.bug信息收集的效率以及有效性。


  • 2.时间限制的压力。


  • 3.人员对项目代码(业务)的熟悉程度。


  • 4.人员自身经验和分析问题的能力。


以上4点可以说直接决定了bug修复的效率。那么如何才能提高bug修复的效率呢?下面我将一一给出我的看法。


微信截图_20220517201651.png


3.1 建立健全的信息收集机制


bug信息的收集可以说是修复bug过程中最为耗时的环节。提升bug信息收集的效率以及有效性可以大幅度地提升我们修复bug的效率。


那么我们应该如何建立健全的信息收集机制呢?这里我给出我的几点建议:


3.1.1 提供优秀的bug报告模板


上文我们在了解bug一步中提到过:一份优秀的bug报告模板,可以让程序员直接跳过bug修复的前三步,直接进入到确认bug步骤,从而能够极大地提高bug修复的效率。

这里我再次重复一步,一份优秀的bug报告模板应当具备哪些内容:


  • bug的标题和问题描述


  • 出现bug的应用版本


  • 出现bug的设备信息(型号、版本等)


  • bug产生相关的视频、截图和错误日志


  • bug复现的步骤


  • bug出现的必要条件(环境)和恢复途径


  • bug修复后的预期效果


  • bug对应的模块或者关联bug


3.1.2 建立完备的日志体系


一套完备的日志体系,可以让我们更加清晰地知道用户到底做了什么才导致bug的出现。


在项目的初期,我们可能为了赶工期而常常忽视了日志打印的重要性,这很可能就会导致该项目日后的维护将非常得艰难。


那么我们为什么要建立一套完备的日志体系呢?


  • 1.并不是所有的用户(测试)都能够给你描述清楚bug产生的信息。


  • 2.即使用户(测试)给你描述了bug产生相关的信息,但是他们并不理解你的代码逻辑,他们只能根据bug出现的现象告诉你问题,可能他们的表述和你的理解不在一个频道。


如果你有这么一套完备的日志体系,那么你就可以在用户(测试)不用开口的情况下,直接get到用户的操作行为以及对于的代码逻辑。同时,可能一句关键点的报错日志就可以帮你直接定位到bug产生的位置,从而直接进入第四步确认bug


说了这么多,我们应该如何打印高效的日志呢?


  • 1.在异常分支返回前打印日志。


  • 2.在复杂业务流程的关键点打印日志。


  • 3.在对外交互或者模块交互点打印日志。


  • 4.在用户交互或者生命周期的关键点打印日志。


  • 5.对重要的信息点打印日志,记录用户画像。


  • 6.按重要性分等级打印日志。


  • 7.禁止在循环中打印日志,禁止打印无效的日志。


  • 8.禁止打印用户隐私相关的信息。


3.2 建立自动化测试机制


建立自动化测试机制,可以让突破时间限制成为可能。


3.2.1 更早地发现bug


很多时候来自时间限制的压力,往往是测试不充分导致的。很多bug直到产品临近上线或者交付的时候才被发现,这个时候唯一解决问题的方式就是在时间上做出限制,无情压迫我们这些活在公司权力最底层的程序员们。


如果这个时候能有一套自动化测试机制,每天下班后都进行自动测试的话,那样很多bug就能被提前发现,从而为我们修复bug预留了不少宝贵的时间。


3.2.2 节约bug验证的时间


对于一些复杂难解、偶现的bug,我们往往会在确认bug验证bug之间花费大量的时间。这个时候如果有一套自动化测试机制或者工具帮助我们验证bug的话,就可以极大地缩减我们修复bug的时间。


QQ截图20220517201823.png


3.3 提高项目代码(业务)的熟悉程度


提高人员对项目代码(业务)的熟悉程度,这样就可以极大地提高人员定位bug的效率。


3.3.1 建立丰富的知识库体系


建立一套丰富的知识库体系,可以帮助我们加深对自己责任内项目代码(业务)的理解,同时还能帮助我们快速了解我们所不了解的业务模块。


那么如何才能建立起丰富的知识库体系呢?下面我给出我的几点建议:


  • 1.对知识进行分类。


  • 2.定期添加和更新知识库的内容。


  • 3.提高知识库的检索效率。


  • 4.定期组织知识的分享。


  • 5.激励贡献知识库的人员。


3.3.2 建立责任田划分机制


划分责任田的目的就是:让专业的人做专业的事情。


划分责任田的好处:


  • 1.专业的人做专业的事情。划分完责任田后,田主需要对自己负责的模块负责,这就必然要求其对模块内的代码(业务)更加熟悉。


  • 2.责任到人利于追责和bug跟踪。


当然责任田也不是想象中的那么完美,它也存在一定的缺陷:


  • 1.职责明确之后可能导致缺少全局视野。一些复杂的bug可能是几个模块共同作用下才产生的,对于这类bug的定位势必会大大增加难度。


  • 2.划分责任田之后,可能导致踢皮球的情况。


责任田划分机制,它是一把双刃剑。所以是否需要建立责任田划分机制,还是需要结合企业自身的情况而定的。


3.4 提高人员的综合素质


提高人员的综合素质,可以帮助我们提高定位bug确认bug以及修复bug三个步骤下的效率。


  • 1.建立公平的员工晋升制度。这样可以充分调动人员的主动性的积极性,提升人员的个人素质和业务能力。


  • 2.建立岗位轮换制度。让人员定期负责不同的模块,可以极大地提升人员的综合素质和全局视野。


  • 3.定期组织培训学习


4.最后


以上内容,是我参与工作五年,开源六年以来所总结下来的全部经验,喜欢的可以点击收藏或者三连支持一下!最后,还是祝福大家从此代码无bug,哈哈哈!!!


相关实践学习
日志服务之使用Nginx模式采集日志
本文介绍如何通过日志服务控制台创建Nginx模式的Logtail配置快速采集Nginx日志并进行多维度分析。
相关文章
C++编码规范——日积月累、持续更新
C++编码规范——日积月累、持续更新
264 0
|
7月前
|
前端开发 JavaScript 程序员
2024年最新65% 的程序员竟都是自学成才?_为啥学技术都自学,2024年最新42岁程序员面试
2024年最新65% 的程序员竟都是自学成才?_为啥学技术都自学,2024年最新42岁程序员面试
2024年最新65% 的程序员竟都是自学成才?_为啥学技术都自学,2024年最新42岁程序员面试
|
算法 搜索推荐 程序员
程序员代码面试指南之笔记01(上)
一、算法数据结构基础课 第一节 一、 评估算法
71 0
程序员代码面试指南之笔记01(上)
|
机器学习/深度学习 算法 程序员
程序员代码面试指南之笔记01(下)
4) 局部最小值问题 public class Code06_BSAwesome {
42 0
|
存储 数据采集 Web App开发
【编程课堂】震惊!小 bug 引发大灾难,0.1 + 0.2 的结果竟然是……
手边有电脑的同学可以立即在 python 控制台下尝试一下,对浮点数精度不够了解的同学可能会大呼:天啦噜,夭寿啦,怎么会是 False !
|
程序员
程序员成长第七篇:面试中需要注意的事项
程序员成长第七篇:面试中需要注意的事项
87 0
|
算法 程序员
《程序员面试宝典》下载
《程序员面试宝典》电子书开放下载!全书涵盖70+算法题目、近30种大厂笔试考点,算法学习看这本书就够了!
75 0
《程序员面试宝典》下载
|
前端开发 测试技术 数据安全/隐私保护
《全栈软件测试工程师宝典》勘误
《全栈软件测试工程师宝典》勘误
135 0
|
存储 消息中间件 安全
「避坑宝典」为大家分享一下笔者在 2022 年所遇到“匪夷所思”的 Bug 趣事(上)
「避坑宝典」为大家分享一下笔者在 2022 年所遇到“匪夷所思”的 Bug 趣事(上)
109 0
|
存储 安全 搜索推荐
天选程序员:如何提个好问题?
天选程序员:如何提个好问题?
279 0
天选程序员:如何提个好问题?

相关实验场景

更多
下一篇
DataWorks