Node.js REST API 向带外键的MySQL表插入数据报外键约束错误求助

这个外键约束报错在你确认关联表存在对应ID的前提下，常见原因和对应解决方案如下：

常见原因 #

• 你的请求头配置错误，你写的是Content-Content-Type: application/json，多写了一层Content-前缀，导致服务端无法正确解析JSON格式的请求体，req.body.WorkingAreaID实际为undefined，插入空值触发外键约束失败
• 你仅在Marker模型中定义了WorkingAreaID为数值类型，没有显式配置Sequelize的外键关联规则，字段类型和数据库层面的外键要求不匹配
• 数据库中working_area表的主键ID类型和你定义的WorkingAreaID类型不一致：比如ID是无符号整型（UNSIGNED INT）、或者是BIGINT，而WorkingAreaID定义的是普通INT，类型不匹配即使值正确也会触发约束失败
• 接口拿到的WorkingAreaID实际为字符串类型（比如"1"而非数字1），和模型定义的INTEGER类型不匹配，插入时触发外键校验失败
• 你手动在数据库创建的外键关联字段和模型字段大小写不匹配，比如数据库外键关联的是working_area_id而非WorkingAreaID

解决步骤 #

1. 修正请求头
   将请求头改为正确格式即可：

Content-Type: application/json

修改后先重新请求测试，排查是不是解析错误导致的问题。

2. 补全Sequelize模型的外键关联配置
   首先确保你已经定义了working_area对应的Sequelize模型WorkingArea，之后在Marker模型代码中添加关联声明：

// 引入WorkingArea模型后添加如下关联配置
Marker.belongsTo(WorkingArea, {
  foreignKey: 'WorkingAreaID',
  targetKey: 'ID', // 对应working_area表的主键字段名
  allowNull: false
})

同时确认WorkingAreaID的类型和working_area表的ID类型完全一致，比如如果ID是无符号整型，就修改字段定义：

WorkingAreaID:{
  type: DataTypes.INTEGER.UNSIGNED,
  allowNull: false
}

3. 校验接口接收的参数类型
   在调用create方法前先打印校验WorkingAreaID的类型，确保是数字类型，如果是字符串可以手动转换：

export const createMarker = async (req, res) => {
  try {
    // 转换为数字类型
    const payload = {
      ...req.body,
      WorkingAreaID: Number(req.body.WorkingAreaID)
    }
    await Marker.create(payload);
    res.json({
        "message":"Marker Created"
    });
  } catch (error) {
    console.log(error) // 可打印完整错误日志定位问题
    res.json({message: error.message});
  } 
}

4. 检查数据库外键配置
   登录数据库执行如下命令，确认外键关联的字段完全匹配：

SHOW CREATE TABLE banksampah;

查看banksampah_ibfk_1的关联规则，确认确实是WorkingAreaID REFERENCES working_area(ID)。

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