Sequelize创建多对一关联报ER_TABLE_EXISTS_ERROR(errno:1050)错误

问题背景 #

开发单题问卷系统时共定义3个数据模型：

• Survey：存储问卷基础内容
• SurveyResult：存储用户提交的问卷答案
• User：存储用户账号信息
  关联规则为：单条SurveyResult仅关联1个用户与1份问卷，Survey与User均可对应多条问卷结果。
  执行以下关联定义代码时程序抛出异常：

SurveyResult.belongsTo(User,{foreigney: 'userId'})
SurveyResult.belongsTo(Survey,{foreigney: 'surveyId'})

错误信息："Table './retronet/survey@002dresults' already exists"
错误标识：错误码ER_TABLE_EXISTS_ERROR，errno: 1050

现有模型完整代码 #

User 模型 #

const sequelize = require('../utility/database')
const Sequelize = require('sequelize')
const Role = require('./role')

const User = sequelize.define('users',{
    id: {
        type: Sequelize.BIGINT,
        primaryKey: true,
        allowNull: false,
        unique: true,
        autoIncrement: true
    },
    username: {
        type: Sequelize.STRING,
        allowNull: false
    },
    email: {
        type: Sequelize.STRING,
        allowNull: false
    },
    password: {
        type: Sequelize.STRING,
        allowNull: false
    },
    roleId : {
        type: Sequelize.INTEGER,
        references: {
            model: Role,
            key: 'id'
        },
        defaultValue: 4294
    }
},
{
    initialAutoIncrement: 10423204895734
})

module.exports = User

Survey 模型 #

const Sequelize = require('sequelize')
const sequelize = require('../utility/database')

const Survey = sequelize.define('surveys',{
    id: {
        type: Sequelize.INTEGER,
        primaryKey: true,
        allowNull: false,
        unique: true,
        autoIncrement: true
    },
    title: {
        type: Sequelize.STRING,
        allowNull: false
    },
    options: {
        type: Sequelize.TEXT,
        allowNull: false
    },
    multipleSelect: {
        type: Sequelize.STRING,
        allowNull: false
    }
    
},
{
    initialAutoIncrement: 1232432,
    timestamps: false
}
)

module.exports = Survey

SurveyResult 模型 #

const Sequelize = require('sequelize')
const sequelize = require('../utility/database')
const Survey = require('./survey')
const User = require('./user')

const SurveyResult = sequelize.define('survey-results',{
    id: {
        type: Sequelize.INTEGER,
        primaryKey: true,
        allowNull: false,
        unique: true,
        autoIncrement: true
    },
    answer: {
        type: Sequelize.STRING,
        allowNull: false
    },
    surveyId: {
        type: Sequelize.INTEGER,
        references: {
            model: Survey,
            key: 'id'
        },
        allowNull: false
    },
    userId: {
        type: Sequelize.BIGINT,
        references: {
            model: User,
            key: 'id'
        },
        allowNull: false
    },
},
{
    initialAutoIncrement: 423420,
    timestamps: false
}
)

module.exports = SurveyResult

错误原因 #

报错由两个问题共同导致：

1. 关联配置字段拼写错误：belongsTo配置里外键字段名是foreignKey，代码中错写为foreigney，导致Sequelize无法识别已定义的外键字段，尝试自动生成新的外键、重复触发表创建逻辑。
2. 表名命名不规范：SurveyResult的表名使用了连字符survey-results，Sequelize内部转义特殊字符时会将-转为@002d，和数据库中已存在的表名匹配异常，触发已存在错误。

修复步骤 #

1. 修正拼写与表名
   首先把SurveyResult定义的表名从带连字符的survey-results改为MySQL通用的下划线命名survey_results，避免特殊字符转义问题。
   修正关联代码的拼写错误，不要在单个模型文件内交叉引用其他模型写关联（容易触发CommonJS循环引用问题），新建模型统一入口文件（比如models/index.js）集中定义关联：

   const User = require('./user')
   const Survey = require('./survey')
   const SurveyResult = require('./surveyResult')
   
   // SurveyResult 关联 User（多对一）
   SurveyResult.belongsTo(User, {
     foreignKey: 'userId',
     onDelete: 'CASCADE'
   })
   // User 关联 SurveyResult（一对多）
   User.hasMany(SurveyResult, {
     foreignKey: 'userId',
     onDelete: 'CASCADE'
   })
   
   // SurveyResult 关联 Survey（多对一）
   SurveyResult.belongsTo(Survey, {
     foreignKey: 'surveyId',
     onDelete: 'CASCADE'
   })
   // Survey 关联 SurveyResult（一对多）
   Survey.hasMany(SurveyResult, {
     foreignKey: 'surveyId',
     onDelete: 'CASCADE'
   })
   
   module.exports = { User, Survey, SurveyResult }
   

2. 处理已存在的异常表
   开发环境下直接删除数据库中残留的survey-results、转义生成的survey@002dresults表，启动服务让Sequelize按正确结构重新建表即可。
   生产/测试环境不想删表的话，把同步配置从sequelize.sync({force: true})改为sequelize.sync({alter: true})，该模式会自动比对现有表结构和模型定义，增量更新字段、约束，不会删除已有数据。

关联实现优化方案 #

1. 移除模型内重复的外键约束定义：正确配置belongsTo/hasMany关联后，Sequelize会自动生成外键字段和参考约束，不需要在SurveyResult的字段定义里重复写references配置，避免重复约束冲突。
2. 添加复合唯一索引防止重复提交：正常业务逻辑下单个用户对单份问卷只能提交一次结果，在SurveyResult的模型配置里加唯一索引：

   {
     initialAutoIncrement: 423420,
     timestamps: false,
     indexes: [
       {
         unique: true,
         fields: ['userId', 'surveyId']
       }
     ]
   }
   

3. 统一外键删除规则：所有外键配置onDelete: 'CASCADE'，避免删除用户或问卷后数据库残留无效的问卷结果脏数据。

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