如何修改Sequelize默认列可为空的配置？

Sequelize默认将所有字段的allowNull设为true，确实会导致遗漏配置时出现意外的空值。下面提供两种实用的解决方法，不用在每个迁移文件里重复写allowNull: false：

方法1：自定义封装数据类型 #

自己封装一套默认带allowNull: false的数据类型，迁移时直接使用这套类型即可，需要允许为空的字段再手动覆盖配置。

示例代码：

// 比如在项目根目录创建 utils/custom-datatypes.js
const { DataTypes } = require('sequelize');

// 封装常用数据类型，默认开启非空约束
const CustomDT = {
  STRING: (opts = {}) => DataTypes.STRING({ allowNull: false, ...opts }),
  INTEGER: (opts = {}) => DataTypes.INTEGER({ allowNull: false, ...opts }),
  DATE: (opts = {}) => DataTypes.DATE({ allowNull: false, ...opts }),
  BOOLEAN: (opts = {}) => DataTypes.BOOLEAN({ allowNull: false, ...opts }),
  // 按需添加其他你需要的数据类型
};

module.exports = CustomDT;

在迁移文件中使用：

const { CustomDT } = require('../utils/custom-datatypes');

module.exports = {
  up: async (queryInterface) => {
    await queryInterface.createTable('Posts', {
      id: {
        type: CustomDT.INTEGER({ primaryKey: true, autoIncrement: true }),
      },
      title: CustomDT.STRING(), // 默认非空
      content: CustomDT.TEXT(), // 默认非空
      // 需要允许为空的字段，手动设置allowNull: true
      excerpt: CustomDT.STRING({ allowNull: true }),
      published_at: CustomDT.DATE({ allowNull: true }),
    });
  },
};

这种方式的好处是隔离性强，不会修改Sequelize的原生行为，避免影响其他依赖或内部逻辑。

方法2：全局修改DataTypes的默认配置 #

如果不想单独封装类型，可以直接修改Sequelize原生DataTypes的默认参数，让所有字段默认allowNull: false。注意这种方式要确保你的Sequelize版本（建议v6及以上）兼容，测试后再用在生产环境。

示例代码（放在Sequelize初始化前加载，比如数据库配置文件开头）：

const { DataTypes } = require('sequelize');

// 遍历所有数据类型，重写默认配置
Object.keys(DataTypes).forEach(typeName => {
  const originalType = DataTypes[typeName];
  // 只处理函数类型的DataType（比如DataTypes.STRING是函数，DataTypes.NOW是常量）
  if (typeof originalType === 'function') {
    DataTypes[typeName] = function(options = {}) {
      // 合并默认配置和用户传入的配置，用户配置优先级更高
      return originalType({ allowNull: false, ...options });
    };
    // 保留原类型的静态属性（比如DataTypes.INTEGER.UNSIGNED）
    Object.assign(DataTypes[typeName], originalType);
  }
});

之后在迁移里直接用原生DataTypes就行，比如：

const { DataTypes } = require('sequelize');

module.exports = {
  up: async (queryInterface) => {
    await queryInterface.createTable('Users', {
      id: {
        type: DataTypes.INTEGER({ primaryKey: true, autoIncrement: true }),
      },
      email: DataTypes.STRING(), // 默认非空
      // 需要为空的字段手动设置
      avatar_url: DataTypes.STRING({ allowNull: true }),
    });
  },
};

额外提示 #

• 对于已经创建好的表，需要手动写迁移修改现有字段的allowNull属性，新字段才会遵循新的默认规则；
• 全局修改的方式虽然方便，但如果项目中有依赖Sequelize默认行为的代码，可能会引发问题，需要谨慎测试；
• 自定义类型的方式更适合长期维护，可读性也更强，团队协作时不容易出现误解。

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