MariaDB 5.6环境下Laravel 5.4查询构建器自动添加\n报错，求排查原因

作为常年处理Laravel老版本问题的开发者，结合你用的MariaDB 5.6 + Laravel 5.4环境，我梳理了几个最可能的触发点，你可以逐一排查：

• 自定义查询宏或扩展代码出问题：如果你最近给查询构建器加了自定义宏（比如用Builder::macro写的扩展方法），或者修改了数据库层的扩展类，很可能是在拼接SQL字符串的时候不小心带进来了换行符。仔细检查这些自定义代码里的字符串拼接逻辑，有没有多余的\n或者未处理的换行。
• 数据库配置文件混入换行符：去config/database.php里看看你MariaDB连接的配置项，比如options数组、charset或collation参数附近，有没有复制粘贴时不小心带进来的隐形换行。这种小细节很容易被忽略，却会导致SQL生成异常。
• 第三方依赖包的更新冲突：Laravel 5.4属于比较老的版本了，如果近期你更新过illuminate/database相关组件，或者任何操作数据库的第三方包，新版本的包可能和老框架的SQL生成逻辑不兼容，从而引入换行符。可以尝试回退最近更新的包，或者查看包的更新日志有没有相关改动记录。
• 数据库驱动版本变化：检查下PHP的MariaDB驱动（比如mysqlnd或mysqli）版本有没有变动。有时候驱动更新后，和老版本Laravel的数据库层交互时会出现额外字符（包括换行）的问题。你可以通过phpinfo查看当前驱动版本，对比之前正常运行时的版本。
• 业务代码中手动引入的换行：比如在写select、where这类查询方法时，有没有在字符串参数里不小心加了换行？举个例子：

  $query->select('id', 'name', 
      'email'); // 这里的换行如果没处理好，可能被直接带入最终SQL
  

  这种情况一般是手动编写时的疏忽，你可以排查下近期修改过的查询相关代码。
• 缓存未及时清理：Laravel的配置缓存或路由缓存如果没更新，可能导致旧的错误配置还在生效。试试运行php artisan config:clear和php artisan cache:clear，清除缓存后再测试查询是否正常。

另外，推荐你开启Laravel的SQL日志，把生成的SQL直接打印出来，这样能精准定位是哪部分逻辑加了\n：

// 在执行查询前添加这段代码
DB::listen(function ($query) {
    dump($query->sql); // 输出最终生成的SQL语句
    dump($query->bindings); // 查看绑定的参数
});

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