laravel 8 首次部署需通过 pdo 直接执行 utf-8 无 bom 的 init.sql 初始化数据库结构，文件首行必须为 create database 语句，脚本 init-db.php 位于根目录，执行前需确保 mysql 用户具备 create 等权限。
部署 Laravel 8 应用时，数据库为空（无表、无结构），需在首次运行前自动执行 SQL 文件初始化表结构，避免 migrate 失败或手动导入；这不是靠 Artisan 命令能直接触发的流程，必须绕过迁移机制、直连 PDO 执行原始 SQL。
确认 SQL 文件路径与编码
把建库语句和建表语句合并为单个 UTF-8 编码的 【init.sql】 文件，放在项目根目录下的 database/init/ 文件夹中（路径可自定义，但不能放在 public 或 storage 下）。
文件首行必须是 CREATE DATABASE IF NOT EXISTS your_db_name CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; 否则后续 CREATE TABLE 会报错“Unknown database”。
确保 SQL 文件不含 BOM 头——Windows 记事本保存极易引入，用 VS Code 或 Sublime Text 以 UTF-8 without BOM 格式另存。
编写初始化脚本 init-db.php
在项目根目录新建 init-db.php，内容如下：
这一步操作起来很简单，直接把文件拖进去就行。
require_once __DIR__.'/vendor/autoload.php';
$dotenv = Dotenv\Dotenv::createImmutable(__DIR__);
$dotenv->safeLoad();
$host = $_ENV['DB_HOST'] ?? '127.0.0.1';
$port = (int)($_ENV['DB_PORT'] ?? 3306);
$dbname = $_ENV['DB_DATABASE'];
$user = $_ENV['DB_USERNAME'];
$pass = $_ENV['DB_PASSWORD'] ?? '';
// 先连空库（不指定 dbname）
$dsn = "mysql:host={$host};port={$port};charset=utf8mb4";
$pdo = new PDO($dsn, $user, $pass, [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC
]);
// 执行 init.sql
$sql = file_get_contents(__DIR__.'/database/init/init.sql');
$pdo->exec($sql);
echo "✅ 数据库结构已从 init.sql 加载完成\n";
执行初始化并验证
第一步：终端进入项目根目录，运行：
php init-db.php
第二步：若报错 SQLSTATE[HY000] [1045] Access denied，则说明 DB_USERNAME/DB_PASSWORD 错误或 MySQL 用户无 CREATE 权限；需登录 MySQL 执行 GRANT CREATE,ALTER,DROP,INSERT ON `your_db_name`.* TO 'your_user'@'%'; FLUSH PRIVILEGES;
第三步：成功后，立刻验证表是否存在：
php artisan tinker → DB::table('migrations')->count() → 返回大于 0 即表示结构已就位，可继续 php artisan migrate。
【注意】此脚本不检查 SQL 语法错误，一旦 exec 报错即中断，不会部分执行。务必先在本地 MySQL 客户端手动运行 init.sql 确认无误。
