1. Linux错误返回值概述
在Linux系统开发中，错误处理是每个开发者必须掌握的核心技能。系统通过预定义的错误码来标识各种异常情况，这些错误码不仅是内核与用户空间通信的桥梁，更是我们调试程序的重要依据。
Linux错误码主要分布在三个头文件中：
errno-base.h：定义基础错误码（1-34）- `errno.h``：扩展错误码（35-133）
errno.h：特殊错误码（512-531）
这些错误码都是通过宏定义实现的，采用全大写命名规范，每个错误码都有对应的英文描述，直观反映了错误类型。例如EPERM表示权限不足，ENOENT表示文件不存在。
提示：在Linux中，错误码通常以负值形式返回。例如open()系统调用失败时返回-1，同时设置errno为具体错误码。
2. 基础错误码解析（1-34）
2.1 文件系统相关错误
c复制#define ENOENT 2 /* No such file or directory */
#define EBADF 9 /* Bad file number */
#define EACCES 13 /* Permission denied */
#define ENOTDIR 20 /* Not a directory */
#define EISDIR 21 /* Is a directory */
#define EROFS 30 /* Read-only file system */
这些是最常见的文件操作错误：
- ENOENT：尝试打开不存在的文件时触发
- EACCES：权限不足时出现，常见于访问受保护的系统文件
- EROFS：在只读文件系统（如某些挂载的CDROM）上尝试写操作时产生
2.2 资源与权限错误
c复制#define EPERM 1 /* Operation not permitted */
#define ENOMEM 12 /* Out of memory */
#define EMFILE 24 /* Too many open files */
#define ENOSPC 28 /* No space left on device */
内存管理要点：
- ENOMEM不仅出现在malloc失败时，执行fork等系统调用时也可能触发
- EMFILE的常见场景是程序未关闭文件描述符导致泄漏，最终达到进程限制
2.3 特殊错误码
c复制#define EINTR 4 /* Interrupted system call */
#define EAGAIN 11 /* Try again */
#define EINVAL 22 /* Invalid argument */
EINTR处理技巧：
c复制// 正确处理被信号中断的系统调用
retry:
n = read(fd, buf, size);
if (n == -1 && errno == EINTR)
goto retry;
3. 扩展错误码详解（35-133）
3.1 网络相关错误
c复制#define ENETDOWN 100 /* Network is down */
#define ECONNREFUSED 111 /* Connection refused */
#define ETIMEDOUT 110 /* Connection timed out */
网络编程中关键错误处理：
- ETIMEDOUT通常需要设置合理的超时时间
- ECONNREFUSED表明目标服务未启动或防火墙拦截
3.2 同步与锁错误
c复制#define EDEADLK 35 /* Resource deadlock would occur */
#define ENOLCK 37 /* No record locks available */
死锁预防建议：
- 统一获取锁的顺序
- 使用非阻塞模式（F_SETLK而非F_SETLKW）
- 设置锁超时时间
3.3 特殊系统错误
c复制#define ENOSYS 38 /* Invalid system call number */
#define ELOOP 40 /* Too many symbolic links encountered */
ENOSYS的典型场景：
- 调用老内核不支持的较新系统调用
- 嵌入式系统中某些功能被裁剪
4. 内核专用错误码（512-531）
4.1 重启相关错误
c复制#define ERESTARTSYS 512
#define ERESTARTNOINTR 513
#define ERESTARTNOHAND 514
这些错误码的特殊性：
- 永远不会直接暴露给用户空间
- 由内核在系统调用被信号中断时内部使用
- 触发系统调用的自动重启机制
4.2 文件系统特殊错误
c复制#define EOPENSTALE 518 /* open found a stale dentry */
#define EBADHANDLE 521 /* Illegal NFS file handle */
NFS文件句柄问题排查：
- 检查服务器和客户端NFS版本兼容性
- 验证网络稳定性
- 确认文件系统在服务端未被意外修改
5. 错误处理实践技巧
5.1 错误判断机制
内核提供了IS_ERR/PTR_ERR组合来判断和获取错误：
c复制// 判断指针是否包含错误
static inline bool __must_check IS_ERR(__force const void *ptr)
{
return IS_ERR_VALUE((unsigned long)ptr);
}
// 提取错误码
static inline long __must_check PTR_ERR(__force const void *ptr)
{
return (long) ptr;
}
使用示例：
c复制struct file *filp = filp_open("/path", O_RDWR, 0);
if (IS_ERR(filp)) {
int err = PTR_ERR(filp);
printk("Open failed with error %d\n", err);
return err;
}
5.2 错误码转换技巧
用户空间与内核空间错误码转换：
c复制// 内核到用户空间
int err_to_user(int kernel_err)
{
return -kernel_err;
}
// 用户空间到内核
int err_from_user(int user_err)
{
return -user_err;
}
5.3 错误日志记录最佳实践
推荐日志格式：
code复制[时间] [进程ID] 文件名:行号 函数名 - 错误描述 (错误码)
示例实现：
c复制#define LOG_ERR(fmt, ...) \
printk(KERN_ERR "[%s:%d] %s - " fmt "\n", \
__FILE__, __LINE__, __func__, ##__VA_ARGS__)
void example_func(void)
{
int fd = open("/dev/device", O_RDWR);
if (fd < 0) {
LOG_ERR("Open device failed: %s (%d)",
strerror(-fd), -fd);
return;
}
}
6. 常见问题排查指南
6.1 EAGAIN与EWOULDBLOCK
这两个错误码的关系：
- 在Linux中EWOULDBLOCK(35)与EAGAIN(11)完全等同
- 历史原因保留了两个定义
- 套接字操作中更常见EWOULDBLOCK
正确处理非阻塞IO：
c复制while (1) {
ret = read(fd, buf, size);
if (ret >= 0) break;
if (errno != EAGAIN && errno != EINTR) {
// 真实错误处理
break;
}
// 可在此处添加usleep短暂延迟
}
6.2 ENOMEM问题定位
内存不足排查步骤：
- 检查
/proc/meminfo确认系统内存状态 - 通过
ps aux --sort=-%mem查找内存消耗大的进程 - 检查内核日志
dmesg | grep oom - 评估cgroup内存限制（容器环境中常见）
6.3 文件系统错误处理
EXT4特有错误补充：
- EFSCORRUPTED（EXT4文件系统损坏）
- ESHUTDOWN（文件系统已卸载）
修复建议：
bash复制# 强制文件系统检查
fsck -y /dev/sdX
# 重新挂载前备份重要数据
7. 错误处理进阶技巧
7.1 错误码分类处理
建议将错误分为几大类处理：
c复制switch (errno) {
// 可重试类错误
case EAGAIN:
case EINTR:
// 延迟后重试
break;
// 权限类错误
case EPERM:
case EACCES:
// 提升权限或提示用户
break;
// 资源不足类
case ENOMEM:
case ENOSPC:
// 释放资源或报错退出
break;
// 参数错误类
case EINVAL:
case ENOTSUPP:
// 检查调用参数
break;
}
7.2 自定义错误码范围
开发者可用的错误码范围：
- 用户空间：1-4095（与系统错误码不冲突）
- 内核模块：512-531以外的未使用值
注册自定义错误码：
c复制// 定义错误码
#define EMYERROR1 2000
#define EMYERROR2 2001
// 错误描述映射
static const char *my_errors[] = {
[EMYERROR1] = "Custom error 1 occurred",
[EMYERROR2] = "Custom error 2 detected"
};
const char *my_strerror(int err)
{
if (err >= EMYERROR1 && err <= EMYERROR2)
return my_errors[err];
return strerror(err);
}
7.3 错误注入测试
内核错误注入方法：
c复制// 强制返回指定错误码
#define force_error(ret) \
do { \
if (test_error_mode) \
return -ret; \
} while (0)
int my_syscall(void)
{
force_error(ENOMEM);
// 正常逻辑...
}
用户空间测试工具：
bash复制# 使用LD_PRELOAD注入错误
$ LD_PRELOAD=./error_inject.so ./myapp
掌握Linux错误处理机制是成为系统开发高手的必经之路。在实际项目中，建议建立完善的错误处理策略：包括错误预防、实时检测、优雅恢复和详细日志记录。记住，好的错误处理不是事后补救，而应该贯穿整个开发周期。