Django调试模型SQL输出的两种方法：配置日志与shell_plus

通过settings.py配置日志查看SQL

要在Django项目中查看模型生成的SQL语句，第一种方法是通过修改配置文件来启用日志记录。具体操作是在settings.py中添加LOGGING配置块。

LOGGING = {
 'version': 1,
 'disable_existing_loggers': False,
 'handlers': {
  'console':{
   'level':'DEBUG',
   'class':'logging.StreamHandler',
  },
 },
 'loggers': {
  'django.db.backends': {
   'handlers': ['console'],
   'propagate': True,
   'level':'DEBUG',
  },
 }
}

配置生效后，当执行数据库查询时，生成的SQL语句会直接输出到控制台终端，方便开发者即时检查。

$ python manage.py shell
 
In [1]: from test.models import A
 
In [2]: A.objects.all()
(0.001) SELECT "app1_a"."id", "app1_a"."name" FROM "app1_a" LIMIT 21; args=()
[<A: A object>]

使用shell_plus命令打印SQL

第二种更便捷的方法是利用django-extensions扩展库提供的增强型Shell功能。该库提供了shell_plus命令，并支持通过--print-sql选项开启SQL打印功能。

在终端中运行以下命令即可启动带有SQL打印功能的交互式Shell：

>>> Author.objects.all()
SELECT "library_author"."id", "library_author"."name" FROM "library_author" LIMIT 21
Execution time: 0.001393s [Database: default]
<QuerySet [<Author: Author object>]>

Django内置记录器说明

除了上述方法，Django框架本身也内置了一套完善的日志记录机制，用于处理不同层级的系统消息。

需要注意的是，Django的消息记录器遵循其内部层次结构，开发者不应直接使用通用的根记录器名称，而应针对特定模块使用具体的记录器。

其中，django.request记录器专门处理与HTTP请求相关的日志。对于状态码为5xx的服务端错误，日志级别会被提升为ERROR；而4xx客户端错误则被记录为WARNING。

django.server记录器负责记录由RunServer命令启动的开发服务器所接收请求的处理过程。HTTP 5xx响应记录为ERROR，4xx记录为WARNING，其他正常请求则记录为INFO级别。

django.template记录器用于捕获与模板渲染过程相关的日志信息，有助于排查模板加载或渲染时的问题。

对于调试SQL而言，最关键的是django.db.backends记录器。它专门记录代码与数据库之间的交互消息。在DEBUG级别下，应用程序执行的每一条SQL语句都会被详细记录在此处，这是查看底层数据库操作的核心入口。

以上介绍了在Django中调试模型SQL输出的两种主要方式，包括配置日志和使用增强型Shell，希望能帮助开发者更高效地进行数据库查询优化与调试。