必须同时修改.env和config/database.php：确认DB_CONNECTION=mysql，config/database.php中'mysql'块的'driver'=>'mysql'、'charset'=>'utf8mb4'、'collation'=>'utf8mb4_unicode_ci'，并执行php artisan config:clear && cache:clear && migrate:fresh --seed。
直接改 .env 不够，config/database.php 里驱动名必须匹配
只改 DB_CONNECTION=mysql 而不检查 config/database.php 中的 'mysql' 连接块，大概率报错 Driver [mysql] not supported。常见原因是 Laravel 安装时没启用 pdo_mysql 扩展，或 config/database.php 里 'mysql' 键下 'driver' 写成了 'mysqli' 或漏配 'charset'/'collation'。
务必确认以下三点：
-
php -m | grep pdo_mysql输出非空（Ubuntu/Debian 下缺扩展可运行sudo apt install php-mysql） -
config/database.php中'mysql'连接块的'driver' => 'mysql'（不是mysqli、pdo_mysql等） -
'charset'设为'utf8mb4'，'collation'设为'utf8mb4_unicode_ci'（SQLite 默认无字符集概念，MySQL 必须显式声明）
php artisan migrate 报错 “SQLSTATE[42000]: Syntax error” 多因 SQLite 特有语法残留
Laravel 的迁移文件若在 SQLite 环境下编写并提交过，很可能含 $table->timestamps() 生成的 created_at/updated_at 字段未设默认值，或用了 $table->softDeletes() 但没配 nullable() —— SQLite 允许 NULL 默认插入，MySQL 严格模式下会拒绝。
典型修复点：
- 所有
timestamps()字段加useCurrent()和useCurrentOnUpdate()：$table->timestamps()->useCurrent()->useCurrentOnUpdate(); -
softDeletes()必须跟nullable()：$table->softDeletes()->nullable(); - 避免用
increments('id')（已弃用），改用id()或显式bigIncrements('id')（MySQL 默认INT可能溢出）
数据类型不兼容：SQLite 的 TEXT 和 INTEGER 在 MySQL 需显式约束
SQLite 是动态类型，字段声明为 TEXT 却存数字也行；MySQL 是严格类型，迁移时若沿用 $table->text('content')，上线后插入超长文本可能被截断（默认 TEXT 最大 65535 字节），而 SQLite 没这限制。
面向 CRM 系统的 MySQL 8 数据库模式设计。当用户需要为客户关系管理（CRM）系统设计、评审、优化或生成数据库模式时，应使用此项技能。
适配建议按实际业务选型：
- 短文本（≤ 255 字符）：用
$table->string('title', 255)→ 对应 MySQLVARCHAR(255) - 中长文本（≤ 16MB）：用
$table->longText('body')→ 对应 MySQLLONGTEXT - 布尔字段：SQLite 常用
INTEGER存 0/1，MySQL 应统一用$table->boolean('active')（生成TINYINT(1)，Laravel 自动转义） - 时间字段：避免
$table->dateTime('published_at')，改用$table->timestamp('published_at')->useCurrent()（MySQLTIMESTAMP支持自动初始化，DATETIME不支持）
迁移前清缓存 + 强制重读配置，否则旧连接仍走 SQLite
改完 .env 和 config/database.php 后，不清理缓存就跑 php artisan migrate，极大概率还是连上本地 .env 里旧的 DB_CONNECTION=sqlite 路径，报错 SQLSTATE[HY000]: General error: 14 unable to open database file（因为 MySQL 驱动试图用 SQLite 路径去连）。
必须执行这三步（顺序不能乱）：
-
php artisan config:clear（清除配置缓存，让新.env生效） -
php artisan cache:clear（清应用缓存，避免 Schema 缓存干扰） -
php artisan migrate:fresh --seed（用:fresh强制删表重建，比:migrate更可靠，尤其当已有 SQLite 表结构残留时）
真正容易被忽略的是：Laravel 的 config:clear 不会自动 reload database.php 中硬编码的连接参数，如果该文件里写了死值（比如 'host' => 'localhost' 但你实际 MySQL 在 Docker 容器里），那改 .env 也白搭 —— 得手动删掉这些覆盖项，只留 env() 调用。
