为何PHP执行PURGE BINARY LOGS时出现无缓冲查询冲突错误？

在PHP 7.4.3、Ubuntu 20.04环境下，执行以下简化脚本时，在$ok = $stmt->execute();处触发错误：Cannot execute queries while other unbuffered queries are active。但脚本此前未执行任何查询，且已显式设置PDO::MYSQL_ATTR_USE_BUFFERED_QUERY = true，需排查异常原因。

测试代码 #

#!/usr/bin/env php
<?php

$ini['OVERALL']['Days to keep'] = 16 ;

if ( ! mysqlIsRunning()) {
    die("It seems that mysql is not running on this system.  Cannot continue.
") ;
    }
    
if ( (! $ini) || (! is_array($ini)) || (! isset($ini['OVERALL'])) ) {
    die("INI file not correctly parsed - must at least include OVERALL section.
") ;
    }


$daysToKeep = (isset($ini['OVERALL']['Days to keep']) ? $ini['OVERALL']['Days to keep'] : 15 ) ;

$purgeDate = Date('Y-m-d', strtotime('Today - ' . $daysToKeep . ' days')) ;
$sql = <<<EOS
            PURGE BINARY LOGS
            BEFORE $purgeDate
            EOS ;

$server = (($host = getenv('MYSQL_HOST')) ? $host : 'LOCALHOST') ;
$user   = (($u    = getenv('MYSQL_USER')) ? $u : $getenv('LOGNAME')) ;
$pwd    = getenv('MYSQL_PASSWORD') ;
$dbname = (($db   = getenv('MYSQL_DBNAME')) ? $db : $user) ;
$timeout = (($to  = getenv('MYSQL_TIMEOUT')) ? $to : 30) ;
$dsn = "mysql:host=" . $server. ";dbname=" . $dbname ;

$options = [ PDO::ATTR_EMULATE_PREPARES   => false // no emulation mode for "real" prepared stmts
          ,  PDO::ATTR_ERRMODE            => PDO::ERRMODE_EXCEPTION // Errors cause exception
          ,  PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC // Default fetch mode
          ,  PDO::MYSQL_ATTR_FOUND_ROWS   => true
          ,  PDO::MYSQL_ATTR_USE_BUFFERED_QUERY => true
          ,  PDO::ATTR_TIMEOUT            =>$timeout // Timeout in n seconds (may/not be supported by MySQL ??)
              ] ;
try {
    $pdo = new PDO($dsn, $user, $pwd, $options) ;
    }
catch (Exception $e) {
    die("Errors occurred when trying to connect to mysql service '$user@$server:$dbname'
") ;
    }
$stmt = $pdo->prepare($sql) ;
$ok = $stmt->execute() ;
if ($ok)
    printf("Binary logs purged before %s
", $purgeDate) ;
else
    die(sprintf("Failed to purge binary logs before %s", $purgeDate)) ;
exit(0) ;


function mysqlIsRunning() : bool {
    if (is_executable('/etc/init.d/mysql')) {
        $output = [] ;
        exec('/etc/init.d/mysql status 2>&1', $output) ;
        foreach ($output as $line) {
            if (preg_match('%\s*Active: active [(]running[)]%', $line))
                return true ;
            }
        }
    return false ;
    }

测试步骤 #

> export MYSQL_HOST=localhost
> export MYSQL_USER=<username>
> export MYSQL_PASSWORD=<password>
> export MYSQL_DATABASE=<database>
> run the script

异常原因排查 #

1. 环境变量名不匹配 #

脚本中读取数据库名使用的是MYSQL_DBNAME，但测试步骤里设置的是MYSQL_DATABASE，导致连接时可能使用默认数据库（如用户名对应的数据库），若该数据库不存在或权限不足，会引发隐性连接异常，进而导致后续查询状态异常。

2. DDL语句与真实预处理的兼容性问题 #

PURGE BINARY LOGS属于DDL操作，当禁用预处理语句模拟（PDO::ATTR_EMULATE_PREPARES => false）时，真实预处理语句与DDL操作的兼容性可能出现问题，MySQL内部执行的元数据查询可能未被正确缓冲，触发错误。

3. 连接选项的生效异常 #

虽然设置了PDO::MYSQL_ATTR_USE_BUFFERED_QUERY = true，但MySQL驱动可能因服务器配置、驱动版本问题导致该选项未正确生效。另外，PDO::ATTR_TIMEOUT在MySQL驱动中实际是连接超时，而非查询超时，该参数可能干扰连接状态。

解决方案 #

• 修正环境变量名：将测试步骤中的export MYSQL_DATABASE=<database>改为export MYSQL_DBNAME=<database>，确保连接使用正确的数据库。
• 启用预处理模拟：将PDO::ATTR_EMULATE_PREPARES设为true，DDL语句无需真实预处理，模拟模式下PDO直接拼接SQL执行，避免兼容性问题。
• 移除无关选项：去掉PDO::MYSQL_ATTR_FOUND_ROWS，该选项仅对UPDATE/DELETE语句生效，对PURGE无意义，可能干扰连接状态。
• 直接执行SQL：替换预处理逻辑为直接执行，将$stmt = $pdo->prepare($sql); $ok = $stmt->execute();改为$ok = $pdo->exec($sql);，PURGE语句无需参数绑定，直接执行更稳妥。

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