Laravel连接SQLite数据库报错数据库不存在解决方法

在Laravel项目中配置SQLite数据库时，许多开发者常遇到一个棘手的问题：明明已按文档正确设置了.env文件和config/database.php，但执行php artisan migrate --database=sqlite命令时却报错Database [xxx] not exist。如果你也被此困扰，别担心，问题多半出在环境变量的写法细节上。

来看一个典型的错误配置样例：

.env 文件里写了类似这样的内容：

DB_CONNECTION=sqlite
VIRSH_SQLITE_DATABASE=database_path('database.sqlite')

而在 config/database.php 对应的 sqlite 连接中：

'sqlite' => [
    'driver' => 'sqlite',
    'database' => env('VIRSH_SQLITE_DATABASE', database_path('database.sqlite')),
    'prefix' => '',
],

表面上看配置无误，但执行迁移命令时却提示数据库不存在。原因其实很简单：.env文件中不能直接使用PHP函数（比如database_path()）。环境变量本质上是纯文本字符串，Laravel 加载.env时并不会解析里面的函数调用，所以VIRSH_SQLITE_DATABASE的值实际上被设置成了字面量字符串database_path('database.sqlite')，而不是预期的绝对路径。这导致 Laravel 找不到真正的数据库文件。

解决方案与正确配置

根据经验（如 YouTube 上的相关教程），正确的做法是：在.env中只填写数据库文件名，然后让框架在配置文件里通过database_path()函数来解析完整路径。具体改动如下：

.env 文件改为：

DB_CONNECTION=sqlite
VIRSH_SQLITE_DATABASE=database.sqlite

对应的 config/database.php 文件改为：

'sqlite' => [
    'driver' => 'sqlite',
    'database' => database_path(env('VIRSH_SQLITE_DATABASE', 'database.sqlite')),
    'prefix' => '',
],

核心变化在于：.env中只保存文件名（如database.sqlite），然后在配置文件中用database_path()包裹env()的返回值。这样 Laravel 就能正确拼接出完整的数据库路径，迁移命令自然也就顺利执行了。

一个小细节：环境变量值若包含路径分隔符或特殊字符，也可能引发问题。保持简洁，仅传递文件名，将路径处理逻辑交给框架，是更为稳妥的做法。希望这个案例能帮你节省排查错误的时间。