【新手必读】如何高效的反馈一个BUG？

qstack

如何高效的反馈一个BUG？

QStack作为一个不断完善的系统，现在版本已经进化到了3.0，必然是一路伴随着不少的BUG。当然，没有各位的支持，QStack不会有现在的成长。不过，我们也竟在看到很多朋友在反馈BUG的时候，就单纯提供了一张局部截图，或者一句“挂了”，“打不开”，“404”，“你们这个系统有BUG”就没了。其实我们很想为大家提供帮助，奈何信息实在有限。所以，我想在这里谈谈如何高效的反馈BUG，才是对QStack最有力的支持。

一、先确定自己遇到的是不是一个BUG

1. 你是否按照教程一步一步操作了？

在系统安装和配置的过程中，是否跳过了一些操作？如果有一些环节，你是凭感觉进行处理的，建议你再完整的看一遍教程，很可能你遇到的问题只是疏忽了某个环节造成的。

常见的比如：计划任务没有配置，nginx没有配置等。

2. 你是否自行修改了文件或者数据库？

自己是否修改过系统的文件，或者做了直接修改数据库数据的操作？

常见的比如：修改模板文件，直接插入业务或者产品数据等。

二、尝试自行解决

首先，我们建议您将系统升级到最新版本，我们在每个版本都会修复一些已知的问题。你目前遇到的问题可能已经在上个版本修复了。

遇到问题后请先使用以下方法，尝试解决问题：

删除最新添加的数据
清除缓存
重启PHP服务、Mysql，或者重启服务器
重新登录

以上是一些简单的处理方案，处理过后看看这个问题是否还会存在？

三、在论坛找找相同的问题

如果你遇到的真的是一个BUG，那么大概率有其他人也会遇到和你一样的问题。你可以现在论坛里看看其他人是怎么解决的。

四、反馈BUG的方式

我们建议按照以下模板来反馈问题，这样可以最效率的反馈出具体的BUG，节省工程师排查问题的时间，尽快找出解决BUG的方案。

BUG反馈模板：

【系统】：是QStack还是CloudInstall还是其他控制器等等，并说明版本。

【诱因】：您是在什么情况下发现bug的，是执行安装、配置、登录、同步数据等等操作的时候，或者说是没做什么特别操作，点着点着系统就崩了。

【错误状况】：什么场景让你觉得系统出现问题了？错误弹窗、不明确的信息、404、白屏等等。

【影响范围】：具体是前台、后台，还是哪个页面？对接接口的时候对接的是QStack的其他系统，还是对接什么品牌？

【解决情况】：您是否尝试解决过bug，比如更新系统、清除缓存之类的，解决了还是无效？

【补充信息】：补充一些能让我们了解更多细节的信息。

【截图】：最好能附带截图，让我们了解实际的状况，而不是单纯的文字描述。

我们来看一个范例：

【系统】：QStack 3.1.8

【诱因】：用户从前台先购买云计算的试用业务，然后再续费，会没办法退款。我这边是试了续费一个月的。

【错误状况】：没办法退款，退款按钮显示是灰色的，点不了。

【影响范围】：前台-会员中心-云计算

【解决情况】：尝试创建了新业务，按一样的方式购买，会产生一样的问题。

【补充信息】：猜测是试用业务没办法退款，导致了后面续费也没办法退款。

【截图】：

五、我们反馈后在干什么？

1. 为什么很多BUG反馈经常石沉大海？

事实上，内部测试反馈的问题往往比外部的更多也更为严重，大部分时间我们肯定都是优先处理这些问题。在每个版本发布之前，这些问题大部分已经被解决掉了，所以用户感知并不高，但工作量着实不小。在这些问题解决的基础上，我们才会从外部渠道挖掘一些新的问题来解决。

但是凭心而论，外部渠道反馈的BUG常常不够完整。相较于那些信息清晰的BUG，我们的工程师需要花大量的精力去定位问题点，所以更优先的会去解决那些信息更加准确，问题更加明确的BUG，来提升自己工作的成效。

2. 为什么反馈BUG有时候很长时间都没处理？

解决BUG最重要的前提，是复现。我们的工程师需要去重现BUG的情况。但是大家的系统环境五花八门，数据也经过了各式各样的处理。所以有时候一些问题的复现难度很大。

如果BUG的情况无法复现，那么我们将没办法准确的定位问题点，那么解决问题的不确定性就会非常大。

其次，在问题处理的选择上，我们倾向于会选择一些更严重的，更广泛的问题去优先解决。

最后

我想说，系统的成长总是伴随着缺陷的发现与改进，论坛的建设是为了建设用户与工程师之间更加通畅的沟通桥梁。希望在未来，大家能够更高效准确地向我们反馈问题，并且感谢大家一直以来对本系统的支持与包容，谢谢大家！