PeeWee创建外键触发IntegrityError(1215)问题求助

以下是针对你遇到的peewee.IntegrityError: (1215, 'Cannot add foreign key constraint')错误的排查和解决步骤：

1. 确认存储引擎为InnoDB #

MySQL的MyISAM引擎不支持外键约束，必须使用InnoDB。检查你的数据库连接或模型配置：

• 连接时指定引擎：

  my_db = MySQLDatabase('your_db', user='user', password='pass', host='localhost', engine='InnoDB')
  

• 或者在基类模型中统一设置：

  class BaseModel(Model):
      class Meta:
          database = my_db
          engine = 'InnoDB'
  

2. 确保外键与父表字段完全匹配 #

外键字段必须和父表对应的字段在数据类型、符号（UNSIGNED）、长度上完全一致：

• 比如User表的主键定义：

  id = BigIntegerField(primary_key=True, unsigned=True, null=False)
  

• 推荐直接用ForeignKeyField自动关联，避免手动定义出错：

  user = ForeignKeyField(User, backref='tickets', on_delete='CASCADE')
  

  若手动定义user_id字段，必须保证类型完全匹配：

  user_id = BigIntegerField(unsigned=True, null=False)
  user = ForeignKeyField(User, to_field='id', column_name='user_id', on_delete='CASCADE')
  

3. 统一表的字符集与排序规则 #

如果User和Ticket表的字符集或排序规则不一致，也会触发外键约束错误。可以在连接或模型中统一设置：

my_db = MySQLDatabase('your_db', user='user', password='pass', host='localhost', charset='utf8mb4', collation='utf8mb4_unicode_ci')

或者在模型Meta中设置：

class Meta:
    charset = 'utf8mb4'
    collation = 'utf8mb4_unicode_ci'

4. 查看InnoDB的详细错误日志 #

执行MySQL命令SHOW ENGINE INNODB STATUS;，找到LATEST FOREIGN KEY ERROR部分，这里会给出具体的错误原因（比如哪两个字段类型不匹配、字符集不一致等），比1215的模糊提示更有用。

5. 测试最小化代码 #

写一段极简的测试代码，排除其他字段或逻辑的干扰：

from peewee import *

my_db = MySQLDatabase('test_db', user='root', password='your_pass', host='localhost', engine='InnoDB', charset='utf8mb4')

class BaseModel(Model):
    class Meta:
        database = my_db

class User(BaseModel):
    id = BigIntegerField(primary_key=True, unsigned=True)
    name = CharField()

class Ticket(BaseModel):
    user = ForeignKeyField(User, on_delete='CASCADE')

my_db.connect()
my_db.create_tables([User, Ticket])

如果这段代码能正常运行，说明你原代码中存在其他细节问题（比如模型中其他字段的定义冲突）。

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