Nginx可通过$cookie_*变量在不解析请求体的前提下，直接从Cookie请求头提取指定字段写入日志；需在log_format中引用如$cookie_user_status，并注意命名规范、敏感信息脱敏及特殊字符转义。
可以通过 Nginx 的 log_format 直接引用 $cookie_* 变量，在不读取或解析请求体（request body）的前提下，将客户端携带的特定 Cookie 值写入访问日志，从而间接反映业务状态（例如登录态、灰度标识、AB 实验分组等）。
确认 Cookie 字段名并启用 log_format 引用
Nginx 原生支持 $cookie_NAME 变量，自动提取请求头中 Cookie: NAME=value 的值（区分大小写，下划线合法）。无需额外模块或 Lua 脚本。
- 确保前端设置 Cookie 时使用语义化名称，如
user_status=active、ab_group=B、auth_token=xxx - 在
http或server块中定义日志格式，例如：
log_format custom '$remote_addr - $remote_user [$time_local] '
'"$request" $status $body_bytes_sent '
'"$http_referer" "$http_user_agent" '
'cookie_user_status="$cookie_user_status" '
'cookie_ab_group="$cookie_ab_group" '
'cookie_auth_token="$cookie_auth_token"';注意：未存在的 Cookie 会输出空字符串，不会报错。
避免 body 解析的关键原理
$cookie_* 是 Nginx 在解析 HTTP 请求头阶段就完成提取的变量，完全独立于 request body。只要请求头中包含 Cookie 字段（标准 HTTP 行为），Nginx 就能在不触发 client_body_buffer_size、client_max_body_size 或任何 body 读取逻辑的情况下获取该值。
- 即使请求是 POST/PUT 且 body 很大（如上传文件），只要不显式使用
$request_body或开启proxy_pass_request_body等依赖 body 的指令，就不会触发 body 解析 - 切勿在
log_format中混用$request_body—— 它强制读取并缓存 body，显著增加延迟和内存开销
结合 map 模块做轻量状态映射（可选增强）
若原始 Cookie 值（如 token）不可读，但需记录其代表的业务含义（如 "logged_in", "trial", "vip"），可用 map 构建映射关系，再注入日志：
map $cookie_auth_token $user_tier {
"" "anonymous";
~^t_[a-z0-9]{8} "trial";
~^v_[a-z0-9]{8} "vip";
default "unknown";
}
<p>log_format enhanced '... cookie_tier="$user_tier"';</p>该方式仍只依赖 header 解析，不触碰 body，且支持正则匹配与默认兜底。
验证与注意事项
- 用
curl -H "Cookie: user_status=paying" http://your.site/测试日志是否正确输出 - Cookie 名含特殊字符（如点、中划线）需转义为下划线：如
my-app-id→$cookie_my_app_id - 敏感字段（如完整 token）不宜直接记入日志，建议仅记录脱敏后标识或映射结果
- 确保日志收集端能正确解析带引号和等号的 KV 对，必要时用
json格式（需 Nginx 1.11.8+ 与log_format ... escape=json）
