如何在Sequelize+PostgreSQL中将多对多关联表ID从整数迁移为UUID？

我有Book和Author两个模型，存在多对多关联。最初将两者的ID设为自增整数，现希望切换为UUID。已在关联中添加UUID数据类型：

// models/book.js
const { Model } = require('sequelize')

module.exports = (sequelize, DataTypes) => {
  class Book extends Model {
    static associate(models) {
      Book.belongsToMany(models.Author, {
        as: 'authors',
        through: 'BookAuthors',
        foreignKey: {
          allowNull: false,
          name: 'bookId',
          type: DataTypes.UUID
        }
      })
    }
  }
  
  Book.init(
    {
      title: {
        type: DataTypes.STRING,
        allowNull: false
      }
    },
    {
      sequelize,
      modelName: 'Book'
    }
  )
  return Book
}

// models/author.js
const { Model } = require('sequelize')

module.exports = (sequelize, DataTypes) => {
  class Author extends Model {
    static associate(models) {
      Author.belongsToMany(models.Book, {
        through: 'BookAuthors',
        foreignKey: {
          allowNull: false,
          name: 'authorId',
          type: DataTypes.UUID
        }
      })
    }
  }
  Author.init(
    {
      name: {
        type: DataTypes.STRING(75),
        allowNull: false,
        unique: true
      },
      biography: DataTypes.TEXT
    },
    {
      sequelize,
      modelName: 'Author'
    }
  )

  return Author
}

同时在数据库初始化迁移中，将两个模型的id属性修改为：

id: {
  allowNull: false,
  defaultValue: Sequelize.UUIDV4,
  primaryKey: true,
  type: Sequelize.UUID
}

我已删除并重新创建表，但启动服务器时出现错误：

Key columns "authorId" and "id" are of incompatible types: integer and uuid.

执行的语句为：

CREATE TABLE IF NOT EXISTS "BookAuthors" ("createdAt" TIMESTAMP WITH TIME ZONE NOT NULL, "updatedAt" TIMESTAMP WITH TIME ZONE NOT NULL, "authorId" INTEGER NOT NULL  REFERENCES "Authors" ("id") ON DELETE CASCADE ON UPDATE CASCADE, "bookId" UUID NOT NULL  REFERENCES "Books" ("id") ON DELETE CASCADE ON UPDATE CASCADE, PRIMARY KEY ("authorId","bookId"));

关联表是调用db.sequelize.sync()时由Sequelize自动创建的，为何Book支持UUID而Author不支持？

问题根源 #

Sequelize自动生成关联表时，会优先读取模型自身定义的主键类型，而非关联配置里的foreignKey类型。你仅在迁移文件中修改了Author的id类型，但未在Author.init()的属性定义里显式声明UUID主键，Sequelize默认仍将Author的id视为自增整数，导致关联表的authorId被推断为integer类型，与Authors表的uuid主键类型不匹配。

修复步骤 #

1. 在模型中显式定义UUID主键
   修改models/author.js的Author.init()部分，添加id字段的UUID配置，和迁移文件保持一致：

   Author.init(
     {
       id: {
         allowNull: false,
         defaultValue: DataTypes.UUIDV4,
         primaryKey: true,
         type: DataTypes.UUID
       },
       name: {
         type: DataTypes.STRING(75),
         allowNull: false,
         unique: true
       },
       biography: DataTypes.TEXT
     },
     {
       sequelize,
       modelName: 'Author'
     }
   )
   

   同理，Book模型也需要补充id字段的显式定义，确保模型与迁移配置完全一致。

2. 清理并重新生成表

   • 删除现有数据库表（包括自动生成的BookAuthors关联表）
   • 重新运行迁移或调用sequelize.sync({ force: true })强制同步模型到数据库

3. 可选：简化关联配置
   当模型主键已显式定义为UUID后，关联配置里的foreignKey.type可以省略，Sequelize会自动匹配主键类型，避免重复配置出错：

   // Author模型关联简化后
   Author.belongsToMany(models.Book, {
     through: 'BookAuthors',
     foreignKey: {
       allowNull: false,
       name: 'authorId'
     }
   })
   

内容的提问来源于stack exchange，提问作者J. Unkrass