确认 MySQL 服务是否已安装并可访问
很多“初始化失败”其实卡在第一步：根本没连上数据库。先验证
mysqld进程是否运行，再确认能否用命令行客户端连接。 Linux/macOS 下执行
ps aux | grep mysqld，看到带
--datadir和
--port的进程才算真正启动 别只信
systemctl status mysql—— 有时显示 active，但实际监听的是
127.0.0.1:3306而非
0.0.0.0:3306，远程项目会连不上 用
mysql -u root -p -h 127.0.0.1 -P 3306显式指定 host 和 port 测试，避免 Unix socket 路径干扰
创建项目专用数据库与用户（非 root）
直接用
root账号跑应用是高危操作，MySQL 8+ 默认禁用
mysql_native_password插件，新用户容易认证失败。
CREATE DATABASE `myapp_dev` CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; CREATE USER 'myapp_user'@'localhost' IDENTIFIED WITH mysql_native_password BY 'strong_password_123'; GRANT ALL ON `myapp_dev`.* TO 'myapp_user'@'localhost'; FLUSH PRIVILEGES;必须显式指定
IDENTIFIED WITH mysql_native_password，否则 MySQL 8 默认用
caching_sha2_password，老版本驱动（如 Python 3.7 的 PyMySQL）可能报错
Authentication plugin 'caching_sha2_password' cannot be loadedhost 写
'localhost'和
'127.0.0.1'效果不同：前者走 Unix socket，后者走 TCP；若应用容器化部署，通常需授权
'myapp_user'@'%'并配
bind-address = 0.0.0.0
utf8mb4是硬性要求，
utf8在 MySQL 里实际是
utf8mb3，不支持 emoji 和部分生僻字
检查并调整关键配置项（my.cnf）
默认配置常导致项目启动慢、插入失败或中文乱码，重点盯这三个参数：
max_allowed_packet：低于 64M 时，大 JSON 字段或 Base64 图片插入会报
Packets larger than max_allowed_packet are not allowed
wait_timeout和
interactive_timeout：设太小（如默认 28800 秒=8 小时）会导致长连接空闲后被服务端断开，应用层若没做重连，下次查询就抛
MySQL server has gone away
sql_mode：严格模式（含
STRICT_TRANS_TABLES）下，
INSERT INTO t (a) VALUES ('') 对非空字段会直接失败，开发阶段建议临时设为 NO_ENGINE_SUBSTITUTION
修改后必须重启
mysqld，仅 reload 不生效。
用 SQL 文件初始化表结构和基础数据
别依赖 ORM 自动建表——字段类型、索引、外键约束、默认值等细节常丢失，且无法回滚到某次 schema 版本。
把schema.sql和
seed.sql分开：前者只含
CREATE TABLE和
ALTER TABLE，后者放
INSERT初始配置数据（如 admin 用户、系统字典） 执行前加
SET NAMES utf8mb4;，否则 SQL 文件里的中文注释或字符串可能乱码 用
mysql -u myapp_user -p myapp_dev 导入，注意不要漏掉数据库名参数，否则语句在错误库执行
字符集、权限、网络监听、SQL 模式这四点没对齐，后面所有迁移和连接问题基本都绕不开。
