EPOLLONESHOT需手动重置以避免多线程竞争，必须在epoll loop线程中用epoll_ctl(EPOLL_CTL_MOD)完整设置events（如EPOLLIN|EPOLLONESHOT），并确保ET模式下读完缓冲区；跨线程重置应通过eventfd等异步通知机制串行处理。
EPOLLONESHOT 为什么必须手动重置事件
EPOLLONESHOT 标志会让内核在触发一次就绪事件后自动禁用该 fd 的监听，不手动重置就再也收不到后续事件。这不是 bug，是设计：它强制你「处理完再申请下一次通知」，从而天然规避重复触发导致的多线程竞争（比如两个线程同时 read 同一个 socket）。但代价是你得自己管重启用——漏掉 epoll_ctl(fd, EPOLL_CTL_MOD, ...)，连接就卡死。
多线程下重置 EPOLLONESHOT 的典型错误姿势
常见错误是多个线程并发调用 epoll_ctl 去 MOD 同一个 fd，而 epoll_ctl 本身不是原子操作：它先读旧事件掩码、再合并新掩码、再写回。如果线程 A 正在重置 EPOLLIN，线程 B 同时想加 EPOLLOUT，可能丢失其中一个标志，或者触发 EAGAIN 错误。
- 不要让多个线程直接操作同一个 epoll fd 上的同一 socket fd
- 避免在 worker 线程里调用
epoll_ctl；所有 MOD 操作统一交由 epoll loop 线程（即调用epoll_wait的那个线程）执行 - 如果必须跨线程请求重置，用无锁队列或 pipe 通知 epoll loop 线程，而不是直接调用
epoll_ctl
安全重置 EPOLLONESHOT 的最小可行代码
核心原则：只在 epoll loop 线程中做 EPOLL_CTL_MOD，且确保结构体初始化完整。下面这段代码常被忽略的是 ev.events 必须显式包含原始监听事件（如 EPOLLIN | EPOLLONESHOT），不能只传 EPOLLONESHOT——否则会清空其他标志。
struct epoll_event ev;
ev.data.fd = client_fd;
ev.events = EPOLLIN | EPOLLONESHOT; // 注意：必须带上原事件类型！
if (epoll_ctl(epoll_fd, EPOLL_CTL_MOD, client_fd, &ev) == -1) {
// 处理 ENOENT（fd 已关闭）、EBADF（fd 无效）等
}
如果你用的是边缘触发（ET）模式，还要确保在重置前已把 socket 缓冲区数据全部 read 到 EOF，否则重置后可能漏事件。
立即学习“C++免费学习笔记（深入）”；
更健壮的做法：用 eventfd 或 timerfd 协同通知
当业务逻辑复杂（比如重置前要查数据库、发 RPC），不能卡住 epoll loop 线程。这时可以用 eventfd 把重置请求“投递”进 epoll 自身：
- 创建一个
eventfd(0, EFD_CLOEXEC)，加入同一 epoll 实例，监听EPOLLIN - worker 线程 write 8 字节到该 eventfd 表示“请重置 fd X”
- epoll loop 收到 eventfd 就绪后，从共享队列取请求、执行
epoll_ctl(... EPOLL_CTL_MOD ...)
这个模式把同步调用转为异步消息，既保住 EPOLLONESHOT 的安全性，又不阻塞主循环。真正容易被忽略的是：所有涉及 fd 状态变更的操作（关闭、重置、超时踢出），都必须串行进 epoll loop，哪怕只是改个 std::map<int connstate></int> 里的状态字段——因为网络事件和状态更新必须严格有序。
