SQLAlchemy创建discorduser表时外键约束格式错误（errno:150）问题排查咨询

你遇到的这个错误核心原因其实很明确——MySQL要求外键所引用的字段必须是一个索引字段（主键、唯一键或者普通索引），而你的users表中的name字段并不满足这个条件。

咱们来拆解一下问题：

1. 从你的Users模型定义能看到，name字段只是普通的db.String(128)，既没有被设为主键、唯一键，也没有添加索引。MySQL在创建外键约束时，需要依赖被引用字段的索引来快速验证关联记录是否存在，没有索引的话，数据库无法高效维护外键的完整性，所以直接抛出了错误码150的异常。
2. 你提到“认为外键并不需要被约束”，这里可能有个误解：外键本身就是用来维护数据引用完整性的约束，数据库必须确保discorduser表中每条username对应的记录都能在users表中找到，而索引是实现这个约束的必要前提，否则每次插入、更新操作都要全表扫描users表，性能开销完全不可接受。

另外还有个小细节：你的discorduser表建表语句里重复定义了两次UNIQUE (id)，这其实没必要，因为主键本身就自带唯一约束，这个可以去掉。

修复方案 #

有两种常见的解决思路：

• 方案一：给users.name添加索引
  修改Users模型的name字段定义，加上索引：

  name = db.Column(db.String(128), index=True)
  

  这样数据库就能通过索引快速验证外键关联的有效性了。

• 方案二：改用users.id作为外键（更推荐）
  从业务逻辑来说，用户名是可能发生变化的，而主键id是稳定不变的，用主键作为外键关联是更常规、更可靠的做法。修改DiscordUser模型的外键字段：

  # 先添加关联用户主键的字段
  user_id = db.Column(db.Integer, db.ForeignKey("users.id", ondelete="CASCADE"))
  # 保留username字段但去掉外键约束，仅作为存储用
  username = db.Column(db.String(128))
  

  这种方式不仅能解决外键错误，还能避免后续用户名修改导致的外键关联问题。

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