MySQL初始化失败常因未连上数据库，需先检查mysqld进程运行状态、显式连接测试、创建专用用户与数据库（指定mysql_native_password）、配置utf8mb4字符集、调整max_allowed_packet等关键参数，并用SQL文件初始化schema。
确认 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 loaded - host 写
'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 < schema.sql导入，注意不要漏掉数据库名参数，否则语句在错误库执行
字符集、权限、网络监听、SQL 模式这四点没对齐，后面所有迁移和连接问题基本都绕不开。
