错误sqlalchemy.exc.IntegrityError: (pymysql.err.IntegrityError)

在用sqlalchemy建表的时候出现了这个错误
sqlalchemy.exc.IntegrityError: (pymysql.err.IntegrityError)
查了一圈资料终于解决了

我的解决方法好像网上都没看到，记录一下。

情景

class Student(Base):
    __tablename__ = 'student'

    id = Column(String(32))
    sno = Column(String(64), primary_key=True)

class Activity(Base):
    __tablename__ = 'activity'

    id = Column(String(32), primary_key=True)

class Join(Base):
    __tablename__ = 'join'

    activity_id = Column(ForeignKey('activity.id'), primary_key=True)
    student_id = Column(ForeignKey('student.id'), primary_key=True)

我截取了三个表定义的关键部分，这是一个多对多关系，Join表的外键无法建立

这个错误首先考虑的是类型不匹配，检查sql语句与类型定义，没有不匹配

解决方法

在WorkBench运行了SHOW ENGINE INNODB STATUS命令，可以看到下面的错误信息。

------------------------
LATEST FOREIGN KEY ERROR
------------------------
2018-12-23 01:13:43 0x36c0 Error in foreign key constraint of table activity/join:
FOREIGN KEY(student_id) REFERENCES student (id), 
    CHECK (joined IN (0, 1)), 
    CHECK (`like` IN (0, 1))
):
Cannot find an index in the referenced table where the
referenced columns appear as the first columns, or column types
in the table and the referenced table do not match for constraint.
Note that the internal storage type of ENUM and SET changed in
tables created with >= InnoDB-4.1.12, and such columns in old tables
cannot be referenced by such columns in new tables.
Please refer to http://dev.mysql.com/doc/refman/5.7/en/innodb-foreign-key-constraints.html for correct foreign key definition.

检查了一下student表，id是没有被索引的，添加该列的索引后运行就好了

为什么？

sqlalchemy会自动给primary_key和foreign_key建立索引（也可能是mysql自动的，这里没有查证），碰巧我这里的外键指向了一个非primary key。而从日志中可以看出，外键是需要被指向一个有索引的列的。

第二个问题

定义了一个新表

class Comment(Base):
    __tablename__ = 'comment'

    id = Column(Integer, primary_key=True)
    activity_id = Column(ForeignKey(Activity.id))
    student_id = Column(ForeignKey(Student.id))

报同样的错误。可是两个id都是主键，必定是已经索引的，查看索引也确实是这样。查了一圈资料都指向了一个问题，类型或字符集不匹配。

查看后发现，建表的时候用的是utf8，后来连接改成了utf8mb4，所以新表会使用utf8mb4，造成了字符集不匹配出错，索性把表全删了重建了一遍。

然后将这个alembic版本推送到了服务器更新，又出现了同样的问题...我服务器的表全是utf8mb4的啊大哥...

总之问题肯定在字符集上。排查了半天发现，我更新了mysql没有重新改配置文件，把默认字符集全部改成utf8mb4再运行就没问题了。

说个题外话，mysql的utf8不是真正的utf8，mb4才是。具体的google一下都是历史

总结

这个错误常见的原因就那么几种：

• 没索引
• 类型不同
• 字符集不同

当然还有些其他的我也没仔细研究，网上都有资料。字符集不同里面的逻辑很混乱，涉及到了数据库、表、字段分别的字符集和client、server字符集，找不到原因的多半就是字符集出了差错。