laravel中sqlite性能优化需五步：一启用wal模式提升并发；二关闭外键检查降低开销；三禁用查询日志减少i/o；四延长busy timeout防止锁超时；五测试时改用:memory:内存数据库。
如果您在Laravel项目中使用SQLite作为数据库驱动，但发现查询响应迟缓、内存占用偏高或迁移执行卡顿，则可能是由于默认配置未针对SQLite轻量级特性进行优化。以下是针对性的优化操作步骤：
一、启用SQLite WAL模式提升并发读写性能
WAL（Write-Ahead Logging）模式可显著改善SQLite在多请求场景下的读写并发能力，避免传统DELETE模式下的整库锁表问题。启用后，读操作不被写操作阻塞，适合Web应用常见的一写多读模式。
1、在.env文件中确认数据库驱动为sqlite：
DB_CONNECTION=sqlite
2、打开config/database.php，定位到sqlite连接配置块，在options数组中追加PDO::ATTR_PERSISTENT与WAL启用指令：
3、添加以下两行代码（确保已存在'options' => []结构）：
'PDO::ATTR_PERSISTENT' => true,
'PDO::ATTR_EMULATE_PREPARES' => false
4、在应用启动时强制执行WAL模式切换：在App\Providers\AppServiceProvider@boot中插入：
DB::statement('PRAGMA journal_mode = WAL');
二、禁用SQLite外键检查以降低开销
SQLite默认不强制外键约束（即使声明了FOREIGN KEY），但若显式启用PRAGMA foreign_keys = ON，每次INSERT/UPDATE都会触发约束校验，带来额外CPU开销。Laravel迁移与Eloquent本身不依赖SQLite外键完整性保障，关闭可提升写入速度。
1、进入config/database.php的sqlite配置项；
2、在options数组中增加一行：
'PDO::ATTR_ERRMODE' => PDO::ERRMODE_EXCEPTION
3、在同位置补充执行语句：
DB::statement('PRAGMA foreign_keys = OFF');
三、配置查询日志与调试开关以减少I/O负担
开发环境下开启DB::enableQueryLog()或APP_DEBUG=true会持续记录每条SQL及其绑定参数，对SQLite这种文件型数据库造成频繁磁盘写入，显著拖慢响应。生产环境必须关闭，开发阶段也建议按需启用。
1、检查.env文件中APP_DEBUG值：
APP_DEBUG=false
2、全局搜索项目中所有DB::enableQueryLog()调用，将其注释或删除；
3、若需临时查看某次查询，改用单次DB::listen()回调捕获，而非全程开启日志；
4、确认config/database.php中sqlite连接的log_queries选项设为false（Laravel 10+默认已禁用，但需人工核验）。
四、调整SQLite Busy Timeout防止超时中断
SQLite在写锁竞争激烈时（如高并发测试或队列任务密集执行）可能抛出database is locked异常。默认timeout仅0.25秒，不足以应对短时争用。延长timeout可让请求等待锁释放而非立即失败，提升稳定性。
1、在config/database.php的sqlite配置中，找到options数组；
2、添加PDO属性设置：
'PDO::ATTR_TIMEOUT' => 5
3、该值单位为秒，5秒是兼顾响应性与成功率的常用值；
4、避免设为过长（如30秒），否则用户请求将无谓挂起。
五、使用内存数据库替代文件数据库用于单元测试
PHPUnit运行期间反复读写SQLite文件会产生大量磁盘I/O，且文件路径权限易出错。改用:memory:内存数据库可彻底消除文件操作，加速测试执行，并保证每次测试隔离性。
1、在phpunit.xml中为测试环境定义环境变量：
2、确保config/database.php中sqlite配置的database字段支持环境变量：
'database' => env('DB_DATABASE', database_path('database.sqlite'))
3、运行测试时使用vendor/bin/phpunit，无需创建物理文件；
4、内存数据库在进程退出后自动销毁，无需清理脚本。
