Python日志配置JSON格式失败：无法配置formatter 'json'问题求助

我之前也碰到过几乎一模一样的问题，你的核心问题大概率集中在依赖缺失、配置参数不匹配第三方库要求，还有代码里漏掉了关键的配置应用步骤，咱们一步步来排查解决：

1. 先安装正确的JSON日志第三方库 #

Python标准库的logging模块根本没有logging_json.JsonFormatter这个类——你应该是混淆了第三方库的名称。目前最常用的JSON日志格式化工具是python-json-logger，先通过pip安装它：

pip install python-json-logger

2. 修正日志配置中的Formatter设置 #

python-json-logger的类路径和字段配置逻辑和你写的不一样，需要调整配置内容：

基础JSON格式配置 #

"formatters": { 
    "simple": { 
        "format": "%(asctime)s - %(name)s - %(levelname)s- %(message)s" 
    }, 
    "json": { 
        "class": "pythonjsonlogger.jsonlogger.JsonFormatter",
        "format": "%(asctime)s %(levelname)s %(threadName)s %(processName)s %(message)s",
        "json_indent": 4  # 可选参数，让输出的JSON日志更易读
    }
}

自定义字段名称（比如把levelname改成level_name） #

如果需要像你原来配置里那样重命名字段，可以用rename_fields参数：

"json": { 
    "class": "pythonjsonlogger.jsonlogger.JsonFormatter",
    "format": "%(asctime)s %(levelname)s %(threadName)s %(processName)s %(message)s",
    "rename_fields": {
        "levelname": "level_name",
        "threadName": "thread_name",
        "processName": "process_name"
    },
    "json_indent": 4
}

3. 补全代码中缺失的日志配置加载步骤 #

你的代码只加载了配置文件，但没有把配置应用到logging系统里，必须加上logging.config.dictConfig(config)这一步，同时注意log变量的定义：

import json
import logging
import logging.config

# 先定义当前模块的logger
log = logging.getLogger(__name__)

# 继承gunicorn的日志处理器和级别
gunicorn_logger = logging.getLogger("gunicorn.error")
log.handlers = gunicorn_logger.handlers
log.setLevel(gunicorn_logger.level)

try:
    with open("./config/config.json") as config_file:
        config = json.load(config_file)
    # 关键步骤：将加载的配置应用到全局日志系统
    logging.config.dictConfig(config)
except Exception as e:
    # 捕获配置错误，方便调试，同时降级到基础日志配置
    print(f"加载日志配置失败: {str(e)}")
    logging.basicConfig(level=gunicorn_logger.level)

4. 额外调试建议 #

如果还是报错，可以试试这些排查手段：

• 打印加载后的config字典，确认配置内容是否被正确读取
• 临时注释掉gunicorn日志继承的代码，单独测试JSON日志配置是否生效，再逐步合并
• 检查python-json-logger的版本，部分旧版本不支持rename_fields这类新参数

内容的提问来源于stack exchange，提问作者tractor boy