为何插入/更新notification表时仍触发外键约束违反错误？

错误信息 #

触发的错误：

insert or update on table "notification" violates foreign key constraint "notification_user_id_foreign"

详细提示：

Key (user_id)=(y3er67cv-939a-e45t-b1ad-30566e3b48aa) is not present in table "user".

已确认该user_id在user表中存在，但仍触发报错。

相关代码 #

Knex建表脚本 #

import { Knex } from "knex";

export async function up(knex: Knex): Promise<void> {
  await knex.schema.createTable("notification", (table) => {
    table.uuid("id").notNullable().unique().primary().defaultTo(knex.raw("uuid_generate_v4()"));
    table.string("user_id").notNullable().index().references("id").inTable("user");
    table.string("type").notNullable();
    table.string("location").notNullable();
    table.string("asset").nullable();
    table.string("reliability").nullable();
    table.string("related_due_type").nullable();
    table.string("related_entity_id").nullable();
    table.timestamps(true, true);
  });
}

export async function down(knex: Knex): Promise<void> {
  await knex.schema.dropTableIfExists("notification");
}

测试代码 #

it("should create a User Notification", async () => {
    const expectedDto: CreateUserNotificationDto = {
      channel: NotificationChannel.email,
      type: RelatedEntityType.integrationFetchRequest,
      location: new Date(new Date().getDate()).toString(),
      assest: new Date(new Date().getDate()).toString(),
      related_due_type: "integrationRequest1",
      relatedEntityType: RelatedEntityType.integrationFetchRequest,
      user_id='y3er67cv-939a-e45t-b1ad-30566e3b48aa'
    };

const response = await request(httpServer).post(`/Notification`).send(expectedDto);
    expect(response.status).toBe(201);
    expect(response.body).toEqual(expect.objectContaining(expectedDto));

排查与解决方案 #

以下是几个核心排查方向和对应解决办法：

• 数据类型不匹配：建表脚本中notification.user_id用了string类型，但user.id是uuid类型，数据库层面可能因类型严格校验导致失败。
  解决：将notification表的user_id改为uuid类型，保持与关联字段一致：

  table.uuid("user_id").notNullable().index().references("id").inTable("user");
  

• 测试代码语法错误：测试代码中user_id='xxx'使用了赋值运算符=，对象字面量需用冒号:，这会导致user_id未正确赋值，实际传入值异常。
  解决：修正语法：

  user_id: 'y3er67cv-939a-e45t-b1ad-30566e3b48aa'
  

• 事务隔离或数据可见性问题：如果测试中创建用户和插入通知不在同一事务，可能存在用户数据未提交的情况，导致通知插入时无法读取到用户数据。
  解决：确保用户创建与通知插入在同一个测试事务中，或测试前确保用户数据已持久化到数据库。

• 字符匹配问题：检查user表中存储的id与传入的user_id是否存在大小写差异、空格或不可见字符（部分数据库对字符串大小写敏感）。
  解决：统一UUID的大小写格式，确保传入值与数据库存储值完全一致。

• 外键关联目标错误：确认user表的主键确实是id，且表名拼写正确（部分数据库区分表名大小写，比如实际表名是users而非user）。
  解决：核对user表结构，确保外键关联的表名、字段名完全匹配。

总结 #

优先排查数据类型匹配和测试代码语法错误，这两个是此类问题最常见的诱因。修正后重新测试，基本可以解决该外键约束错误。

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