Sequelize设置UUIDV4为默认值失效，使用literal触发MySQL语法错误如何解决

问题原因说明 #

• uuid_generate_v4() 是PostgreSQL专属的UUID生成函数，MySQL不支持该语法，所以直接调用会报SQL语法错误
• 旧版本Sequelize直接配置defaultValue: Sequelize.UUIDV4存在内置生成逻辑不触发的兼容问题

可选解决方案 #

方案1：应用层生成UUID（推荐，跨数据库兼容） #

该方案由Node.js端生成UUID后写入数据库，不需要依赖数据库内置函数，兼容所有支持UUID类型的数据库，不会出现版本兼容问题。

1. 先安装uuid依赖

npm install uuid

2. 模型配置示例

const { Model, DataTypes } = require('sequelize');
const { v4: uuidv4 } = require('uuid');

class Product extends Model {}
Product.init({
  user_id: {
    type: DataTypes.UUID,
    primaryKey: true,
    defaultValue: () => uuidv4(),
    allowNull: false
  },
  // 其他字段配置...
}, {
  sequelize,
  modelName: 'Product'
});

方案2：MySQL数据库层生成UUID #

如果希望由数据库负责生成默认值，将literal调用的函数替换为MySQL原生支持的UUID()即可：

const { Model, DataTypes, literal } = require('sequelize');

class Product extends Model {}
Product.init({
  user_id: {
    type: DataTypes.UUID,
    primaryKey: true,
    defaultValue: literal('UUID()'),
    allowNull: false
  },
  // 其他字段配置...
}, {
  sequelize,
  modelName: 'Product'
});

注意：该方案仅适配MySQL数据库，切换到PostgreSQL时需要将函数替换为uuid_generate_v4()。

补充注意事项 #

• 主键字段必须配置allowNull: false，避免空值写入
• 如果对索引性能有要求，可以选择UUIDv1版本（基于时间戳生成，索引排序效率更高），只需要把uuid生成方法替换为uuidv1()即可
• Sequelize v6+版本已经修复了内置UUIDV4默认值不生效的问题，升级版本后也可以直接配置defaultValue: DataTypes.UUIDV4使用

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