mod_unique_id可为每个请求生成高概率全局唯一的字符串，但需启用模块、配置Header或LogFormat才能注入响应头或日志，且不兼容W3C标准、不跨服务传播。
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 位范围内
将 UNIQUE_ID 注入响应头供前端或下游使用
仅启用模块不会自动输出 ID，必须显式设置响应头：
Apache Superset Dashboard and SQL Exploration Skill
下载
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 变量，不是拼写错误
理解它的局限性与常见空值原因
并非所有请求都会产生 UNIQUE_ID，这是设计使然，不是故障：
- SSL 握手失败、mod_security 拦截、400/403 等早期拒绝的请求，不进入 request processing phase，ID 不生成
- 静态资源被 mod_cache 或磁盘缓存直接返回时，可能跳过 ID 初始化阶段
- 子请求（subrequest）在部分 Apache 版本中 %{UNIQUE_ID}e 不可用，可配合 SetEnvIf 预设 fallback
- 它不兼容 W3C traceparent 标准，也不跨服务传播——只负责在当前 Apache 实例内提供可靠原料
