FastAPI+Uvicorn+Loguru：HTTP请求日志打印失败？终极解决方案！

本文探讨了FastAPI项目中使用Loguru库记录日志时遇到的问题：通过`uvicorn main:app`命令启动项目，HTTP请求日志能够正常打印；但使用Python代码启动Uvicorn服务器时，HTTP请求日志却缺失。 即使设置`access_log=True`也无法解决。 问题根源在于代码启动方式绕过了Uvicorn的默认日志处理机制，导致自定义的日志拦截器`InterceptHandler`失效。文章分析了命令行启动和代码启动Uvicorn的差异，并指出解决方法需要深入研究Uvicorn的代码启动流程，并可能需要调整`InterceptHandler`或Uvicorn配置。

FastAPI项目中Loguru日志记录与Uvicorn启动方式的差异分析

本文分析了在FastAPI项目中，使用Loguru进行日志记录时，Uvicorn的不同启动方式（命令行 vs. 代码）如何影响HTTP请求日志输出的问题。

问题表现为：使用uvicorn main:app命令启动时，HTTP请求日志正常打印；而使用代码启动Uvicorn服务器时，HTTP请求日志缺失。

代码启动Uvicorn的示例：

if __name__ == "__main__":
    config = uvicorn.config("main:app", host=serveice_host_ip, port=int(service_host_port), workers=1)
    server = uvicorn.server(config)
    server.run()

即使添加access_log=True参数：

if __name__ == "__main__":
    config = uvicorn.config("main:app", host=serveice_host_ip, port=int(service_host_port), access_log=True, workers=1)
    server = uvicorn.server(config)
    server.run()

问题仍然存在。这并非access_log参数设置错误，而是代码启动方式绕过了Uvicorn的默认日志处理机制。

logger.py文件中的InterceptHandler类负责将Uvicorn的日志重定向到Loguru：

class InterceptHandler(logging.Handler):
    def emit(self, record: logging.LogRecord) -> None:  # pragma: no cover
        # ... (代码略) ...

它拦截了uvicorn.asgi、uvicorn.access和uvicorn这三个logger的日志。命令行启动时，Uvicorn自行处理日志，InterceptHandler能够成功捕获并重定向。

然而，代码启动时，Uvicorn的日志处理流程发生变化，InterceptHandler无法有效捕获Uvicorn内部的HTTP请求日志。这可能是因为两种启动方式在日志处理机制上存在差异。 setting.py中Loguru的handler配置本身没有问题，问题在于Uvicorn在代码启动模式下的日志处理流程改变，导致InterceptHandler失效。

解决此问题需要深入研究Uvicorn的代码启动流程，并可能需要调整InterceptHandler或Uvicorn的配置，以确保日志正确捕获和输出。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。