pthread_key_create报EAGAIN原因排查及fork后键限制问题

首先，咱们先明确pthread_key_create返回EAGAIN的两种核心原因，和你查阅的文档完全一致：

• 系统缺少创建新线程键的必要资源（比如内存等系统资源不足）
• 进程已达到线程键总数上限PTHREAD_KEYS_MAX

如何排查是否是键数超限导致？ #

系统没有直接的命令行工具可以实时查看进程已使用的线程键数量，但可以通过以下方式高效排查：

1. 先确认系统上限：用sysconf(_SC_THREAD_KEYS_MAX)获取当前系统允许的最大线程键数，比如你在Ubuntu 16.04上看到的1024就是默认值。
2. 代码内统计跟踪：像你测试代码里的create_keys函数那样，在每次调用pthread_key_create时统计成功次数，直接掌握当前进程已使用的键数。这是最直接有效的方式，适合在调试阶段或生产环境中埋点监控。
3. 调试工具辅助：如果需要离线排查，可以用gdb附加到进程，查看进程内部的线程键表（不同系统的实现可能有差异，比如在glibc中，线程键相关结构存在进程的pthread_keys数组里，不过这个方式偏底层，需要对glibc实现有一定了解）。

关于fork后线程键限制共享的问题 #

你测试代码里的现象完全符合POSIX标准的行为：线程键是进程级资源，当调用fork()创建子进程时，子进程会完整继承父进程的线程键表状态——包括已使用的键数、已创建的键本身。

举个例子对应你的测试场景：

• 当父进程创建1024个键（达到上限），子进程继承后键表已经满了，所以子进程调用pthread_key_create直接返回EAGAIN，无法创建任何新键。
• 当父进程创建512个键，子进程继承后已使用512个，再创建512个刚好达到1024的上限，所以可以正常完成。

解决思路 #

如果你的业务场景需要在fork后的子进程中创建新的线程键，可以考虑以下方案：

1. 清理继承的键：在子进程启动后，调用pthread_key_delete删除不需要的父进程遗留键，释放键表空间。注意：删除键前要确保没有线程在使用该键关联的线程本地数据，避免内存泄漏。
2. 复用线程键：尽量减少新键的创建，复用已有的键来存储不同的线程本地数据（比如用结构体封装多个数据字段）。
3. 替代方案：如果编译器支持C11标准，可以使用_Thread_local关键字定义线程本地变量，这种方式不需要手动管理线程键，使用起来更简洁，且通常没有数量上限限制（仅受内存限制而非固定键数限制）。

你的测试代码（带注释） #

#include <stdio.h>
#include <pthread.h>
#include <string.h>
#include <unistd.h>

// 批量创建线程键，返回成功创建的数量
size_t create_keys(pthread_key_t *keys, size_t number_of_keys) {
    size_t counter = 0;
    for (size_t i = 0; i < number_of_keys; i++) {
        int e = pthread_key_create(keys + i, NULL);
        if (e) {
            printf("ERROR (%d): index: %ld, pthread_key_create (%d)\n", getpid(), i, e);
            break;
        }
        counter++;
    }
    return counter;
}

int main(int argc, char const *argv[]) {
    // 打印系统允许的最大线程键数
    printf("maximum number of thread keys: %ld\n", sysconf(_SC_THREAD_KEYS_MAX));
    printf("process id: %d\n", getpid());
    const size_t number_of_keys = 1024;
    pthread_key_t keys_1[number_of_keys];
    memset(keys_1, 0, number_of_keys * sizeof(pthread_key_t));
    // 父进程创建键并统计数量
    printf("INFO (%d): number of active keys: %ld\n", getpid(), create_keys(keys_1, number_of_keys));
    pid_t p = fork();
    if (p == 0) {
        printf("process id: %d\n", getpid());
        pthread_key_t keys_2[number_of_keys];
        memset(keys_2, 0, number_of_keys * sizeof(pthread_key_t));
        // 子进程尝试创建键并统计数量
        printf("INFO (%d): number of active keys: %ld\n", getpid(), create_keys(keys_2, number_of_keys));
    }
    return 0;
}

内容的提问来源于stack exchange，提问作者John Tracid