SQLAlchemy对接MySQL8.0时主键id无法自动自增如何解决

核心问题是数据库中已存在的shows表id列未配置AUTO_INCREMENT属性。
SQLAlchemy文档提到的“整数类型主键默认开启自增”，仅在框架首次执行CREATE TABLE语句建表时生效，不会自动修改已经存在的表结构。你手动给列加autoincrement=True后Alembic检测不到变更，是因为SQLAlchemy本身将“整数主键自增”视为默认配置，默认对比模型和表结构差异时不会把这个属性识别为变更项，自然不会生成迁移脚本。

• 给id列加index参数和自增逻辑完全无关，索引只优化查询效率，不影响字段赋值规则
• 关闭STRICT_TRANS_TABLES严格模式属于错误排错：该模式关闭后，MySQL遇到未赋值的非空无默认值字段时不会抛错，会隐式填入类型默认值（整数类型默认值为0），这也是后续出现Duplicate entry '0' for key 'PRIMARY'报错的直接原因——每次插入都隐式填0，第一次插入成功后第二次就主键冲突了。

1. 先确认表结构问题，登录MySQL执行以下语句查看shows表字段定义：

   DESCRIBE shows;
   

   正常带自增属性的id列，Extra列会显示auto_increment，出问题的表查询结果该字段必然为空。
2. 手动给id列补全自增属性，执行以下DDL语句：

   ALTER TABLE shows MODIFY COLUMN id INT NOT NULL AUTO_INCREMENT;
   

   如果表中已有存量数据，执行该语句时MySQL会自动给现有行补齐连续递增的id值，不会造成数据丢失。
3. 修正Alembic配置避免后续漏检结构变更：找到Alembic迁移目录下的env.py文件，在context.configure配置段中添加compare_type=True参数，开启列级属性差异检测：

   with connectable.connect() as connection:
       context.configure(
           connection=connection,
           target_metadata=target_metadata,
           compare_type=True, # 新增该行，开启列属性对比
           # 保留原有其他配置项
       )
   

4. 还原之前修改的my.ini配置，重新开启STRICT_TRANS_TABLES严格模式。该模式是MySQL重要的数据校验防护，关闭后大量数据写入异常会被静默吞掉，后续排查问题成本极高。

• 不要依赖ORM框架的默认配置兜底已存在的表结构，涉及主键、约束这类核心属性变更，最好先直接查数据库实际表结构确认，不要只看模型定义
• 排错时不要通过关闭校验类配置绕过报错，这类操作只会把显性报错转为隐性数据脏写，后续会引发更难排查的数据一致性问题
• 如果是本地开发环境的全新测试库，也可以直接删除shows表后让SQLAlchemy重新建表，但生产环境绝对禁止该操作，必须通过ALTER语句变更结构

内容的提问来源于stack exchange，提问作者Superstars111