MySQL建表需严守字段定义顺序与约束组合规则：AUTO_INCREMENT必须为整型且配PRIMARY KEY/UNIQUE；DEFAULT禁用于TEXT/BLOB（旧版）；NOT NULL缺DEFAULT则插入时报错；PHP动态拼接须过滤字段名、严格映射类型、校验长度；引擎统一用InnoDB，字符集用utf8mb4；PDO需设ERRMODE_EXCEPTION防静默失败。
CREATE TABLE 语句中字段定义顺序不能乱
MySQL 对 CREATE TABLE 中字段定义的顺序本身没强制要求，但一旦混用 AUTO_INCREMENT、PRIMARY KEY、DEFAULT 和 NOT NULL，顺序错位会直接报错。最典型的是把 AUTO_INCREMENT 加在非整型字段上，或没配合 PRIMARY KEY 或 UNIQUE 使用。
-
AUTO_INCREMENT字段必须是整型（如INT、BIGINT），且必须有PRIMARY KEY或UNIQUE约束 -
DEFAULT值不能用于TEXT、BLOB类型（MySQL 5.7+ 允许TEXT用DEFAULT ''，但老版本会报错） -
NOT NULL和DEFAULT同时存在时，若字段没显式赋值，MySQL 用默认值填充；但如果漏写DEFAULT又设了NOT NULL，建表不报错，插入时才崩
CREATE TABLE users ( id INT AUTO_INCREMENT PRIMARY KEY, name VARCHAR(50) NOT NULL, email VARCHAR(100) DEFAULT '' );
PHP 拼接建表 SQL 时必须过滤字段名和类型
用 PHP 动态生成 CREATE TABLE 语句时，如果字段名来自用户输入（比如配置数组键名）、或类型映射逻辑有误（如把 string 直接映射成 STRING），会导致语法错误。MySQL 不认 STRING，只认 VARCHAR、TEXT 等。
- 字段名必须用反引号包裹：
`user_name`，避免关键字冲突（如`order`、`group`） - 类型映射要严格：PHP 的
'string'→ MySQL 的VARCHAR(255)，'int'→INT，不能直译 - 长度参数必须校验：比如
VARCHAR(-1)或VARCHAR(0)都非法
$fields = [
'id' => ['type' => 'INT', 'extra' => 'AUTO_INCREMENT PRIMARY KEY'],
'title' => ['type' => 'VARCHAR', 'length' => 200],
];
$sql = "CREATE TABLE posts (";
foreach ($fields as $name => $def) {
$type = $def['type'];
$length = $def['length'] ?? '';
$lengthPart = $length ? "($length)" : '';
$sql .= "`$name` $type$lengthPart";
if (!empty($def['extra'])) {
$sql .= ' ' . $def['extra'];
}
$sql .= ', ';
}
$sql = rtrim($sql, ', ') . ');';
引擎与字符集不匹配引发的隐性失败
MySQL 8.0 默认引擎是 InnoDB，默认字符集是 utf8mb4。但如果你在建表语句里写 ENGINE=MyISAM DEFAULT CHARSET=utf8，而服务器禁用了 MyISAM（如阿里云 RDS），或者 utf8 实际指 utf8mb3，某些 emoji 插入会失败——建表成功，后续出问题。
- 始终显式声明
ENGINE=InnoDB，避免依赖默认值 - 字符集统一用
CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci，尤其涉及用户昵称、评论等场景 - 检查 MySQL 版本兼容性：MySQL 5.5 不支持
utf8mb4的部分排序规则，需降级为utf8mb4_general_ci
CREATE TABLE logs ( id INT PRIMARY KEY, content TEXT ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
使用 PDO 执行建表前务必检查错误模式
PDO 默认的错误模式是 PDO::ERRMODE_SILENT，建表失败不会抛异常，$pdo->exec() 只返回 false。很多 PHP 脚本没检查返回值，导致建表静默失败，后面插入时报 “Table doesn’t exist”。
立即学习“PHP免费学习笔记（深入）”；
- 初始化 PDO 时设置
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION - 不要用
mysql_query()（已废弃），也不要跳过try/catch - 建表语句含多条时（如带
COMMENT或分区），确保 MySQL 版本支持（如分区表在 MySQL 5.1+）
$pdo = new PDO($dsn, $user, $pass, [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
]);
try {
$pdo->exec("CREATE TABLE test (id INT)");
} catch (PDOException $e) {
error_log('建表失败: ' . $e->getMessage());
}
实际建表最难缠的不是语法写错，而是字段约束组合、引擎特性、字符集层级之间互相咬合。一个 NOT NULL 搭配缺失的 DEFAULT，可能在本地跑通，上线后因 strict mode 报错；一个没加反引号的 order 字段，在测试库不报错，遇到生产库升级就挂掉。 
