C / C++ / 系统课时

用 RAII 管住文件描述符

用 RAII 管住文件描述符

这一课把裸 int 文件描述符变成明确的资源所有权对象:构造时接管,析构时关闭,禁止复制,只允许移动。这样 socket、pipe、epoll 等描述符在异常、提前返回和对象转移时都能自动释放,避免重复关闭与泄漏。

学习目标

  • 理解文件描述符为什么需要“唯一所有者”,以及裸 int 容易造成的生命周期错误。
  • 实现支持移动语义的 UniqueFd,正确处理析构、移动赋值、release 与 reset。
  • 用可运行示例验证移动后旧对象失效、资源仍可使用且最终只关闭一次。

所有权比数值更重要

文件描述符本质上只是进程文件描述符表中的一个整数索引。两个变量都保存数字 5,并不代表它们各自拥有一份独立资源;如果两个对象都在析构时调用 close(5),第二次关闭可能误伤已经被系统复用成其他资源的描述符。

RAII 的关键不是“把 close 放进析构函数”这么简单,而是让所有权规则与 C++ 对象语义一致:同一时刻只有一个对象负责关闭资源,所有权转移后源对象必须立即进入无效状态。

UniqueFd 所有权转移状态图

实现唯一所有权封装

下面先看 UniqueFd 的核心实现。片段示例依赖 POSIX unistd.h,用于说明类型设计,本身没有 main 入口;后面会给出完整可运行程序。复制构造与复制赋值被删除,移动构造使用 release() 取走所有权,移动赋值则先释放自己原有的描述符,再接管源对象。

cpp
#include <unistd.h>

#include <utility>

class UniqueFd {
public:
    explicit UniqueFd(int fd = -1) noexcept : fd_(fd) {}

    ~UniqueFd() {
        reset();
    }

    UniqueFd(const UniqueFd&) = delete;
    UniqueFd& operator=(const UniqueFd&) = delete;

    UniqueFd(UniqueFd&& other) noexcept
        : fd_(other.release()) {}

    UniqueFd& operator=(UniqueFd&& other) noexcept {
        if (this != &other) {
            reset(other.release());
        }
        return *this;
    }

    int get() const noexcept {
        return fd_;
    }

    bool valid() const noexcept {
        return fd_ >= 0;
    }

    int release() noexcept {
        return std::exchange(fd_, -1);
    }

    void reset(int new_fd = -1) noexcept {
        if (fd_ >= 0) {
            ::close(fd_);
        }
        fd_ = new_fd;
    }

private:
    int fd_;
};

release() 只转移所有权,不调用 close;reset() 则先关闭当前资源再接管新值。析构函数调用 reset(),因此异常和提前返回都不需要单独写清理分支。

用 pipe 验证移动语义

下面的程序创建一对 pipe 描述符,把读端从 reader 移动到 moved,再通过写端写入数据。移动后 reader 必须失效,而 moved 仍能正常读取。

cpp
#include <unistd.h>

#include <array>
#include <cerrno>
#include <iostream>
#include <string_view>
#include <system_error>
#include <utility>

class UniqueFd {
public:
    explicit UniqueFd(int fd = -1) noexcept : fd_(fd) {}

    ~UniqueFd() {
        reset();
    }

    UniqueFd(const UniqueFd&) = delete;
    UniqueFd& operator=(const UniqueFd&) = delete;

    UniqueFd(UniqueFd&& other) noexcept : fd_(other.release()) {}

    UniqueFd& operator=(UniqueFd&& other) noexcept {
        if (this != &other) {
            reset(other.release());
        }
        return *this;
    }

    int get() const noexcept { return fd_; }
    bool valid() const noexcept { return fd_ >= 0; }

    int release() noexcept {
        return std::exchange(fd_, -1);
    }

    void reset(int new_fd = -1) noexcept {
        if (fd_ >= 0) {
            ::close(fd_);
        }
        fd_ = new_fd;
    }

private:
    int fd_;
};

int main() {
    int fds[2];
    if (::pipe(fds) != 0) {
        throw std::system_error(errno, std::generic_category(), "pipe");
    }

    UniqueFd reader(fds[0]);
    UniqueFd writer(fds[1]);
    UniqueFd moved(std::move(reader));

    std::cout << std::boolalpha
              << "reader.valid=" << reader.valid() << "\n"
              << "moved.valid=" << moved.valid() << "\n";

    constexpr std::string_view message = "hello";
    if (::write(writer.get(), message.data(), message.size()) !=
        static_cast<ssize_t>(message.size())) {
        throw std::system_error(errno, std::generic_category(), "write");
    }

    std::array<char, 5> buffer{};
    const ssize_t n = ::read(moved.get(), buffer.data(), buffer.size());
    if (n < 0) {
        throw std::system_error(errno, std::generic_category(), "read");
    }

    std::cout << "read="
              << std::string_view(buffer.data(), static_cast<std::size_t>(n))
              << "\n";
}

在 Linux 或其他提供 POSIX pipe、read、write 的环境中,可使用 C++20 编译并运行:

bash
c++ -std=c++20 -Wall -Wextra -Wpedantic unique_fd_demo.cpp -o unique_fd_demo
./unique_fd_demo

预期输出:

text
reader.valid=false
moved.valid=true
read=hello

程序退出时,moved 和 writer 分别关闭各自仍持有的描述符;已经被移动的 reader 保存 -1,因此不会再次关闭读端。

处理边界时守住三个规则

第一,绝不要从同一个裸描述符同时构造两个 UniqueFd,因为这会制造两个“唯一所有者”。第二,调用 release() 后,返回的裸描述符必须立刻交给新的所有者或显式关闭,否则 RAII 保护会在这一刻失效。第三,只有真正拥有资源的对象才能调用 reset() 关闭它,借用场景只应传递 get() 的返回值。

网络库中的 socket、监听 fd、连接 fd、epoll fd 都可以采用同样模式。把“谁负责关闭”编码进类型系统后,资源释放就不再依赖每条控制流都手写 close,这正是 RAII 在底层网络编程中最有价值的地方。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 RAII 管住文件描述符

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通