inotify_init() 返回 -1 主因是内核限制或权限问题：ENFILE（进程fd耗尽）、EMFILE（单进程fd超限）、ENOMEM（inotify实例超限，查/proc/sys/fs/inotify/max_user_instances）；需确保目录有x权限、及时close fd。
inotify_init() 返回 -1 怎么排查
调用 inotify_init() 失败（返回 -1）通常不是代码写错，而是内核限制或权限问题。先检查 errno 值：ENFILE 表示进程级文件描述符耗尽；EMFILE 是当前进程打开的 fd 数超限；ENOMEM 则是内核 inotify 实例数达到上限（由 /proc/sys/fs/inotify/max_user_instances 控制）。
实操建议：
- 用
cat /proc/sys/fs/inotify/max_user_instances查当前限制，临时提高可用sudo sysctl fs.inotify.max_user_instances=8192 - 确保没漏掉
close(inotify_fd)—— 每次inotify_init()都消耗一个 fd，反复创建不释放必崩 - 普通用户无需 root 权限，但监控目录必须有执行（
x）权限（否则inotify_add_watch()会报EACCES）
inotify_add_watch() 监控子目录是否递归
inotify_add_watch() **不递归**。它只监控指定路径本身：对目录加 watch，能收到该目录下直接创建/删除/重命名等事件；但子目录里的变更，除非你显式对每个子目录再调一次 inotify_add_watch()，否则收不到。
常见误判场景：监控 /tmp/mydir，然后在 /tmp/mydir/sub/ 里新建文件，却没触发事件——因为 sub/ 没被单独 watch。
实操建议：
- 若需递归监控，得自己遍历目录树，对每个子目录调用
inotify_add_watch()（注意控制深度，避免符号链接循环） - 监控目录时，事件掩码至少包含
IN_CREATE | IN_DELETE | IN_MOVED_TO | IN_MOVED_FROM | IN_DELETE_SELF，否则重命名或删目录时可能丢失关键事件 -
IN_MOVED_TO和IN_MOVED_FROM总成对出现，靠cookie字段关联，别只过滤其中一个
读 inotify 事件时 read() 返回值小于 sizeof(struct inotify_event)
read() 从 inotify fd 读取的是变长结构流，每个 struct inotify_event 后紧跟可选的 name[] 字段。如果缓冲区太小（比如只开 sizeof(struct inotify_event) 字节），read() 可能只读到结构头，后续 name 被截断，导致 len 字段失效、解析崩溃。
正确做法是分配足够大的缓冲区（如 4096 字节），并用循环解析：
char buf[4096];
ssize_t len = read(inotify_fd, buf, sizeof(buf));
char *ptr = buf;
while (ptr name（长度为 ev->len）
ptr += sizeof(struct inotify_event) + ev->len;
}
注意：ev->len 是 name 字符串长度（不含 \0），不是整个事件长度；若 ev->mask & IN_ISDIR，说明事件来自子目录，此时 ev->name 才有效（否则为空）。
程序退出前忘记 IN_IGNORED 事件处理
当用 inotify_rm_watch() 移除 watch，或监控目录被删除/卸载时，内核会向 inotify fd 发送一个带 IN_IGNORED 标志的事件。如果程序没处理这个事件，又继续 read()，可能阻塞或读到无效数据（尤其在循环监听中容易卡住）。
实操建议：
- 每次
read()解析事件后，检查ev->mask & IN_IGNORED，遇到就跳出监听循环或清理对应 watch ID - 不要依赖信号或异常退出来释放资源——
inotifyfd 必须显式close()，否则内核资源不释放，且同一进程重复 init 容易 hitmax_user_instances - 监控点较多时，用
std::map维护 wd → path 映射，收到IN_IGNORED后及时 erase，避免后续误用已失效 wd
inotify 的事件队列有大小限制（/proc/sys/fs/inotify/max_queued_events），高频率变更下容易溢出丢事件，真要可靠监控大流量目录，得结合 fanotify 或用户态轮询补漏——但这已是另一层权衡了。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
