C/C++大型项目错误管理

本文涉及的产品
日志服务 SLS,月写入数据量 50GB 1个月
简介:

         在C/C++大型项目中,错误管理在项目中起着举足轻重的作用,以我自己的项目经验以及观摩其他项目,错误管理对项目框架以及开发效率有着很大的影响。对于错误管理的认识大致分为三类:

  1. 刚刚开始写程序的新手,满篇程序看不到一处关于返回出错的处理,更不用说出错管理了。说明他没认识到出错管理的重要性
  2. 程序中到处都能看到关于出错的处理。认识到了错误,但是处理方式欠缺
  3. 程序中几乎不会很明显的看到关于错误的处理。这是错误管理的最高境界。

         错误管理,涉及到程序的健壮性,可恢复性,可靠性,高效性。在出错的情况下,程序任然能够相对稳健高效的执行。

下面我谈谈我自己在C/C++项目开发中关于错误管理的经验。

对于C/C++系统API,都提供了errno.h头文件,里面已经定义了绝大多数系统已知的错误以及其对应的错误提示。 参考《linux中出错处理》

        一般系统自带的错误定义以及出错提示都不能很好的满足实际的项目需求,毕竟项目中很多都涉及到具体业务,如果笼统的使用系统定义的错误号以及描述,并不能很快的定义错误位置。通常需要我们自己重新封装并定义错误。

   

       《The Art of Unix Programming》中有一个原则说的非常好:Rule of Repair: When you must fail, fail noisily and as soon as possible。当程序遇到无法修复必须报错的时候,就让它立即用很明显的方式报错。这句话很简洁,但是缺描述出了关于错误管理的理念。如果一定要出错,就很明显的方式来表达,目的就是为了很迅速精准的定位错误。出错不是期望,出错管理也不是目的,目的是为了在出错之后能很快的定位错误使得程序能够很快的恢复。

 
为了快速定位错误,有三个宏非常有用:

__FILE__             //文件名

__FUNCTION__   //函数名

__LINE__            //当前行号

一般针对不同的业务会有不同的模块。自定义错误号的方式如下:

//EBASE最高位是1,保证错误号是负数,符合编程习惯
#define				EBASE			0X80000000

//串口业务模块
#define				ESERIAL			EBASE + 0XC8
#define				ESERIALTIMEOUT  ESERIAL + 1 //串口超时
#define				ESERIALREAD		ESERIAL + 2 //读串口错误
//....

//HTTP业务模块,与ESERIAL之间有200的差距,这样串口业务模块可以有200个错误号
#define				EHTTPSERVICE	EBASE + 0X190
#define				EHTTPTIME		EHTTPSERVICE + 1
#define				EHTTPGET		EHTTPSERVICE + 2
//...

//与EHTTPSERVICE有200差距,这样HTTP也可以有200个错误号
#define				EGSM			EBASE + 258

//....

模块化定义错误,通过错误号区间可以很快的查阅错误模块。例如错误号是 -202,通过对照,毫无疑问是串口模块出错了。


        接下来就是错误的翻译了。所谓错误翻译就是将错误号翻译成具体的语句。可以选择将错误描述与错误号写入Excel表中,然后导出XML文件,在程序中错误描述可以直接解析对应XML中错误号的描述即可。

另一种比较常见的方式就是直接用宏写在一个头文件中。当然,__FILE__, __FUNCTION__这些必不可少。


        日志文件记录了程序后台运行状况以及出错前一刻程序正在做什么,一般可以从日志文件的数据分析程序的行为并定位错误。对于日志文件,我想C/C++程序员都会写,这里我就不多说。一般打印错误提示的同时都会伴随着写日志。

        一般都会用宏来写打印错误和写日志的操作,关于如何写我这里不多说,我想很多人都会。这里我想强调的事关于打印错误信息和写日志一定要设置开关。在实际项目中,我经常会遇到这种问题,当有很多地方都需要打印和记录log的时候,程序执行的非常慢,当我把写日志去掉,程序立马就能很快的运行。所以,设置开关是很有必要的:

#ifndef LOG_OFF
#define WriteLog(file, line, function, desc)  \

//...一些写日志和打印操作


#else
#define  WriteLog(file, line, function, desc)
#endif 

这样,在程序中可以很好的控制开关。提高效率



相关实践学习
日志服务之使用Nginx模式采集日志
本文介绍如何通过日志服务控制台创建Nginx模式的Logtail配置快速采集Nginx日志并进行多维度分析。
目录
相关文章
|
1月前
|
移动开发 监控 数据可视化
通过C++实现对管理员工上网行为的数据挖掘与可视化
这篇文章介绍了如何使用C++进行员工上网行为的监控数据挖掘与可视化。首先,通过读取系统日志收集上网数据,然后进行数据分析,包括统计访问频率和识别异常行为。接着,利用数据可视化工具展示结果。最后,讨论了如何将监控数据自动提交到网站,以实现实时监控和问题响应。示例代码展示了使用Boost.Asio库创建HTTP客户端上传数据的基本过程。
116 2
|
1月前
|
编译器 C++ 开发者
【Conan 入门教程 】使用Conan 2.X和Autotools高效构建C/C++项目
【Conan 入门教程 】使用Conan 2.X和Autotools高效构建C/C++项目
118 1
|
1月前
|
算法 测试技术 数据处理
【C/C++ 面试技巧】如何在简单的项目里突出自己的价值?
【C/C++ 面试技巧】如何在简单的项目里突出自己的价值?
65 1
|
1月前
|
存储 监控 算法
【C++ 软件设计思路】高效管理历史任务记录:内存与磁盘结合的策略解析
【C++ 软件设计思路】高效管理历史任务记录:内存与磁盘结合的策略解析
83 0
|
1月前
|
算法 测试技术 开发工具
编写高效技术文档的艺术:C++项目实践指南
编写高效技术文档的艺术:C++项目实践指南
100 0
|
1月前
|
存储 算法 Linux
【实战项目】网络编程:在Linux环境下基于opencv和socket的人脸识别系统--C++实现
【实战项目】网络编程:在Linux环境下基于opencv和socket的人脸识别系统--C++实现
107 7
|
9天前
|
安全 C++ 开发者
C++一分钟之-动态内存管理:new与delete
【6月更文挑战第19天】在C++中,`new`和`delete`用于动态内存管理,分配和释放堆内存。不正确使用可能导致内存泄漏和悬挂指针。要避免这些问题,确保每次`new`都有匹配的`delete`,释放内存后设指针为`nullptr`。使用`delete[]`释放数组,避免重复释放。智能指针如`std::unique_ptr`可自动管理内存,减少手动管理的风险。通过实例展示了如何使用智能指针进行安全的内存操作。
23 4
|
8天前
|
C++
C++对C的改进和拓展\动态内存空间管理
C++对C的改进和拓展\动态内存空间管理
8 0
|
14天前
|
存储 C++ C语言
【C++语言】动态内存管理
【C++语言】动态内存管理
|
1月前
|
存储 C++ UED
【C++】飞机大战项目记录
通过上面的设计,我们实现来看飞机大战的主要功能
52 4