如何在MariaDB中记录含占位符的完整查询及批量插入日志

一、核心配置调整 #

要让通用日志显示PreparedStatement的实际参数，以及批量插入的完整语句，得修改MariaDB的这些配置：

1. 开启参数化语句的日志记录 #

在MariaDB的配置文件中（Docker环境下，可将自定义配置挂载到容器/etc/mysql/conf.d/目录，比如新建custom.cnf文件），添加以下内容：

general_log = ON
general_log_file = /var/log/mysql/general.log
# 开启预处理语句日志，记录实际执行的参数细节
log_prepared_statements = ON
# 设置日志记录所有语句，包括预处理Execute阶段的参数
log_statement = 'all'
# 若使用慢查询日志，将verbosity设为全量，包含参数和执行计划
log_slow_verbosity = full,query_plan

2. 重启MariaDB容器 #

修改配置后必须重启容器才能生效：

docker restart <你的MariaDB容器名/ID>

二、关于批量插入日志的说明 #

你期望的insert ... values (?,?), (?,?), ...格式日志，取决于Java持久化框架（如MyBatis、JPA）和JDBC驱动的实现：

• 如果框架将多个值组打包为单个语句批量提交，开启上述配置后，通用日志会显示完整的多值组语句。
• 如果框架是多次执行单条PreparedStatement，日志会显示多条Execute记录，每条对应一组实际参数。

三、验证配置是否生效 #

配置完成后执行一次批量插入操作，查看/var/log/mysql/general.log，应该能看到类似如下的日志（带真实参数）：

254 Prepare  insert into announce_images (announce_id, image) values (?, ?)
254 Execute  insert into announce_images (announce_id, image) values (1, 'img1.jpg'), (2, 'img2.jpg'), (3, 'img3.jpg')

若框架为多次执行模式，则会看到多条带具体参数的Execute记录。

四、Docker环境的注意事项 #

• 确保容器内/var/log/mysql/目录有写入权限，建议将该目录挂载到宿主机，避免容器重启后日志丢失：

  docker run -d \
    -v /宿主机本地路径/mysql/logs:/var/log/mysql \
    -v /宿主机本地路径/mysql/conf:/etc/mysql/conf.d \
    --name mariadb-10.10 \
    mariadb:10.10.6
  

• 若不想修改配置文件，启动容器时可通过环境变量传递配置：

  docker run -d \
    -e MYSQL_GENERAL_LOG=1 \
    -e MYSQL_LOG_PREPARED_STATEMENTS=1 \
    -e MYSQL_LOG_STATEMENT=all \
    --name mariadb-10.10 \
    mariadb:10.10.6
  

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