如何利用mod_unique_id为Apache处理的每个请求生成全局唯一链路ID-Apache-PHP中文网

mod_unique_id可为每个请求生成高概率全局唯一的字符串，但需启用模块、配置Header或LogFormat才能注入响应头或日志，且不兼容W3C标准、不跨服务传播。

如何利用mod_unique_id为apache处理的每个请求生成全局唯一链路id

mod_unique_id 可以为每个请求生成一个高概率全局唯一的字符串，但“全局唯一”有前提条件，它本身不自动成为链路 ID，需配合配置才能注入到日志、响应头或下游服务中。

Apache 默认不加载 mod_unique_id。必须先确认并启用：

运行 httpd -M | grep unique（Linux/macOS）或 apache2ctl -M | grep unique（Debian/Ubuntu），检查是否输出 unique_id_module (shared)
若未启用：Debian/Ubuntu 执行 a2enmod unique_id && systemctl reload apache2；RHEL/CentOS 编辑 httpd.conf，取消 LoadModule unique_id_module modules/mod_unique_id.so 前的注释，再 systemctl reload httpd
集群部署时，所有机器需满足：NTP 时间同步、主机名可解析为不同 IP、PID 在 32 位范围内

仅启用模块不会自动输出 ID，必须显式设置响应头：

Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。

下载

在 VirtualHost 或 Directory 块中添加：
Header always set X-Request-ID "%{UNIQUE_ID}e"
若 Apache 作为反向代理（如 ProxyPass），还需透传给后端：
RequestHeader set X-Request-ID "%{UNIQUE_ID}e" env=UNIQUE_ID
注意 env=UNIQUE_ID 是关键——避免未生成 ID 时传递空值
确保 mod_headers 已启用，且加载顺序在 mod_unique_id 之后

把 ID 写入 access log 是排查请求链路最直接的方式：

定义 LogFormat：
LogFormat "%{UNIQUE_ID}e %h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" unique_log
在 VirtualHost 中启用：
CustomLog /var/log/apache2/access.log unique_log
注意：%{UNIQUE_ID}e 中的 e 表示 environment 变量，不是拼写错误