Flask API日志配置问题：dict config配置后日志文件无写入

看起来你遇到的核心问题是日志配置没有和Flask的app.logger正确关联，加上几个常见的配置疏漏，导致日志文件没有任何输出。我来一步步帮你排查和修复：

1. 先修正你的日志配置 #

你的dict config有几个关键问题需要调整：

关键调整点： #

• 必须设置disable_existing_loggers: False：默认这个值是True，会直接禁用已经存在的logger（包括Flask自动创建的app.logger），这是最常见的坑！
• 确保logger名称和Flask的app.logger名称匹配：Flask的app.logger默认使用你的应用名称（也就是Flask(__name__)里的__name__，如果是主脚本运行就是__main__，如果是导入模块就是模块名），或者你可以直接配置根logger（用空字符串""），让所有子logger自动继承配置。
• 补全formatter的格式字符串：你的配置里format截断了，必须是完整的格式表达式。
• 建议加上编码参数，避免乱码。

修正后的配置示例：

LOGGING_CONFIG = {
    "version": 1,
    "disable_existing_loggers": False,  # 重中之重！
    "handlers": {
        "fileHandler": {
            "class": "logging.FileHandler",
            "formatter": "myFormatter",
            "filename": "/opt/foo/foo.log",
            "encoding": "utf-8"  # 避免中文乱码
        }
    },
    "loggers": {
        # 方式1：配置根logger，所有日志都会写入文件
        "": {
            "handlers": ["fileHandler"],
            "level": "INFO"
        },
        # 方式2：指定你的Flask应用的logger名称（比如app = Flask("foo")就用"foo"）
        # "foo": {
        #     "handlers": ["fileHandler"],
        #     "level": "INFO",
        #     "propagate": False
        # }
    },
    "formatters": {
        "myFormatter": {
            "format": "%(asctime)s - %(name)s - %(levelname)s - %(message)s"
        }
    }
}

2. 正确加载配置并测试 #

在你的Flask应用中，要确保在创建app实例后加载日志配置，然后就可以正常使用app.logger了：

from flask import Flask
import logging.config

# 创建Flask应用
app = Flask(__name__)

# 加载日志配置
logging.config.dictConfig(LOGGING_CONFIG)

# 测试日志输出
@app.route("/")
def index():
    app.logger.info("用户访问了首页")  # 这条日志会写入/opt/foo/foo.log
    app.logger.warning("这是一条警告日志")
    return "Hello World!"

if __name__ == "__main__":
    app.run()

3. 排查其他可能的问题 #

如果还是没有日志输出，检查以下几点：

• 文件权限：确保/opt/foo/目录存在，并且运行Flask应用的用户有该目录的写入权限。可以手动创建目录：

  mkdir -p /opt/foo
  chown $(whoami) /opt/foo  # 给当前用户权限
  

• 日志级别：你的配置里设置的是INFO级别，所以app.logger.debug()的内容不会被记录，要确保你调用的是info()及以上级别的日志方法。
• 配置加载时机：必须在创建app实例之后加载日志配置吗？其实顺序不影响，但要确保在使用app.logger之前加载。

备选方案：直接配置app.logger #

如果你觉得dict config太麻烦，也可以直接给app.logger添加文件handler，更直观：

from flask import Flask
import logging

app = Flask(__name__)

# 创建文件handler
file_handler = logging.FileHandler("/opt/foo/foo.log", encoding="utf-8")
# 设置格式
formatter = logging.Formatter("%(asctime)s - %(name)s - %(levelname)s - %(message)s")
file_handler.setFormatter(formatter)
# 添加到app.logger
app.logger.addHandler(file_handler)
# 设置日志级别
app.logger.setLevel(logging.INFO)

# 测试
@app.route("/")
def index():
    app.logger.info("直接配置的日志生效了！")
    return "Success"

内容的提问来源于stack exchange，提问作者Thales Rocha