Nginx源码编译中断若由内核头文件缺失引起，通常在make阶段报SOCK_NONBLOCK、EPOLL_CLOEXEC等未声明错误，需安装与当前内核版本匹配的kernel-headers（RHEL/CentOS）或linux-headers-$(uname -r)（Ubuntu/Debian），并验证/usr/include/linux/version.h和/usr/include/asm/unistd_64.h是否存在。
Nginx 源码编译中断若由系统内核头文件缺失引起，通常不会直接报“kernel headers missing”，而是表现为 make 阶段出现底层系统调用相关错误，比如 error: ‘SOCK_NONBLOCK’ undeclared、‘AF_MAX’ undeclared、‘EPOLL_CLOEXEC’ not declared 等，或在 src/os/unix/ngx_linux_config.h 编译时失败。这类问题本质是 Nginx 的 Unix 系统适配层（尤其是 Linux 特有功能）依赖当前内核版本对应的 <linux/*.h> 和 <asm/*.h> 头文件，而这些文件由 kernel-headers（或 linux-headers）开发包提供——它不是运行时库，而是编译期必需的元数据。
确认是否缺失内核头文件
- 运行命令检查关键头文件是否存在：
ls /usr/include/linux/version.h &>/dev/null && echo "kernel headers present" || echo "kernel headers missing" ls /usr/include/asm/unistd_64.h &>/dev/null && echo "asm headers OK" || echo "asm headers missing"
若任一命令返回
missing，基本可判定缺失。
按发行版安装对应开发包
-
RHEL/CentOS/Rocky 8+ 或 AlmaLinux：
内核头文件由kernel-headers包提供，且必须与当前运行内核版本严格匹配：uname -r # 先查看内核版本，例如 4.18.0-513.el8.x86_64 sudo dnf install kernel-headers-$(uname -r) # 精确安装对应版本 # 若无精确匹配，可装最新兼容版（不推荐生产环境）： sudo dnf install kernel-headers
-
RHEL/CentOS 7 或旧版：
sudo yum install kernel-headers-$(uname -r) # 或尝试通用安装（若仓库中存在）： sudo yum install kernel-headers
-
Ubuntu/Debian 系列：
对应包名为linux-headers-$(uname -r)，需同时安装通用头文件（部分宏定义在此）：sudo apt-get install linux-headers-$(uname -r) linux-headers-generic # 注意：若 uname -r 返回如 6.8.0-45-generic，则安装 linux-headers-6.8.0-45-generic
验证头文件可用性与编译兼容性
- Nginx configure 脚本本身不检测内核头文件，但
make会触发 GCC 编译src/os/unix/ngx_linux_init.c等文件。若头文件缺失，错误出现在make阶段而非configure阶段。 - 查看
make报错位置：若错误集中在ngx_linux_config.h或ngx_epoll_module.c，大概率是内核头问题。 - 可临时加
-v参数让 GCC 显示包含路径，辅助定位：make CFLAGS="-v" 2>&1 | grep "search starts here"
确认
/usr/include是否在搜索路径中，且其中包含linux/和asm/子目录。
特殊情况处理
-
若使用自定义内核（如 RT 内核、LTS 补丁版），需手动安装对应源码树中的
headers_install输出内容：cd /path/to/linux-src make headers_install INSTALL_HDR_PATH=/usr
容器环境（如 build-stage Dockerfile）中常默认不带内核头，需显式
RUN apt-get install -y linux-headers-amd64（Debian）或RUN dnf install -y kernel-headers（AlmaLinux/Rocky）。不要混淆
glibc-devel（C 标准库头）和kernel-headers（系统调用接口头）。两者都需，但缺失后者才会引发上述 epoll/socket 相关编译失败。
不复杂但容易忽略
