nginx可通过log_format手动构造合法json日志，需对字符串字段加双引号、数值字段不加引号，并转义特殊字符；推荐用map预处理$remote_addr等高危变量，配合access_log启用，每行一个json对象。

Nginx 本身不直接支持原生 JSON 日志格式，但可以通过 log_format 指令结合变量和转义规则，构造出合法、可解析的 JSON 字符串写入日志文件。关键在于正确处理字段值中的双引号、换行、制表符等特殊字符，避免破坏 JSON 结构。

定义 JSON 格式的 log_format

在 http 或 server 块中添加自定义日志格式，用双引号包裹字段名和字符串值，对变量内容做基础转义（Nginx 不提供自动 JSON 编码，需手动规避非法字符）：

log_format json_escape
  '{'
    '"time_local":"$time_local",'
    '"remote_addr":"$remote_addr",'
    '"request_method":"$request_method",'
    '"request_uri":"$request_uri",'
    '"status":"$status",'
    '"body_bytes_sent":"$body_bytes_sent",'
    '"http_referer":"$http_referer",'
    '"http_user_agent":"$http_user_agent",'
    '"request_time":$request_time,'
    '"upstream_response_time":"$upstream_response_time"'
  '}';

注意：
- 字符串字段（如 $remote_addr）必须用双引号包裹；
- 数值字段（如 $request_time）不加引号，保持原始输出（Nginx 输出为数字或短横线 -）；
- 若变量可能含双引号或换行（如 $http_user_agent），建议配合 map 指令预处理，或使用第三方模块（如 nginx-json-log）增强安全性；
- $upstream_response_time 可能为空或多个值（多 upstream 时用逗号分隔），实际使用时可加判断逻辑。

启用 JSON 日志并指定日志文件

在 server 或 location 块中使用 access_log 启用该格式：

Json Schema Toolkit

使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。

下载

access_log /var/log/nginx/access.json json_escape;

确保目标目录可写，且日志轮转工具（如 logrotate）配置兼容 JSON 行格式（每行一个 JSON 对象，即 JSON Lines）。不要合并多行——Nginx 每次请求只写一行。

处理特殊字符（可选但推荐）

为防止 $http_user_agent 等字段破坏 JSON，可用 map 清洗常见非法字符：

map $http_user_agent $ua_json {
  default          $http_user_agent;
  "~[[:cntrl:]"\]"  "-";
}

然后在 log_format 中改用 $ua_json 替代 $http_user_agent。类似方式可用于 $request_uri、$http_referer 等高风险字段。

验证与调试

• 重载 Nginx 配置：nginx -t && nginx -s reload
• 触发一次请求：curl -I http://localhost/
• 检查日志是否为单行有效 JSON：tail -n1 /var/log/nginx/access.json | jq .（需安装 jq）
• 若报错，重点检查双引号是否成对、末尾逗号是否多余、数值字段是否误加引号