ThinkPHP原生建表出错90%因SQL拼接不规范：字段定义顺序错误（如AUTO_INCREMENT位置不当）、未加反引号（保留字或特殊命名）、ENGINE/CHARSET缺失或不匹配、PHP变量拼接引号混乱。
ThinkPHP 原生建表语句出错，90% 是 SQL 字符串拼接不规范导致的，不是框架问题，也不是 MySQL 版本兼容性问题。
CREATE TABLE 里字段定义顺序写反了
MySQL 对字段定义顺序本身宽松，但一旦混用 AUTO_INCREMENT、PRIMARY KEY、DEFAULT 和 NOT NULL，顺序错位会直接报错。比如把 AUTO_INCREMENT 加在 VARCHAR 字段上，或漏掉 PRIMARY KEY 却硬加 AUTO_INCREMENT。
-
AUTO_INCREMENT字段必须是整型（INT、BIGINT），且必须有PRIMARY KEY或UNIQUE约束 -
DEFAULT不能用于TEXT/BLOB（MySQL 5.7+ 允许DEFAULT ''，但老版本会崩） -
NOT NULL和DEFAULT同时存在时，插入不给值才用默认值；如果只写NOT NULL却没写DEFAULT，建表不报错，插入时才炸 - 正确顺序示例：
`id` INT AUTO_INCREMENT PRIMARY KEY，不是`id` INT PRIMARY KEY AUTO_INCREMENT（虽部分版本容忍，但不保险）
表名和字段名没加反引号
ThinkPHP 原生执行 SQL 时，不会自动帮你加反引号。一旦表名或字段名是 MySQL 保留字（如 order、group、key），或者含下划线、数字开头（如 2024_log），不加反引号就直接语法错误。
- 动态生成表名时（比如
tb_comment_{$menuId}），必须包裹：`tb_comment_{$menuId}` - 所有字段名都建议统一加反引号：
`co_id`、`co_info`，避免后期改名踩坑 - 别依赖“现在能跑”，保留字列表随 MySQL 版本扩大（8.0 新增了
admin、channel等）
ENGINE 和 CHARSET 写法不完整或版本不匹配
省略存储引擎或字符集，MySQL 会按默认配置走，但不同版本默认值不同：MySQL 5.7 默认 ENGINE=InnoDB，8.0 还强制要求 utf8mb4；若脚本在测试环境（8.0）写死 CHARSET=utf8，上线到生产（严格模式）可能被拒绝。
立即学习“PHP免费学习笔记（深入）”；
- 显式声明更稳妥：
ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci -
AUTO_INCREMENT=1要写在最后，且不能跟在COLLATE后面——必须是) ENGINE=... AUTO_INCREMENT=1;，否则报错 nearAUTO_INCREMENT - ThinkPHP 的
Db::execute()不校验 SQL 结构，拼错就执行失败，错误信息只显示 near 那一段，很难定位到是缺了ENGINE
PHP 拼接时变量未过滤或引号混乱
最隐蔽的坑：PHP 层字符串拼接出空格、换行、未转义单引号，导致最终 SQL 在 MySQL 解析时断在 _php、near ' ' 这类位置。尤其用双引号 + 大括号插值时，$table 和 ${table} 行为不同，容易漏掉花括号。
- 禁止直接拼接用户输入：
"CREATE TABLE {$table} (...)"→ 改用"CREATE TABLE `" . $table . "` (...)"; - 建库/建表前先输出验证：
echo "SQL: CREATE TABLE `" . $table . "` (...);"; die(); - 用
preg_match('/^[a-zA-Z_][a-zA-Z0-9_]*$/', $table)校验表名合法性，非法字符全替换为下划线 - 别在 SQL 字符串里写 PHP 注释（
//或/* */），MySQL 不认，会当语法一部分解析
真正麻烦的不是语法写不对，而是错误不发生在建表时——比如 DEFAULT 写错类型，表建成了，插入第一条数据才报错；或者 AUTO_INCREMENT 没配 PRIMARY KEY，本地能跑，上生产因 sql_mode 不同直接失败。每次改完 SQL，务必在目标环境的 MySQL 客户端里手动粘贴执行一次，比看 PHP 报错快得多。
