Laravel使用MySQL函数的查询在SQLite测试环境下报错如何解决

方案1：SQLite自定义函数注册（零业务代码改动首选） #

利用PDO SQLite支持注册自定义函数的特性，直接在服务提供者中为测试环境的SQLite连接补全缺失的MySQL同名函数，原有业务查询代码完全不用修改。
在 app/Providers/AppServiceProvider.php 的 boot 方法中添加如下代码：

use Illuminate\Support\Facades\DB;

public function boot()
{
    // 仅当数据库驱动为SQLite时注册适配函数
    if (DB::getDriverName() === 'sqlite') {
        $pdo = DB::connection()->getPdo();
        
        // 适配MySQL NOW() 函数，返回当前 datetime 格式时间
        $pdo->sqliteCreateFunction('NOW', function () {
            return date('Y-m-d H:i:s');
        }, 0);
        
        // 适配MySQL TIMESTAMP(date, time) 函数，拼接日期时间为完整时间戳
        $pdo->sqliteCreateFunction('TIMESTAMP', function ($date, $time) {
            return trim($date . ' ' . $time);
        }, 2);
    }
}

你现有的 whereRaw 查询不需要做任何调整，MySQL环境下继续使用原生函数的性能优势，SQLite测试环境会自动调用注册的适配函数执行，不会再报函数不存在的错误。如果后续用到其他MySQL专属函数，按照同样的逻辑补充注册即可。

方案2：跨驱动查询作用域封装 #

如果不想全局注册函数，也可以用Eloquent的查询作用域封装跨数据库的条件逻辑，业务层统一调用封装后的方法即可：

1. 在对应模型中定义本地作用域：

use Illuminate\Support\Facades\DB;

public function scopeWherePublished($query)
{
    return match(DB::getDriverName()) {
        'mysql' => $query->whereRaw('TIMESTAMP(publish_date, publish_time) < NOW()'),
        'sqlite' => $query->whereRaw("datetime(publish_date || ' ' || publish_time) < datetime('now')"),
        default => $query
    };
}

2. 业务代码统一调用：

// 自动适配当前数据库驱动
$publishedPosts = Post::wherePublished()->get();

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