Laravel数据库配置入门教程新手快速设置指南

刚接触Lara vel，配置数据库这一步看似简单，却常常成为新手遇到的第一个“拦路虎”。别担心，今天咱们就把这事儿彻底讲清楚，让你避开那些常见的坑，一次配置成功。

数据库配置文件在哪、改哪几行

首先，你得找准地方。Lara vel的数据库配置核心，其实藏在项目根目录的 .env 文件里，而不是很多人以为的 config/database.php。后者更像是一个“默认设置库”，真正起决定性作用的是 .env。这也是为什么新手常犯的一个错误：明明改了 config/database.php，运行命令却死活不生效——因为 .env 的优先级更高，而且它通常被 .gitignore 排除在版本控制之外，就是为了方便不同环境（本地、测试、生产）使用不同的配置。

那么，打开 .env 文件，你需要修改的关键行是哪几个呢？主要是这四行：

• DB_CONNECTION=mysql（根据你用的数据库来，可选 pgsql、sqlite 等）
• DB_HOST=127.0.0.1（这里有个小细节：建议用 127.0.0.1 而非 localhost，尤其在Docker等环境下，后者可能走Unix Socket导致连接失败）
• DB_PORT=3306（MySQL默认端口是3306，但如果你用的是MAMP或XAMPP这类集成环境，端口可能是8889，务必确认清楚）
• DB_DATABASE=your_db_name（记住，这个数据库需要你提前手动创建好，Lara vel的迁移命令不会自动建库）

如果你用的是MySQL且设置了用户名密码，那么 DB_USERNAME 和 DB_PASSWORD 这两行也绝对不能漏。缺少任何一个字段，运行 php artisan migrate 时，大概率会迎面撞上那个经典的 SQLSTATE[HY000] [1045] Access denied 错误。

运行迁移前必须验证连接

配置文件改完，先别急着执行迁移命令。经验表明，多花30秒验证一下连接，能省下后面半小时的排查时间。Lara vel提供了一个非常方便的方法：打开终端，运行 php artisan tinker 进入交互式命令行，然后执行 DB::connection()->getPdo();。如果一切正常，它会返回一个PDO对象；如果抛出异常，那就说明配置有误，或者数据库服务压根没启动。

这里有几个高频“翻车点”，值得你特别留意：

• Docker环境：DB_HOST 写 localhost 是行不通的，需要改为宿主机的IP地址，或者Docker Compose中定义的服务名称（比如 mysql）。
• MySQL 8.0+ 认证插件：MySQL 8默认使用了 caching_sha2_password 认证插件，而Lara vel 8以下的版本可能不兼容。解决办法是修改MySQL用户的认证方式：ALTER USER 'your_user'@'%' IDENTIFIED WITH mysql_native_password BY 'your_pass';
• SQLite路径问题：使用SQLite时，DB_DATABASE 需要填写数据库文件的绝对路径（例如 database/database.sqlite），使用相对路径有时会导致文件找不到。

config/database.php 里 driver 和 prefix 怎么配

说完了 .env，再来看看 config/database.php 这个文件。它并非无用，其中有两个配置项直接影响程序行为：'default' 连接和各个连接下的 'driver'、'prefix'。

'default' 键的值对应着 .env 里的 DB_CONNECTION，决定了默认使用哪个数据库连接。'prefix' 则是表名前缀，比如你设置为 'prefix' => 'lara vel_'，那么通过迁移创建的用户表，实际在数据库里的名字会是 lara vel_users。

关于这个配置文件，还有几个细节需要注意：

• 'driver' 的值必须与 .env 中的 DB_CONNECTION 完全一致（注意大小写），否则Lara vel会找不到对应的配置块。
• 如果你的项目后期需要用到读写分离或多数据库连接，就需要在 'connections' 数组里额外定义配置（比如 'mysql_read' 和 'mysql_write'），并在模型或查询中显式指定连接，不能只靠修改 .env。
• 修改了 config/database.php 后，记得运行 php artisan config:clear 来清除配置缓存，否则修改可能不会立即生效。

本地开发用 SQLite 最省事，但别上线还这么干

对于刚入门、只想快速验证功能的新手来说，SQLite是个极佳的选择。配置极其简单：在 .env 里设置 DB_CONNECTION=sqlite，DB_DATABASE=database/database.sqlite，然后在终端执行 touch database/database.sqlite 创建一个空文件即可。无需安装MySQL，马上就能运行迁移和填充数据。

但是，必须警惕的是，SQLite有其明显的局限性，不适合用于生产环境或复杂业务测试：

• 外键约束：默认不支持，需要在迁移文件中显式启用，而Lara vel的迁移默认并不添加外键约束。
• 表结构修改困难：不支持 ALTER COLUMN 语法，这意味着后期如果你想修改某个字段的类型或长度，只能通过删除表并重建的方式来实现，非常麻烦。
• 并发性能差：在写入时会对整个数据库文件加锁。如果你用 php artisan serve 开了多个浏览器标签页同时操作，很容易遇到 database is locked 的错误。

所以，SQLite适合用于本地快速启动和简单的逻辑验证。一旦需要测试涉及队列、复杂事务、行锁等真实业务场景，还是应该尽早切换回MySQL或PostgreSQL。别等到项目部署上线时，才发现SQL语法不兼容，那就为时已晚了。