如何在Mapnik渲染时开启含bbox参数的SQL查询日志？

使用npm的Mapnik包结合PostGIS时，若要在调用render()函数时让控制台输出替换了!bbox!参数的完整SQL查询语句，可按以下步骤配置：

1. 配置Mapnik全局日志 #

在初始化Mapnik后，设置日志级别为DEBUG并将日志输出定向到控制台：

import * as mapnik from "mapnik";

mapnik.register_default_input_plugins();
// 设置日志级别为DEBUG，开启详细日志
(mapnik as any).Logger.setSeverity((mapnik as any).Logger.DEBUG);
// 将日志输出到控制台
(mapnik as any).Logger.setDestination((mapnik as any).Logger.STDOUT);

注：TypeScript环境下需用类型断言绕过类型检查，JavaScript环境可直接使用mapnik.Logger

2. 开启PostGIS数据源调试日志 #

在创建PostGIS数据源配置时，必须添加debug: true选项，这是输出实际执行SQL的关键：

private createPostgisConfig(sql: string) {
  return {
    type: "postgis",
    host: "你的数据库地址",
    dbname: "目标数据库名",
    user: "数据库用户名",
    password: "数据库密码",
    sql: sql,
    debug: true, // 启用数据源级调试，输出替换bbox后的完整SQL
    srid: 3857 // 匹配你的投影坐标系
  };
}

3. 验证效果 #

完成上述配置后，调用map.render()时，控制台会打印出类似以下的完整SQL语句（已替换!bbox!为实际范围值）：

SELECT id, geometry FROM nordic_sector WHERE deleted_at IS NULL AND ST_Intersects(ST_Transform(geometry, 3857), ST_MakeEnvelope(123456.789, 987654.321, 123466.789, 987644.321, 3857))

之前配置无效的原因 #

你尝试的日志配置仅设置了全局日志级别，未同时开启PostGIS数据源的debug选项，也未明确指定日志输出目标为控制台，导致SQL查询日志无法正常打印。

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